SuperVanish는 Bukkit/Spigot 서버용 Minecraft 플러그인으로, 서버 운영자와 스태프가 다른 플레이어에게 완전히 보이지 않게 해줍니다. 모니터링과 테스트에 적합한 탐지되지 않는 vanish 상태를 제공하는 동시에, 다른 플러그인이 vanish 상태와 상호작용할 수 있도록 API도 제공합니다.

🎯 목적

이 플러그인의 핵심 목적은 모더레이션과 관리용 모니터링입니다. 신뢰할 수 있는 스태프가 대부분의 플레이어에게 플레이어 목록, 입장/퇴장 메시지, 월드 내 존재감에 보이지 않으면서 플레이어의 행동을 관찰할 수 있게 합니다. 안정적인 vanish 구현이 필요한 서버 소유자, 관리자, 플러그인 개발자를 위한 것입니다.

⚙️ 기능

vanish 상태의 플레이어를 다른 플레이어에게 완전히 숨깁니다(월드 내 가시성).
vanish 상태의 플레이어를 플레이어 목록(tab)에서 숨기며, 관찰자에게 보이는 외형을 설정할 수 있습니다.
ProtocolLib를 사용할 수 있을 때 온라인 플레이어 수/서버 목록 표시를 조정합니다.
누구를 누가 볼 수 있는지 정확하게 설정할 수 있는 계층형 권한 모델.
접속, 재시작, 리로드 후에도 vanish 상태를 유지합니다.
고급 패킷 기반 기능을 위해 ProtocolLib가 필요한 선택적 통합 지점.
vanish 상태에서 "silent chest" 동작을 개선하기 위해 OpenInv 설치를 권장합니다(선택 사항).
다른 플러그인을 위한 공개 VanishAPI: 플레이어를 숨기기/보이기, 보이지 않는 플레이어 조회, PlayerHideEvent/PlayerShowEvent 감지.

🧩 대상

은신형 모더레이션 도구가 필요한 Survival 및 SMP 서버.
다른 모더레이션 또는 유틸리티 플러그인을 위해 vanish API가 필요한 서버.
설정 가능한 가시성 규칙과 tablist 제어가 필요한 관리자.

🏗️ 사용 예시

한 모더레이터가 용의자에게 들키지 않고 그리핑 신고를 조사하기 위해 모습을 감춘다.
한 플러그인이 VanishAPI를 조회해 게임 메커니즘이나 리포트에서 vanish 상태의 플레이어를 제외한다.
서버 운영자가 플레이어만 있는 조건을 시뮬레이션하기 위해 라이브 테스트 중 자신의 존재를 숨긴다.

⚙️ 설치

📥 설정

공식 플러그인 JAR를 다운로드해 서버의 plugins/ 디렉터리에 넣습니다.
서버를 재시작하고 콘솔 로그에서 SuperVanish가 로드되었는지 확인합니다.
확장 기능에 ProtocolLib를 사용할 경우 ProtocolLib도 설치한 뒤 재시작합니다.

📦 의존성

ProtocolLib(선택 사항): 플레이어 수 조정 및 일부 액션바 기능 같은 패킷 기반 기능에 필요합니다.
OpenInv(선택 권장): vanish 상태에서 인벤토리를 다룰 때 silent chest 동작을 개선합니다.

🧠 기술 참고

플랫폼: Bukkit/Spigot 플러그인으로 구현되며 다른 플러그인을 위한 Java API를 제공합니다.
API: 플레이어 숨기기/보이기, vanish 상태 확인, 보이지 않는 플레이어 목록 조회 메서드를 제공하는 VanishAPI를 제공합니다. 이벤트 기반 통합을 위해 PlayerHideEvent와 PlayerShowEvent도 포함됩니다.
영속성: API를 통해 모든 보이지 않는 플레이어(온라인 및 오프라인) 목록을 반환할 수 있습니다. 모든 보이지 않는 플레이어를 가져오는 작업은 데이터베이스 접근이 필요할 수 있으며, 메인 스레드 밖에서는 주의해서 사용해야 합니다.
라이선스: MIT 라이선스로 배포되며 소스 코드는 프로젝트 저장소에서 उपलब्ध합니다.