Skip to content

视觉效果

插件提供了一套可扩展的视觉效果系统,用于在游戏中创建自定义的动态特效。

工作原理

效果系统采用组合模式和模板方法模式,通过继承 GroovyEffect 基类即可创建自定义效果。

每个效果都有明确的生命周期:

创建效果 → spawn() 生成 → 每帧 tick() 更新 → 达到持续时间 → despawn() 销毁

生命周期方法

方法调用时机用途
onSpawn()效果创建时调用一次初始化资源、创建全息字或粒子
onTick()每个游戏刻调用更新动画、移动效果
onDespawn()效果结束时调用一次清理资源、删除全息字、释放内存

典型应用

  • 属性触发的视觉反馈(暴击特效、治疗数字等)
  • 战斗中的浮动提示文字
  • RPG 中的 buff/debuff 显示

内置示例

插件内置了一个基于 DecentHolograms 的示例效果 DHEffect.groovy(位于 scripts/expansions/),展示了如何创建浮动的伤害和治疗全息字。

自定义效果

编写自定义效果请参考 视效脚本GroovyEffect 基类