minecraft-essentials-ops

Minecraft EssentialsX 運用スキル

スキルの対象範囲

振り分けの境界

• Use when：EssentialsX のコマンド、設定、権限、経済、またはモデレーションの運用に関するタスク。
• Do not use when：一般的なサーバーのデプロイ、プロキシ、パフォーマンスアーキテクチャに関するタスク（minecraft-server-admin）。
• Do not use when：Java プラグインのコード作成に関するタスク（minecraft-plugin-dev）。
• Do not use when：WorldEdit の選択や建築ワークフローに関するタスク（minecraft-worldedit-ops）。

リファレンス

• 権限の監査、経済機能の導入、モデレーションポリシーの変更に関するタスクで、簡潔な事前確認リストが必要な場合は、references/permissions-and-rollout-checklists.md を読みます。

---

モジュールの概要とインストールに関する注意事項

プラットフォームの条件

EssentialsX は、サポート対象の Paper または Spigot サーバービルドでのみ使用してください。EssentialsX 2.22.0 は Folia および Folia のフォークをサポートしていないと警告しており、ユーザーデータが失われる可能性もあります。また、 Forge、NeoForge、Fabric の Bukkit ハイブリッドサーバーもサポートしていません。現在のプラットフォームがいずれかに該当する場合は、 EssentialsX の有効化や設定を行わず、サポート対象の運用方法を確認してください。このガイドでは 移行を推奨しません。

本番環境でよく使われる EssentialsX モジュール：

• EssentialsX（コアコマンドとユーザーツール）
• EssentialsXChat
• EssentialsXSpawn
• EssentialsXProtect

運用上のインストールチェックリスト：

1. EssentialsX のビルドを、Paper／Spigot API の世代に合わせます。
2. 経済プロバイダーや権限／チャット連携を使用する場合は、Vault をインストールします。
3. サーバーを一度起動し、ログで依存関係に関する警告を確認します。
4. ロールバックに備えて、プラグイン jar のバージョンを記録します。

バージョン整合性のルール：

• まずステージング環境で、EssentialsX と関連プラグインをテスト済みの一括更新として適用します。
• 使用する EssentialsX のリリース版または開発版が対象の Paper リリースをサポートしていることを確認します。26.1 向けのビルドが 26.2 もサポートすると想定しないでください。

---

Vault と経済機能の基本

経済機能の構成モデル

• EssentialsX は経済コマンドと残高を提供できます。
• Vault は共通の連携ブリッジを提供し、他のプラグイン（ショップ、職業、ランク）が残高を読み書きできるようにします。

プロバイダーの連携経路を確認します：

1. サーバーが Vault のフックエラーなしで起動すること。
2. 経済コマンドが権限エラーなしで応答すること。
3. サードパーティープラグインの取引が残高に一貫して反映されること。

経済コアコマンド

/bal
/baltop
/pay Alex 250
/eco give Alex 1000
/eco take Alex 100
/eco reset Alex

経済管理コマンドは、スタッフのロールを通じてのみ使用してください。

---

ショップの価格設定と看板ショップ

EssentialsX の看板と経済機能を使用する場合：

1. 価格設定ポリシーを定めます：
   • 初心者向け価格
   • インフレ抑制用の通貨回収策
   • 管理者限定アイテムの例外
2. config.yml で、サポートする予定の看板タイプのみを有効にします：

   enabledSigns:
     - buy
     - sell
   

3. 信頼できるグループのみに作成権限を制限します：
   • essentials.signs.create.buy
   • essentials.signs.create.sell
4. 取引を許可するグループのみに使用権限を付与します：
   • essentials.signs.use.buy
   • essentials.signs.use.sell
5. 設定変更後、オペレーター権限のないプレイヤーアカウントで購入／販売の計算を検証します。

看板ショップの形式

[Buy]
<quantity>
<item>
<price>

[Sell]
<quantity>
<item>
<price>

例（スポーン地点の市場で石を販売）：

[Buy]
32
stone
$50

[Sell]
32
stone
$20

購入価格と販売価格を別々に設定する場合は、[Buy] と [Sell] の看板を別々に使います。 4 行目は、その看板での 1 回の取引価格です。

運用上のガードレール：

• 制限のない管理者ショップ看板への広範なプレイヤーアクセスは決して有効にしないでください
• 複製や悪用のパターンがないか、残高の急増を監視してください

---

キット、ワープ、ホーム、ニックネーム、スポーン地点

キットの運用

一般的なキットのライフサイクル：

1. キット定義を作成／編集する
2. クールダウンと権限を設定する
3. プレイヤーランクのアカウントでテストする

plugins/Essentials/kits.yml のキットエントリー：

kits:
  starter:
    delay: 86400
    items:
      - stone 64
      - oak_planks 32
      - bread 16

よく使うコマンド：

/kit
/kit starter
/createkit starter 86400

ワープとホーム

/setwarp spawn
/setwarp market
/warp spawn
/sethome
/home
/delhome

権限と Essentials の設定値で制限を管理します。

ニックネームとスポーン地点の管理

