鹤造工坊

Appearance

更新日志 ​

更新计划 ​

  • 补充文档
  • 增加轻量级的读取组件读取事件和属性组件处理事件

作者暂时没有时间更新，但仍然活跃。严重 bug 会第一时间修复，信息看到也会回，功能性更新暂时放缓，放心使用

如果你是开发（脚本、插件）者，你可以选择性的阅读更新日志，不懂可以问我

警告

当前处于开发测试阶段，插件可能存在 BUG、功能缺失！

开发版 0.1.x ​

0.1.0-dev 2026/07/28 ​

  • 优化部分代码
  • 将 libs attributes reads expansions 资源文件夹统一收束到 scripts 中
    • 为 config.yml 新增配置 groovy load sort，用于自定义 scripts 文件夹中的加载顺序
  • 增加一套可自定义的 CombatVisualEffect 系统
    • 内置一个 DHEffect.groovy 脚本作为例子，需依赖 DecentHolograms 插件
    • 内置一个 DHEffectManager.groovy，用于管理显示伤害和治疗全息字，可在脚本内启用或关闭显示
  • 为 ATTACK_AND_DEFENSE 属性类型添加 enable damage intensity 配置，用于是否启用伤害强度（蓄力）
  • 为 DamageTracker 增加 multiplyDamage 和 multiplyDamageData 方法，用于快速乘算
  • 为 AttributeSource 增加 metadata 参数
  • 为 AttributeData 中所有操作属性源的方法添加一个可选的回调函数
    • EntityDataManager 同步添加，AttributeAPI 保持不变
  • 将 updateAttribute 方法改为 updateAttributeSource，旨在统一设计
  • 将 updateAttributeAsync 方法改为 updateAttributeSourceAsync，旨在统一设计
  • 将 AttributeData#computeAndAddAttributeSource 改为 Java 友好的方法
  • 将 ListenerUtils#registerListener 改为 Java 友好的方法
  • 新增 extra.yml 配置，用于插件其他扩展功能
  • 新增 ca-source extra-add 命令，用于快速添加 extra.yml 中配置的属性源
  • 新增 ca-bukkit attribute modifier add 命令，用于快速添加 extra.yml 中配置的原版 AttributeModifier
  • 新增 ca-bukkit attribute modifier remove 命令，用于移除原版 AttributeModifier
  • 新增 AbstractAttributeSource 类，旨在简化设计
  • 新增 AbstractAttributeData 类，旨在简化设计
  • 移除 PersistentAttributeSource 调整为 Persistable 接口，且不再继承 AttributeSource，旨在简化设计
  • 移除 ca reload compile-groovy 命令，现在使用 ca reload 命令即可重载并重新编译脚本
    • 重载会自动缓存（和复用）编译后的 Groovy 类文件，加快重载速度
  • 修复查询属性源变量中点击 [点击移除] 无法移除的问题
  • 修复属性 饱食恢复.groovy 在任何恢复事件都会触发的问题
  • 修复通过 BukkitUtils#safeHeal 恢复生命时，无法触发原版 EntityRegainHealthEvent 的问题
  • 优化添加属性源时添加逻辑，现在持续时间小于 100ms 的属性源直接视为无效属性源
  • 优化 attribute.yml 文件中的注释
  • 优化插件在控制台的信息

本次修改内容极多，建议删除全部配置文件重新生成后对照修改。

开发版 0.0.x ​

0.0.11-dev 2026/03/12 ​

  • 重构计数器系统，以及支持数据库
  • 细分 ca 命令为 ca ca-bukkit ca-source ca-counter
  • 为 ca test ... 测试命令添加信息
  • 为 ATTACK_AND_DEFENSE ACCIDENTAL_DAMAGED 添加 cancel damage cause 的配置
  • 新增 REGAIN_HEALTH 属性类型
  • 新增 reads 文件夹
  • 新增自定义 ActionBar 的功能
  • 优化 GroovyManager 对于脚本文件的加载逻辑
  • 修复部分命令无法在控制台使用、目标玩家无效的问题
  • 细分属性源类的接口
  • 优化 AttributeData 的设计，添加更多操作属性源方法
  • 修改资源文件的命名，更符合逻辑
  • 修改部分受影响的资源文件，建议重新生成
    • 建议全部重新生成

0.0.10-dev 2026/01/21 ​

  • 支持 1.21.11 版本
  • 独立读取组件的缓存模块，引入 Caffeine
  • 优化不取消原版伤害时的处理，现在可以在处理器中获取伤害值
  • 添加 2 个属性脚本 体型加成.groovy 攻击范围.groovy
  • 添加属性组件注册事件，读取组件注册事件
  • 添加属性管理器加载、卸载事件，读取管理器加载、卸载事件
  • 添加信息控制器发送信息事件
  • 优化 MythicMobs 生物出生时的属性处理，现在全异步
  • 优化 attribute.yml 下关于触发器的注释信息
  • 补充 stats.yml 中缺少的配置
  • 修复 物理攻击.groovy 中护甲穿透计算写反的问题
  • 修复 stats.yml 中 x 大小写错误的和无法关闭的问题
  • 修复 attribute.yml 中 RUNTIME_AFTER.runtime tick 配置失效的问题
  • 修改部分受影响的资源文件，建议重新生成
    • attribute.yml
    • attributes/attack/物理攻击.groovy
    • libs/AttributeName.groovy
    • gui/stats.yml

