MatrixShop v1.4.0

中文

发布日期：2026-04-03

MatrixShop 1.4.0 为 SystemShop 增加了完整的折扣系统，并补齐了价格对象、折扣重叠控制、Kether 条件与购物车锁价行为。

本次更新：

• price 键同时支持旧写法 price: 420 和新写法 price: { base, discounts }
• 折扣规则支持 percent、amount-off、surcharge
• 支持 Kether condition 条件判断
• 新增 whitelist / blacklist，用于控制折扣叠加关系
• 刷新池价格对象会与商品本体折扣规则合并
• 系统商店商品加入购物车时，锁定入车时折后价
• 同步更新 README、CHANGELOG 与文档站 1.4.0 发布说明

验证结果：

• ./gradlew build
• docs site npm run build
• paper-1.21.8 smoke boot 通过
• paper-1.21.11 smoke boot 通过
• paper-1.21.11 已验证可加载包含 VIP / SVIP / MVP 折扣链、blacklist 与 Kether condition 的 inline price 对象配置，且未出现新的 price-config-invalid / discount-condition-failed 启动告警

文档：

• https://54895y.github.io/docs/matrixshop/release-notes-1-4-0

English

Release date: 2026-04-03

MatrixShop 1.4.0 adds a full discount system for SystemShop, including price objects, stacking controls, Kether conditions, and cart price locking behavior.

Highlights:

• The price key now supports both legacy scalar form price: 420 and object form price: { base, discounts }
• Discount rules support percent, amount-off, and surcharge
• Added Kether-based condition evaluation
• Added whitelist / blacklist controls for discount stacking
• Refresh pool price objects now merge with base goods discount rules
• SystemShop cart entries now lock the discounted snapshot price at add-to-cart time
• Updated the README, changelog, and dedicated 1.4.0 docs page

Validation:

• ./gradlew build
• docs site npm run build
• paper-1.21.8 smoke boot passed
• paper-1.21.11 smoke boot passed
• paper-1.21.11 successfully loaded an inline price object using a VIP / SVIP / MVP discount chain with blacklist and Kether condition rules, with no new price-config-invalid or discount-condition-failed startup warnings

Docs:

• https://54895y.github.io/docs/matrixshop/release-notes-1-4-0