跳到主要内容

MatrixShop 1.5.0 发布说明

发布时间：2026-04-03

版本定位​

1.5.0 是围绕经济结算链的一次功能版本更新。

这一版把税率系统从少数模块的固定值，扩展成了跨模块统一的“条件税规则”。

本版本重点​

多模块条件税系统​

以下模块现在支持条件税配置：

  • PlayerShop
  • GlobalMarket
  • Auction
  • Transaction
  • ChestShop

税规则结构​

当前税配置支持：

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

验证结果为：插件可正常启动，未出现新的税规则相关启动错误。

相关链接​