Minecraft 플러그인 VotingPlugin

🔌 VotingPlugin 소개

VotingPlugin은 Minecraft용 고급 투표 리스너이자 보상 관리자 역할을 하는 플러그인입니다. 외부 투표 서비스로부터 투표 알림을 (Votifier 또는 유사한 리스너를 통해) 받아 서버에 매우 유연하게 설정 가능한 보상, 공지, 추적 기능을 적용합니다.

🎯 목적

이 플러그인은 투표 처리와 보상 지급을 한곳에 모아 서버 관리자가 총투표 수와 월간 투표 수를 추적하고, 사이트별 또는 누적 보상을 지급하며, 투표 이벤트를 방송하고, 상위 투표자 순위를 관리할 수 있게 합니다.

⚙️ 기능

• 투표 사이트별 보상과 플레이어별 누적 보상 설정 가능 (X번 투표하면 보상 획득).
• 들어오는 투표에 대한 공지 및 브로드캐스트 옵션.
• 상위 투표자 추적 및 선택적 상위 투표자 보상.
• PlaceholderAPI 호환성 (게임 내 표시용 플레이스홀더 제공).
• 복잡한 구성을 단순화하는 외부 편집기 지원.
• 활발히 개발 중이며, 소스와 릴리스가 공개 저장소에서 관리됩니다.

🧩 대상 사용자

• 서버 목록 투표로 트래픽을 유도하고 자동 보상을 원하는 서버 소유자와 관리자.
• 보상과 플레이어 참여를 위해 투표를 사용하는 SMP 및 Survival 서버.
• Votifier 스타일 리스너로 투표를 받고 중앙 보상 시스템이 필요한 네트워크.

🏗️ 사용 예시

• 사이트에서 투표할 때마다 플레이어에게 아이템이나 화폐 보상을 지급.
• 플레이어가 설정된 투표 수에 도달하면 특별 보상을 지급.
• 월간 순위를 유지하고 상위 투표자에게 상품을 제공.

📥 설치

📥 설정

• 공식 플러그인 JAR를 다운로드해 Spigot 호환 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 재시작하고 콘솔 로그를 확인해 플러그인이 정상적으로 로드되는지 확인합니다.
• 외부 투표 사이트가 서버에 알릴 수 있도록 Votifier 스타일 리스너가 설정되어 있는지 확인하세요.

📦 의존성

• 외부 투표 전달에는 Votifier(또는 다른 투표 알림 리스너)가 필요합니다.
• PlaceholderAPI는 스코어보드, 채팅 또는 GUI와의 연동이 필요할 때 플레이스홀더용으로 지원됩니다.

🧠 기술 메모

• 확인된 플랫폼: Spigot.
• 테스트된 Minecraft 주요 버전에는 프로젝트에 표시된 항목(예: 1.17, 1.18, 1.19, 1.20, 1.21)이 포함됩니다. 프로젝트에는 그 이전의 기본 주요 버전도 함께 나열되어 있습니다.
• 소스 코드와 이슈 트래커는 프로젝트 저장소에서 공개되어 있습니다.

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

외부 서버 목록 투표를 게임 내 보상, 공지, 순위표로 바꿀 수 있는 설정 가능한 시스템이 필요하다면, VotingPlugin은 Spigot 호환 서버를 위한 기능이 풍부하고 활발히 유지보수되는 솔루션입니다.