Document module-level economy configs

Author: 54895y

docs/matrixshop/shop-types/auction.mdx

@@ -5,7 +5,7 @@ description: Auction 模块的默认配置、入口页和核心拍卖参数解
 
 # Auction
 
-`Auction` 是 MatrixShop 里配置最复杂的模块之一。它不仅决定拍卖入口长什么样，还控制英式拍卖、荷式拍卖、押金、税率、抢拍保护和记录写入。
+`Auction` 是 MatrixShop 里配置最复杂的模块之一。它不仅决定拍卖入口长什么样，还控制英式拍卖、荷式拍卖、押金、税率、抢拍保护、记录写入，以及拍卖使用的货币来源。
 
 ## 默认文件
 
@@ -34,6 +34,8 @@ Bindings:
     Condition: 'perm matrixshop.auction.use'
 
 Options:
+  Currency:
+    Key: vault
   Listing:
     Max-Active: 20
     Duration:
@@ -89,6 +91,7 @@ Options:
 | `Register` | 这里直接是 `true`，所以会注册独立拍卖命令。 |
 | `Priority` | 由于 `ah` 很容易和别的插件冲突，这个优先级非常重要。 |
 | `Condition` | 默认权限节点。 |
+| `Options.Currency.Key` | 模块级默认货币 key。 |
 
 ### `Options.Listing`
 
@@ -151,6 +154,9 @@ Bindings:
     Show-In-Help: true
     Priority: 100
 
+Currency:
+  Key: vault
+
 Title:
   - '&8Auction Hall &7{page}/{max-page}'
 
@@ -212,6 +218,14 @@ icons:
 | `icons.P/N` | 翻页。 |
 | `icons.R` | 关闭页面。 |
 
+## 当前货币优先级
+
+`Auction` 当前采用：
+
+1. `Auction/shops/*.yml -> Currency.Key`
+2. `Auction/settings.yml -> Options.Currency.Key`
+3. 默认回退 `vault`
+
 ## 使用建议
 
 - 想限制玩家同时挂拍数量：改 `Options.Listing.Max-Active`。

docs/matrixshop/shop-types/chest-shop.mdx

@@ -7,10 +7,11 @@ description: ChestShop 的入口、GUI、告示牌与库存相关配置说明。
 
 `ChestShop` 是箱子商店模块。它和前面的菜单型商店不同，既有 GUI，也有箱子、告示牌、库存和数量档位这些线下交互逻辑。
 
+当前版本中，`ChestShop` 不使用 `shops/*.yml` 作为入口层，货币也只支持模块级配置。
+
 ## 默认文件
 
 - `ChestShop/settings.yml`
-- `ChestShop/shops/default.yml`
 - `ChestShop/signs.yml`
 - `ChestShop/ui/create.yml`
 - `ChestShop/ui/edit.yml`
@@ -40,6 +41,8 @@ Entry:
   Direct-Trade-On: []
 Stock:
   Double-Chest-Mode: expand_only
