ZNPCs：MinecraftでNPCを作成するためのプラグイン
依存関係： サーバータイプ：Paper または Spigot 1.8.8–1.21.4 Minecraftのバージョン：1.8.8–1.21.4 依存プラグイン：PlaceholderAPI（任意、ホログラム内の変数用） ダウンロード：SpigotMC / GitHub…
依存関係： サーバータイプ：Paper または Spigot 1.8.8–1.21.4 Minecraftのバージョン：1.8.8–1.21.4 依存プラグイン：PlaceholderAPI（任意、ホログラム内の変数用） ダウンロード：SpigotMC / GitHub ロビーや装飾用にシンプルなNPCが必要なだけなら、Citizensは重すぎるかもしれません。ZNPCsは同じ課題をよりシンプルに解決します。これは大量の依存関係を持た
依存関係：
サーバータイプ：Paper または Spigot 1.8.8–1.21.4
Minecraftのバージョン：1.8.8–1.21.4
依存プラグイン：PlaceholderAPI（任意、ホログラム内の変数用）
ダウンロード：SpigotMC / GitHub
ロビーや装飾用にシンプルなNPCが必要なだけなら、Citizensは重すぎるかもしれません。ZNPCsは同じ課題をよりシンプルに解決します。これは大量の依存関係を持たない単一の.jarファイルで、独自のスキン、テキスト、クリックへの反応を持つキャラクターを設置できます。
主な機能
すべてのNPCには固有の数値IDがあります。ニックネームやURLでスキンを指定した通常のプレイヤーを作成したり、ZOMBIEやSKELETONのようなモブを設置したりできます。
プレイヤーがNPCをクリックすると、プラグインは設定されたアクションを実行します。それはメッセージ、プレイヤーまたはコンソールの名義でのコマンド、あるいはBungeeCord経由でプレイヤーを別のサーバーへ送ることさえできます。アクションが複数ある場合は、順番に実行されます。各アクションにクールダウン（遅延）を設定することもできます。
頭上のテキスト（Lines）
NPCの上には、linesコマンドを使ってテキストを追加できます。プラグインはカラーコードに対応しており、PlaceholderAPIが導入されていれば %player_name% や %server_online% などの変数にも対応します。また、heightコマンドでテキストの高さを変更できます。
ルート（Paths）
NPCは必ずしもその場に立ち続ける必要はありません。歩かせるには、記録モードを有効にし（/znpcs path create <名前>）、目的のルートを自分で歩く必要があります。完了後は /znpcs path exit を入力します。次に、このルートを特定のNPCに割り当てると（/znpcs path set <id> <名前>）、そのNPCは無限にそのルートを巡回し始めます。
重要な注意点：移動は非常に単純です。ZNPCsはバニラの経路探索（Pathfinder）を使用しないため、キャラクターは障害物を避けず、他のプレイヤーにも反応しません。
装備と外見
キャラクターには防具を着せたり、手にアイテムを持たせたりできます。目的の物を手に持って /znpcs equip <id> <スロット> と入力するだけです（利用可能なスロット：HAND、OFFHAND、HELMET、CHESTPLATE、LEGGINGS、BOOTS）。
また、toggleコマンドでNPCの挙動を設定することも可能です。最も近いプレイヤーを見るようにしたり（look）、見ているプレイヤーのスキンをミラーリングしたり（mirror）、選んだ色の発光（glow）を追加したりできます。
コマンド
これらのコマンドには管理者権限（znpcs.admin）が必要です。
コマンド | 説明 | 権限 |
| あなたの座標にNPCを作成します | znpcs.admin |
| NPCを削除します | znpcs.admin |
| NPCとそのIDの一覧を表示します | znpcs.admin |
| NPCをあなたの場所へテレポートさせます | znpcs.admin |
| あなたをNPCの場所へテレポートさせます | znpcs.admin |
| 既存のNPCのタイプを変更します | znpcs.admin |
| キャラクターのスキンを変更します | znpcs.admin |
| あなたの手のアイテムをNPCに渡します | znpcs.admin |
| NPCの上のテキストを変更します | znpcs.admin |
| テキストの高さを変更します（デフォルトは1） | znpcs.admin |
| クリック時のアクションを追加します | znpcs.admin |
| NPCのアクション一覧（IDを含む）を表示します | znpcs.admin |
| IDを指定してアクションを削除します | znpcs.admin |
| アクションの実行に遅延を設定します | znpcs.admin |
| 新しいルートを記録します | znpcs.admin |
| ルートの記録モードを終了します | znpcs.admin |
| NPCにルートを割り当てます | znpcs.admin |
| オプションを有効/無効にします（look、holo、mirror） | znpcs.admin |
| 選んだ色の発光エフェクトを追加します | znpcs.admin |
action add 用のアクションタイプ：
CMD（プレイヤーの名義でコマンドを実行）
CONSOLE（コンソールからコマンドを実行）
CHAT（プレイヤーがチャットにメッセージを書き込む）
MESSAGE（プレイヤーにメッセージを送信）
SERVER（BungeeCord経由で別のサーバーへ転送）
アクセス権限
ここでは何もかもが極めてシンプルです。ほぼすべてに、たった1つのノードしか必要ありません：
ノード | 付与される内容 |
znpcs.admin | すべてのコマンドへのフルアクセス |
設定
config.json
パラメータ | 値 | 説明 |
| 500 | 1つのNPCルートに記録できるポイント（ステップ）の最大数。ルートが長すぎる場合、この上限に達すると記録は自動的に停止します。 |
| "DEFAULT" | NPCの内部名を生成するアルゴリズム。標準値はIDの正しい紐付けを保証します。 |
| TRUE | NPCの作成時に、自動的にブロックの中央に正確に揃えます。モデルがブロックの端へずれるのを防ぎます。 |
| "-" | プラグインがコマンドのテキスト内の空白を置き換える際、または識別子を生成する際に使用する記号。 |
| 600 | 作成したキャラクターをファイルnpcs.jsonへ自動保存する間隔（600秒＝10分）。サーバーの突然のクラッシュによるデータ損失を防ぎます。 |
| TRUE | デバッグモードの有効化。プラグインは詳細な技術情報とエラーログをサーバーコンソールに出力し始めます。安定したサーバーでは、コンソールを見やすく保つために無効（false）にすることを推奨します。 |
| 0.3 | NPCの頭上のホログラム（テキスト）の行間の間隔。値を小さくするとテキストがより密になります。 |
| 32 | サーバーがNPCモデルを描画するためのパケットをプレイヤーへ送信し始める範囲の半径（ブロック単位）。値を下げるとサーバーとクライアントのリソースを節約できます。 |
| FALSE | ホログラムテキストの動的な色変化（RGBグラデーション）への対応。有効にするとクライアントに追加の負荷がかかる場合があります。 |
npcs.json
作成されたすべてのNPCはファイルnpcs.jsonに記録されます。プラグインが自動的に生成するため、手動で編集しない方が良いでしょう。このファイルに手を入れる唯一の正当な理由は、設定済みのNPCを別のサーバーへ移行する必要があるときです。
conversations.json
すべての会話はここに保存されます。
paths
記録されたすべてのルートが保存されるフォルダ。
data.json
作成されたNPCに関するすべての詳細情報がここに保存されます。
連携
サーバーにPlaceholderAPIが導入されている場合、ZNPCsは特別な拡張機能なしで自動的にそれを認識します。これは、たとえばNPCの上に動的なオンライン人数のカウンターを表示したい場合に役立ちます。
互換性
オリジナルのZNPCsはバージョン1.21.1までしか正常に動作しません。より新しいサーバー（1.21.1以上）では、フォークであるZNPC Plusを導入する必要があります。
また、このプラグインはエンティティの扱いに関する特性のため、Foliaでは起動しません。
ZNPCsを使うべき場面
スポーンに、単にメニューを開いたり、スターターキットを配布したり、プレイヤーを他のミニゲームサーバーへ転送したりするだけのNPCを設置したいなら、ZNPCsは素晴らしい選択肢です。約束どおりのことを正確に行い、不要な機能でサーバーに負荷をかけることもありません。
しかし、分岐する会話や複雑なクエストを作る予定があるなら、Citizens + Denizen のエコシステムが必要です。ZNPCsはそのためのものではありません。
インストール
通常のインストールは約 5 分で完了します。手順は同じで、ローダーと対応するビルドだけが異なります。
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
