Register MatrixStorage for shared updater and bump 1.0.2

Author: 54895y

CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to MatrixStorage will be documented in this file.
 
 The format is based on Keep a Changelog, and this project follows Semantic Versioning for release tags.
 
+## [1.0.2] - 2026-04-05
+
+### Added
+
+- Added MatrixStorage registration into the shared MatrixLib GitHub Releases updater.
+
+### Changed
+
+- Updated MatrixStorage to depend on `MatrixLib 1.4.0`.
+- Documented MatrixLib-managed approval-based auto update flow.
+
+### Validated
+
+- Verified `bash ./gradlew build`.
+
 ## [1.0.1] - 2026-04-05
 
 ### Added

README.md

@@ -4,12 +4,12 @@
 
 | 文档 | Release Notes | Releases | 依赖 |
 | --- | --- | --- | --- |
-| [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) |
+| [Docs](https://54895y.github.io/docs/matrixstorage) | [1.0.2](https://54895y.github.io/docs/matrixstorage/release-notes-1-0-2) | [GitHub Releases](https://github.com/54895y/MatrixStorage/releases) | [MatrixLib 1.4.0](https://github.com/54895y/MatrixLib) |
 
 ## 当前发布
 
-- 当前版本：`1.0.1`
-- 必需前置：`MatrixLib 1.3.0`
+- 当前版本：`1.0.2`
+- 必需前置：`MatrixLib 1.4.0`
 - 后端支持：`sqlite / mysql / redis / yaml`
 - 可选集成：`MatrixShop / Vault / CraftEngine / ItemsAdder / Nexo`
 
@@ -46,9 +46,17 @@
 | `placement_mode_distribution` | 统计 terminal / location 模式分布 |
 | `pending_delivery_target` | 统计待收区 / 邮箱投递分布 |
 
+## 自动更新
+
+MatrixStorage 当前接入 `MatrixLib` 的共享更新器。
+
+- 检查：`/matrixlib update check MatrixStorage`
+- 审批下载：`/matrixlib update approve MatrixStorage`
+- 更新包下载到 `plugins/update/`
+
 ## 文档入口
 
 - [概览](https://54895y.github.io/docs/matrixstorage)
-- [1.0.1 发布说明](https://54895y.github.io/docs/matrixstorage/release-notes-1-0-1)
+- [1.0.2 发布说明](https://54895y.github.io/docs/matrixstorage/release-notes-1-0-2)
 - [bStats 与遥测](https://54895y.github.io/docs/matrixstorage/bstats-and-telemetry)
 - [Matrix 插件总文档入口](https://54895y.github.io/docs/plugins)

RELEASE_POST_BBCODE.txt

@@ -1,6 +1,6 @@
 [center][size=6][b]MatrixStorage[/b][/size][/center]
 [center][size=4]Matrix 系列统一仓储插件 / 储存库插件[/size][/center]
-[center][size=3]当前发布版本：1.0.1[/size][/center]
+[center][size=3]当前发布版本：1.0.2[/size][/center]
 
 [hr]
 
@@ -61,9 +61,10 @@ MatrixStorage 是 Matrix 系列的统一仓储插件，围绕玩家邮箱、个
 当前代码基线重点如下：
 
 [list]
-[*]当前发布版本已升级到 1.0.1
+[*]当前发布版本已升级到 1.0.2
 [*]共享货币定义已统一来自 MatrixLib
 [*]新增通过 MatrixLib 共享 API 注册的 bStats 遥测
+[*]新增通过 MatrixLib 共享更新器参与 GitHub Releases 更新检查与审批下载
 [*]MatrixLib / MatrixShop / MatrixStorage 三端会同步 Economy/currency.yml
 [*]仓库与邮箱支持多条件、多价格、多货币解锁格子
 [*]玩家总览页可直接执行容量扩容

RELEASE_POST_MINEBBS_BBCODE.txt

@@ -1,7 +1,7 @@
 [center][size=7][b]MatrixStorage[/b][/size][/center]
 [center][size=4][color=#3D8BFF]Matrix 系列统一仓储插件 / 储存库插件[/color][/size][/center]
 [center][color=#999999]邮箱 / 仓库 / 待收区 / 实体仓库 / MatrixShop 外部投递[/color][/center]
-[center][color=#999999]当前发布版本：1.0.1[/color][/center]
+[center][color=#999999]当前发布版本：1.0.2[/color][/center]
 
 [hr]
 
@@ -88,9 +88,10 @@ MatrixStorage 围绕玩家邮箱、个人仓库、待收区、位置型实体仓
 [b]当前代码基线重点：[/b]
 
 [list]
-[*]当前发布版本已升级到 1.0.1
+[*]当前发布版本已升级到 1.0.2
 [*]共享货币定义已统一来自 MatrixLib
 [*]新增通过 MatrixLib 共享 API 注册的 bStats 遥测
+[*]新增通过 MatrixLib 共享更新器参与 GitHub Releases 更新检查与审批下载
 [*]MatrixLib / MatrixShop / MatrixStorage 三端会同步 Economy/currency.yml
 [*]仓库与邮箱支持多条件、多价格、多货币解锁格子
 [*]玩家总览页可直接执行容量扩容

gradle.properties

@@ -1,6 +1,6 @@
 group=com.y54895.matrixstorage
-version=1.0.1
-matrixlibApiVersion=1.3.0
+version=1.0.2
+matrixlibApiVersion=1.4.0
 kotlin.incremental=true
 kotlin.incremental.java=true
 kotlin.caching.enabled=true

src/main/kotlin/com/y54895/matrixstorage/MatrixStorage.kt

@@ -2,6 +2,7 @@ package com.y54895.matrixstorage
 
 import com.y54895.matrixlib.api.console.MatrixConsoleFact
 import com.y54895.matrixlib.api.console.MatrixConsoleVisuals
+import com.y54895.matrixlib.api.update.MatrixPluginUpdates
 import com.y54895.matrixstorage.bridge.MatrixShopBridge
 import com.y54895.matrixstorage.command.MatrixStorageCommands
 import com.y54895.matrixstorage.integration.ExternalPlacementSupport
@@ -42,6 +43,14 @@ object MatrixStorage : Plugin() {
             WarehouseService.reload()
             ExternalPlacementSupport.reload()
             MatrixShopBridge.reload()
+            MatrixPluginUpdates.register(
+                plugin = MatrixStoragePlatform.plugin(),
+                displayName = "MatrixStorage",
+                repoOwner = "54895y",
+                repoName = "MatrixStorage",
+                assetNamePattern = "MatrixStorage-.*-all\\.jar",
+                commandHint = "/matrixstorage"
+            )
             runCatching { BStatsMetrics.initialize() }
                 .onFailure {
                     warning("Failed to initialize bStats metrics: ${it.message ?: it.javaClass.simpleName}")