Minecraft 플러그인 WorldGuardExtraFlagsPlus

🔌 WorldGuard ExtraFlags Plus 소개

WorldGuard ExtraFlags Plus는 WorldGuard 플러그인을 위한 확장으로, 추가 지역 플래그와 동작을 제공합니다. WorldGuard의 지역 시스템을 40개 이상의 확인된 플래그로 확장하여 아이템 사용, 텔레포트, 입장 제한, 제작, 플레이어 충돌, 주민 거래 및 기타 지역별 규칙을 제어할 수 있게 합니다.

🎯 목적

이 플러그인은 WorldGuard 기본 플래그에서 부족한 부분을 채워, 플레이어 행동과 지역 정책을 세밀하게 제어할 수 있게 해줍니다. 핵심 WorldGuard를 넘어서는 지역 수준의 커스터마이징이 필요한 서버 관리자용이며, 예를 들어 보호된 PvP 아레나, 로비, 허브 동작, 제한된 게임플레이 구역을 만드는 데 적합합니다.

⚙️ 기능

• 40개 이상의 추가 플래그를 추가합니다 (teleport-on-entry/exit, command-on-entry/exit, console-command-on-entry/exit, walk-speed, fly-speed, keep-inventory, keep-exp).
• Plus 전용 새 플래그: disable-completely, disable-throw, entry-min-level, entry-max-level, player-count-limit, villager-trade, lightning-damage, disable-collision, inventory-craft, permit-workbenches, deny-item-drops, deny-item-pickup, allow-block-place, deny-block-place, allow-block-break, deny-block-break.
• messages-wgefp.yml에 저장되는 사용자 지정 메시지(스팸 방지를 위한 메시지 쿨다운 포함).
• 선택적 연동 훅: 숫자 플레이스홀더를 위한 PlaceholderAPI 지원, 특정 아이템/공격에 대한 차단 범위를 개선하는 PacketEvents 또는 ProtocolLib 패킷 훅.
• EssentialsX 연동: godmode와 fly 플래그 개선으로 해당 플래그가 거부되면 EssentialsX의 godmode/fly를 비활성화합니다.
• Folia 지원 및 적용 가능한 경우 async 안전 핸들러.
• 업데이트 검사기와 실험적 hide-players 플래그, 그리고 실험적 동작인 chambered-enderpearl.
• 플레이어가 지역에 머무는 동안 콘솔 명령을 반복 실행하는 console-command-repeat 플래그(기본 비활성화).

🧩 대상

• WorldGuard를 사용하며 더 정밀한 지역 제어가 필요한 서버 소유자와 관리자.
• 지역 기반 동작 커스터마이징이 필요한 Survival, SMP, hub/lobby, PvP 서버.
• async 또는 fork 전용 지원이 필요한 Paper 또는 Folia 사용 서버.

🏗️ 사용 예시

• player-count-limit으로 아레나 지역의 플레이어 수를 제한합니다.
• disable-completely와 disable-throw를 사용해 이벤트 구역 안에서 특정 아이템(mace, trident, ender pearls)의 사용과 투척을 차단합니다.
• inventory-craft로 안전 구역 내 인벤토리(2x2) 제작을 막거나 permit-workbenches로 작업대 사용을 차단합니다.
• entry-min-level / entry-max-level을 사용해 플레이어 XP 레벨 또는 숫자 PlaceholderAPI 값으로 지역 प्रवेश을 제한합니다.
• console-command-repeat를 사용해 플레이어가 지역 안에 머무는 동안 콘솔 명령을 반복 실행합니다.

⌨️ 명령어

⚙️ 설치

📥 설정

• 공식 JAR을 다운로드해 WorldGuard와 함께 서버의 plugins/ 디렉터리에 넣으세요.
• 이전 WorldGuardExtraFlags에서 업그레이드하는 경우, 시작하기 전에 기존 WorldGuardExtraFlags.jar를 제거하세요 — 두 플러그인은 공존할 수 없습니다.
• 서버를 재시작하고 콘솔에서 플러그인과 플래그가 올바르게 로드되었는지 확인하세요.

📦 의존성

• 필수: WorldGuard (이 프로젝트는 WorldGuard의 확장입니다).
• 선택 사항 / 연동: PlaceholderAPI(숫자 플레이스홀더 지원), PacketEvents 또는 ProtocolLib(패킷 기반 차단 개선), EssentialsX(godmode/fly 동작 연동).

🧾 설정

• 플러그인 메시지는 plugins/WorldGuard/messages-wgefp.yml에 저장되며 완전히 커스터마이즈할 수 있습니다. 메시지 쿨다운 시스템은 플러그인 설정에서 조정할 수 있습니다.

🧠 기술 메모

• 이 프로젝트는 api-version: 1.21을 선언하며 최신 Paper API 아티팩트를 대상으로 합니다. Folia 호환성은 구현되어 있으며 확인되었습니다.
• Java 바이트코드와 API 대상은 최근 1.21 세대 서버 환경에 맞춰져 있습니다.
• 이 플러그인은 더 넓은 아이템 차단 의미를 위해 기존 permit-completely 동작을 disable-completely로 대체합니다.
• 일부 기능(예: 특정 창 공격 메커니즘의 완전 차단)은 PacketEvents 또는 ProtocolLib가 있을 때 더 안정적입니다.
• 이 플러그인은 표준 WorldGuard 플래그 명령을 통해 많은 플래그를 노출합니다(플래그는 WorldGuard의 지역 플래그 인터페이스로 설정됩니다).

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

WorldGuard를 사용하면서 아이템 사용, 플레이어 입장 규칙, 제작, 기타 지역별 동작을 제어할 추가 확인된 지역 플래그가 필요하다면 — 특히 Paper 또는 Folia 서버에서 — WorldGuard ExtraFlags Plus는 별도의 지역 관리 플러그인 없이 WorldGuard의 플래그 시스템 안에서 이러한 기능을 하나로 모아줍니다.