+Currency:
+  Key: vault
 ```
 
 字段解释：
@@ -54,102 +57,7 @@ Stock:
 | `Entry.Open-GUI-On` | 哪些交互动作会直接打开 GUI。 |
 | `Entry.Direct-Trade-On` | 哪些交互动作会走直接交易。默认是空列表。 |
 | `Stock.Double-Chest-Mode` | 双箱库存处理方式，示例是 `expand_only`。 |
-
-## `ChestShop/shops/default.yml`
-
-```yaml
-Bindings:
-  Commands:
-    Bindings:
-      - 'chestshop'
-      - 'cshop'
-    Register: true
-    Show-In-Help: true
-    Priority: 100
-
-Title:
-  - '&8ChestShop &7{shop-id}'
-
-layout:
-  - '#########'
-  - '#11i22S##'
-  - '#33###B##'
-  - '##I#H#M##'
-  - '#########'
-  - '####R####'
-
-icons:
-  '#':
-    material: 'STAINED_GLASS_PANE'
-    name: ' '
-  '1':
-    material: 'WOOD_BUTTON'
-    name: '&f1x'
-    lore:
-      - '&7Preview one trade bundle'
-  '2':
-    material: 'STONE_BUTTON'
-    name: '&f8x'
-    lore:
-      - '&7Preview eight trade bundles'
-  '3':
-    material: 'STONE_BUTTON'
-    name: '&f64x'
-    lore:
-      - '&7Preview sixty-four trade bundles'
-  'i':
-    material: 'AIR'
-    mode: 'preview'
-  'S':
-    material: 'HOPPER'
-    name: '&aSell To Shop'
-    lore:
-      - '&7Mode: &f{mode}'
-      - '&7Amount: &f{total-amount}'
-      - '&7Value: &e{total-buy-price}'
-  'B':
-    material: 'EMERALD'
-    name: '&6Buy From Shop'
-    lore:
-      - '&7Mode: &f{mode}'
-      - '&7Amount: &f{total-amount}'
-      - '&7Cost: &e{total-sell-price}'
-  'I':
-    material: 'CHEST'
-    name: '&fStock'
-    lore:
-      - '&7Current stock: &f{stock}'
-  'H':
-    material: 'PAPER'
-    name: '&fHistory'
-    lore:
-      - '&7View recent trades'
-  'M':
-    material: 'BOOK'
-    name: '&eManage'
-    lore:
-      - '&7Owner only'
-  'R':
-    material: 'BARRIER'
-    name: '&cClose'
-    actions:
-      left:
-        - 'close'
-```
-
-### 顶层字段解释
-
-| 字段 | 说明 |
-| --- | --- |
-| `Title` | 箱子商店标题。 |
-| `layout` | `1/2/3` 是数量档位，`i` 是预览区，`S/B` 是卖出和买入，`I/H/M` 是库存、历史、管理。 |
-| `icons.i.mode: preview` | 由模块代码渲染交易预览。 |
-| `icons.S` | 卖给商店。 |
-| `icons.B` | 从商店购买。 |
-| `icons.I` | 查看库存。 |
-| `icons.H` | 打开交易历史。 |
-| `icons.M` | 打开管理页。 |
-| `icons.R` | 关闭。 |
+| `Currency.Key` | 箱子商店统一使用的货币 key。 |
 
 ## `ChestShop/signs.yml`
 
@@ -183,6 +91,13 @@ Formats:
 
 ## 使用建议
 
-- 想改玩家打开箱店后的布局：改 `shops/default.yml`。
+- 想改玩家打开箱店后的布局：改 `ui/shop.yml`、`ui/edit.yml`、`ui/create.yml`。
 - 想改告示牌显示样式：改 `signs.yml`。
 - 想改变“右键箱子”“右键告示牌”的行为：改 `Entry.Open-GUI-On` 和 `Direct-Trade-On`。
+
+## 当前货币优先级
+
+`ChestShop` 当前不走商店级或商品级货币配置，直接使用：
+
+1. `ChestShop/settings.yml -> Currency.Key`
+2. 默认回退 `vault`

docs/matrixshop/shop-types/transaction.mdx

@@ -7,6 +7,8 @@ description: Transaction 面对面交易模块的设置、入口页与交易界
 
 `Transaction` 是玩家之间的面对面交易模块。它不依赖“商店上架”，而是依赖请求、会话、准备、确认这条流程。
 
+当前版本中，金钱报价已经接入统一经济模块。
+
 ## 默认文件
 
 - `Transaction/settings.yml`
@@ -29,6 +31,8 @@ Bindings:
     Priority: 18
     Condition: 'perm matrixshop.transaction.use'
 Options:
+  Currency:
+    Money-Key: vault
   Request:
     Timeout-Seconds: 30
     Max-Pending: 5
@@ -70,6 +74,7 @@ Options:
 | `Trade.Allow-Items` | 是否允许交换物品。 |
 | `Trade.Allow-Money` | 是否允许附带金钱。 |
 | `Trade.Allow-Exp` | 是否允许附带经验。 |
+| `Options.Currency.Money-Key` | 金钱报价默认使用的货币 key。 |
 | `Record.Write-On-Complete` | 成交时是否写记录。 |
 | `Record.Write-On-Cancel` | 取消时是否写记录。 |
 
@@ -85,6 +90,9 @@ Bindings:
     Show-In-Help: true
     Priority: 100
 
+Currency:
+  Key: vault
+
 Title:
   - '&8Trade Hub &7{shop-id}'
 
@@ -126,6 +134,14 @@ icons:
 | `L` | 打开交易记录。 |
 | `layout` | 这个页面不是商品列表，而是交易中心的导航页。 |
 
+## 当前货币优先级
+
+`Transaction` 当前采用：
+
+1. `Transaction/shops/*.yml -> Currency.Key`
+2. `Transaction/settings.yml -> Options.Currency.Money-Key`
+3. 默认回退 `vault`
+
 ## `Transaction/ui/trade.yml`
 
 这个文件决定真正交易时的主界面结构：