Skip to content

Commit c765eb7

Browse files
54895y54895y
committed
Add MatrixLib-backed bStats and prepare 1.0.1 release
1 parent fbe77b5 commit c765eb7

8 files changed

Lines changed: 408 additions & 15 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Changelog
2+
3+
All notable changes to MatrixStorage will be documented in this file.
4+
5+
The format is based on Keep a Changelog, and this project follows Semantic Versioning for release tags.
6+
7+
## [1.0.1] - 2026-04-05
8+
9+
### Added
10+
11+
- Added `bStats` telemetry registration through MatrixLib shared metrics API.
12+
- Added charts for storage backend, MatrixShop bridge status, mailbox volume, block warehouse volume, and definition sources.
13+
14+
### Changed
15+
16+
- Updated MatrixStorage to depend on `MatrixLib 1.3.0`.
17+
- Updated README and docs entry points for release and telemetry documentation.
18+
19+
### Validated
20+
21+
- Verified `bash ./gradlew build`.

‎README.md‎

Lines changed: 42 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,54 @@
11
# MatrixStorage
22

3-
`MatrixStorage` 是 Matrix 系列的仓储插件，提供：
3+
`MatrixStorage` 是 Matrix 系列的统一仓储插件，围绕邮箱、个人仓库、待收区、实体仓库和 MatrixShop 外部投递工作。
4+
5+
| 文档 | Release Notes | Releases | 依赖 |
6+
| --- | --- | --- | --- |
7+
| [Docs](https://54895y.github.io/docs/matrixstorage) | [1.0.1](https://54895y.github.io/docs/matrixstorage/release-notes-1-0-1) | [GitHub Releases](https://github.com/54895y/MatrixStorage/releases) | [MatrixLib 1.3.0](https://github.com/54895y/MatrixLib) |
8+
9+
## 当前发布
10+
11+
- 当前版本：`1.0.1`
12+
- 必需前置：`MatrixLib 1.3.0`
13+
- 后端支持：`sqlite / mysql / redis / yaml`
14+
- 可选集成：`MatrixShop / Vault / CraftEngine / ItemsAdder / Nexo`
15+
16+
## 功能定位
417

518
- 玩家邮箱
6-
- 个人仓库
7-
- 仓库/邮箱格子解锁
19+
- 个人仓库与待收区
20+
- 仓库 / 邮箱格子解锁
821
- 位置型实体仓库
922
- MatrixShop 外部仓库投递对接
1023
- CraftEngine / ItemsAdder / Nexo 自定义方块与家具接入
1124

12-
技术栈：
25+
## bStats 遥测
26+
27+
- Plugin ID: `30559`
28+
- 遥测通过 `MatrixLib` 的 `MatrixBStats` API 注册
29+
30+
当前图表：
31+
32+
| Chart ID | 类型 | 含义 |
33+
| --- | --- | --- |
34+
| `storage_backend` | SimplePie | 当前仓储状态后端 |
35+
| `matrixshop_bridge` | SimplePie | MatrixShop 桥接是否就绪 |
36+
| `warehouse_definition_count` | SingleLineChart | 已加载仓库定义数量 |
37+
| `mailbox_count` | SingleLineChart | 当前邮箱消息数量 |
38+
| `block_warehouse_count` | SingleLineChart | 当前实体仓库数量 |
39+
| `warehouse_definition_sources` | AdvancedPie | 仓库定义来源分布 |
1340

14-
- TabooLib 6
15-
- Kotlin
16-
- MatrixLib 作为前置插件
41+
预留图表位：
1742

18-
当前代码库默认支持 `sqlite / mysql / redis / yaml` 四种后端，并接入统一的 Matrix 文档站。
43+
| 预留 Chart ID | 计划用途 |
44+
| --- | --- |
45+
| `unlock_rule_count` | 统计邮箱 / 仓库扩容规则数量 |
46+
| `placement_mode_distribution` | 统计 terminal / location 模式分布 |
47+
| `pending_delivery_target` | 统计待收区 / 邮箱投递分布 |
1948

20-
当前新增重点：
49+
## 文档入口
2150

22-
- 共享货币定义来自 `MatrixLib`
23-
- `MatrixLib / MatrixShop / MatrixStorage` 三端同步 `Economy/currency.yml`
24-
- 仓库与邮箱支持多条件、多价格、多货币解锁格子
25-
- 玩家总览页可直接执行容量扩容
51+
- [概览](https://54895y.github.io/docs/matrixstorage)
52+
- [1.0.1 发布说明](https://54895y.github.io/docs/matrixstorage/release-notes-1-0-1)
53+
- [bStats 与遥测](https://54895y.github.io/docs/matrixstorage/bstats-and-telemetry)
54+
- [Matrix 插件总文档入口](https://54895y.github.io/docs/plugins)

‎RELEASE_POST_BBCODE.txt‎

Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
[center][size=6][b]MatrixStorage[/b][/size][/center]
2+
[center][size=4]Matrix 系列统一仓储插件 / 储存库插件[/size][/center]
3+
[center][size=3]当前发布版本：1.0.1[/size][/center]
4+
5+
[hr]
6+
7+
[b]插件简介[/b]
8+
9+
MatrixStorage 是 Matrix 系列的统一仓储插件，围绕玩家邮箱、个人仓库、待收区、位置型实体仓库和外部仓库投递工作。
10+
11+
当前实现已接入原版方块仓库，以及 CraftEngine、ItemsAdder、Nexo 的自定义方块与家具仓库，同时支持与 MatrixShop 进行外部仓库投递对接。
12+
13+
[b]核心功能[/b]
14+
15+
[list]
16+
[*]玩家邮箱系统，支持玩家互寄与系统邮件
17+
[*]支持文本内容、主手物品附件、Vault 金额附件
18+
[*]个人仓库与待收区，总览页统一管理
19+
[*]实体仓库系统，支持 location 型坐标仓库记录
20+
[*]支持原版方块仓库
21+
[*]支持 CraftEngine / ItemsAdder / Nexo 自定义方块与家具仓库
22+
[*]支持仓库格子解锁与邮箱格子解锁
23+
[*]每条解锁规则支持多条件、多价格、多货币同时扣费
24+
[*]可与 MatrixShop 对接，承接外部仓库投递
25+
[*]支持 sqlite / mysql / redis / yaml 四种后端
26+
[/list]
27+
28+
[b]Wiki / 相关地址[/b]
29+
30+
[list]
31+
[*]插件文档：[url]https://54895y.github.io/docs/matrixstorage[/url]
32+
[*]项目仓库：[url]https://github.com/54895y/MatrixStorage[/url]
33+
[*]GitHub Releases：[url]https://github.com/54895y/MatrixStorage/releases[/url]
34+
[*]Issue 地址：[url]https://github.com/54895y/MatrixStorage/issues[/url]
35+
[/list]
36+
37+
[b]Skills 使用方法[/b]
38+
39+
如果你希望使用 AI 生成 MatrixStorage 的邮箱、仓库、扩容规则，或同时联动 MatrixLib / MatrixShop 的共享货币配置，可以使用公开的 MatrixAgentSkills：
40+
41+
[list]
42+
[*]Matrix Series Config 文档：[url]https://54895y.github.io/docs/matrix-agent-skills/matrix-series-config[/url]
43+
[*]Codex / OpenAI Skills：
44+
[url]https://github.com/54895y/MatrixAgentSkills/tree/main/matrix-series-config[/url]
45+
[*]Claude / Gemini / Cline / Roo / Continue 通用 Prompt：
46+
[url]https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrix-series-config.md[/url]
47+
[*]AIChat 知识库入口：
48+
[url]https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/aichat/matrix-series-config-kb.md[/url]
49+
[/list]
50+
51+
推荐使用方式：
52+
53+
[list=1]
54+
[*]把对应的 Skill 或 Prompt 链接发给你的 AI Agent
55+
[*]说明你要生成 MatrixStorage 的邮箱、仓库、扩容或实体仓库配置
56+
[*]如果涉及货币结算，可以同时让 Agent 规划 MatrixLib / MatrixShop / MatrixStorage 三端同步的货币配置
57+
[/list]
58+
59+
[b]更新日志[/b]
60+
61+
当前代码基线重点如下：
62+
63+
[list]
64+
[*]当前发布版本已升级到 1.0.1
65+
[*]共享货币定义已统一来自 MatrixLib
66+
[*]新增通过 MatrixLib 共享 API 注册的 bStats 遥测
67+
[*]MatrixLib / MatrixShop / MatrixStorage 三端会同步 Economy/currency.yml
68+
[*]仓库与邮箱支持多条件、多价格、多货币解锁格子
69+
[*]玩家总览页可直接执行容量扩容
70+
[*]支持玩家邮箱、个人仓库、待收区与实体仓库总览
71+
[*]支持 MatrixShop 外部仓库桥接，当前提供 store / openWarehouse / pendingCount 能力
72+
[*]已接入 CraftEngine、ItemsAdder、Nexo 的自定义方块与家具仓库
73+
[*]支持 sqlite / mysql / redis / yaml 四后端
74+
[/list]
75+
76+
[b]bStats 图表[/b]
77+
78+
[list]
79+
[*]Plugin ID：30559
80+
[*]storage_backend：当前仓储状态后端
81+
[*]matrixshop_bridge：MatrixShop 桥接是否就绪
82+
[*]warehouse_definition_count：仓库定义数量
83+
[*]mailbox_count：邮箱消息数量
84+
[*]block_warehouse_count：实体仓库数量
85+
[*]warehouse_definition_sources：仓库定义来源分布
86+
[/list]
87+
88+
[b]预留图表位[/b]
89+
90+
[list]
91+
[*]unlock_rule_count
92+
[*]placement_mode_distribution
93+
[*]pending_delivery_target
94+
[/list]
95+
96+
[b]GitHub Issue 提交问题[/b]
97+
98+
[list]
99+
[*]项目地址：[url]https://github.com/54895y/MatrixStorage[/url]
100+
[*]Issue 地址：[url]https://github.com/54895y/MatrixStorage/issues[/url]
101+
[/list]
102+
103+
如果你在使用过程中遇到以下问题，欢迎直接提交 Issue：
104+
105+
[list]
106+
[*]邮箱收发异常
107+
[*]仓库内容异常或丢失
108+
[*]扩容规则配置问题
109+
[*]实体仓库交互异常
110+
[*]MatrixShop 桥接问题
111+
[*]自定义方块插件兼容问题
112+
[*]新功能建议
113+
[/list]
114+
115+
提交 Issue 时建议附带以下信息：
116+
117+
[list]
118+
[*]服务端核心与版本
119+
[*]MatrixStorage 版本
120+
[*]MatrixLib 版本
121+
[*]是否安装 MatrixShop / CraftEngine / ItemsAdder / Nexo
122+
[*]控制台报错日志
123+
[*]相关配置文件片段
124+
[*]复现步骤
125+
[/list]
126+
127+
[hr]
128+
[right][size=2][color=red]VibeCoding 声明：本插件在开发过程中使用了 AI / Vibe Coding 作为辅助工具，但实际功能收敛、配置结构、兼容性边界与发布内容仍以仓库代码、文档和实机测试结果为准；如发现问题，请优先通过 GitHub Issues 提交反馈。[/color][/size][/right]

‎RELEASE_POST_MINEBBS_BBCODE.txt‎

Lines changed: 157 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,157 @@
1+
[center][size=7][b]MatrixStorage[/b][/size][/center]
2+
[center][size=4][color=#3D8BFF]Matrix 系列统一仓储插件 / 储存库插件[/color][/size][/center]
3+
[center][color=#999999]邮箱 / 仓库 / 待收区 / 实体仓库 / MatrixShop 外部投递[/color][/center]
4+
[center][color=#999999]当前发布版本：1.0.1[/color][/center]
5+
6+
[hr]
7+
8+
[table]
9+
[tr]
10+
[td][b]插件定位[/b][/td]
11+
[td]Matrix 系列统一仓储与储存库插件[/td]
12+
[/tr]
13+
[tr]
14+
[td][b]必需前置[/b][/td]
15+
[td]MatrixLib[/td]
16+
[/tr]
17+
[tr]
18+
[td][b]可选集成[/b][/td]
19+
[td]MatrixShop / Vault / CraftEngine / ItemsAdder / Nexo[/td]
20+
[/tr]
21+
[tr]
22+
[td][b]后端支持[/b][/td]
23+
[td]sqlite / mysql / redis / yaml[/td]
24+
[/tr]
25+
[/table]
26+
27+
[quote]
28+
MatrixStorage 围绕玩家邮箱、个人仓库、待收区、位置型实体仓库和外部仓库投递工作，当前已接入原版方块仓库，以及 CraftEngine、ItemsAdder、Nexo 的自定义方块与家具仓库，同时支持与 MatrixShop 对接。
29+
[/quote]
30+
31+
[size=5][b][color=#3D8BFF]一、插件大概功能[/color][/b][/size]
32+
33+
[list]
34+
[*][b]邮箱系统[/b]
35+
支持玩家互寄与系统邮件，当前附件支持文本、主手物品和 Vault 金额
36+
[*][b]个人仓库与待收区[/b]
37+
支持总览中心统一打开个人仓库、待收区和邮箱入口
38+
[*][b]容量扩容[/b]
39+
仓库与邮箱支持格子解锁，且每条规则支持多条件、多价格、多货币同时扣费
40+
[*][b]实体仓库[/b]
41+
支持 location 型坐标仓库记录与设置页管理
42+
[*][b]原版与自定义方块接入[/b]
43+
支持原版方块、CraftEngine、ItemsAdder、Nexo 的自定义方块与家具仓库
44+
[*][b]MatrixShop 桥接[/b]
45+
支持 MatrixShop 外部仓库投递，可直接写入待收区或打开目标仓库
46+
[*][b]多后端存储[/b]
47+
支持 sqlite / mysql / redis / yaml 四后端
48+
[/list]
49+
50+
[size=5][b][color=#3D8BFF]二、Wiki 与相关地址[/color][/b][/size]
51+
52+
[list]
53+
[*][b]插件文档[/b]
54+
[url]https://54895y.github.io/docs/matrixstorage[/url]
55+
[*][b]项目仓库[/b]
56+
[url]https://github.com/54895y/MatrixStorage[/url]
57+
[*][b]GitHub Releases[/b]
58+
[url]https://github.com/54895y/MatrixStorage/releases[/url]
59+
[*][b]Issue 地址[/b]
60+
[url]https://github.com/54895y/MatrixStorage/issues[/url]
61+
[/list]
62+
63+
[size=5][b][color=#3D8BFF]三、Skills 使用方法[/color][/b][/size]
64+
65+
如果你希望用 AI 生成 MatrixStorage 的邮箱、仓库、扩容规则，或同时联动 MatrixLib / MatrixShop 的共享货币配置，可以直接使用公开的 [b]MatrixAgentSkills[/b]。
66+
67+
[list]
68+
[*][b]Matrix Series Config 文档[/b]
69+
[url]https://54895y.github.io/docs/matrix-agent-skills/matrix-series-config[/url]
70+
[*][b]Codex / OpenAI Skills[/b]
71+
[url]https://github.com/54895y/MatrixAgentSkills/tree/main/matrix-series-config[/url]
72+
[*][b]Claude / Gemini / Cline / Roo / Continue 通用 Prompt[/b]
73+
[url]https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/portable/matrix-series-config.md[/url]
74+
[*][b]AIChat 知识库入口[/b]
75+
[url]https://raw.githubusercontent.com/54895y/MatrixAgentSkills/main/aichat/matrix-series-config-kb.md[/url]
76+
[/list]
77+
78+
[b]推荐用法：[/b]
79+
80+
[list=1]
81+
[*]把上面的 Skill 或 Prompt 链接发给你的 AI Agent
82+
[*]告诉它你要生成 MatrixStorage 的邮箱、仓库、扩容或实体仓库配置
83+
[*]如果涉及货币结算，可以直接让 Agent 同时规划 MatrixLib / MatrixShop / MatrixStorage 三端同步货币配置
84+
[/list]
85+
86+
[size=5][b][color=#3D8BFF]四、更新日志[/color][/b][/size]
87+
88+
[b]当前代码基线重点：[/b]
89+
90+
[list]
91+
[*]当前发布版本已升级到 1.0.1
92+
[*]共享货币定义已统一来自 MatrixLib
93+
[*]新增通过 MatrixLib 共享 API 注册的 bStats 遥测
94+
[*]MatrixLib / MatrixShop / MatrixStorage 三端会同步 Economy/currency.yml
95+
[*]仓库与邮箱支持多条件、多价格、多货币解锁格子
96+
[*]玩家总览页可直接执行容量扩容
97+
[*]支持玩家邮箱、个人仓库、待收区与实体仓库总览
98+
[*]支持 MatrixShop 外部仓库桥接，当前提供 store / openWarehouse / pendingCount 能力
99+
[*]已接入 CraftEngine、ItemsAdder、Nexo 的自定义方块与家具仓库
100+
[*]支持 sqlite / mysql / redis / yaml 四后端
101+
[/list]
102+
103+
[size=5][b][color=#3D8BFF]五、bStats 图表[/color][/b][/size]
104+
105+
[list]
106+
[*]Plugin ID：30559
107+
[*]storage_backend：当前仓储状态后端
108+
[*]matrixshop_bridge：MatrixShop 桥接是否就绪
109+
[*]warehouse_definition_count：仓库定义数量
110+
[*]mailbox_count：邮箱消息数量
111+
[*]block_warehouse_count：实体仓库数量
112+
[*]warehouse_definition_sources：仓库定义来源分布
113+
[/list]
114+
115+
[b]预留图表位：[/b]
116+
117+
[list]
118+
[*]unlock_rule_count
119+
[*]placement_mode_distribution
120+
[*]pending_delivery_target
121+
[/list]
122+
123+
[size=5][b][color=#3D8BFF]六、GitHub Issue 提交问题[/color][/b][/size]
124+
125+
项目地址：
126+
[url]https://github.com/54895y/MatrixStorage[/url]
127+
128+
Issue 地址：
129+
[url]https://github.com/54895y/MatrixStorage/issues[/url]
130+
131+
如果你在使用过程中遇到以下问题，欢迎直接提交 Issue：
132+
133+
[list]
134+
[*]邮箱收发异常
135+
[*]仓库内容异常或丢失
136+
[*]扩容规则配置问题
137+
[*]实体仓库交互异常
138+
[*]MatrixShop 桥接问题
139+
[*]自定义方块插件兼容问题
140+
[*]新功能建议
141+
[/list]
142+
143+
[b]提交 Issue 时建议附带：[/b]
144+
145+
[list]
146+
[*]服务端核心与版本
147+
[*]MatrixStorage 版本
148+
[*]MatrixLib 版本
149+
[*]是否安装 MatrixShop / CraftEngine / ItemsAdder / Nexo
150+
[*]控制台报错日志
151+
[*]相关配置文件片段
152+
[*]复现步骤
153+
[/list]
154+
155+
[hr]
156+
[center][color=#999999]如果你正在找一个能统一邮箱、仓库、待收区和实体仓库体验的储存库插件，可以试试 MatrixStorage。[/color][/center]
157+
[right][size=2][color=red]VibeCoding 声明：本插件在开发过程中使用了 AI / Vibe Coding 作为辅助工具，但实际功能收敛、配置结构、兼容性边界与发布内容仍以仓库代码、文档和实机测试结果为准；如发现问题，请优先通过 GitHub Issues 提交反馈。[/color][/size][/right]

‎gradle.properties‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
group=com.y54895.matrixstorage
2-
version=1.0.0
3-
matrixlibApiVersion=1.1.0
2+
version=1.0.1
3+
matrixlibApiVersion=1.3.0
44
kotlin.incremental=true
55
kotlin.incremental.java=true
66
kotlin.caching.enabled=true

0 commit comments

Comments
 (0)