游戏 VFX：网格 + 贴图 + 引擎数学

核心理念

3D 软件造壳，AI/贴图画皮，引擎赋魂。

VFX ≈ 简单 Mesh（塑料外壳）× 滚动贴图（活涂装）× 引擎数学（缩放/旋转/淡出/错开）

请不要在 DCC 中渲染完成的 FX，也不要依赖 TyFlow/Houdini 进行独立游戏快速迭代。 请不要在非原型阶段，用纯过程化 noise2d() 替代纹理。

标准流程

AI 纹理提示词建议

生成适用于 UV 滚动的无缝、高对比度遮罩图：

• seamless jade ink wash noise, high contrast alpha, tileable, 512x512, no background
• seamless magic energy noise, soft core bright edges dark, tileable
• 避免插画风格的单帧图像；需要的是可平铺的遮罩/能量图。

将贴图放入 assets/textures/vfx/ 目录，并在着色器中赋值给 albedo_texture。

构图：点 · 线 · 面

各层需使用错开延迟（0.05–0.18 秒）叠加；切勿在 t=0 时刻一次性全部生成。

色彩：631 法则 + 对比度

墨痕黑（ink black） 不计入 631 色彩比例——仅作为对比边缘使用（类似气泡黑边）：覆盖面积小、不透明度高。

扩展公式（流体/魔法类效果）：

主色冷色大面积 + 辅色邻近/弱对比 + 微面积色散高光 + 极小面积点缀色

针对水墨风格项目：主色 = 青玉色/青绿色；辅色 = 蓝紫色雾气；点缀色 = 暖金色；墨色 = 近黑色。

2.5D / 固定视角规则（关键）

正交斜向相机（例如偏移 (20, 22.5, 20)）会破坏许多自由 3D 场景的默认假设。

Billboard 朝向（Godot 4）：

node.look_at(camera.global_position, Vector3.UP)
node.rotate_object_local(Vector3.RIGHT, -PI * 0.5)
node.rotate_object_local(Vector3.FORWARD, yaw_offset)

Godot 实现模式

着色器拆分（最多 3 种材质）

关键 uniform 参数：albedo_texture、scroll_speed、effect_time、intensity、expand_progress、tone_dark/mid/bright/accent。

脚本结构（参考 heal_mesh_effect.gd）

HealEffect (Node3D, y=1.0 on Player)
├── Ground: pool + rings (horizontal planes)
├── Body: twirl billboards ×2 crossed yaw
├── Mist: secondary billboard (30%)
├── Ink: splashes, strokes, traces, rising flecks
└── Accent: core add + star billboards (10%)

公开接口：trigger_heal()（含冷却机制）；_process 更新 effect_time 及 Billboard 朝向。

Tween 规则

# 正确 —— Lambda 将浮点值直接传入 intensity 参数
_tween.tween_method(func(v): mat.set_shader_parameter("intensity", v), 0.0, 2.0, 0.3)

# 错误 —— bind 会追加参数；浮点值被错误地传给其他参数
_tween.tween_method(_set_intensity.bind(mat), 0.0, 2.0, 0.3)  # 在 GDScript 4 中失效

tween_method 返回类型为 MethodTweener，而非 Tween。

纹理随机选取（类型化数组）：

const SPARK_TEX: Array[Texture2D] = [TEX_A, TEX_B, TEX_C]
var tex: Texture2D = SPARK_TEX[i % 3]

新技能检查清单

发布 VFX 前，请确认以下各项：

• 纹理单独预览可见（未被过程化遮罩 / Fresnel 杀死）
• 所有角色相关元素在 2.5D 下正确面向相机
• 631 色彩配比在项目背景上清晰可辨
• 若风格为水墨风，则必须包含墨/对比层
• 各层启用错开时间调度
• 使用 preload() 加载纹理；所有材质同步更新 effect_time
• 本项目风格不依赖 Sky/SDFGI/体积雾等全局环境特性
• 支持无头加载 / 游戏内 Q 测试通过

反模式（来自 game02 的经验教训）

参考实现（game02）

Heal 效果的 Kenney 资源映射：smoke_06 光池、circle_05 环、twirl_02 角色主体、light_03 光晕、magic_02 雾气、magic_04 核心、star/spark 点缀、scratch/scorch/slash/trace 墨迹。

更多陷阱细节与环境约束说明，请查阅 reference.md。