Minecraft 플러그인 InteractiveChat

🔌 InteractiveChat 소개

InteractiveChat은 Minecraft 플러그인으로, 평범한 플레이어 이름과 키워드를 호버 메시지와 클릭 동작이 포함된 상호작용형 콘텐츠로 바꾸고, 플레이어가 아이템, 인벤토리, 엔더 상자를 채팅에 직접 보여줄 수 있게 해 게임 내 채팅을 강화합니다. 기존 채팅 포맷 플러그인 위에서 동작하도록 설계되었으며, 채팅 시스템을 대체하는 대신 패킷을 수정합니다.

🎯 목적

InteractiveChat은 단순한 텍스트만 있는 정적인 채팅의 문제를 해결하기 위해 상호작용 요소와 풍부한 플레이스홀더를 추가해, 플레이어가 아이템/도구 정보와 인벤토리 내용을 호버 및 클릭 상호작용으로 공유할 수 있게 합니다. 또한 프록시 네트워크에서 서버 간 기능을 지원하여 백엔드 서버 전반에서 상호작용형 채팅 기능을 사용할 수 있습니다.

⚙️ 기능

• 채팅의 플레이어 이름을 호버/클릭 상호작용 콘텐츠로 바꿉니다.
• 키워드(예: [item])를 통해 손에 든 아이템 미리보기를 채팅에 표시합니다.
• 키워드(예: [inv])를 통해 플레이어 인벤토리 내용을 채팅에 표시하고 표시 레이아웃을 선택할 수 있습니다.
• 키워드(예: [ender])를 통해 엔더 상자 내용을 채팅에 표시합니다.
• 채팅에서 사용할 사용자 지정 상호작용 키워드/플레이스홀더를 만들 수 있습니다.
• 서버 버전이 지원하는 경우, 플레이어 멘션 시 선택적 알림(사운드, 타이틀, 액션바, 보스바)을 제공합니다.
• 프록시와 백엔드에 설정되어 있으면 BungeeCord 및 Velocity의 서버 간 지원을 제공합니다.
• PlaceholderAPI 플레이스홀더를 지원하고, 아이템 재질 이름을 클라이언트 언어로 번역하는 기능과 연동됩니다.
• RGB 색상 코드와 사용자 지정 글꼴을 지원하는 서버에서는 해당 메시지 기능을 사용할 수 있습니다(RGB 동작은 1.16+가 필요).

🧩 대상

• 더 풍부한 채팅 상호작용과 호버/클릭 가능한 콘텐츠를 원하는 서버 관리자.
• 백엔드 서버 간 상호작용형 채팅이 필요한 프록시(BungeeCord/Velocity) 네트워크.
• 외부 모드 없이 플레이어가 아이템이나 인벤토리를 채팅에 보여주길 원하는 커뮤니티.

🏗️ 사용 예시

• 플레이어가 전역 채팅에 [item]을 입력해 들고 있는 아이템의 상호작용형 툴팁을 보여주고, 다른 사람들이 확인하게 합니다.
• 관리자가 플레이스홀더와 인라인 인벤토리 미리보기를 사용한 형식 있는 채팅 메시지를 보내 지원이나 검토에 활용합니다.
• 프록시 네트워크에서 프록시와 백엔드 모두에 플러그인을 설치해 멘션과 플레이스홀더가 서버 전반에서 작동하게 합니다.

⌨️ 명령어

참고: 위에는 공식 출처에 명시적으로 나온 명령어만 포함되어 있습니다. 권한 노드는 플러그인 문서에 명시된 경우에만 포함되며, 그렇지 않으면 권한 열에 지정되지 않음으로 표시됩니다.

🔐 권한

(위에는 플러그인의 공식 문서에 명시된 권한 노드만 나열되어 있습니다.)

⚙️ 설치

📥 설정

• 공식 플러그인 JAR과 필요한 의존성 플러그인을 다운로드합니다.
• InteractiveChat.jar(및 의존성 jar)을 서버 plugins/ 디렉터리에 넣습니다.
• 서버를 시작합니다.
• 필요하면 플러그인 설정을 편집하고 서버를 재시작해 변경 사항을 적용합니다.

📦 의존성

백엔드(Spigot/Paper 등) 서버에서 필요한 것으로 확인된 의존성:

• ProtocolLib 또는 PacketEvents(+ 관련 패킷 모듈)
• PlaceholderAPI
• Vault

참고: 의존성은 프록시 소프트웨어에는 필요하지 않습니다. BungeeCord 또는 Velocity와 함께 사용할 계획이라면 프록시와 백엔드 서버 모두에 InteractiveChat를 설치하고, 각 백엔드의 설정에서 proxy/bungeecord 옵션을 활성화하세요.

🧠 기술 참고

• 이 플러그인은 패킷 수준에서 채팅을 수정합니다. 백엔드 서버의 메시지를 가로채고 수정하려면 패킷 라이브러리(ProtocolLib 또는 PacketEvents)가 필요합니다.
• 프록시 지원: BungeeCord와 Velocity가 지원됩니다. 서버 간 플레이스홀더와 멘션을 활성화하려면 플러그인을 프록시와 모든 백엔드 서버에 설치하고, 각 백엔드 설정에서 bungeecord 옵션을 활성화해야 합니다.
• PlaceholderAPI는 플레이스홀더 해석에 사용되며, 필요한 확장 기능은 해당 플레이스홀더가 작동하도록 별도로 설치해야 합니다.
• 아이템 재질 이름은 해당하는 경우 각 플레이어의 클라이언트 언어로 번역됩니다.
• RGB 색상 코드와 사용자 지정 글꼴 태그는 해당 기능을 지원하는 서버/클라이언트에서 사용할 수 있습니다(RGB 동작은 일반적으로 1.16+에서 제공되는 서버/클라이언트 지원이 필요합니다).

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

기존 채팅 포맷 플러그인을 그대로 유지하면서 확인 가능한 아이템/도구 미리보기, 인벤토리 공유, 클릭 가능한 채팅 키워드, 서버 간 상호작용형 채팅 기능을 추가하고 싶다면, InteractiveChat은 표준 채팅 시스템 위에 상호작용형 콘텐츠를 덧씌우는 패킷 수준 통합을 제공합니다.