Minecraftプラグイン PvPManager

🔌 PvPManager について

PvPManager は、プレイヤー同士の戦闘や戦闘関連のサーバールールを管理するための Minecraft プラグインです。PvP の切り替え、戦闘タグ、combat-log 防止、初心者保護、死亡/リスポーン時の挙動などを 1 つの設定可能なプラグインにまとめ、サーバー管理者向けに設計されています。

🎯 目的

PvPManager の主な目的は、PvP のやり取りや戦闘に関する例外処理を一元的かつ柔軟に制御できるようにすることです。これにより、サーバー所有者は一貫したルールを適用できます（PvP の切り替え、combat logging の罰則、初心者保護、キル報酬/ペナルティの制御、戦闘制限の管理など）。

⚙️ 機能

• プレイヤーごと、ワールドごと、または全体で PvP を切り替え可能。
• 設定可能なタイマーと表示インジケーター（action bar/boss bar）付きの戦闘タグシステム。
• 設定可能な罰則（インベントリを落とす、装備/経験値を落とす、所持金ペナルティ、プレイヤーをキル、イベントの通知/記録）を備えた combat-log 防止。
• 初心者保護とリスポーン/テレポート保護。
• border-hopping 対策（タグ付きのまま安全地帯へ逃げるのを防ぐ）とキル乱用対策トリガー。
• 戦闘中の行動を無効化（飛行、ゲームモード変更、コマンド、エンダーパール、ブロック設置など）。
• インベントリ処理の選択肢（保持、ドロップ、またはキラーへ転送）と auto-soup 対応。
• キル時の所持金報酬/ペナルティと実行可能なコマンド。
• PlaceholderAPI との連携、ゾーン系プラグイン（WorldGuard、Towny）や Citizens のサポート、特定動作向けの任意連携。
• bStats によるテレメトリと使用状況報告。

🧩 対象ユーザー

• 設定可能な PvP ルールが必要な Survival や SMP サーバー。
• combat logging 対策や初心者向けの安全な導入を必要とするサーバー。
• 複数の別プラグインを使わず、キル/報酬ルールとシンプルな PvP 切り替えを統合したい管理者。

🏗️ 使用例

• 初回プレイ時に初心者保護を有効にし、設定した時間が経過してから PvP を許可する。
• 戦闘中のプレイヤーにタグを付け、タグが切れるまでテレポート、コマンド、安全地帯への侵入を禁止する。
• 戦闘中に切断したプレイヤーに対し、インベントリを落とすかサーバー定義の罰則を適用する。
• キラーに自動で所持金を付与したり、キル時にカスタムコマンドを実行したりする。

⌨️ コマンド

注: 掲載されているコマンドは、公式プラグインドキュメントとリソースページの内容に基づいています。各コマンドの権限ノードはプロジェクト側で文書化されていますが、ここには記載していません。

⚙️ インストール

📥 セットアップ

• プラットフォーム向けの公式配布ページから、プラグインの JAR をダウンロードします。
• Spigot/Paper 対応サーバーの plugins/ ディレクトリに JAR を配置します。
• サーバーを再起動し、コンソールログを確認してプラグインが読み込まれたことを確認します。

📦 依存関係

• PlaceholderAPI（プレースホルダー用の任意連携）。
• WorldGuard、Towny、Citizens などのゾーン/NPC プラグイン向け連携（任意、存在する場合に使用）。

🧠 技術メモ

• 対応が確認されているサーバーソフトウェアには Spigot と Paper が含まれます。Folia のサポートもプロジェクトで案内されています。
• このプラグインには開発者向け API があり、テスト用の dev build も公開されています。
• プロジェクトは公開リポジトリでソースコードと issue tracking を公開しており、テレメトリに bStats を使用しています。
• テスト済みの Minecraft バージョンは多岐にわたります。特定のサーバーバージョンとの正確な互換性については、プラグインのドキュメントを確認してください。

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

PvPManager は、PvP の切り替え、戦闘タグ、combat-log の罰則、初心者保護を、複数の別プラグインを組み合わせずに 1 つの設定可能なプラグインで管理したい場合に役立ちます。一般的な PvP ルールを一元化し、管理者コマンドと連携機能で、さまざまなサーバー構成に合わせて動作を調整できます。