コマンド体系リファレンス
Citizensのコマンドは更新頻度が高く、Wikiの一覧に載っていないものもあります。以下はコマンドの用途を把握するための分類表です。引数・短縮形・権限・使用可能なエンティティ種別は、必ずサーバー内の /npc help <command> で確認してください。
1. ヘルプ・管理
| コマンド | 用途 |
|---|
/citizens | プラグイン情報を表示 |
/citizens save | NPCと設定を保存 |
/citizens reload | Citizensの設定再読み込み。使用時は版ごとの注意を確認 |
/citizens help | 管理用ヘルプ |
/npc help [ページ] | NPCコマンドの一覧 |
/npc help <コマンド> | 指定コマンドの引数などを確認 |
/trait help | Trait関連ヘルプ |
/template help | テンプレート関連ヘルプ |
/waypoints help | ウェイポイント関連ヘルプ |
2. NPCの作成・選択・整理
| コマンド | 用途・注意点 |
|---|
/npc create <名前> [フラグ] | NPC作成。標準タイプは通常PLAYER。--type 等はヘルプで確認 |
/npc select <IDまたは名前> | NPCを選択 |
/npc deselect | 選択解除 |
/npc list [ページ] | NPC一覧。所有者・タイプなどで絞り込める版もあります |
/npc id | 選択中NPCのID表示 |
/npc copy | NPCを複製 |
/npc rename <名前> | 名前変更 |
/npc remove <対象> | NPCデータ削除。対象指定に注意 |
/npc despawn | ワールドから退場させる（データ削除ではない） |
/npc spawn <IDまたは名前> | NPCをスポーン |
/npc tp | NPCの位置へ移動するためのコマンド |
/npc tphere | NPCを実行者の位置に移動 |
/npc moveto ... | 指定位置にNPCを移動／テレポート |
/npc owner <UUIDまたはSERVER> | 所有者を設定 |
/npc metadata ... | NPCメタデータの取得・設定・削除 |
/npc configgui | 対応版ではNPC設定GUIを表示 |
/npc copier | NPC複製用の操作を切り替え |
3. 見た目・表示
| コマンド | 用途 |
|---|
/npc skin <プレイヤー名> [-l] | プレイヤー型NPCのスキンを設定。-l は最新スキンに追従する設定 |
/npc skinlayers ... | ケープ・帽子・ジャケット・袖・ズボンなどのレイヤー表示 |
/npc name | 名前表示の切り替え。詳細は使用版のヘルプを参照 |
/npc type <エンティティ種別> | NPCの種類を変更できる版で使用 |
/npc disguise ... | エンティティの変装・見た目を設定。対応条件を確認 |
/npc mirror ... | 名前・装備等のミラー関連設定。対象オプションは版に依存 |
/npc hologram ... | ホログラム行の追加・編集・削除 |
/npc textdisplay ... | Text Displayエンティティの設定 |
/npc itemdisplay ... | Item Displayエンティティの表示変換設定 |
/npc display ... | Display系エンティティの拡大率、明るさ、回転、オフセット等 |
/npc model ... | 対応版におけるモデル関連設定 |
/npc modelanimate ... | 対応版におけるモデルアニメーション |
/npc glowing ... | 発光の切り替えや色設定 |
/npc bossbar ... | ボスバーの設定 |
/npc sound ... | 死亡・環境音・被ダメージ音等の設定 |
4. テキスト・クリック処理・ショップ
| コマンド | 用途 |
|---|
/npc text | セリフ編集画面 |
/npc speak <文章> | NPCとして文章を発言させる。対象や範囲を指定できる版もあります |
/npc command | NPCクリック時に実行されるコマンドの確認・編集 |
/npc shop edit [ショップ名] | 組み込みショップを編集 |
/npc shop show [ショップ名] | ショップを表示 |
/npc shop delete [ショップ名] | ショップを削除 |
/npc shop copyfrom ... | ショップ設定を複製する機能がある版で使用 |
5. AI・移動・相互作用
| コマンド | 用途 |
|---|
| `/npc ai [true | false]` |
/npc lookclose | 近くのプレイヤーなどへ視線を向ける設定 |
/npc follow ... | プレイヤー／NPCへの追従 |
/npc target ... | 対象エンティティの指定・解除 |
/npc targetable | ターゲット可能状態の切り替え |
/npc aggressive ... | 攻撃的状態の設定。対応エンティティなどに注意 |
/npc passive ... | 他エンティティへダメージを与えるかどうか等の制御 |
/npc controllable ... | NPCに乗る・操作する機能 |
/npc path | ウェイポイントエディタ |
/waypoints ... | ウェイポイントの追加・削除・プロバイダ設定 |
/npc pathto ... | 指定位置への経路移動 |
/npc pathopt ... | 経路探索の各種パラメータ |
/npc pausepathfinding ... | 経路移動を一時停止する条件等 |
/npc home ... | ホーム位置の設定・移動制御 |
/npc anchor ... | 名前付き位置アンカーの保存・呼び出し・削除 |
/npc speed <値> | 移動速度の調整 |
/npc gravity | 重力の切り替え |
| `/npc flyable [true | false]` |
/npc swim ... | 水泳動作の設定 |
/npc forcefield ... | 接近したプレイヤーを押し戻すフィールド |
/npc breakblock ... | ブロック破壊関連の機能。使用条件に注意 |
6. 装備・インベントリ・効果
| コマンド | 用途 |
|---|
/npc equip | 装備エディタ |
/npc setequipment ... | 装備スロットをコマンドで設定 |
/npc item <アイテム> | アイテム設定 |
/npc inventory ... | NPCインベントリの確認・操作が可能なタイプで使用 |
/npc drops | ドロップ設定エディタ |
/npc potioneffect ... | ポーション効果の追加・削除・一覧 |
/npc attribute ... | 属性値の設定 |
/npc scaledmaxhealth ... | 最大体力の設定に関するコマンド |
/npc hurt ... | NPCにダメージを与えるコマンド |
/npc pickupitems ... | アイテム取得動作の切り替え |
7. エンティティ固有のコマンド
Citizensには、エンティティ種別に応じた専用コマンドがあります。現行Wiki／ソースに見られる例は次のとおりです。
- 動物・Mob：
/npc allay、/npc axolotl、/npc armadillo、/npc bat、/npc bee、/npc camel、/npc cat、/npc chicken、/npc cow、/npc fox、/npc frog、/npc goat、/npc horse、/npc llama、/npc panda、/npc parrot、/npc pig、/npc piglin、/npc sheep、/npc shulker、/npc sniffer、/npc snowman、/npc tropicalfish など。
- オブジェクト系：
/npc armorstand、/npc boat、/npc minecart、/npc itemframe、/npc painting、/npc endercrystal、/npc areaeffectcloud など。
- そのほか：
/npc age、/npc entitypose、/npc sitting、/npc leashable、/npc collidable、/npc knockback など。
対象タイプに応じたコマンドだけが動作します。使用できる種別・状態・オプションはMinecraftとCitizensのバージョンに依存します。
8. 開発・診断
| コマンド | 用途 |
|---|
/npc debug | 経路探索・ナビゲーション・手持ちアイテムなどの診断情報（対応フラグはヘルプを確認） |
/npc behavior ... | 行動ツリー等の設定ファイルを管理する機能がある版で使用 |
/npc eval ... | 評価系コマンド。強い権限が必要な管理・開発用途として扱い、一般ユーザーに許可しない |
9. コマンドの読み方
<必須引数>：入力が必要な値。[任意引数]：省略可能な値。--flag value：名前付きオプション。-l など：短縮フラグ。意味はコマンドごとに異なります。たとえば /npc skin の -l は latest ですが、別コマンドで同じ意味とは限りません。- 引数の一部は、名前・UUID・数値・列挙値（
PLAYER、VILLAGERなど）です。引用符の扱いが必要な場合は、ゲーム内ヘルプを確認してください。