Theseus 模组文档
API 参考 / 打击特效样式(render 包)

打击特效样式


音符被判定时,宿主会为它创建一个打击特效实例并绘制在判定线上。模组通过实现 HitEffectStyleProvider 并注册到 ctx.registries().hitEffectStyles() 来决定这个特效长什么样:返回字符特效(TEXT)或多帧图片动画(IMAGE_SEQUENCE)。

本分类覆盖:样式描述 HitEffectStyle 与工厂 HitEffectStyles、注册入口的提供者接口 HitEffectStyleProvider、触发上下文 HitEffectContext 与音符类型 HitEffectNoteType,以及文本绘制用的 TextStyle / TextMetrics。

相关章节:ModRegistries(注册入口)、ActiveHitEffect(运行时修改/取消已产生的特效)、HitEffectLifecycleEvent(特效创建/取消/到期事件)、RenderCanvas(自绘入口)。