Minecraft 플러그인 InteractionVisualizer

🔌 InteractionVisualizer 소개

InteractionVisualizer는 기능 블록과 관련 엔티티(예: crafting tables, furnaces, enchantment tables)에 대한 클라이언트 측 시각 표현과 애니메이션을 렌더링하는 Minecraft 플러그인입니다. 시각 효과는 packet을 통해 플레이어에게 전송되며 서버 측 블록이나 엔티티를 생성하지 않습니다 — 이는 순수한 클라이언트 측 표시로, 월드 상태에 영향을 주지 않습니다.

🎯 목적

이 플러그인은 플레이어가 GUI를 사용하는 동안 아이템, 진행 상황, 홀로그램, 애니메이션을 보여 줌으로써, 자주 사용되는 기능 블록과의 상호작용을 주변 플레이어도 볼 수 있게 합니다. 월드 내 인터페이스와 플레이어가 상호작용할 때 더 풍부하고 이해하기 쉬운 시각적 피드백을 원하는 서버 운영자를 위한 플러그인입니다.

⚙️ 기능

• 많은 기능 블록과 해당 아이템/엔티티를 애니메이션과 함께 시각화합니다(crafting table, furnace, enchantment table 등).
• 클라이언트 전용 표시: 시각 효과는 지속적이거나 상호작용 가능한 서버 엔티티를 생성하지 않습니다.
• 블록별 표시 토글 및 전역 모듈 토글.
• 플레이어 토글 상태는 데이터베이스에 저장됩니다(기본값 SQLite, MySQL 지원).
• 플레이어 토글 상태를 위한 PlaceholderAPI 플레이스홀더를 사용할 수 있습니다.
• 애드온용 개발자 API / 위키를 제공합니다.
• 일반적인 플러그인과의 연동을 고려하여 애니메이션을 비활성화하거나 조정할 수 있습니다(vanish 플러그인, OpenInv 등).

🧩 대상

• 블록 상호작용에 대해 더 몰입감 있는 시각적 피드백을 원하는 Survival 및 SMP 서버.
• 서버 월드 데이터를 수정하지 않고 클라이언트 측 시각적 완성도를 선호하는 장식/롤플레잉 서버.
• 플레이어별 시각 효과 제어를 선택적으로 제공하고 싶은 서버 관리자.

🏗️ 사용 예시

• 플레이어가 레시피 칸을 채울 때 crafting table 위에 아이템이 나타나는 모습을 보여 주어, 주변 플레이어가 진행 상황을 볼 수 있게 함.
• 플레이어가 furnace UI와 상호작용하는 동안 furnace 진행 홀로그램과 생성된 아이템 시각 효과를 표시함.
• 플레이어가 어떤 표시 모듈을 볼지 직접 전환할 수 있게 함(itemstands, dropped items, holograms).

⌨️ 명령어

🔐 권한

⚙️ 설치

📥 설정

• 공식 플러그인 JAR와 필요한 모든 의존성 JAR를 다운로드합니다.
• JAR 파일을 서버의 plugins/ 폴더에 넣습니다.
• 서버를 시작하고 콘솔에서 플러그인이 로드되었는지 확인합니다.
• 필요에 따라 설정을 편집하고, 설정 변경을 적용하려면 서버를 다시 시작합니다.

📦 의존성

• ProtocolLib(명시된 오래된 서버 버전 / packet 처리에 필요).
• LightAPI Fork(사용되는 오래된 버전에서 필요).

프로젝트에서 언급한 느슨한/선택적 연동(동작 조정에 사용): EssentialsX, OpenInv, PlaceholderAPI, SuperVanish, PremiumVanish, CMI.

🧾 설정

• 플러그인은 기본적으로 플레이어별 토글을 SQLite에 저장하며, 서버 간 영구 저장을 위해 MySQL도 지원합니다.
• 각 블록 표시와 각 모듈은 플러그인 설정에서 비활성화할 수 있습니다.

🧠 기술 참고

• Spigot API를 기반으로 제작되었으며, Paper 및 여러 최신 서버 빌드와의 호환성도 보고됩니다.
• 표시는 클라이언트 전용이며, 죽일 수 있거나 지속적인 서버 엔티티를 생성하지 않습니다.
• 이 플러그인은 서드파티 애드온용 개발자 API를 제공하며, 번역은 커뮤니티에서 유지합니다.
• 프로젝트에는 제한 사항이 있으며, Minecraft 1.10.2 이하에서는 작동하지 않을 수 있다고 명시되어 있습니다.

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

서버 측 상태를 변경하지 않으면서 플레이어 상호작용에 대해 눈에 거슬리지 않는 장식용 시각 피드백을 원한다면, InteractionVisualizer는 packet 기반 애니메이션과 플레이어별 제어를 제공해 월드를 그대로 유지한 채 몰입감을 높여 줍니다.