Add MatrixShop 1.5.0 tax docs

Author: 54895y

docs/matrixshop/configuration/bstats-and-telemetry.mdx

@@ -76,7 +76,7 @@ enabled: false
 源码构建后，MatrixShop 当前会输出带重定位 bStats 的运行产物：
 
 ```text
-build/libs/MatrixShop-1.4.0-all.jar
+build/libs/MatrixShop-1.5.0-all.jar
 ```
 
 `org.bstats` 已被重定位到插件私有包名下，避免和其他同样使用 bStats 的插件产生类冲突。

docs/matrixshop/getting-started/quick-start.mdx

@@ -21,6 +21,7 @@ sidebar_position: 1
 
 如果你正在从 `1.0.0` 升级，请先阅读：
 
+- [1.5.0 发布说明](./release-notes-1-5-0)
 - [1.4.0 发布说明](./release-notes-1-4-0)
 - [1.3.0 发布说明](./release-notes-1-3-0)
 - [1.2.0 发布说明](./release-notes-1-2-0)

docs/matrixshop/index.mdx

@@ -10,7 +10,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 当前最新版本入口：
 
-- [1.4.0 发布说明](./release-notes-1-4-0)
+- [1.5.0 发布说明](./release-notes-1-5-0)
 - [更新日志总览](./release-notes)
 
 ## 当前版本状态
@@ -69,7 +69,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 如果你第一次接触 MatrixShop，推荐顺序是：
 
 1. [快速开始](./quick-start)
-2. [1.4.0 发布说明](./release-notes-1-4-0)
+2. [1.5.0 发布说明](./release-notes-1-5-0)
 3. [配置结构](./configuration-structure)
 4. [经济模块](./economy)
 5. [命令与权限](./commands-and-permissions)
@@ -105,6 +105,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 ### 更新日志
 
+- [1.5.0 发布说明](./release-notes-1-5-0)
 - [1.4.0 发布说明](./release-notes-1-4-0)
 - [1.3.0 发布说明](./release-notes-1-3-0)
 - [1.2.0 发布说明](./release-notes-1-2-0)
@@ -121,6 +122,7 @@ MatrixShop 是面向生存、经济和市场场景的模块化交易插件。当
 
 如果你是从 `1.0.0` 升级，请先看：
 
+- [1.5.0 发布说明](./release-notes-1-5-0)
 - [1.4.0 发布说明](./release-notes-1-4-0)
 - [1.3.0 发布说明](./release-notes-1-3-0)
 - [1.2.0 发布说明](./release-notes-1-2-0)

docs/matrixshop/modules/interaction-modules.mdx

@@ -42,6 +42,7 @@ sidebar_position: 3
 - `Entry.Open-GUI-On`
 - `Entry.Direct-Trade-On`
 - `Stock.Double-Chest-Mode`
+- `Trade.Tax`
 
 ### 常用命令
 
@@ -74,6 +75,7 @@ sidebar_position: 3
 - `Options.Session.Max-Distance`
 - `Options.Session.Same-World-Only`
 - `Options.Trade.Allow-Items / Allow-Money / Allow-Exp`
+- `Options.Trade.Tax`
 
 ### 常用命令
 

docs/matrixshop/modules/player-economy-modules.mdx

@@ -27,6 +27,7 @@ sidebar_position: 2
 - `Search.enable`
 - `Search.condition`
 - `Currency.Key`
+- `Listing.Tax`
 
 默认情况下，`PlayerShop` 的货币 key 优先级是：
 
@@ -59,7 +60,7 @@ sidebar_position: 2
 `GlobalMarket/settings.yml` 当前默认使用：
 
 - `Listing.Expire-Hours`
-- `Listing.Tax-Percent`
+- `Listing.Tax`
 - `Currency.Key`
 
 `GlobalMarket` 的货币 key 优先级是：
@@ -110,6 +111,7 @@ sidebar_position: 2
 - 荷式拍卖
 - 一口价 / 终价
 - 押金与税
+- 条件税规则与 Kether 判断
 - 抢拍保护
 - 主人取消限制
 

docs/matrixshop/release-notes/index.mdx

@@ -11,14 +11,16 @@ sidebar_position: 0
 
 如果你准备升级，建议按从新到旧的顺序阅读：
 
