Bukkit MatrixShop | 多功能商店 | kether脚本控制 2026-04-03

---

MatrixShop 将系统商店、玩家商店、全局市场、拍卖、箱子商店、面对面交易、购物车和交易记录整合到同一个项目中，提供统一的命令体系、菜单框架、权限校验、经济模块与数据存储方案。

点击展开...

一、插件大概功能

• SystemShop
  静态系统商店，支持 goods 仓库、product / group / pool 资源模型、定时刷新与后台维护
• PlayerShop
  玩家个人商店，适合长期经营和自由上架
• GlobalMarket
  全服共享市场，方便玩家统一浏览和购买商品
• Auction
  拍卖行，支持竞拍与一口价玩法
• ChestShop
  箱子商店，支持库存型售卖与线下交互
• Transaction
  玩家面对面交易，适合高价值物品或点对点交换
• Cart
  购物车系统，支持集中结算
• Record
  交易记录 / 账本系统，方便追踪收入与支出
• Economy
  统一经济模块，支持多货币与业务模块统一结算

二、Wiki 与相关地址

• 插件文档
  https://54895y.github.io/docs/matrixshop
• 更新日志
  https://54895y.github.io/docs/matrixshop/release-notes
• GitHub Releases
  https://github.com/54895y/MatrixShop/releases
• 项目仓库
  https://github.com/54895y/MatrixShop

三、Skills 使用方法

如果你希望用 AI 帮你生成、迁移或校对 MatrixShop 配置，可以直接使用公开的 MatrixAgentSkills。

• Skills 总览
  https://54895y.github.io/docs/matrix-agent-skills
• Codex / OpenAI Skills
  https://github.com/54895y/MatrixAgentSkills/tree/main/matrixshop-config
• Claude / Gemini / Cline / Roo / Continue 通用 Prompt
  https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrixshop-config.md
• AIChat 知识库入口
  https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/aichat/matrixshop-config-kb.md

推荐用法：

1. 把上面的 Skill 或 Prompt 链接直接发给你的 AI Agent
2. 补充你的服设需求，例如默认货币、启用模块、目标 YAML 文件
3. 让 Agent 按 MatrixShop 当前结构生成 module.yml、Economy/currency.yml、SystemShop/shops/*.yml 等配置
4. 如果你是从其他商店插件迁移，也可以直接让 Agent 按当前结构转换配置

四、更新日志

当前源码主线重点更新：

• 货币模块正式迁移到 MatrixLib
• MatrixShop 通过共享经济 API 读取货币配置
• 货币定义主入口改为 plugins/MatrixLib/Economy/currency.yml
• 运行时会与 MatrixStorage 同步 Economy/currency.yml
• 依赖 MatrixLib 升级到 1.1.0
• 已完成 ./gradlew build
• 已通过 Paper 1.21.11 smoke boot 验证

近期版本更新：

• 1.5.0
  为 PlayerShop、GlobalMarket、Auction、Transaction、ChestShop 增加统一条件税系统
• 1.4.0
  为 SystemShop 增加折扣系统、价格对象与购物车锁价
• 1.3.0
  增加 goods 仓库流、product / group / pool、定时刷新与 bStats 遥测

五、GitHub Issue 提交问题

项目地址：
https://github.com/54895y/MatrixShop

Issue 地址：
https://github.com/54895y/MatrixShop/issues

如果你在使用过程中遇到以下问题，欢迎直接提交 Issue：

• 启动报错
• 配置兼容问题
• 模块逻辑异常
• 文档缺失或示例错误
• 新功能建议

提交 Issue 时建议附带：

• 服务端核心与版本
• MatrixShop 版本
• MatrixLib 版本
• 报错日志或控制台截图
• 相关配置文件片段
• 复现步骤

---