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 を削除してください — 2 つは共存できません。
• サーバーを再起動し、コンソールでプラグインとそのフラグが正しく読み込まれたことを確認してください。

📦 依存関係

• 必須: WorldGuard (このプロジェクトは WorldGuard の拡張です)。
• オプション / 連携: PlaceholderAPI (数値プレースホルダー対応)、PacketEvents または ProtocolLib (パケットベースのブロック精度向上)、EssentialsX (godmode/fly 動作の連携)。

🧾 設定

• プラグインのメッセージは plugins/WorldGuard/messages-wgefp.yml に保存され、完全にカスタマイズ可能です。メッセージクールダウンの仕組みはプラグイン設定から調整できます。

🧠 技術メモ

• このプロジェクトは api-version: 1.21 を宣言しており、最新の Paper API アーティファクトを対象にしています。Folia 互換性は実装済みで、確認されています。
• Java バイトコードと API の対象は、1.21 世代の最近のサーバー環境に合わせています。
• このプラグインは、より広いアイテムブロックの意味を持つ disable-completely によって、旧来の permit-completely の動作を置き換えています。
• 一部の機能 (たとえば、特定の槍の突進メカニクスの完全ブロック) は、PacketEvents または ProtocolLib があるとより信頼性が高くなります。
• このプラグインは、標準の WorldGuard フラグコマンドを通じて多くのフラグを公開します (フラグは WorldGuard のリージョンフラグインターフェースで設定します)。

🤝 このプラグインが役立つ場面

WorldGuard を使っていて、アイテム使用、プレイヤーの入場ルール、クラフト、その他のリージョンごとの動作を制御するための、追加の確認済みリージョンフラグが必要な場合 — 特に Paper または Folia サーバーでは — WorldGuard ExtraFlags Plus は、別のリージョン管理プラグインを使わずに、WorldGuard のフラグシステム内へこれらの機能を集約します。