EssentialsX GeoIP は、MaxMind GeoLite2 データベースを使用してローカルで GeoIP 参照を行う EssentialsX プラグインスイート向けのモジュールです。EssentialsX と連携し、プレイヤーのおおよその位置を表示します（たとえば /whois で、また必要に応じてプレイヤー参加時にスタッフへ表示）。

🎯 目的

このモジュールは、プレイヤーの IP から推定したおおよその地理情報をサーバースタッフに提供し、モデレーション、ログ記録、基本的な位置把握を支援します。参照は外部の検索サービスに毎回問い合わせるのではなく、GeoLite2 データベースを使ってローカルで実行されます。

⚙️ 機能

IP から位置を調べるために MaxMind GeoLite2 データベースを使用します。
EssentialsX の /whois 出力と連携して、おおよその位置を表示します。
オプション: プレイヤー参加時に、そのおおよその位置をスタッフへ表示します。
データベースの自動更新: モジュールは GeoLite2 データベースを定期的にダウンロードして更新します（既定では 30 日ごとに更新するよう設定）。
GeoIP の結果を表示・非表示にできるユーザーを制御する権限ノードがあります。

🧩 対象ユーザー

このモジュールは、EssentialsX を使っていて、Bukkit/Spigot/Paper サーバー上でモデレーションやログ記録のためにおおよその地理データを必要とするサーバー管理者やモデレーションチーム向けです。

🏗️ 使用例

/whois でプレイヤーを確認するときに、スタッフへおおよその国や都市を表示する。
不審な接続の発信元地域をおおよそ記録し、モデレーションを支援する。
権限によって、非表示を選択したプレイヤーの位置表示を隠す。

🔐 権限

権限	説明	既定
`essentials.geoip.show`	ユーザーがプレイヤーのおおよその位置を見られるようにします（例: ログイン時や `/whois` 使用時）。	指定なし
`essentials.geoip.hide`	GeoIP 機能によるプレイヤーの位置表示を防ぎます。	指定なし

⚙️ インストール

📥 セットアップ

EssentialsX のメインプラグインをインストールします（GeoIP モジュールには対応する EssentialsX コアモジュールが必要です）。
EssentialsX GeoIP モジュールの JAR をダウンロードし、サーバーの plugins/ ディレクトリに配置します。
サーバーを 1 回起動して plugins/EssentialsGeoIP/config.yml ファイルを生成します。
MaxMind の GeoLite2 データベースへのアクセスを登録し、ライセンスキーを生成して、そのキーを plugins/EssentialsGeoIP/config.yml の license-key 設定に追加します。
サーバーを再起動します。モジュールは提供されたキーを使って GeoLite2 データベースをダウンロードし、自動的に最新状態を保ちます。

📦 依存関係

EssentialsX（メインモジュール） — 対応するバージョンの EssentialsX コアプラグインが必要です。

🧠 技術的な注意

このモジュールは MaxMind GeoLite2 EULA への同意と順守が必要です。データベースはあくまでおおよその情報であり、正確なプレイヤー位置の特定には使用できません。
データベースのダウンロード/更新動作はモジュールの一部であり、月次更新に設定されています。自動更新には有効な MaxMind ライセンスキーを用意する必要があります。
データは EssentialsX コアが /whois または参加通知を公開している場所でのみ表示されます。モジュール自体が EssentialsX の機能を置き換えるわけではありません。