Shop
Shops 拡張は生きた経済をシミュレートします。価格は需要と供給に応じて変動し、在庫設定で希少性を演出でき、自動補充によって市場が動き続けます。
機能
- 動的な価格設定 — 在庫水準に応じて価格が変動します。
- 在庫管理 — 最大供給量と補充上限。
- 購入制限 — プレイヤーごとにアイテムを制限します。
- 通貨非依存 — Vault、ポイント、アイテムのいずれでも動作します。
エントリー
クイックスタート
- 1. 設定を構成する — 設定エントリーから始めます：shop_definition。拡張のグローバル設定を定義します。→ shop_definition
- 2. アクションを発動する — アクションエントリーを使って拡張と連携します：open_shop。コマンド、NPC、イベント、その他のエントリーから発動できます。→ open_shop
プレースホルダー
接頭辞：%typewriter_shop:<id>:%
| プレースホルダー | 説明 |
|---|---|
%typewriter_shop:<id>:name% | ショップ名 |
%typewriter_shop:<id>:cooldown% | 補充タイマー |
%typewriter_shop:<id>:<index>:buy_price% | 現在の購入価格 |
%typewriter_shop:<id>:<index>:stock% | 現在の在庫 |
コマンド
| コマンド | 説明 |
|---|---|
/shop | ショップメニューを開きます。 |
権限
| Permission | 説明 |
|---|---|
typewriter.shop.open | ショップメニューを開く。 |
現在のリファレンス
ShopDefinitionEntry は ShopItemConfig、ShopInteractionConfig、ShopClickAction / ShopButtonType を接続する。関連サービスは ShopGuiService、ShopTransactionHandler、ShopButtonActionHandler。
BUY_1 / SELL_1 は1個、BUY_STACK / SELL_STACK は stack、BUY_MAX / SELL_ALL は可能な最大数を使う。BUY_CUSTOM / SELL_CUSTOM は入力を開く。BUY_1:10 / SELL_1:10 はサブメニューに固定数量ボタンを作る。
ダイアログのフィールドは buyAmountPrompt、sellAmountPrompt、amountConfirmButton、amountInputLabel、amountInputPlaceholder、amountInputWidth、amountInputMaxLength、invalidAmountMessage。
バージョンと互換性
| 項目 | リファレンス |
|---|---|
| バージョン | 公開済みの公式 release は確認されていない。 |
TypeWriter | 拡張機能が対応する公式 release を使用する。 |
| GUI | メニュー依存関係は公開 release と一致させる。 |