Minecraft 플러그인 MarriageMaster

🔌 Marriage Master 소개

Marriage Master는 서버용으로 설정 가능한 결혼 시스템을 제공하는 Bukkit/Spigot Minecraft 플러그인입니다. 플레이어가 결혼을 맺을 수 있게 해 주며(설정에 따라 단일 또는 다중), 결혼한 플레이어에게 협력 기능과 명령을 제공합니다. 이 프로젝트에는 개발자용 API가 포함되어 있으며 지속형 저장을 지원합니다.

🎯 목적

이 플러그인은 게임 내 결혼 요소를 원하는 롤플레잉 및 소셜 서버를 위해 설계되었습니다. 커플이 함께 쓸 수 있는 편의 기능, 비공개 채팅, 선택적인 경제 연동, 그리고 파트너가 가까이 있을 때 적용되는 설정 가능한 게임플레이 효과를 제공합니다.

⚙️ 기능

• 플레이어 간 결혼 요청과 (선택 사항인) 사제 주관 예식.
• 파트너에게 텔레포트하기와 두 파트너가 모두 이동할 수 있는 공유 집.
• 커플 전용 비공개 채팅과 공개 채팅 대신 모든 채팅을 파트너에게 보내는 전환 기능.
• 선물 아이템: 플레이어가 손에 든 아이템을 파트너에게 줄 수 있습니다.
• 파트너 간 PvP 전환(PvP를 켜거나 끄기).
• 파티클 효과가 있는 kiss 같은 꾸미기 동작.
• 파트너가 가까이 있을 때의 XP 및 재생 보너스(Minecraft XP, mcMMO, SkillAPI 연동 언급).
• 선택 사항인 공유 백팩 / Minepacks 연동.
• 설정 가능한 언어 파일을 통한 다국어 지원.
• 설정 가능한 저장 백엔드: SQLite 및 MySQL 지원.
• 플러그인 개발자가 Marriage Master 데이터와 이벤트를 다룰 수 있는 API.

🧩 대상

• 게임 내 관계 메커니즘을 원하는 롤플레잉 및 소셜 서버.
• 플레이어 쌍을 위한 선택적 협동 혜택을 원하는 SMP 또는 서바이벌 서버.
• 경제나 다른 플러그인과의 연동, 그리고 설정 가능한 권한이 필요한 서버 관리자.

🏗️ 사용 예시

• 두 플레이어가 결혼 요청을 보내고 공유 집과 비공개 채팅 채널을 얻게 됩니다.
• 서버가 이벤트용으로 사제 예식을 활성화하고, 서버 스크립트나 API 훅을 통해 결혼 시 특별한 아이템이나 칭호를 부여합니다.
• 커플이 gift 명령을 사용해 손에 든 아이템을 교환하며 롤플레잉을 즐깁니다.

⌨️ 명령어

참고: 공식 출처에는 이러한 명령어가 나와 있지만 리소스 페이지에 권한 노드가 직접 문서화되어 있지는 않습니다. 권한은 플러그인 문서와 권한 목록에서 확인할 수 있습니다.

⚙️ 설치

📥 설정

• 공식 리소스 페이지에서 플러그인 JAR를 다운로드하여 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔 출력을 확인해 플러그인이 정상적으로 로드되었는지 확인합니다.

📦 종속성

• 실행 시 Java 8이 필요합니다.
• 확인된 실행 플랫폼: Bukkit, Spigot, Paper.
• 작성자가 문서화한 선택적 연동/종속성: Vault(선택 사항, 경제 기능용), PCGF PluginLib(선택 사항), Minepacks 연동, Placeholder 지원.
• 선택적 프록시 지원: BungeeCord / Waterfall.

🧾 설정

• 이 플러그인은 거의 모든 동작, 메시지, 기능을 커스터마이즈할 수 있는 포괄적이고 문서화된 설정과 언어 파일을 제공합니다.
• 저장소는 SQLite 또는 MySQL을 사용하도록 설정할 수 있습니다.

🧠 기술 메모

• 지원되는 서버 소프트웨어: Bukkit, Spigot, Paper(작성자는 Bukkit/Spigot/Paper 지원과 선택적 BungeeCord/Waterfall 프록시 지원을 명시함).
• 실행 시 Java 8이 필요합니다.
• 이 프로젝트에는 개발자용 API가 포함되어 있으며 연동을 위한 JavaDoc 문서도 제공합니다.
• 플러그인은 UUID/이름 변경을 지원하며 리소스 파일을 통한 다국어 지원이 있습니다.

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

롤플레잉, 소셜, 또는 SMP 서버를 운영하면서 설정 가능한 혜택, 커플 전용 유틸리티, 개발자 훅이 있는 게임 내 결혼 시스템을 원한다면, Marriage Master는 데이터베이스 지원과 일반적인 서버 생태계를 위한 연동 기능으로 이러한 요구를 충족합니다.