Repository navigation
Getting Started
Norvan edited this page Nov 10, 2026
·
1 revision
目标引擎为 Godot 4.3+。已通过 Godot 4.3 / Ubuntu headless CI,本机视觉与性能记录使用 Godot 4.7.2 / macOS。运行时不需要 Node.js、C#、GDExtension 或 Autoload。
- 下载 main 源码 ZIP,或克隆仓库。正式发行包 0.2.0 只包含早期五个算法。
- 将
addons/pixelfx/整个目录复制到你的 Godot 项目。 - 在 Project → Project Settings → Plugins 中启用 PixelFX,获得底部预览面板。运行时可以不启用编辑器插件。
- 在场景里添加
PixelFXPlayer2D,将addons/pixelfx/presets/fireball.tres拖到 Effect 属性。
const FIREBALL = preload("res://addons/pixelfx/presets/fireball.tres")
func spawn_visual(at: Vector2) -> PixelFXPlayer2D:
var fx := PixelFXPlayer2D.new()
fx.autoplay = false
fx.effect = FIREBALL
fx.free_when_finished = true
add_child(fx)
fx.global_position = at
fx.play({"radius": 7.0})
return fx命中或离场时调用 fx.stop(),效果会淡出。弹道、碰撞和伤害由游戏自己控制。
直接在 Godot 打开仓库里的 project.godot。F5 是五效果入口;要浏览全部 244 项,打开 demos/pixelfx/full_gallery.tscn 后按 F6。它按选择加载,避免一次创建所有效果。
底部 PixelFX 面板支持预览、改参数和 Save preset。创建预设副本后保存,避免把共享预设当成某个实例的私有状态。