Minecraftプラグイン Citizens

🔌 Citizens について

Citizens は、サーバー側 NPC を作成・管理するための完全なシステムを提供する Minecraft プラグインです。プレイヤー風、Mob、ショップ店員、警備員、像など多くの NPC タイプに対応しており、他のプラグインやカスタムコードが挙動、trait、連携を追加できるよう API も公開しています。

🎯 目的

Citizens は、サーバー上で永続的かつ設定可能な NPC を必要とするニーズを解決します。NPC は、操作できるショップ店員、スクリプト化された演者、ウェイポイントに従う警備員、案内用キオスク、装飾用の像などとして機能できます。このプラグインは、サーバー運営者がゲームプレイ機能を作るためにも、開発者が Citizens API ിലൂടെ機能を拡張するためにも使われます。

⚙️ 機能

• ゲーム内コマンドで NPC を作成・削除できます。
• 複数の NPC タイプ（プレイヤー、Mob ベース、村人など）に対応。
• NPC にコマンドやスクリプト化されたアクションを割り当てられます（クリック/実行トリガー、コマンドの追加）。
• 移動する NPC 向けのウェイポイントと巡回動作。
• NPC の挙動や見た目をカスタマイズする traits とエディタ。
• テンプレートと永続化により、再起動後も NPC が残ります。
• アドオン、traits、連携のための開発者向け API。

🧩 対象ユーザー

• ショップ、案内役、景観用のインタラクティブ NPC を欲しいサーバー運営者。
• 連携やミニゲームを作るために NPC API が必要なプラグイン開発者。
• 装飾用または機能的な非プレイヤーキャラクターが必要なコミュニティサーバー。

🏗️ 使用例

• Survival サーバーで NPC ショップ店員を使い、経済プラグインなしでアイテムを交換する。
• RPG サーバーで NPC にクエストや会話を出すスクリプトを設定する。
• 管理者が、町の周囲でウェイポイントに従って巡回する警備 NPC を配置する。
• 開発者が、ミニゲームのインタラクション用に NPC にカスタム trait を付与する。

⌨️ コマンド

(注: /npc には多くのサブコマンドと、特定機能向けのより細かい権限ノードがあります。完全なコマンド一覧はプラグインのドキュメントを参照してください。)

🔐 権限

(特定のコマンドや traits 向けに、ほかにも多くの権限ノードがあります。プラグインの権限リファレンスに詳細が記載されています。)

⚙️ インストール

📥 セットアップ

• プロジェクトの公式配布（プラグインカタログまたはダウンロード）から、Citizens の公式 JAR をダウンロードします。
• Spigot または Paper 対応サーバーの plugins/ ディレクトリに JAR を配置します。
• サーバーを再起動し、コンソールで Citizens が読み込まれ、データディレクトリが作成されたことを確認します。

📦 依存関係

• 既定では必須の外部依存関係はありません。Citizens はオプションのアドオン（サードパーティ製アドオンや他のプラグイン）で拡張されることが一般的ですが、基本動作に必須のものはありません。

🧠 技術的なメモ

• Citizens は開発者向け API を提供しており、他のプラグインが traits を作成したり、NPC とやり取りしたり、NPC イベントをフックしたりできます。
• このプラグインは NPC データを永続的に保存するため、再起動後も NPC が残り、実行時のカスタマイズ向けに traits/エディタをサポートしています。
• 公式ドキュメントとコミュニティ wiki で、コマンド、権限、traits、エディタ、連携ポイントが解説されています。

🤝 このプラグインが役立つ場面

持続的でスクリプト化可能な NPC と、非プレイヤーキャラクターをゲームプレイやサーバーシステムに統合するための API が必要なら、Citizens はサーバー管理者とプラグイン開発者の両方に必要な、NPC 管理、永続化、拡張ポイントの中核を提供します。