Add shared GitHub release updater and bump 1.4.0

Author: 54895y

CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to MatrixLib will be documented in this file.
 
 The format is based on Keep a Changelog, and this project follows Semantic Versioning for release tags.
 
+## [1.4.0] - 2026-04-05
+
+### Added
+
+- Added shared GitHub Releases updater with admin approval workflow.
+- Added centralized registration for MatrixAuth, MatrixCook, MatrixShop, and MatrixStorage.
+- Added `/matrixlib update ...` commands and updater config resource.
+
+### Changed
+
+- MatrixLib now manages Matrix-series update checks and downloads to `plugins/update/`.
+- Updated docs and README to explain the approval-based update flow.
+
+### Validated
+
+- Verified `bash ./gradlew build`.
+- Verified downstream builds for MatrixAuth, MatrixCook, MatrixShop, and MatrixStorage against `matrixlibApiVersion=1.4.0`.
+
 ## [1.3.0] - 2026-04-05
 
 ### Added

README.md

@@ -7,12 +7,12 @@
 
 | 文档 | Release Notes | Releases | Issues |
 | --- | --- | --- | --- |
-| [Docs](https://54895y.github.io/docs/matrixlib) | [1.3.0](https://54895y.github.io/docs/matrixlib/release-notes-1-3-0) | [GitHub Releases](https://github.com/54895y/MatrixLib/releases) | [GitHub Issues](https://github.com/54895y/MatrixLib/issues) |
+| [Docs](https://54895y.github.io/docs/matrixlib) | [1.4.0](https://54895y.github.io/docs/matrixlib/release-notes-1-4-0) | [GitHub Releases](https://github.com/54895y/MatrixLib/releases) | [GitHub Issues](https://github.com/54895y/MatrixLib/issues) |
 
 ## 当前发布
 
-- 当前版本：`1.3.0`
-- 依赖坐标：`com.y54895.matrixlib:matrixlib-api:1.3.0`
+- 当前版本：`1.4.0`
+- 依赖坐标：`com.y54895.matrixlib:matrixlib-api:1.4.0`
 - 服务对象：`MatrixShop / MatrixAuth / MatrixCook / MatrixStorage`
 - 支持核心：`Paper / Bukkit / Spigot / Folia`
 
@@ -25,19 +25,48 @@
 - 共享 Bukkit / Folia 兼容桥接
 - 共享 `bStats` 封装 API `MatrixBStats`
 - 为下游插件统一承接 `bStats` shaded 依赖与图表注册
+- 共享 GitHub Releases 更新检查、审批下载与 `plugins/update/` 投递
 
 ## 下游集成
 
 下游项目当前统一引用：
 
 ```kotlin
 dependencies {
-    compileOnly("com.y54895.matrixlib:matrixlib-api:1.3.0")
+    compileOnly("com.y54895.matrixlib:matrixlib-api:1.4.0")
 }
 ```
 
 如果工作区里存在本地 `MatrixLib` 目录，下游项目会通过 `includeBuild` 直接链接源码；否则会通过 GitHub `sourceControl` 拉取。
 
+## 自动更新
+
+当前推荐方案：
+
+- 用 GitHub Releases latest API 检查新版本
+- 默认只提示，不直接覆盖当前运行中的 jar
+- 由管理员审批后下载到 `plugins/update/`
+- 服务器重启后由 Bukkit / Spigot 更新目录机制自动替换
+
+配置文件：
+
+```text
+plugins/MatrixLib/Update/config.yml
+```
+
+管理命令：
+
+```text
+/matrixlib update list
+/matrixlib update check [all|插件名]
+/matrixlib update notes <插件名>
+/matrixlib update approve <插件名|all>
+```
+
+默认启用审批模式：
+
+- `require-approval: true`
+
 ## bStats 遥测
 
 - Plugin ID: `30557`

RELEASE_POST_BBCODE.txt

@@ -1,6 +1,6 @@
 [center][size=6][b]MatrixLib[/b][/size][/center]
 [center][size=4]Matrix 系列统一前置插件 / 共享运行时基础层[/size][/center]
-[center][size=3]当前发布版本：1.3.0[/size][/center]
+[center][size=3]当前发布版本：1.4.0[/size][/center]
 
 [hr]
 
@@ -61,9 +61,10 @@ MatrixLib 是 Matrix 系列插件的共享前置插件，用于统一品牌风
 当前源码主线版本重点如下：
 
 [list]
-[*]当前发布版本已升级到 1.3.0
+[*]当前发布版本已升级到 1.4.0
 [*]共享 economy API 已正式收敛到 MatrixLib
 [*]新增共享 MatrixBStats API，统一承接 Matrix 系列插件的 bStats 遥测注册
+[*]新增共享 GitHub Releases 更新器，支持管理员审批下载到 plugins/update
 [*]plugins/MatrixLib/Economy/currency.yml 成为 Matrix 系列货币定义主入口
 [*]运行时会同步货币文件到 MatrixShop 与 MatrixStorage
 [*]共享 runtime text / console 能力已经稳定承载下游插件

RELEASE_POST_MINEBBS_BBCODE.txt

@@ -1,7 +1,7 @@
 [center][size=7][b]MatrixLib[/b][/size][/center]
 [center][size=4][color=#3D8BFF]Matrix 系列统一前置插件 / 共享运行时基础层[/color][/size][/center]
 [center][color=#999999]适用于 MatrixShop / MatrixStorage / MatrixAuth / MatrixCook[/color][/center]
-[center][color=#999999]当前发布版本：1.3.0[/color][/center]
+[center][color=#999999]当前发布版本：1.4.0[/color][/center]
 
 [hr]
 
@@ -88,9 +88,10 @@ MatrixLib 是 Matrix 系列插件的共享前置插件，用于统一品牌风
 [b]当前源码主线重点：[/b]
 
 [list]
-[*]当前发布版本已升级到 1.3.0
+[*]当前发布版本已升级到 1.4.0
 [*]共享 economy API 已正式收敛到 MatrixLib
 [*]新增共享 MatrixBStats API，统一承接 Matrix 系列插件的 bStats 遥测注册
+[*]新增共享 GitHub Releases 更新器，支持管理员审批下载到 plugins/update
 [*]plugins/MatrixLib/Economy/currency.yml 成为 Matrix 系列货币定义主入口
 [*]运行时会同步货币文件到 MatrixShop 与 MatrixStorage
 [*]共享 runtime text / console 能力已经稳定承载下游插件

build.gradle.kts

@@ -26,6 +26,7 @@ taboolib {
         coroutines = "1.8.1"
     }
     relocate("org.bstats", "${project.group}.libs.bstats")
+    relocate("com.google.gson", "${project.group}.libs.gson")
 }
 
 repositories {
@@ -35,6 +36,7 @@ repositories {
 
 dependencies {
     taboo("org.bstats:bstats-bukkit:3.2.1")
+    taboo("com.google.code.gson:gson:2.11.0")
     compileOnly("org.spigotmc:spigot-api:1.12.2-R0.1-SNAPSHOT")
     compileOnly(kotlin("stdlib"))
     compileOnly(fileTree("libs") {

gradle.properties

@@ -1,5 +1,5 @@
 group=com.y54895.matrixlib
-version=1.3.0
+version=1.4.0
 kotlin.incremental=true
 kotlin.incremental.java=true
 kotlin.caching.enabled=true

src/main/kotlin/com/y54895/matrixlib/MatrixLib.kt

@@ -4,10 +4,13 @@ import com.y54895.matrixlib.api.brand.MatrixBranding
 import com.y54895.matrixlib.api.console.MatrixConsoleFact
 import com.y54895.matrixlib.api.console.MatrixConsoleVisuals
 import com.y54895.matrixlib.api.economy.MatrixEconomy
+import com.y54895.matrixlib.api.update.MatrixPluginUpdates
+import com.y54895.matrixlib.command.MatrixLibCommands
 import com.y54895.matrixlib.metrics.BStatsMetrics
 import taboolib.common.platform.Plugin
 import taboolib.common.platform.function.pluginVersion
 import taboolib.common.platform.function.warning
+import taboolib.platform.BukkitPlugin
 
 object MatrixLib : Plugin() {
 
@@ -30,6 +33,16 @@ object MatrixLib : Plugin() {
 
     override fun onEnable() {
         MatrixEconomy.reload()
+        MatrixPluginUpdates.bootstrap(branding)
+        MatrixLibCommands.register()
+        MatrixPluginUpdates.register(
+            plugin = BukkitPlugin.getInstance(),
+            displayName = "MatrixLib",
+            repoOwner = "54895y",
+            repoName = "MatrixLib",
+            assetNamePattern = "MatrixLib-.*\\.jar",
+            commandHint = "/matrixlib"
+        )
         runCatching { BStatsMetrics.initialize() }
             .onFailure {
                 warning("Failed to initialize bStats metrics: ${it.message ?: it.javaClass.simpleName}")
@@ -40,6 +53,7 @@ object MatrixLib : Plugin() {
             details = listOf(
                 MatrixConsoleFact("共享接口", "action / menu / compat / text / yaml / console / economy"),
                 MatrixConsoleFact("货币提供者", MatrixEconomy.providerSummary()),
+                MatrixConsoleFact("更新器", "GitHub Releases / 审批下载 / plugins/update"),
                 MatrixConsoleFact("运行状态", "控制台品牌 / 资源桥接 / 通用适配")
             )
         )