Minecraftプラグイン SuperVanish

🔌 SuperVanishについて

SuperVanish は、Bukkit/Spigot サーバー向けの Minecraft プラグインで、サーバー運営者やスタッフが他のプレイヤーから完全に見えなくなるようにします。監視やテストに適した検出されない vanish 状態を提供しつつ、ほかのプラグインが vanish 状態と連携できる API も公開します。

🎯 目的

このプラグインの主な目的は、モデレーションと管理者向けの監視です。信頼できるスタッフが、ほとんどのプレイヤーに対してプレイヤーリスト、入退室メッセージ、ワールド内での存在感に表示されることなく、プレイヤーの行動を観察できます。信頼できる vanish 実装を必要とするサーバー所有者、管理者、プラグイン開発者向けに作られています。

⚙️ 機能

• vanish 中のプレイヤーを他のプレイヤーから完全に非表示にします（ワールド内での表示）。
• vanish 中のプレイヤーをプレイヤーリスト（tab）から非表示にし、観察者向けの見た目を設定できます。
• ProtocolLib が利用可能な場合、オンライン人数/サーバー一覧の表示を調整します。
• 誰が誰を見られるかを細かく設定できる、階層型の権限モデル。
• 参加、再起動、リロード後も vanish 状態を保持します。
• 高度なパケットベース機能のために ProtocolLib を必要とする、任意の統合ポイントがあります。
• vanish 中の "silent chest" の挙動改善のために OpenInv の導入を推奨します（任意）。
• 他のプラグイン向けの公開 VanishAPI: プレイヤーを隠す/表示するメソッド、非表示プレイヤーの取得、PlayerHideEvent/PlayerShowEvent の監視。

🧩 対象ユーザー

• ステルスなモデレーションツールを必要とする Survival / SMP サーバー。
• 他のモデレーションまたはユーティリティ系プラグイン向けに vanish API を求めるサーバー。
• 設定可能な可視性ルールと tablist 制御が必要な管理者。

🏗️ 使用例

• モデレーターが、容疑者に気づかれずに荒らし報告を調査するために姿を消す。
• プラグインが VanishAPI を参照して、ゲーム機構や報告から vanish 中のプレイヤーを除外する。
• サーバー運営者が、プレイヤーのみの条件を再現するためにライブテスト中の存在を隠す。

⚙️ インストール

📥 セットアップ

• 公式プラグインの JAR をダウンロードし、サーバーの plugins/ ディレクトリに配置します。
• サーバーを再起動し、コンソールログで SuperVanish が読み込まれたことを確認します。
• 拡張機能で ProtocolLib を使用する場合は、ProtocolLib もインストールして再起動してください。

📦 依存関係

• ProtocolLib（任意）: プレイヤー数の調整や一部のアクションバー機能など、パケットベースの機能に必要です。
• OpenInv（任意の推奨）: vanish 中にインベントリを操作する際の silent chest の挙動を改善します。

🧠 技術的な注意

• プラットフォーム: Bukkit/Spigot プラグインとして実装され、他のプラグイン向けに Java API を公開します。
• API: プレイヤーを隠す/表示する、vanish 状態を確認する、非表示プレイヤーの一覧を取得するメソッドを持つ VanishAPI を提供します。イベント駆動の統合向けに PlayerHideEvent と PlayerShowEvent も含まれます。
• 永続化: API 経由で、すべての非表示プレイヤー（オンライン/オフライン）の一覧を返せます。すべての非表示プレイヤーを取得する処理にはデータベースアクセスが関わる場合があり、メインスレッド外では慎重に使うべきです。
• ライセンス: MIT ライセンスで公開されており、ソースコードはプロジェクトのリポジトリで利用できます。

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

他のプラグインと連携し、モデレーションのために細かな可視性ルールをサポートする vanish 実装が必要なら、SuperVanish は API 駆動で設定可能な vanish を提供し、ProtocolLib/OpenInv の任意統合で挙動をさらに改善できます。