0.0.9.2-dev 2025/12/20 ​

  • 为 EntityDataManager AttributeAPI 增加异步操作属性源的方法
  • 属性更新线程改为属性变化线程，支持更多功能
  • 优化物品 NBT 读取，现在支持两种读取方式
  • 增加 CooldownUtils 工具类
  • 增加 CaTaskUtils 工具类
  • 属性源中 shouldOnUpdateRemove 改为 removeTriggers，支持更多场景的移除属性源
  • 计数器中 type 改为 resetTriggers，支持更多场景的重置
  • 为 ACCIDENTAL_DAMAGED 类属性增加触发原因白名单 trigger damage cause 的配置
  • 优化ATTACK_AND_DEFENSE ACCIDENTAL_DAMAGED 类属性的配置 cancel damage cause 的判断逻辑
  • 修复非玩家也会触发 PLAYER_KILL_ENTITY 类属性的问题
  • 优化部分配置的注释
  • 修复生命压缩失效的问题
  • 升级 Kotlin 版本至 2.2.21
  • 修改部分受影响的资源文件，建议重新生成
    • attribute.yml
    • read.yml
    • attributes/attack/*
    • attributes/update/*
    • libs/source/GroovyAttributeSource.groovy

0.0.8.1-dev 2025/12/17 ​

  • 修复部分命令显示错误的问题
  • 修复 ACCIDENTAL_DAMAGED 类属性未正常生效的问题
  • 修复 cancel heart particle: true 在高版本失效的问题
  • 修改 attribute.yml 中自动生成的属性配置的结构
  • 优化部分代码逻辑
  • 修改部分类的包路径，和命名，更规范统一
  • 升级 taboolib 版本至 6.2.4
  • 升级 Kotlin 版本至 2.2.20
  • 修改部分受影响的资源文件，建议重新生成
    • attributes/attack/*
    • attributes/update/*

0.0.7-dev 2025/12/10 ​

  • 添加 AttributeComponent#enable 可以调整是否为服务器开启此属性
  • 添加 MessageTracker 接口，可以在处理器实现简单的信息控制
  • 属性处理器 AttackAndDefenseHandler 实现 MessageTracker 接口
  • 为 ATTACK_AND_DEFENSE 类属性蓄力机制兼容原版弓箭蓄力强度
  • 添加 1 个属性脚本 攻击间隔.groovy，原版 cd 效果，默认关闭（setEnable(false)），可自行决定是否启用该属性
  • 添加属性状态UI（箱子菜单），使用 /ca stats [<player>] 查看，可在 gui/stats.yml 中配置（默认配置目前什么都没有写）
  • 优化命令 /ca source /ca health /ca counter，不加 player 参数时默认为自己查询
  • 修改部分受影响的资源文件，建议重新生成
    • libs/AttributeName.groovy
    • attributes/attack/物理攻击.groovy

0.0.6-dev 2025/12/05 ​

  • 修改 AttributeComponent#run 为 AttributeComponent#onExtHandler 并，移除 function 参数，统一使用 onExtHandler(...) 处理第三方扩展属性类型的属性
  • 添加 AttributeComponent#basicMax AttributeComponent#percentMax 限制最大基本值和最大加成值
  • 修复 AttributeComponent#max 没有为非玩家实体处理的问题
  • 为 ATTACK_AND_DEFENSE 类属性新增蓄力机制（原版攻速效果）
  • 优化 MythicMobs 重载时的生物属性更新逻辑
  • 优化 /ca reload 重载命令，现在默认不再重新编译 Groovy 脚本，以提升重载速度，若修改了 Groovy 脚本内容，需使用 /ca reload compile-groovy 可在重载时一并编译脚本
  • 优化属性数据更新逻辑
  • 优化数据库读写逻辑

0.0.5-dev 2025/11/29 ​

  • 为属性添加最大值（AttributeComponent#max）设定，允许设置一个最大值来限制面板生效的属性值
  • 修改 Attribute JsAttribute 的构造函数（添加 max）
  • 修改部分受影响的资源文件，建议重新生成
    • libs/AttributeName.groovy
    • libs/GroovyAttribute.groovy
    • libs/Utils.groovy

0.0.4-dev 2025/11/28 ​

  • 检测 nbt 使用的标签（read.yml 中 options.nbt tag）改为多个
  • 实装世界限制属性功能（attribute.yml 中 options.limit attribute worlds）
  • 修改部分受影响的资源文件，建议重新生成
    • read.yml
    • attributes/update/实体默认属性.groovy

0.0.3-dev 2025/11/28 ​

  • 支持 MythicMobs，可直接为插件生物配置属性源
  • 修复重载插件后 debug level 跟随配置文件的问题
  • 修改部分受影响的资源文件，建议重新生成
    • libs/AttributeName.groovy
    • expansions/CommandTest.groovy
    • attributes/update/玩家默认属性.groovy
    • attributes/update/默认属性.groovy

0.0.2-dev 2025/11/22 ​

  • 优化部分代码

0.0.1-dev 2025/11/22 ​

  • 发布