|
| 1 | +--- |
| 2 | +title: 1.1.0 发布说明 |
| 3 | +description: MatrixShop 1.1.0 的正式发布内容、升级重点和兼容说明。 |
| 4 | +--- |
| 5 | + |
| 6 | +# MatrixShop 1.1.0 发布说明 |
| 7 | + |
| 8 | +发布时间:`2026-03-31` |
| 9 | + |
| 10 | +## 版本定位 |
| 11 | + |
| 12 | +`1.1.0` 是 MatrixShop 首个面向正式部署收口的稳定迭代版本。 |
| 13 | + |
| 14 | +这一版没有推翻原有模块结构,而是在 `1.0.0` 的基础上重点补齐: |
| 15 | + |
| 16 | +- 统一经济模块 |
| 17 | +- 默认模块帮助系统 |
| 18 | +- 发布态语言与默认反馈 |
| 19 | +- 配置结构收口 |
| 20 | +- 文档站与示例覆盖 |
| 21 | + |
| 22 | +## 本版本重点 |
| 23 | + |
| 24 | +### 统一经济模块 |
| 25 | + |
| 26 | +新增强制启用的 `Economy` 核心模块,用于集中管理所有货币定义。 |
| 27 | + |
| 28 | +当前货币优先级为: |
| 29 | + |
| 30 | +1. 商品级 |
| 31 | +2. 商店级 |
| 32 | +3. 模块级 |
| 33 | +4. 默认回退 `vault` |
| 34 | + |
| 35 | +这意味着业务模块只需要引用货币键,不再各自维护一套经济接入逻辑。 |
| 36 | + |
| 37 | +继续阅读: |
| 38 | + |
| 39 | +- [经济模块](./economy) |
| 40 | +- [经济字段参考](./economy-reference) |
| 41 | +- [经济配置示例](./economy-examples) |
| 42 | + |
| 43 | +### 默认帮助系统增强 |
| 44 | + |
| 45 | +默认模块命令现在支持: |
| 46 | + |
| 47 | +- 多行 `Help` |
| 48 | +- `Help-Key` |
| 49 | +- `Hint-Keys` |
| 50 | +- 别名感知的 `{command}` 提示 |
| 51 | + |
| 52 | +这让 `/auction help`、`/trade help`、`/cart help`、`/record help` 这类入口可以围绕当前命令前缀输出更正式的帮助信息。 |
| 53 | + |
| 54 | +继续阅读: |
| 55 | + |
| 56 | +- [Help、Help-Key 与 Hint-Keys](./bindings-help-and-hints) |
| 57 | + |
| 58 | +### 配置结构收口 |
| 59 | + |
| 60 | +这一版对几个模块的默认结构做了收口: |
| 61 | + |
| 62 | +- `ChestShop` 不再使用 `shops/*.yml` |
| 63 | +- `Cart` 不再使用 `shops/*.yml` |
| 64 | +- `Record` 不再使用 `shops/*.yml` |
| 65 | + |
| 66 | +这几个模块现在更接近“模块级单入口 + 多个 UI 视图”的设计。 |
| 67 | + |
| 68 | +### 文案与反馈正式化 |
| 69 | + |
| 70 | +这一版统一收紧了以下内容: |
| 71 | + |
| 72 | +- 启动和控制台输出 |
| 73 | +- 默认语言包 |
| 74 | +- 交易、拍卖、箱子商店、购物车、记录等关键反馈 |
| 75 | +- 默认帮助与提示词 |
| 76 | + |
| 77 | +目标是让默认发布包更接近正式产品,而不是开发期原型。 |
| 78 | + |
| 79 | +## 升级建议 |
| 80 | + |
| 81 | +如果你从 `1.0.0` 升级到 `1.1.0`,建议至少检查这些文件: |
| 82 | + |
| 83 | +- `plugins/MatrixShop/Economy/currency.yml` |
| 84 | +- `plugins/MatrixShop/module.yml` |
| 85 | +- 各模块 `settings.yml` |
| 86 | +- 各模块 `shops/*.yml` |
| 87 | +- `plugins/MatrixShop/Lang/*.yml` |
| 88 | + |
| 89 | +尤其需要注意: |
| 90 | + |
| 91 | +- 旧语言文件会自动补缺失键,但你仍然应该检查是否覆盖了旧自定义文案 |
| 92 | +- `ChestShop`、`Cart`、`Record` 的入口结构已经和早期草案不同 |
| 93 | +- 若你自定义了帮助提示,建议复查 `Help / Help-Key / Hint-Keys` |
| 94 | + |
| 95 | +## 兼容与验证 |
| 96 | + |
| 97 | +本版本发布前已完成的基础验证包括: |
| 98 | + |
| 99 | +- `bash ./gradlew build` |
| 100 | +- `paper-1.12.2` smoke boot |
| 101 | +- 默认命令帮助与模块入口回归 |
| 102 | +- 经济模块与货币优先级回归 |
| 103 | + |
| 104 | +## 相关链接 |
| 105 | + |
| 106 | +- [GitHub Releases](https://github.com/54895y/MatrixShop/releases) |
| 107 | +- [1.1.0 GitHub Release](https://github.com/54895y/MatrixShop/releases/tag/v1.1.0) |
| 108 | +- [CHANGELOG](https://github.com/54895y/MatrixShop/blob/main/CHANGELOG.md) |
0 commit comments