組み込みGUIショップ

1. 概要

Citizensには基本的なGUIショップ機能が組み込まれています。ショップをNPCに関連付け、アイテムを並べたり、ショップの種別・タイトル・閲覧権限などを設定できます。ショップ名を指定すると、複数NPCから共有できる名前付きショップとして扱える機能があります。

公式資料：https://wiki.citizensnpcs.co/Shops

2. 編集画面を開く

/npc select <NPC ID>
/npc shop edit

名前付きショップを編集する例：

/npc shop edit 道具屋

関連するコマンドには show、delete、copyfrom などが掲載されています。使用可能な引数は /npc help shop を参照してください。

3. ショップ画面で設定する項目

公式Wikiの説明では、GUIから以下を設定できます。

• ショップのタイトル
• 商品ページとスロット内のアイテム
• 閲覧に必要な権限
• 右クリック時にショップを自動で開くか
• ショップ種別（Buy／Sell／Commandなどの種類や、トレーダー型UIを含む版）
• ショップのページ構成

GUIのアイコンや配置はバージョンにより変わる可能性があります。画面に示される説明を優先してください。

4. Buy／Sell／Commandの考え方

Citizensのショップは単なるアイテム展示だけでなく、ショップ種別に応じて取引動作を変えられる機能があります。商品を登録する際は、「プレイヤーが何を支払うか」「プレイヤーが何を受け取るか」「どの価格／コスト条件で取引可能か」を正しく設定します。

経済プラグイン、Vault互換連携、アイテムコンポーネント比較、Placeholder等を用いた高度な条件は、対象バージョンや連携プラグインによって利用可能範囲が変わります。現在の機能に未対応の項目がある場合、無理に推測せず、公式Wikiとゲーム内GUIの説明を確認してください。

5. 共有ショップ

名前付きショップは複数NPCで共有できるため、店舗の入り口NPCと売買専用NPCで同一ショップを使う構成などが考えられます。

注意点：

• 共有されるショップデータを編集すると、同じショップを参照しているNPCにも影響します。
• 不要な名前付きショップを削除する前に、それを使っているNPCがないか確認してください。
• 同名ショップが存在し得る構成では、完全な名前空間／名称で指定する方法を確認してください。

6. テスト項目

本番導入前に次をテストします。

1. 権限を持つプレイヤーと持たないプレイヤーの表示差。
2. 買う／売る両方の向きで取引が意図どおりか。
3. 残高不足、必要アイテム不足、在庫なし、連続クリック。
4. 取引失敗時にアイテムや通貨が失われないか。
5. ショップが右クリックで開く設定か、明示コマンドのみか。
6. NPC・ショップ・Citizensの保存と再起動後に設定が保持されるか。

7. どの機能を使うべきか

• 通貨やアイテムの通常売買：CitizensのShopを検討。
• クリックで独自メニューを開く：/npc command からメニュー系プラグインを呼ぶ方法。
• 複雑なクエスト報酬、プレイヤーごとの進捗、外部データベース連携：専用プラグイン／スクリプトを検討。

Citizensの組み込みショップは「基本的なGUIショップ」です。高度な在庫管理・プレイヤー別価格・クエスト進行まで自動で実現できると想定しないでください。