-1. [1.4.0 发布说明](./release-notes-1-4-0)
-2. [1.3.0 发布说明](./release-notes-1-3-0)
-3. [1.2.0 发布说明](./release-notes-1-2-0)
-4. [1.1.1 发布说明](./release-notes-1-1-1)
-5. [1.1.0 发布说明](./release-notes-1-1-0)
+1. [1.5.0 发布说明](./release-notes-1-5-0)
+2. [1.4.0 发布说明](./release-notes-1-4-0)
+3. [1.3.0 发布说明](./release-notes-1-3-0)
+4. [1.2.0 发布说明](./release-notes-1-2-0)
+5. [1.1.1 发布说明](./release-notes-1-1-1)
+6. [1.1.0 发布说明](./release-notes-1-1-0)
 
 ## 阅读建议
 
-- 想看当前最新功能和验证结果：先看 [1.4.0 发布说明](./release-notes-1-4-0)
+- 想看当前最新功能和验证结果：先看 [1.5.0 发布说明](./release-notes-1-5-0)
+- 想看多模块条件税系统：看 [1.5.0 发布说明](./release-notes-1-5-0)
 - 想看 `SystemShop` 折扣系统、价格对象和购物车锁价行为：看 [1.4.0 发布说明](./release-notes-1-4-0)
 - 想回看 `1.1.x` 的收口和修复：看 [1.1.1](./release-notes-1-1-1) 与 [1.1.0](./release-notes-1-1-0)

docs/matrixshop/release-notes/release-notes-1-5-0.mdx

