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 使用一个单位；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 匹配。 |