Skip to content

Commit d94379f

Browse files
committed
Add MatrixShop 1.1.0 release notes
1 parent fe4b41b commit d94379f

4 files changed

Lines changed: 124 additions & 6 deletions

File tree

docs/matrixshop/index.mdx

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -52,12 +52,13 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
5252
如果你第一次接触 MatrixShop,推荐顺序是:
5353

5454
1. [快速开始](./quick-start)
55-
2. [配置结构](./configuration-structure)
56-
3. [经济模块](./economy)
57-
4. [命令与权限](./commands-and-permissions)
58-
5. [数据库与存储](./database-and-storage)
59-
6. [模块总览](./modules-overview)
60-
7. [商店与模块详解](./shop-types)
55+
2. [1.1.0 发布说明](./release-notes-1-1-0)
56+
3. [配置结构](./configuration-structure)
57+
4. [经济模块](./economy)
58+
5. [命令与权限](./commands-and-permissions)
59+
6. [数据库与存储](./database-and-storage)
60+
7. [模块总览](./modules-overview)
61+
8. [商店与模块详解](./shop-types)
6162

6263
## 发布前建议
6364

@@ -66,3 +67,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
6667
1. 先执行一次 `/matrixshopadmin status`
6768
2. 确认 `database.yml``module.yml` 和主要模块 `settings.yml` 已按你的服设完成调整
6869
3. 逐个验证你实际会开放给玩家的入口命令和菜单绑定
70+
71+
如果你是从 `1.0.0` 升级,请先看:
72+
73+
- [1.1.0 发布说明](./release-notes-1-1-0)

docs/matrixshop/quick-start.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,10 @@ description: 首次部署 MatrixShop、生成默认配置并验证基本指令
1313
4. 按需修改 `module.yml``database.yml``Economy/currency.yml`
1414
5. 重新启动,或使用管理员命令重载。
1515

16+
如果你正在从 `1.0.0` 升级,请先阅读:
17+
18+
- [1.1.0 发布说明](./release-notes-1-1-0)
19+
1620
## 2. 默认目录
1721

1822
当前版本的默认目录结构是:
Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
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)

sidebars.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ const sidebars: SidebarsConfig = {
4545
},
4646
items: [
4747
'matrixshop/quick-start',
48+
'matrixshop/release-notes-1-1-0',
4849
'matrixshop/configuration-structure',
4950
'matrixshop/economy',
5051
'matrixshop/economy-reference',

0 commit comments

Comments
 (0)