跳到主要内容

MatrixShop 文档

MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当前主线版本已经具备正式部署所需的核心模块、统一命令体系、统一菜单框架、统一权限校验、统一经济模块和 JDBC 优先的数据层。

当前最新版本入口：

当前版本状态​

  • 已完成首发所需的核心业务链
  • 默认文案、帮助输出和主要模块反馈已统一进语言系统
  • 支持 SQLite / MySQL，JDBC 不可用时自动回退到文件后端
  • SystemShop 已支持 goods 仓库、商品组、随机池和定时刷新基础能力
  • 已集成 bStats，可统计模块和基础配置分布
  • 默认文档以 main 分支和当前默认资源文件为准

当前实现的模块​

  • economy
  • menu
  • system-shop
  • player-shop
  • global-market
  • auction
  • chestshop
  • transaction
  • cart
  • record

插件启动时会执行这条主流程：

  1. 释放默认资源文件
  2. 读取 config.yml、module.yml、database.yml
  3. 初始化记录服务
  4. 同步数据库 schema
  5. 导入旧版数据
  6. 加载经济模块、业务模块与命令

当前文档覆盖的重点​

  • 真实目录结构与文件职责
  • 命令绑定、独立命令与 shopId 解析规则
  • 统一经济模块与货币优先级规则
  • SQLite / MySQL / 文件回退行为
  • 各模块当前能力和配置边界
  • 每个模块默认配置的完整示例与字段解读
  • UI 配置和动作语法

文档结构​

当前文档按这五组整理：

  1. 开始使用
  2. 配置与系统
  3. 模块与机制
  4. 更新日志
  5. 商店与模块详解

推荐阅读顺序​

如果你第一次接触 MatrixShop，推荐顺序是：

  1. 快速开始
  2. 1.5.0 发布说明
  3. 配置结构
  4. 经济模块
  5. 命令与权限
  6. 数据库与存储
  7. 模块总览
  8. 商店与模块详解

分类导览​

开始使用​

配置与系统​

模块与机制​

更新日志​

发布前建议​

如果你准备直接部署到正式服务器，建议至少先完成这三项检查：

  1. 先执行一次 /matrixshopadmin status
  2. 确认 database.yml、module.yml 和主要模块 settings.yml 已按你的服设完成调整
  3. 逐个验证你实际会开放给玩家的入口命令和菜单绑定

如果你是从 1.0.0 升级，请先看：