更新日志

0.0.1

当前版本（先行版）

核心系统

• 宝石镶嵌：把宝石镶到装备上获得属性、附魔、常驻 BUFF 与主动技能
• 三种宝石类型：镶嵌类（默认）、PlayerGem（右键直接生效）、RandomGem（开箱抽奖）
• 奖励函数体系：Attribute Enchant LoreAdd LoreVar Conditional 等，支持表达式与叠加上限
• 技能引擎：绑定装备 lore 文本触发，支持触发标记、条件、概率、延迟、重复与形态切换
• 常驻 BUFF 引擎：每秒扫描装备 lore 标记施加效果
• 自定义工作台菜单：字符网格布局，五种槽位类型
• 内置宝石镶嵌台 /sgem embed

查看与拆卸

• /sgem inspect 只读查看装备上已镶嵌的宝石
• /sgem dismantle 拆卸宝石，可配置费用（金币/点券/经验）与损坏概率
• 拆卸时真正撤销属性修饰符与附魔等级，而非仅跑 $onRemove
• 镶嵌属性宝石前先固化装备原生属性，避免护甲/韧性等自带属性消失

多版本兼容

• 支持 1.21.4 → 26.x，同一份配置跨版本通用
• 启动时读服务端注册表建快照，不按版本号硬编码
• 七个可开关的版本功能模块（Mace Spear CopperEquipment 等），默认 auto
• 1.21.11 矛（七种材质）与其专属附魔「突进」lunge 的完整支持
• 旧名兼容：DURABILITY、GENERIC_MAX_HEALTH 等老配置无需修改
• /sgem compat 版本能力报告与配置自检，区分「版本不支持」与「写错了」

权限

• 13 个细粒度权限节点，两个伞节点 snowygems.user（默认所有人）与 snowygems.admin（默认 OP）

版本更新与公告

• 服务器启动完成后异步检测一次，本地版本与官方不一致即提示
• 公告拉取，控制台与管理员上线时展示
• 遵循 JVM 系统代理，可完全关闭

经济对接

• 金币走 Vault，点券支持内置账户或 PlayerPoints
• 兑换券类宝石发放后主动告知玩家获得数额

排错

• 20 个 debug tag，可按范围过滤日志
• 全部玩家可见文案集中在 lang.yml（134 个节点），热重载生效

版本记录约定

发布新版本时，在上方按这个格式追加：

## 0.1.0

**新增**
- 我是功能

**修复**
- 我是问题

**配置变动**
- 我是变动

**破坏性变更**
- 我是变更