所有效果共用 PixelFXPreset 与 PixelFXPlayer2D。资源和公共接口保持 v1。详细签名和约束以插件 API 文档为准。
PixelFXPreset
PixelFXPlayer2D
play(overrides)
restart()
set_parameters(values)
paused
playback_speed
stop()
cancel()
seek(seconds)
update_mode = MANUAL
advance(delta)
face_target(position)
aim_at(position)
常用信号为 started、finished、cancelled、looped、frame_changed 和 validation_failed。free_when_finished=true 适合临时效果。
started
finished
cancelled
looped
frame_changed
validation_failed
free_when_finished=true
直接播放预设会复制实例参数。修改某次播放用 set_parameters(),需要编辑和保存资源则先调用 preset.copy()。不要修改共享缓存纹理。
set_parameters()
preset.copy()
有状态效果每次播放使用独立模拟;修改参数会重播,不支持 seek、共享帧缓存或预热。解析效果可按其元数据使用这些能力,不能把一类效果的能力推广到全部目录。
Player 可以从同一次模拟输出 back/front 两层,适合让烟雾、水波等绕过角色。默认前后 Sprite2D 的 z_index 为 -1/+1。复杂 y-sort 或 CanvasLayer 使用 external_layers 与 PixelFXLayer2D,不要为两层分别推进模拟。
external_layers
PixelFXLayer2D
效果负责画面。游戏负责运动、碰撞、命中、伤害和角色状态。Actor/scene/act 输入的本机类型和约束见原生迁移接入。
完整 API · 效果契约 · 自定义效果
There was an error while loading. Please reload this page.
PixelFX for Godot
宣传页 · GitHub