/setspawn と /spawn を使用するには、EssentialsXSpawn モジュールが必要です。スポーンコマンドの失敗を場所の問題と判断する前に、JAR がインストールされていること、起動ログにモジュールの読み込みエラーがないこと、プレイヤーのグループに essentials.spawn が設定されていることを確認してください。

/nick BuilderOne
/realname BuilderOne
/setspawn
/spawn

モデレーションとなりすまし防止のため、ニックネームのポリシーを明確にしてください。

---

権限のパターン

権限マネージャー（LuckPerms など）を使って、役割の階層を設定します。

役割の意図の例：

• admin：EssentialsX の管理、モデレーション、経済機能をすべて操作可能
• staff：モデレーションおよびサポートコマンド、制限付きの経済ツール
• player：基本的なホーム／ワープ／メッセージ送信／送金機能を安全策付きで利用可能

権限設定の概要例：

groups:
  admin:
    permissions:
      - essentials.*
  staff:
    permissions:
      - essentials.kick
      - essentials.mute
      - essentials.tempban
      - essentials.togglejail
      - essentials.warp
      - essentials.msg
  player:
    permissions:
      - essentials.home
      - essentials.sethome
      - essentials.delhome
      - essentials.spawn
      - essentials.warp
      - essentials.msg
      - essentials.pay

信頼できる管理者ロール以外には、ワイルドカード権限を付与しないでください。

---

モデレーションのワークフロー

ワークフロー：ミュート

/mute Alex 30m Chat abuse after warning
/unmute Alex

運用のポイント：

• 理由と期間を含めます
• 繰り返し行為に対する段階的な対応を記録します

トラブルシューティング：ミュートが適用されない → EssentialsX のコアモジュールが読み込まれていること、実行者に essentials.mute があること、対象にミュートの免除状態がないこと、ほかのモデレーションまたはチャットプラグインが結果を上書きしていないことを確認します。EssentialsXChat はチャットの書式を設定するものであり、コアのミュート処理に必須ではありません。

ワークフロー：投獄

/setjail intake
/jail Alex intake 20m Griefing spawn edge
/unjail Alex

運用のポイント：

• 明確な投獄理由を定めます
• 該当する場合は、ロールバック／修復対応と組み合わせます
• 刑務所の場所を作成または移動する権限のあるロールにのみ essentials.setjail を付与します。プレイヤーの投獄または釈放のみを行うスタッフには essentials.togglejail を付与します

トラブルシューティング：投獄が機能しない → /setjail intake で刑務所の場所が設定されていること、およびプレイヤーにバイパス権限がないことを確認します。

ワークフロー：一時 BAN

/tempban Alex 7d Repeated harassment
/unban Alex

運用のポイント：

• 期間をポリシーの段階に合わせます
• 証拠と対応したスタッフを記録します

IP BAN は別の機能です。/banip Alex <reason> はプレイヤーの最後に使用した IP を特定し、その IP を共有するほかのプレイヤーにも影響する可能性があります。許可された IP BAN を解除するには、BAN された正確なアドレスを指定して /unbanip <address> を使用します。/unban Alex で解除されるのはアカウントの BAN のみです。

トラブルシューティング：一時 BAN が維持されない → essentials.tempban 権限と、上書きプラグイン（LiteBans など）との競合がないことを確認します。

---

設定時の落とし穴と強化の注意点

よくある落とし穴：

• プラグインを部分的に更新した後の EssentialsX／Vault／プロバイダーのバージョン不一致
• 管理者向けの経済コマンドを公開してしまう、過度に寛容なワイルドカード権限の付与
• 移動手段の悪用やコマンドの連続実行につながる、多すぎるホーム／ワープの上限
• スタッフのシフト間でチャット／ニックネームのルールに一貫性がない

強化チェックリスト：

• 編集前に、テスト済みの基本設定のバックアップを保管します
• 一度に変更するポリシーの領域は1つにします（経済、ホーム、モデレーション、チャット）
• 設定を反映するたびに、スタッフとプレイヤーの基本テストを実施します
• コマンド権限に対応したポリシーを文書化して維持します

---

運用手順書：安全な設定の反映

1. 現在の Essentials 設定ファイルをバックアップします。
2. 対象を絞って設定を編集します。
3. 変更した項目のライブリロードをプラグインのドキュメントが明示的にサポートしている場合にのみ、リロードします。
4. 影響の大きい変更には、メンテナンス再起動を推奨します。
5. 次の項目を検証します：
   • ログインの流れ
   • ホーム／ワープ
   • 経済取引
   • モデレーションコマンド
6. すぐに復元できるよう、ロールバック用の一式を準備しておきます。

---

参考資料

• https://essentialsx.net/wiki/Home.html
• https://essentialsx.net/commands
• https://essentialsx.net/permissions
• https://essentialsx.net/wiki/modules
• https://essentialsx.net/wiki/Module-breakdown.html
• https://essentialsx.net/wiki/Configuration-file.html
• https://essentialsx.net/wiki/Sign-Tutorial.html
• https://github.com/EssentialsX/Essentials/discussions/6552
• https://www.spigotmc.org/resources/vault.34315/