@@ -0,0 +1,115 @@
+---
+title: 1.5.0 发布说明
+description: MatrixShop 1.5.0 的多模块条件税系统、测试结果与升级说明。
+slug: /matrixshop/release-notes-1-5-0
+sidebar_position: 1
+---
+
+# MatrixShop 1.5.0 发布说明
+
+发布时间：`2026-04-03`
+
+## 版本定位
+
+`1.5.0` 是围绕经济结算链的一次功能版本更新。
+
+这一版把税率系统从少数模块的固定值，扩展成了跨模块统一的“条件税规则”。
+
+## 本版本重点
+
+### 多模块条件税系统
+
+以下模块现在支持条件税配置：
+
+- `PlayerShop`
+- `GlobalMarket`
+- `Auction`
+- `Transaction`
+- `ChestShop`
+
+### 税规则结构
+
+当前税配置支持：
+
+```yaml
+Tax:
+  Enabled: true
+  Mode: percent
+  Value: 3.0
+  Rules:
+    vip:
+      Enabled: true
+      Priority: 100
+      Mode: percent
+      Value: 1.0
+      Condition:
+        - "perm 'group.vip'"
+```
+
+支持字段：
+
+- `Enabled`
+- `Mode`
+- `Value`
+- `Rules.<id>.Enabled`
+- `Rules.<id>.Priority`
+- `Rules.<id>.Mode`
+- `Rules.<id>.Value`
+- `Rules.<id>.Condition`
+
+当前行为：
+
+- 多条税规则按 `Priority` 选择一条命中的规则
+- 命中的规则会覆盖默认税配置
+- `Condition` 使用 Kether
+
+### 各模块落点
+
+- `PlayerShop`
+  - `PlayerShop/settings.yml -> Listing.Tax`
+- `GlobalMarket`
+  - `GlobalMarket/settings.yml -> Listing.Tax`
+  - 兼容旧配置 `Listing.Tax-Percent`
+- `Auction`
+  - `Auction/settings.yml -> Options.Listing.Tax`
+- `Transaction`
+  - `Transaction/settings.yml -> Options.Trade.Tax`
+  - 每个方向的金钱报价分别计算税
+- `ChestShop`
+  - `ChestShop/settings.yml -> Trade.Tax`
+  - 玩家购买时从店主收入中扣税
+  - 玩家出售时从玩家收入中扣税
+
+## 升级说明
+
+这一版不要求你立刻改旧配置。
+
+兼容策略：
+
+- `GlobalMarket` 旧的 `Listing.Tax-Percent` 仍可读取
+- `Auction` 旧的 `Options.Listing.Tax.Enabled / Mode / Value` 继续有效
+- 新条件税规则是在原有税配置上扩展 `Rules`
+
+## 验证
+
+本版本发布前已完成：
+
+- `./gradlew build`
+- docs site `npm run build`
+- `paper-1.21.8` smoke boot
+- `paper-1.21.11` smoke boot
+- 在 `paper-1.21.11` 测试服中，为以下模块写入带 Kether `Condition` 的税规则配置并完成启动验证：
+  - `PlayerShop`
+  - `GlobalMarket`
+  - `Auction`
+  - `Transaction`
+  - `ChestShop`
+
+验证结果为：插件可正常启动，未出现新的税规则相关启动错误。
+
+## 相关链接
+
+- [GitHub Releases](https://github.com/54895y/MatrixShop/releases)
+- [1.5.0 GitHub Release](https://github.com/54895y/MatrixShop/releases/tag/v1.5.0)
+- [CHANGELOG](https://github.com/54895y/MatrixShop/blob/main/CHANGELOG.md)
+- [1.4.0 发布说明](./release-notes-1-4-0)

docs/matrixshop/shop-types/auction.mdx

@@ -66,6 +66,14 @@ Options:
       Enabled: true
       Mode: percent
       Value: 3
+      Rules:
+        vip:
+          Enabled: true
+          Priority: 100
+          Mode: percent
+          Value: 1
+          Condition:
+            - "perm 'group.vip'"
   Snipe-Protection:
     Enabled: true
     Trigger-Seconds: 30
@@ -134,6 +142,7 @@ Options:
 | `Tax.Enabled` | 是否启用交易税。 |
 | `Tax.Mode` | 税率模式。 |
 | `Tax.Value` | 税值。 |
+| `Tax.Rules.*` | 条件税规则，命中后覆盖默认税配置。 |
 | `Snipe-Protection.Enabled` | 是否启用尾秒保护。 |
 | `Trigger-Seconds` | 剩余时间少于多少秒时触发保护。 |
 | `Extend-Seconds` | 每次触发后延长多少秒。 |
@@ -142,6 +151,14 @@ Options:
 | `Cancel.Owner.Deny-If-Has-Bid` | 已有人出价时是否禁止取消。 |
 | `Record.Write-On-*` | 各类行为是否写入记录系统。 |
 
+`Tax.Rules.*` 当前支持：
+
+- `Enabled`
+- `Priority`
+- `Mode`
+- `Value`
+- `Condition`
+
 ## `Auction/shops/default.yml`
 
 ```yaml

docs/matrixshop/shop-types/chest-shop.mdx

@@ -41,6 +41,11 @@ Entry:
   Direct-Trade-On: []
 Stock:
   Double-Chest-Mode: expand_only
+Trade:
+  Tax:
+    Enabled: false
+    Mode: percent
+    Value: 3.0
 Currency:
   Key: vault
 ```
@@ -57,6 +62,7 @@ Currency:
 | `Entry.Open-GUI-On` | 哪些交互动作会直接打开 GUI。 |
 | `Entry.Direct-Trade-On` | 哪些交互动作会走直接交易。默认是空列表。 |
 | `Stock.Double-Chest-Mode` | 双箱库存处理方式，示例是 `expand_only`。 |
+| `Trade.Tax` | 箱子商店税配置。玩家购买时税从店主收入中扣除，玩家出售时税从玩家收入中扣除。 |
 | `Currency.Key` | 箱子商店统一使用的货币 key。 |
 
 ## `ChestShop/signs.yml`

docs/matrixshop/shop-types/global-market.mdx

@@ -34,7 +34,18 @@ Bindings:
 
 Listing:
   Expire-Hours: 72
-  Tax-Percent: 3.0
+  Tax:
+    Enabled: true
+    Mode: percent
+    Value: 3.0
+    Rules:
+      vip:
+        Enabled: true
+        Priority: 100
+        Mode: percent
+        Value: 1.0
+        Condition:
+          - "perm 'group.vip'"
 ```
 
 字段解释：
@@ -47,7 +58,18 @@ Listing:
 | `Priority` | `market`、`gm` 的命令优先级。 |
 | `Condition` | 默认权限节点。 |
 | `Listing.Expire-Hours` | 市场上架物品的默认过期时长。 |
-| `Listing.Tax-Percent` | 市场成交税率。 |
+| `Listing.Tax.Enabled` | 是否启用市场成交税。 |
+| `Listing.Tax.Mode` | 税计算方式，当前支持 `percent` / `fixed`。 |
+| `Listing.Tax.Value` | 默认税值。 |
+| `Listing.Tax.Rules.*` | 条件税规则，按优先级选中一条命中规则。 |
+
+条件税规则支持：
+
+- `Enabled`
+- `Priority`
+- `Mode`
+- `Value`
+- `Condition`
 
 ## `GlobalMarket/shops/default.yml`
 
@@ -134,6 +156,6 @@ icons:
 ## 使用建议
 
 - 想改过期时间：改 `Listing.Expire-Hours`。
-- 想改全服税率：改 `Listing.Tax-Percent`。
+- 想改全服税率：改 `Listing.Tax`。
 - 想隐藏购物车按钮：删掉 `layout` 里的 `C` 并移除 `icons.C`。
 - 想改独立命令：改 `Bindings.Commands.Bindings` 和 `Register`。