Minecraft 플러그인 DeathMessages

🔌 DeathMessages 소개

DeathMessages는 Minecraft에 기본으로 포함된 사망 메시지를 교체하고 커스터마이즈하기 위한 Minecraft 플러그인입니다. 플레이어, 몹, 길들일 수 있는 몹, 자연사에 대한 설정 가능한 메시지 템플릿을 불러오며, 바닐라 문자열 대신 텍스트 컴포넌트 메시지(hover/click 컴포넌트 포함)를 전송합니다.

🎯 목적

이 플러그인의 목적은 서버 관리자가 플레이어에게 사망 정보가 어떻게 표시될지 제어할 수 있게 하는 것입니다. 문구 변경, 플레이스홀더 사용, 색상 및 hover/click 데이터 추가, 월드나 지역별 브로드캐스트 제한, 그리고 다른 서버 시스템(플레이스홀더, Discord, MythicMobs)과의 연동이 가능합니다.

⚙️ 기능

• 바닐라 사망 메시지를 설정 가능한 템플릿으로 완전히 대체.
• 텍스트 컴포넌트(hover 텍스트, 클릭 동작)와 16진수 색상 코드 지원.
• 피해 유형별로 다양한 사용자 지정 메시지를 넣을 수 있는 여러 설정 파일.
• 월드별 메시지와 비활성화된 월드 목록.
• 활성화 시 특정 사망 메시지 유형(플레이어, 몹, 자연, 길들일 수 있는 몹)을 숨기는 WorldGuard 지역 플래그.
• PlaceholderAPI 연동: 피해자, 죽인 플레이어, 플러그인 상태용 플레이스홀더 집합을 노출.
• MythicMobs 및 DiscordSRV용 선택적 훅(설정 기반).
• Bungee/Proxy 글로벌 메시지 지원.
• API 이벤트(BroadcastDeathMessageEvent, BroadcastTameableDeathMessageEvent)를 발생시키고 PlayerManager 유틸리티 클래스를 제공.
• 설정 가능한 이벤트 우선순위와 무리 몹 처치용 gang-kill 감지 기능.

🧩 대상

• 커스텀 또는 테마형 사망 메시지를 원하는 Survival / SMP 서버.
• 플레이스홀더나 외부 시스템(DiscordSRV, MythicMobs)을 사용하며 일관된 메시지 형식이 필요한 서버.
• 월드별 또는 지역별로 메시지 브로드캐스트를 제어해야 하는 서버.

🏗️ 사용 예시

• 기본 사망 메시지를 16진수 색상과 hover 텍스트를 사용한 테마형 또는 롤플레잉 스타일 메시지로 바꾸기.
• 사망 템플릿 안에서 PlaceholderAPI 값(피해자 이름, 죽인 사람 이름, 마지막 위치) 사용하기.
• WorldGuard로 보호된 지역 안에서 사망 메시지가 표시되지 않도록 막기.
• DiscordSRV 훅을 통해 사망 이벤트를 Discord 채널로 브로드캐스트하기.

⌨️ 명령어

🔐 권한

⚙️ 설치

📥 설정

• 공식 플러그인 .jar 파일을 다운로드하여 서버의 plugins/ 폴더에 넣습니다.
• 서버를 재시작하고 콘솔 로그에서 플러그인이 로드되었는지 확인합니다.
• 플러그인 페이지에는 Spigot보다 Paper가 권장된다고 안내되어 있습니다.

📦 의존성

• 작성자가 언급한 선택적 연동: PlaceholderAPI, WorldGuard, MythicMobs, DiscordSRV. 이들은 선택적 훅이며 기본 메시지 교체에는 반드시 필요하지 않습니다.

🧠 기술 참고

• 이 플러그인은 API 이벤트(BroadcastDeathMessageEvent 및 BroadcastTameableDeathMessageEvent)를 노출하고, 플러그인 작성자를 위한 PlayerManager 유틸리티를 제공합니다.
• 이벤트 우선순위는 설정에서 변경할 수 있으며, 선택한 PlayerDeathEvent 우선순위로 동작할 수 있습니다.
• 여러 Minecraft 메이저 버전을 지원하며, 공식 리소스 페이지에서 1.12부터 1.21까지 명시적으로 테스트되었습니다.

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

플레이어에게 사망 정보를 보여주는 방식을 정밀하게 제어해야 한다면(커스텀 문구, 플레이스홀더, 월드/지역별 규칙 및 연동), DeathMessages는 설정 가능한 템플릿과 훅을 제공하면서 추가 확장을 위한 이벤트도 노출합니다.