SuperAPI AI 工具集

roblox-vfx

设计与创作

查看项目

更新于 11-05 16:19

技能介绍

用途

该技能用于在 Roblox 中制作专业级视觉效果(VFX),面向动漫风格表现:招式动作、斩击、光束、冲击、光环、终极技能、召唤物等。效果以“定义”形式编写,可在浏览器模拟器中预览与逐帧判断,再导出为 Studio 套件。

两种制作路线

创作路线(常规、专业做法):设计效果,在浏览器模拟器中构建为定义,逐帧判断,然后导出 Studio 套件。每张纹理与每个网格都由技能生成,因此产出归使用者所有。

采集路线(快速原型与占位):从使用者自有的免费资源包中读取每个发射器,将配方存入自己的库,输出 VFXKit 模块。

首次运行(每台机器一次)

纹理库与网格是生成的,不在下载包中,需先构建(约 250 MB PNG,耗时数分钟):

cd sim/tex && python make_textures.py && python make_magic_tex.py && python make_painted.py
cd lib && python build_library.py        # 2,000+ library textures, run it from this FILE, not stdin
cd ../../mesh
blender -b -P make_meshes.py             # use the full path to blender.exe from LOCAL.md if it is not on PATH
blender -b -P make_props.py
blender -b -P make_dragon.py
cd ../tex && python make_prop_tex.py     # skins for the prop meshes (needs meshes/props.json)

Python 依赖 numpy、scipy、Pillow(pip install numpy scipy pillow)。随后运行 python sim/serve.py 并打开打印出的地址,三个示例(Crimson Detonation、Eclipse Rend、Riptide Lance)应当可以播放。若首次在本机使用,需阅读本文件夹的 LOCAL.md;若不存在,运行 roblox-skills-setup 技能,或将 LOCAL.template.md 复制为 LOCAL.md 并填写。LOCAL.md 保存路径与工具位置,仅归使用者所有,不会被共享。

质量标准

该技能调校的目标是 20 个角色、100 个招式,并在 Studio 中录制验证。要点包括:每个元素都用真实物体(武器、生物、棺材为网格,重击留下真实弹坑与碎片);终极技加入动漫式演出层(冲击帧、FOV 冲击、集中线、黑边与镜头切换);每个效果最后运行润色流程 sim/effects/fxpolish.py 的 polish(d);能量穹顶用最饱和颜色的 ForceField 外壳包住 0.6 倍大小的 Neon 内核;光环火焰与火花挂在 Part 上而非 Attachment;有色残影透明度至少 0.6;滞留烟雾更小更透;使用饱和色而非淡色混合;目标要像身体一样反应;相机要框住整个动作,每个切换的首尾帧都要检查。

录制前检查

每项检查需基于数字通过,而非目测:sa_parent_check.py 报告 0 个 MeshPart 上的 SurfaceAppearance;lune run sim/tools/lune/build_check.luau <kits/*.luau> 每个套件通过;lune run sim/tools/lune/compile_check.luau <scripts> 每个脚本通过;phys_audit.js [prefix] 无 gap、sink、hover 或 STILL DOWN 行;每个招式的关键帧模拟快照拼成每个角色一张图并查看;正式录制前在 Studio 完整试播一遍。正式录制要求:0 个“being generated”警告、0 次效果或施法者对目标的触及、起身最低点不低于 -0.05、最差帧约 40 ms。

命中反应系统

已验证模块为 references/HitSystem.luau,驱动被抛出、翻滚的 R6 身体。要点:进入软瘫需三步(PlatformStand = true、ChangeState(Enum.HumanoidStateType.Physics)、EvaluateStateMachine = false);抬升 VectorForce 必须包含 HumanoidRootPart(占 R6 12.6 质量中的 2.8);使用碰撞组,所有效果部件进入 FX 组,目标进入 target 组且两组不碰撞;直立静止的身体需被推倒;起身时通过射线检测地面并逐帧放置根部位;蹒跚滑动不得让根部低于地面 +3;布娃娃必须是最后一击;招式之间由导演调用 HitSystem.recover(target) 并等待 isStanding(上限 2 秒)。模拟器以 w.foe 的 stand、fly、down、getup 模式建模同一身体,由 phys_audit.js 检查。

Studio 实测校准(2026-10-27)

模拟器已针对三个高难度效果与真实 Studio 帧对比校准。关键结论:ParticleEmitter Size 为绘制宽度的一半(Size 4 绘制 8 studs),构建器写入时需通过 to_roblox_units() 转换;SurfaceAppearance 自发光会饱和且不泛光,白热来自 Neon 或 LightEmission 粒子;PointLights 在 Roblox 中照亮表面而模拟器不会,需淡出;大平面上不要用实心核心纹理,改用 glow_falloff;加入时预加载所有模板;网格上传走 OBJ → FBX 会使网格绕 Y 轴转 180 度,需用 sim/mesh/obj_to_fbx.py,并用非对称网格检查朝向。

制作 100 个动漫招式时积累的经验(2026-10-27 至 10-29)

涵盖多类静默失败:CFrame 补间走短路径(260 度旋转变为 -100 度,720 度不转),应使用 { "do":"spin" };SurfaceAppearance 贴图需按 ID 预加载;新上传资源可能 30 分钟以上处于“生成中”;大球体上加性白色会过曝;薄纹理新月带会消失,需真实新月网格;帧条需预加载网格;相机要适配整个动作;Luau 每函数 200 局部变量上限;Attachment 下的发射器忽略 Shape;冲击帧的用法与限制;模拟与套件中的 fov、overlay、bloom 等演出动作;绳索不能简单用 path+lag;灰度 CC 反转色度需钳制;相机补间运行中切换镜头在 Roblox 中会丢失;帧审查用 sim/snap.js;timescale 为 0 时冻结粒子行为;暗色光环不得发光;穹顶内 Neon 内核取最饱和色;ForceField 穹顶须在 Studio 判断;球体内部被剔除,天空需用 Neon 网格球;黑暗招式要让世界变淡而黑暗为黑;撕裂天空需要密集云层;Neon 网格配柔和发光贴图会成团块;path 步骤会重建旋转、倾角需放 offset;旋转部件上的拖尾粒子需改用独立载体上的 Trail;生物召唤需真实网格;SurfaceAppearance 只能挂到 MeshPart;贴图首次显示可能约 1 秒无纹理,需在隐藏处从 t=0 绘制。角色动作部分涉及 def.rig、def.actors、拉伸、残影、Highlight、表情与命中调用。

仅模拟展示的经验

若需不依赖 Studio 的展示:fxpolish.polish() 会把火焰外壳转为 ForceField 外壳 + Neon 内核,而模拟器将大 ForceField 画成白色团块,因此渲染视频时应写两个文件——完整润色的 <name>.studio.json 与去掉 domes() 的 <name>.json;TL.flash() 会把 Brightness 写回 0,若场景通过渐变压暗需给闪光单独 grade;共享空间建模的网格需按 place(origin, centre * K) 与 box_of(mesh, K) 对齐。

适用场景与限制

适用于 Roblox 动漫风格 VFX 的专业制作、快速原型与效果库采集。限制:需要本地 Python(numpy、scipy、Pillow)与 Blender 环境;首次需生成约 250 MB 纹理并耗时数分钟;模拟器与 Studio 存在渲染差异,部分效果(如 ForceField 穹顶)只能在 Studio 判断;新上传的网格与贴图可能长时间处于生成状态。