Minecraft 플러그인 NightVision

🔌 NightVision 소개

NightVision은 Spigot/Paper 서버용 Minecraft 플러그인으로, 보이는 포션 입자나 거품 없이 토글 가능한 풀브라이트 야간 시야를 제공합니다. 이 플러그인은 플레이어 상태를 UUID로 저장하고, 재로그인, 사망, 리스폰, 월드 변경, 서버 재시작 후에도 복원하면서 권한 검사를 적용합니다.

🎯 목적

이 플러그인은 서버가 제어하는 밝기(야간 시야)를 지속적이고 보이지 않게(포션 입자 없이) 플레이어에게 제공하는 문제를 해결하며, 관리자가 누가 이 효과를 활성화하거나 유지할 수 있는지 명확하게 제어할 수 있게 합니다.

⚙️ 기능

• 플레이어용 토글형 야간 시야(/nv).
• 숨겨진 입자와 포션 거품이 있는 풀브라이트 효과.
• UUID 기반 영구 저장 상태; 재로그인, 사망, 리스폰, 월드 변경, 재시작 후 복원.
• 다른 플레이어를 토글/확인하고 플러그인을 다시 불러오는 관리자 명령어.
• 선택적 관리자 강제 지속 및 권한 제거 후 우회 방지를 위한 안전한 권한 검사.
• config.yml과 messages.yml 분리; /nv reload가 누락된 파일을 다시 생성.
• PlaceholderAPI 연동(상태용 플레이스홀더 제공).
• 사용 통계를 위해 bStats 사용.

🧩 대상

• 클라이언트 모드 없이 서버 측 밝기 제어를 원하는 Survival 및 SMP 서버.
• 권한이나 랭크에 연결된 지속적인 시각 효과가 필요한 서버 관리자.
• PlaceholderAPI를 사용하고 야간 시야 상태용 플레이스홀더를 원하는 서버.

🏗️ 사용 예시

• 밤에 작업하는 스태프나 빌더에게 입자 없는 영구 야간 시야를 제공.
• 재로그인과 월드 변경 후에도 유지되는 구독자 또는 기부자용 영구 야간 시야 랭크 제공.
• 월드 시간을 변경하지 않고 밤 이벤트 동안 플레이어에게 일시적으로 야간 시야를 활성화.

⌨️ 명령어

🔐 권한

⚙️ 설치

📥 설정

• 플러그인 JAR를 다운로드하여 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작합니다(중지되어 있었다면 서버를 시작합니다).
• 서버 콘솔/로그를 확인하여 플러그인이 올바르게 로드되었는지 확인합니다.
• 플러그인은 config.yml과 messages.yml을 생성합니다. /nv reload를 사용하면 누락된 파일을 다시 생성합니다.

📦 의존성

• PlaceholderAPI(선택 사항 — PlaceholderAPI가 있으면 플러그인이 플레이스홀더를 제공합니다).

🧠 기술 메모

• 최신 Paper 및 Spigot 스타일 서버용으로 제작되었습니다. 플러그인은 기본 Minecraft 버전을 1.21로 표기하며, 1.17부터 1.21까지(1.20.6 포함) 명시적으로 테스트되었습니다.
• UUID로 영구 상태를 저장하므로 플레이어의 야간 시야 상태가 세션과 서버 재시작을 넘어 유지됩니다.
• PlaceholderAPI와 연동되며 bStats를 통해 사용량을 보고합니다.
• 공식 리소스 페이지에는 공개 소스 저장소 URL이 표시되어 있지 않습니다.

🤝 이 플러그인이 유용한 경우

재로그인과 월드 변경을 넘어 유지되며 권한으로 제어할 수 있는 풀브라이트 야간 시야를 플레이어에게 간단하게 제공해야 한다면, NightVision은 최소한의 설정과 관리자 도구로 그 기능을 제공합니다.