Minecraft 플러그인 PvPManager

🔌 PvPManager 소개

PvPManager는 플레이어 간 전투와 전투 관련 서버 규칙을 관리하는 Minecraft 플러그인입니다. PvP 전환, 전투 태그, combat-log 방지, 초보자 보호, 그리고 다양한 처치/리스폰 동작을 하나의 설정 가능한 플러그인에 통합해 서버 관리자를 위해 설계되었습니다.

🎯 목적

PvPManager의 핵심 목적은 PvP 상호작용과 전투 관련 예외 상황을 중앙에서 설정 가능하게 제어하는 것입니다. 이를 통해 서버 소유자는 일관된 규칙을 적용할 수 있습니다(PvP 전환, combat logging 처벌, 신규 유저 보호, 처치 보상/패널티 제어, 전투 제한 관리 등).

⚙️ 기능

• 플레이어별, 월드별, 또는 전역 PvP 전환.
• 설정 가능한 타이머와 시각적 표시(action bar/boss bar)가 있는 전투 태그 시스템.
• 설정 가능한 처벌(인벤토리 드롭, 갑옷/경험치 드롭, 돈 패널티, 플레이어 처치, 이벤트 브로드캐스트/로그)을 포함한 combat-log 방지.
• 초보자 보호 및 리스폰/텔레포트 보호.
• border-hopping 방지(태그가 붙은 상태에서 안전 구역으로 도망가는 것 방지)와 kill 남용 방지 트리거.
• 전투 중 행동 비활성화(비행, 게임 모드 변경, 명령어, 엔더펄, 블록 설치 등).
• 인벤토리 처리 옵션(보관, 드롭, 또는 드롭을 killer에게 전달)과 auto-soup 지원.
• 금전 보상/패널티와 처치 시 실행되는 명령어.
• PlaceholderAPI 연동과 구역 플러그인(WorldGuard, Towny) 및 Citizens 지원, 특정 동작을 위한 선택적 연동.
• bStats를 통한 텔레메트리 및 사용량 보고.

🧩 대상

• 설정 가능한 PvP 규칙이 필요한 Survival 및 SMP 서버.
• combat logging 방지와 신규 유저 온보딩 안전이 필요한 서버.
• 여러 개의 별도 플러그인 없이 통합된 처치/보상 규칙과 간단한 PvP 전환을 원하는 관리자.

🏗️ 사용 예시

• 첫 플레이 세션에 초보자 보호를 활성화하고, 설정한 시간이 지난 뒤에만 PvP를 허용.
• 전투 중인 플레이어를 태그하고, 태그가 만료될 때까지 텔레포트, 명령어 사용, 안전 구역 진입을 막음.
• 전투 중 접속을 끊은 플레이어에게 인벤토리 드롭 또는 서버가 정의한 처벌을 적용.
• killer에게 자동으로 돈을 보상하거나, 처치 시 사용자 지정 명령어를 실행.

⌨️ 명령어

참고: 나열된 명령어는 공식 플러그인 문서와 리소스 페이지에서 가져온 것입니다. 각 명령어의 권한 노드는 프로젝트 문서에 있지만 여기에는 포함하지 않았습니다.

⚙️ 설치

📥 설정

• 플랫폼에 맞는 플러그인 배포 페이지에서 공식 JAR 파일을 다운로드합니다.
• Spigot/Paper 호환 서버의 plugins/ 디렉터리에 JAR을 넣습니다.
• 서버를 재시작하고 콘솔 로그를 확인하여 플러그인이 로드되었는지 확인합니다.

📦 의존성

• PlaceholderAPI(플레이스홀더용 선택적 연동).
• WorldGuard, Towny, Citizens 같은 구역 및 NPC 플러그인용 연동(선택 사항, 존재할 때 사용).

🧠 기술 메모

• 확인된 지원 서버 소프트웨어에는 Spigot과 Paper가 포함되며, Folia 지원도 프로젝트에 명시되어 있습니다.
• 이 플러그인은 개발자 API를 제공하고 테스트용 dev build를 배포합니다.
• 프로젝트는 공개 저장소에서 소스 코드와 이슈 추적을 제공하며, 텔레메트리에 bStats를 사용합니다.
• 테스트된 Minecraft 버전은 여러 릴리스를 아우릅니다. 정확한 호환성은 특정 서버 버전에 대한 플러그인 문서를 확인해야 합니다.

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

PvPManager는 여러 개의 별도 플러그인을 조합하지 않고도 PvP 전환, 전투 태그, combat-log 처벌, 초보자 보호를 처리할 수 있는 하나의 설정 가능한 플러그인이 필요할 때 유용합니다. 일반적인 PvP 규칙을 중앙에서 관리하고, 관리자 명령어와 연동 기능을 통해 다양한 서버 환경에 맞게 동작을 조정할 수 있습니다.