minecraft-worldedit-ops

Minecraft WorldEdit 操作スキル

対象範囲と位置付け

このスキルは、稼働中またはステージング環境のサーバーで WorldEdit を操作するためのものです。
WorldEdit API と連携するプラグインコードの作成には使用しません。

振り分けの境界

• Use when：WorldEdit を使用した、ゲーム内でのコマンド駆動型編集（選択、変形、スケマティック、地形整形、ロールバックを安全に行えるワークフロー）。
• Do not use when：Java プラグインの実装（minecraft-plugin-dev）。
• Do not use when：サーバーの広範なデプロイ／チューニング／プロキシ／バックアップ戦略（minecraft-server-admin）。
• Do not use when：EssentialsX のコマンド／経済／モデレーションのワークフロー（minecraft-essentials-ops）。

---

プラットフォームとセットアップに関する注意事項

WorldEdit は、一般的に次の環境で使用されます。

• WorldEdit プラグインを導入した Paper／Purpur／Folia サーバー
• Mod 版を導入した Fabric／NeoForge

運用上のベストプラクティス：

1. 大規模な編集は、ステージング環境またはメンテナンス時間帯に行います。
2. 大規模な領域操作の前に、自動バックアップを維持します。
3. 破壊的なコマンドを実行する前に、選択範囲とマスクの条件を慎重に設定します。

互換性に関する注意：WorldEdit 7.4.x には、1.21.x、26.1、26.2 向けのビルドがあります。 サーバーの正確なバージョンに対応するビルドを選択し、本番ワールドで 使用する前にステージング環境でテストしてください。

参考資料

• 大規模なペースト、破壊的な置換、または速度よりもロールバックの徹底が重要となる編集を行う前に、references/safety-checklists.md を読んでください。

---

基本的な選択ワークフロー

選択モード

最も一般的な直方体選択の流れ：

//wand
//pos1
//pos2
//size

手早く行う方法：

//hpos1
//hpos2
//chunk
//expand 20 up
//expand 20 down

選択時の安全確認：

• //set または //replace の前に、必ず //size を実行します。
• //paste の前に、実際のペーストで使うものと同じ配置フラグを指定して //paste -n を実行し、貼り付け先をプレビューします（例：//paste -n -a または //paste -n -o）。その後、//size を実行し、選択された貼り付け先を確認します。
• 置換前に、//distr でブロック構成をプレビューします。

---

領域操作

使用頻度の高い操作

//set stone
//replace stone andesite
//replace water air
//walls stone_bricks
//overlay grass_block
//smooth 3

マスクと条件付き置換

マスクを使用して対象範囲を制限します。

//gmask #existing
//replace grass_block dirt
//gmask

単一コマンドでマスクを指定する方法：

//replace stone,andesite,diorite,granite smooth_stone
//replace ##leaves air

パターンの例：

//set 70%stone,20%andesite,10%cobblestone
//replace dirt 60%coarse_dirt,40%podzol

---

クリップボードとスケマティックのワークフロー

クリップボードの基本

//copy
//rotate 90
//flip east
//paste -a

ペースト時に空気ブロックをスキップする場合は、-a を使用します。

スケマティックのワークフロー

//schem save spawn-hub-v3
//schem list
//schem load spawn-hub-v3
//paste -n -a
//size
//paste -a

運用上の指針：

• バージョン付きの名前を使用します（arena-mid-2026-03-27）。
• ロールバック用に読み取り専用のアーカイブコピーを保持します。
• -n を指定すると、ブロックを配置せずに選択範囲を予定の貼り付け先に変更します。プレビューと実際のペーストで、-a、-o、その他の配置フラグを一致させてください。
• 大規模なペーストのたびに、直後にバックアップのチェックポイントを作成します。

---

ブラシと地形整形

実用的なブラシ設定

//brush sphere stone 4
//brush smooth 3
//brush raise sphere 2
//brush lower sphere 2
//mask #existing

ブラシをリセット：

//none

地形整形時の安全対策：

• 小さな半径（3～5）から始め、繰り返し調整します。
• 建造物を損傷しないよう、マスクを有効にしておきます。
• 定期的にスケマティックまたはバックアップのチェックポイントを保存します。編集は //undo で元に戻せます。

---

元に戻す、履歴、安全対策

履歴コマンド

//undo
//undo 5
//redo

本番環境での操作に関する安全方針：

1. バックアップのチェックポイントを作成します。
2. ひとまとまりの編集を一度に行います。
3. 目視で一通り確認し、検証します。
4. 続行するか、すぐに //undo を実行します。

中間確認をせずに、破壊的な編集をいくつも連続して行わないでください。 編集が承認され、バックアップまたはスケマティックのチェックポイントが存在し、ロールバック期間が終了した後に限り、//clearhistory を実行してください。

---

実用的な手順書

手順書：スポーンエリアの更新

• スポーンゾーンを選択し、//size を実行します。
• スナップショットを作成します。

//copy
//schem save spawn-before-refresh

• 対象を限定した置換とオーバーレイを適用します。
• 地形の端を滑らかにします。

//smooth 2

• スポーンの安全性（空洞、照明、移動経路）を確認します。
• 必要に応じて編集したエリアを再選択し、保存前に最終状態をコピーします。

//copy
//schem save spawn-after-refresh

ランブック：試合間のアリーナリセット

• 元の配置を記録した、手つかずのアリーナ設計図を保管します。
• 各試合の後に、次の手順を実行します。

//schem load arena-pristine
//paste -n -o
//size
//paste -o

• プレビュー後に選択した配置先を確認してから、同じ -o 原点フラグを指定して貼り付けます。プレイヤーが追加したブロックを削除するには空気ブロックを含めます。-a を指定すると、それらのブロックが残ります。エンティティとバイオームの復元には、意図したコピー／貼り付けフラグと個別の検証が必要です。
• アリーナのロジックに関連するコマンドブロックや信号を検証します。

ランブック：ブロックのクリーンアップ（ラグと視覚的なノイズ）

一般的なクリーンアップ対象：

• 落下した足場の建築物
• 意図せず広がった液体
• 過剰に残った葉や原木

クリーンアップ手順の例：

//replace lava air
//replace water air
//replace ##leaves air

マップ全体を誤って編集しないよう、必ず最初に選択範囲／マスクを設定します。

ランブック：道の形成と地形のなじませ

• 通路／道の範囲を選択します。
• 表面を組み合わせて作ります。

//set 50%dirt_path,30%coarse_dirt,20%gravel

• 半径を小さくしたスムーズブラシで、端をなじませます。
• 標高が変化する場所には、擁壁（stone_bricks、andesite）を追加します。

---

運用上のガードレール

• グローバル／ワールド範囲を対象に、広範囲な置換を実行しないでください。
• 破壊的なコマンドを実行する前に、毎回選択範囲のサイズを確認します。
• 大規模な建築エリアごとに、復元用の設計図を保管します。
• 操作が重複しないよう、他のスタッフと編集内容を調整します。
• 意図しない大規模編集を防ぐため、役割ごとにWorldEditの制限／権限を検証します。

---

参考資料

• https://worldedit.enginehub.org/en/latest/
• https://worldedit.enginehub.org/en/latest/usage/
• https://worldedit.enginehub.org/en/latest/usage/regions/selections/
• https://worldedit.enginehub.org/en/latest/usage/general/masks/
• https://worldedit.enginehub.org/en/latest/usage/clipboard/
• https://worldedit.enginehub.org/en/latest/usage/tools/brushes/