快速开始

1. 首次启动

将 MatrixShop.jar 放入服务端 plugins/ 目录。
如果你准备使用 vault 货币，确保服务器安装了可用的 Vault 经济提供者。
启动一次服务器，让插件生成默认资源文件。
按需修改 module.yml、database.yml 和 MatrixLib/Economy/currency.yml。
重新启动，或使用管理员命令重载。

如果你关心统计或隐私说明，继续看：

bStats 与遥测

如果你正在从 1.0.0 升级，请先阅读：

2. 默认目录

当前版本的默认目录结构是：

plugins/MatrixShop/
├─ config.yml
├─ module.yml
├─ database.yml
├─ Economy/
├─ Menu/
├─ SystemShop/
│  ├─ goods/
│  ├─ shops/
│  └─ ui/
├─ PlayerShop/
├─ GlobalMarket/
├─ Auction/
├─ ChestShop/
├─ Transaction/
├─ Cart/
└─ Record/

大多数模块目录下会包含：

settings.yml
shops/*.yml
ui/*.yml

SystemShop 还会额外包含：

goods/*.yml

但有三个例外：

ChestShop/：不再使用 shops/*.yml，只保留 settings.yml、signs.yml 和 ui/*.yml
Cart/：不再使用 shops/*.yml，只保留 settings.yml 和 ui/*.yml
Record/：不再使用 shops/*.yml，只保留 settings.yml、retention.yml 和 ui/*.yml

对于仍然使用 shops/*.yml 的模块，文件名就是当前实现里的 shopId。

3. 先做的三项检查

检查模块开关

module.yml 控制九个可切换模块是否启用：

modules:
  menu: true
  system-shop: true
  player-shop: true
  global-market: true
  auction: true
  chestshop: true
  transaction: true
  cart: true
  record: true

说明：

economy 是核心模块，不在 module.yml 中关闭
它始终启用，并统一处理货币定义和结算入口

检查数据库后端

database.yml 当前支持：

SQLITE
MYSQL

如果 JDBC 初始化失败，插件会回退到文件后端，并在 /matrixshopadmin status 中显示原因。

检查经济模块

默认共享货币定义文件在：

plugins/MatrixLib/Economy/currency.yml

运行时它会同步到 MatrixShop 和 MatrixStorage 的同路径文件。

建议至少确认：

vault 是否可用
如需点券，playerpoints 是否已安装对应插件
如需自定义货币，是否已正确写入 Actions.Take / Give / Deny

检查绑定命令

模块命令不是全部写死的。它们会从各模块 settings.yml 和 shops/*.yml 里的 Bindings.Commands 读取。

例如默认情况下：

/menu
/auction
/chestshop
/trade
/market
/cart
/record

都可能在启动时注册成独立命令。

如果你准备直接改：

模块命令别名
/模块 help 的多行帮助
子命令提示词

建议继续看：

4. 首次验证命令

建议按这个顺序验证：

/matrixshopadmin status
/matrixshop
/menu open
/ms system open weapon
/ms open systemshop:weapon
/auction open
/market open
/cart help
/record help

如果你能正常打开系统商店、拍卖、市场、购物车和记录页面，说明基础配置已经生效。

1. 首次启动​

2. 默认目录​

3. 先做的三项检查​

检查模块开关​

检查数据库后端​

检查经济模块​

检查绑定命令​

4. 首次验证命令​