跳到主要内容

模块总览

当前 MatrixShop 默认包含十个模块，其中 economy 是核心模块，始终启用；其余九个模块按业务拆分。

模块清单​

模块作用关键文件详细页
economy统一货币定义与结算入口Economy/currency.yml经济模块
menu总入口导航菜单Menu/settings.yml、Menu/shops/main.ymlMenu
system-shop静态系统商店SystemShop/settings.yml、SystemShop/goods/*.yml、SystemShop/shops/*.ymlSystemShop
player-shop玩家个人商店PlayerShop/settings.yml、PlayerShop/shops/default.ymlPlayerShop
global-market全服共享市场GlobalMarket/settings.yml、GlobalMarket/shops/default.ymlGlobalMarket
auction拍卖行Auction/settings.yml、Auction/shops/default.ymlAuction
chestshop箱子商店ChestShop/settings.yml、ChestShop/signs.yml、ChestShop/ui/*.ymlChestShop
transaction面对面交易Transaction/settings.yml、Transaction/shops/default.ymlTransaction
cart购物车Cart/settings.yml、Cart/ui/*.ymlCart
record账本记录Record/settings.yml、Record/retention.yml、Record/ui/*.ymlRecord

应该先读哪些页​

如果你在做新服部署​

建议顺序：

  1. 配置结构
  2. 经济模块
  3. 商店与模块详解
  4. 你实际会用到的模块页

如果你在排查某个商店为什么打不开​

先看：

  1. 对应模块的 settings.yml 是否启用、是否有权限条件。
  2. 如果该模块使用 shops/*.yml，确认文件名是否和你打开的 shopId 一致。
  3. 模块页里记录的默认命令别名和 UI 文件是否匹配。

如果你在做中文化或重做界面​

先看：

  1. 绑定与 UI
  2. 对应模块页中的 shops/*.yml 或 ui/*.yml
  3. 对应模块的 ui/*.yml

当前模块边界​

为了避免把 MatrixShop 理解成“所有模块都完全一样”，这里再强调一次：

  • Economy 负责统一货币定义，不建议在业务模块里重复实现结算逻辑。
  • SystemShop 主要是静态 YAML 商品，推荐用 goods/*.yml + shops/*.yml 引用。
  • PlayerShop、GlobalMarket、Auction 主要是运行时上架数据。
  • ChestShop 有箱子、库存、告示牌这套线下交互。
  • Transaction 不是商品市场，而是面对面交换。
  • Cart 和 Record 是辅助模块，不是独立销售市场，也不再使用 shops/*.yml 作为主入口。

如果你准备直接改字段，请进入 商店与模块详解 下的具体模块页。