视觉效果
插件提供了一套可扩展的视觉效果系统,用于在游戏中创建自定义的动态特效。
工作原理
效果系统采用组合模式和模板方法模式,通过继承 GroovyEffect 基类即可创建自定义效果。
每个效果都有明确的生命周期:
创建效果 → spawn() 生成 → 每帧 tick() 更新 → 达到持续时间 → despawn() 销毁生命周期方法
| 方法 | 调用时机 | 用途 |
|---|---|---|
onSpawn() | 效果创建时调用一次 | 初始化资源、创建全息字或粒子 |
onTick() | 每个游戏刻调用 | 更新动画、移动效果 |
onDespawn() | 效果结束时调用一次 | 清理资源、删除全息字、释放内存 |
典型应用
- 属性触发的视觉反馈(暴击特效、治疗数字等)
- 战斗中的浮动提示文字
- RPG 中的 buff/debuff 显示
内置示例
插件内置了一个基于 DecentHolograms 的示例效果 DHEffect.groovy(位于 scripts/expansions/),展示了如何创建浮动的伤害和治疗全息字。
自定义效果
编写自定义效果请参考 视效脚本 和 GroovyEffect 基类。
