Unknown Network

NPCの作成・基本プロパティ・スキン

1. NPCの作成

/npc create 案内係
/npc create 村人店員 --type VILLAGER
/npc create 飾り --type ARMOR_STAND

/npc create は標準では PLAYER 型を作成します。--type で対応するBukkitエンティティ種別を指定します。すべてのエンティティがNPCとして利用できるとは限らず、Citizens側にコントローラーがある種別のみ作成できます。現行ソースでは、新規NPC名から同名プレイヤーのスキンを取得しようとする設定 npc.skins.try-fetch-default-skin があり、既定値は true です。したがって、NPC名を実在プレイヤーのID／名前にすると、そのプレイヤーのスキンが自動取得される場合があります。

現行の実装には、位置指定、タイプ指定、Trait指定、初期アイテム、名前表示形式、テンプレート適用、一時NPC、パケットNPC等に関するフラグが存在します。ただしフラグの正確な書式は版によって異なるため、/npc help create を確認してください。

2. 選択用アイテム（デフォルトは棒）

Citizensの標準選択アイテムは 棒（Stick） です。棒を持ってNPCを右クリックすると選択できる設定が標準で用意されています。現在の構成で動作しない場合は config.yml の npc.selection.item や選択権限を確認してください。エディタや他プラグインのクリック処理によって選択しづらい場合は、/npc select <IDまたは名前> で直接選択できます。

3. IDと名前

  • IDはNPCを識別するための番号です。
  • 名前はプレイヤーに見せる表示名です。
  • 名前を変更してもIDによる識別を利用できます。
/npc list
/npc select 12
/npc id
/npc rename 駅員

同名NPCが複数いる場合、名前だけで選択すると意図しないNPCが対象になることがあります。確実に指定したい場合はIDを使用してください。

4. 所有者

/npc owner <プレイヤーUUIDまたはSERVER>

NPCの編集権限は所有者と権限設定の影響を受けます。サーバー共用の案内NPCは、個人所有にせず管理者／サーバー所有として運用する方法もあります。権限の仕様は「Citizens_Config_Permissions.md」を参照してください。

5. プレイヤー型NPCのスキン

/npc skin Notch
/npc skin Notch -l
  • /npc skin <プレイヤー名>：プレイヤー名に対応するスキンを取得して設定します。
  • -l（小文字のエル、latest）：そのプレイヤーの最新スキンに追従する設定です。
  • -l を指定しない場合、取得した時点のスキンを保持する動作が基本です。既定で最新追従を有効にする設定 npc.skins.use-latest-by-default もありますが、現行ソースの既定値は false です。

NPC名とスキンの自動取得

現行ソースでは、新規NPCの名前から同名プレイヤーのスキンを取得する既定設定が有効です（npc.skins.try-fetch-default-skin: true）。そのため、NPC名をプレイヤーID／名前にすると、そのプレイヤーのスキンが自動で取得されます。ただし、この機能が false に設定されている場合、取得に失敗した場合、または既存NPCを後から改名した場合などは、同じ結果になるとは限りません。

NPC名をプレイヤーID以外の表示名（例：案内人）にしたい場合は、明示的に /npc skin <プレイヤー名> でスキンを指定してください。NPC名とスキンの対象プレイヤーは別々に設定できます。

画像URLからのスキン

Wikiでは、公開された直接参照可能なPNG画像を使う --url オプションも説明されています。

/npc skin --url https://example.invalid/skin.png

上記URLは書式例です。実際には公開されている有効なスキン画像URLに置き換えます。画像ホストのリンクがアルバムページやリダイレクトURLだと失敗する場合があります。必要に応じてSlim／Alexモデル等の指定方法を /npc help skin で確認してください。

スキンの反映トラブル

  1. プレイヤー名の綴り・大文字小文字を確認。
  2. Mojang側のスキン取得が終わるまで待つ。
  3. /npc skin <プレイヤー名> -l で最新追従設定を検討する。
  4. NPCを再スポーンさせる、またはプレイヤー側を再ログインして表示を更新する。
  5. ネットワーク、API接続、サーバーログを確認する。

--refresh は今回確認した現行公式コマンド資料では一般的なスキン更新フラグとして確認できませんでした。-l と混同しないでください。

6. 名前表示・外観

Citizensには、名前表示の切り替え、カーソルを合わせたときだけ名前を表示する設定、スキンレイヤー、発光、変装、表示エンティティのサイズなど複数の外観関連機能があります。

例：

/npc name
/npc skinlayers --hat false
/npc glowing --color AQUA
/npc disguise --type ZOMBIE

これは例示であり、引数は対象バージョンで確認してください。/npc disguise は見た目を変える機能で、NPCの基礎エンティティ種別自体を変更する操作とは異なります。

7. プレイヤーの名前・装備のミラー

現行コマンド一覧には /npc mirror のようなミラー設定があります。ミラーの対象（名前、装備など）と実際の動作はバージョンのヘルプを確認してください。/npc mirrorskin、/npc mirrorname、/npc mirrorequip という表記は、公式WikiではDenizenの追加コマンドとして掲載されている場合があり、Citizens本体だけの機能とみなさないでください。

8. 作成位置と移動

NPCは作成地点に出現するのが基本です。作成時に位置を指定するフラグや、後からNPCを実行者位置・指定座標にテレポートするコマンドもあります。

/npc tphere
/npc moveto <x> <y> <z> <world>

正確な引数形式は/npc help tphere、/npc help movetoで確認してください。

9. 複製・削除

/npc copy
/npc remove <ID>
/npc remove --world <world>

複製ではTraitや設定がコピーされますが、外部プラグイン固有のデータまで完全に複製されるとは限りません。removeは削除操作です。ID・名前・対象ワールド・所有者条件を事前に確認し、必要ならplugins/Citizens/とワールドデータをバックアップしてください。

Citizens - NPC Properties | Unknown Network