Add shared Matrix economy module

Author: 54895y

README.md

@@ -5,28 +5,44 @@
 
 **Keywords:** Minecraft plugin library, Paper plugin library, Folia plugin library, Bukkit plugin API, Spigot plugin API, TabooLib, Kotlin plugin library, GUI framework, shared runtime, Matrix plugin framework
 
-MatrixLib is a shared Minecraft plugin runtime and dependency library for MatrixShop, MatrixAuth and MatrixCook. It targets Paper, Bukkit, Spigot and Folia servers, and provides shared branding, console, menu, YAML, compat and action APIs.
+`MatrixLib` 是 Matrix 系列插件的共享前置插件，用于统一品牌风格、控制台输出、文本能力、YAML 读取、兼容层、共享菜单能力和共享货币模块。
+
+MatrixLib is a shared Minecraft plugin runtime and dependency library for MatrixShop, MatrixAuth, MatrixCook and MatrixStorage. It targets Paper, Bukkit, Spigot and Folia servers, and provides shared branding, console, menu, YAML, compat, action and economy APIs.
 
 **中文关键词：** Minecraft 插件前置, Paper 插件前置, Folia 插件前置, Bukkit 插件 API, Spigot 插件 API, TabooLib 前置, Kotlin 插件库, GUI 菜单框架, 共享运行时, Matrix 插件框架
 
 ## Discoverability
 
 - English: Minecraft plugin library, Paper plugin framework, Folia plugin framework, Bukkit shared runtime, TabooLib shared API, Kotlin Minecraft library
-- 中文: Minecraft 插件前置, 服务器插件前置, 中文控制台前置, 共享菜单前置, 兼容层前置, GUI 菜单前置
+- 中文: Minecraft 插件前置, 服务器插件前置, 中文控制台前置, 共享菜单前置, 兼容层前置, GUI 菜单前置, 共享货币前置
 
 ## What MatrixLib Provides
 
 - Shared `branding / console / text / yaml` APIs
-- Shared `menu / compat / action` APIs
+- Shared `menu / compat / action / economy` APIs
 - Unified Chinese terminal banner and lifecycle output
 - Shared Bukkit / Folia compatibility bridge
-- Shared runtime for MatrixShop, MatrixAuth and MatrixCook
+- Shared runtime for MatrixShop, MatrixAuth, MatrixCook and MatrixStorage
+- Shared `Economy/currency.yml` with runtime synchronization to MatrixShop and MatrixStorage
+
+## Current Focus
+
+- Shared `economy` API is now part of MatrixLib
+- `plugins/MatrixLib/Economy/currency.yml` is the source of truth for Matrix series currency definitions
+- Runtime sync targets:
+  - `plugins/MatrixLib/Economy/currency.yml`
+  - `plugins/MatrixShop/Economy/currency.yml`
+  - `plugins/MatrixStorage/Economy/currency.yml`
+- Supported shared currency backends:
+  - `Vault`
+  - `PlayerPoints`
+  - PlaceholderAPI-driven custom currencies
 
 ## Downstream Build Integration
 
 Dependency coordinate:
 
-- `com.y54895.matrixlib:matrixlib-api:1.0.1`
+- `com.y54895.matrixlib:matrixlib-api:1.1.0`
 
 Downstream projects support two build modes:
 
@@ -49,11 +65,11 @@ sourceControl {
 
 ## Current Public Release
 
-- First public release: `1.0.1`
+- `1.1.0`
 
 ## Links
 
 - GitHub Repo: [https://github.com/54895y/MatrixLib](https://github.com/54895y/MatrixLib)
 - Issues: [https://github.com/54895y/MatrixLib/issues](https://github.com/54895y/MatrixLib/issues)
 - Releases: [https://github.com/54895y/MatrixLib/releases](https://github.com/54895y/MatrixLib/releases)
-- Related docs: `MatrixDevDocs`
+- Related docs: [https://54895y.github.io/docs/plugins](https://54895y.github.io/docs/plugins)

gradle.properties

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

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

@@ -3,6 +3,7 @@ package com.y54895.matrixlib
 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 taboolib.common.platform.Plugin
 import taboolib.common.platform.function.pluginVersion
 
@@ -19,18 +20,20 @@ object MatrixLib : Plugin() {
             branding = branding,
             headline = "正在装载共享接口与运行时桥接",
             details = listOf(
-                MatrixConsoleFact("导出接口", "action / menu / compat / text / yaml / console"),
+                MatrixConsoleFact("导出接口", "action / menu / compat / text / yaml / console / economy"),
                 MatrixConsoleFact("服务对象", "MatrixShop / MatrixAuth / MatrixCook")
             )
         )
     }
 
     override fun onEnable() {
+        MatrixEconomy.reload()
         MatrixConsoleVisuals.renderReady(
             branding = branding,
             version = pluginVersion,
             details = listOf(
-                MatrixConsoleFact("共享接口", "action / menu / compat / text / yaml / console"),
+                MatrixConsoleFact("共享接口", "action / menu / compat / text / yaml / console / economy"),
+                MatrixConsoleFact("货币提供者", MatrixEconomy.providerSummary()),
                 MatrixConsoleFact("运行状态", "控制台品牌 / 资源桥接 / 通用适配")
             )
         )