roblox-vfx-lab
Exports rendered VFX as Roblox assets: bakes WGSL effects into flipbook PNG sheets, uploads them to Roblox (public, moderated), and wires them onto Roblox ParticleEmitters, Beams and Trails for use in a Roblox place.
Uses Roblox's own Studio MCP server to upload baked flipbook textures into a place and apply the right ParticleEmitter settings (FlipbookLayout, FlipbookMode, Texture, LightEmission), create emitters under a selected part or attachment, and preview the emitter in the Edit viewport frozen at chosen moments.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@roblox-vfx-lab Make a blue electric hit spark as a 4x4 OneShot and apply it to my sword emitter"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Roblox VFX Lab
Write a shader, bake it into a Roblox texture, and put it on a ParticleEmitter in Studio. You ask an AI for the effect, or you write it in the browser; the lab renders it on your GPU, checks it, and exports it to your place.
What it is
Roblox runs no custom shaders. A ParticleEmitter, a Beam or a Trail shows a texture, and a flipbook sheet animates that texture. The lab closes the gap: you write the effect as a small WGSL function, the lab renders it on a real GPU, bakes the frames into one PNG sheet, and puts that sheet on your emitter with the right flipbook settings.
flowchart LR
node["Node<br/>WGSL effect()"] --> render["Render<br/>look, fix, repeat"]
render --> bake["Bake<br/>PNG sheet + recipe"]
bake --> upload["Upload<br/>Roblox Studio MCP"]
upload --> apply["Apply<br/>emitter settings"]
apply --> preview["Preview<br/>frozen frames in Studio"]You can use it in two ways:
In the browser at nevelstudios.github.io/roblox-vfx-lab. Nothing to install. Open an example, change it, bake it, download the PNG.
As an MCP server for an AI client (Claude Code, Claude Desktop, Cursor). The AI writes and fixes the node, reads the quality warnings, and exports the result to Studio. The same lab page runs on your machine and follows every change the AI makes.
Related MCP server: Roblox AI Agents
Try it in 60 seconds
Open the lab in Chrome, Edge, Safari 26 or Firefox 141 on Windows.
The gallery plays every example as Roblox plays it. Press Open on one.
Move a slider in Parameters. The live view on the left changes at once.
Turn Auto bake on. The baked sheet plays beside the live view, frame by frame, as the emitter will show it.
Press Code to see the node. Examples are read-only: press Duplicate to get your own copy, then edit and press Save (Ctrl+S). The editor colours the WGSL and completes names as you type: the
vfx_helpers, theparams.of the node and thevfx.frame values (Ctrl+Space opens the list, Tab or Enter takes one). To delete one of your nodes or bakes, point at it in the list and press ×.In Export, press Download PNG. Upload it in Studio (Asset Manager, or the Texture property of an emitter).
Press Copy under Export and paste the lines into a script, or set the same properties by hand:
emitter.Texture = "rbxassetid://<your id>"
emitter.FlipbookLayout = Enum.ParticleFlipbookLayout.Grid4x4
emitter.FlipbookMode = Enum.ParticleFlipbookMode.OneShotYour nodes and bakes stay in this browser (IndexedDB). In a private window that blocks storage, the lab still works, and the header says Not saving.
Install the MCP
You need:
Node.js 22 or later.
A GPU with D3D12 (Windows), Metal (macOS) or Vulkan (Linux). The lab renders with Dawn, the WebGPU engine of Chrome.
Roblox Studio, only to export. The lab uses Roblox's own Studio MCP server for the upload and for every change in your place, so it needs no plugin of its own. In Studio, turn on the MCP server in the Assistant's MCP settings (Roblox's guide).
Claude Code
claude mcp add roblox-vfx-lab -- npx -y github:NevelStudios/roblox-vfx-labClaude Desktop (claude_desktop_config.json) and Cursor (~/.cursor/mcp.json)
{ "mcpServers": { "roblox-vfx-lab": { "command": "npx", "args": ["-y", "github:NevelStudios/roblox-vfx-lab"] } } }Restart the client. When the library (~/roblox-vfx-lab) has no shaders/ folder yet, the first start copies the
examples into it. Then try:
Open the VFX lab page for me, then make a blue electric hit spark for a sword: a 4x4 OneShot sheet, additive.
Your first effect
This is what a full run looks like. You say what you want; the AI calls the tools.
You: "Make a shock ring for a ground slam, white so I can tint it, 4x4 OneShot."
The AI reads
vfx_guide, then writesshaders/impact/slam-ring.wgslwithvfx_shader_write. The answer has the compiler's problems with line and column, so a broken node gets fixed before anything renders.It calls
vfx_renderand looks at the frames as one image. It reads the stats under the image (edge alpha, coverage, white share) and fixes what the warnings name withvfx_shader_edit.You watch on the lab page (
vfx_viewergives the URL): every write shows at once, and you can move the sliders yourself.vfx_bakewritesbakes/impact/slam-ring.pngand its recipe.json.You: "Upload it and put it on the emitter I selected." The AI calls
vfx_upload(public, moderated and permanent, so it asks first), thenvfx_applywith the flipbook settings.vfx_previewplays the emitter in the Edit viewport and freezes it at chosen moments, so the AI can look at the effect in your scene.
On the local page you can do steps 5 and 6 yourself: select a part, an attachment or an emitter in Studio, and press Export to Roblox. The lab asks before it uploads, then sets the texture on the selected emitters, or makes a new ParticleEmitter under the selected part or attachment.
Writing nodes
A node is WGSL with one function. uv is 0..1 inside the frame, y up. Return straight RGBA: alpha is the shape, and
RGB stays near white so the emitter's Color tints it.
fn effect(uv: vec2f) -> vec4fWhat a node can read:
Name | Meaning |
| 0..1 across the clip. OneShot: the last frame is 1. Loop: 1 is the next loop's frame 0. |
| Seconds into the clip, and its length. |
| This frame and the frame count. |
| One output pixel in uv units, for crisp edges. |
| A value from a |
Parameters are comments. Each one becomes a slider or a colour field on the page:
// @param width f32 0.02..0.3 = 0.12 ring width
// @param tint color = #ffd27aThe types are f32, vec2f, vec3f, vec4f and color, 15 at most. The helpers (all vfx_) cover shapes
(vfx_circle, vfx_ring, vfx_segment, vfx_box), edges and light (vfx_fill, vfx_glow), easing, polar
coordinates, hashes, noise (vfx_noise, vfx_fbm, vfx_loop_fbm for seamless loops) and Worley cells. The full
list is in src/guide.md.
A ring that grows and fades:
// @param width f32 0.01..0.2 = 0.06
fn effect(uv: vec2f) -> vec4f {
let p = vfx_center(uv);
let t = vfx.phase;
let d = vfx_ring(p, 0.8 * vfx_ease_out(t), params.width * (1.0 - 0.6 * t));
return vec4f(vec3f(1.0), vfx_fill(d, vfx.px * 1.5) * (1.0 - vfx_ease_in(t)));
}A smoke puff that loops with no jump:
fn effect(uv: vec2f) -> vec4f {
let p = vfx_center(uv);
let n = vfx_loop_fbm(p * 2.5, vfx.phase, 1.5, 5);
let shape = vfx_fill(length(p) - 0.62 - n * 0.22, vfx.px * 2.0);
return vec4f(vec3f(0.8), shape);
}Quality rules
Every render and bake measures each frame and warns about the usual faults. The page shows the warnings under Bake; the AI reads them in the tool answer.
Keep the shape inside the frame. Alpha on the frame edge makes a hard cut line in game. The
edgestat must be 0 or close to it (the warning starts above 0.02). Only a tiling still for a Beam or a Trail may touch the edge.Nothing ends on a cut. Fade over a long band (about 0.62 to 0.93 of the radius), and check the bake over the light backdrop too.
Frame 0 must read alone. Devices that turn flipbooks off show only frame 0.
Every frame changes. A sheet that grows and then holds plays as a still image.
A loop does not jump from its last frame to its first. Use
vfx_loop_fbmorsin(phase * VFX_TAU).Little is full white. A bright core and a fainter body read better than a flat white shape.
Fill the frame. Empty space spends pixels on nothing.
Roblox export
FlipbookLayoutcomes from the grid (Grid2x2,Grid4x4,Grid8x8).FlipbookModeisOneShot(once over the particle's Lifetime) orLoopatFlipbookFramerate.Roblox plays a flipbook at 30 fps at most. A loop of 64 frames takes 2.13 s, whatever its duration says. The page warns when a loop goes over 30 fps.
LightEmission1 is additive: dark pixels vanish, good for light. 0 is alpha blend: the alpha shape shows, good for smoke and ink.A flipbook plays only on a ParticleEmitter. A Beam or a Trail takes a still: bake it with margin 0 so it tiles along the beam, then scroll it with
TextureSpeed.Roblox scales images above 1024 px down. A still that must be sharper (a big sky object) bakes with
tiles2..4 into several 1024 PNGs, laid out as ImageLabels in one BillboardGui.
Examples
Every example ships as a node, a baked PNG and its recipe in examples/. Download them from the gallery, or use them in your own place as they are.
Preview | Example | Sheet | Target |
Green portal: a lumpy green disk with painted spiral arms that wind into a bright eye, a lime rim and white specks | 4x4 loop, 1.5 s | ParticleEmitter, LightEmission 0.2 | |
Black hole: ray-traced; a thick accretion disk lensed over and under the shadow, Doppler beaming and a photon ring | 4x4 loop, 2 s | ParticleEmitter, LightEmission 0 |
Tools reference
Tool | What it does |
| The node rules, helpers, quality rules and Roblox settings, by topic. |
| Every node in the library with its hash and state. |
| One node's source, hash, problems and parameters. |
| Creates or replaces a node ( |
| Changes a node by exact text replacements, all or nothing. |
| Renders frames, chosen phases or a parameter sweep as one image, with stats and warnings. |
| Writes the final PNG (still or 2x2, 4x4, 8x8 sheet at 256, 512 or 1024) and its recipe. |
| Uploads a bake through Roblox's Studio MCP and records the asset id. |
| Sets the texture and flipbook settings on instances, or makes a new emitter. |
| Plays emitters in the Edit viewport and freezes them at chosen moments for screenshots. |
| Deletes a node or a bake (its PNG and recipe) from the library. |
| Starts the local lab page and answers its URL. |
Configuration
Variable | Default | Meaning |
|
| The library folder: |
|
| The port of the local lab page (127.0.0.1 only). |
| Windows: | The command that starts Roblox's Studio MCP. Use double quotes around a path with spaces. |
Troubleshooting
no GPU adapter: Dawn found no D3D12, Vulkan or Metal device. The machine has no GPU the lab can use (a VM or a
server with no GPU driver). Update the GPU driver, or run the lab on a machine with a GPU.
no Roblox Studio MCP found at .... Studio is not installed, or it never ran on this account. Install Studio and
open it once. If Studio is somewhere else, set ROBLOX_STUDIO_MCP to the command that starts its MCP server.
Roblox's Studio MCP did not start or exited. Open Studio with a place, and turn on its MCP server in the
Assistant's MCP settings. The next call starts the Studio MCP again.
no Studio is connected: open a place in Roblox Studio. The Studio MCP runs, but no place is open. Open one.
With two Studio windows open, the page asks which one to use.
macOS. The lab looks for the Studio MCP at /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP. If Studio
is in another folder, set ROBLOX_STUDIO_MCP.
port 4518 is taken by another program. Set VFX_LAB_PORT to a free port. A lab that already runs on that port
is used as it is.
The page says the browser has no WebGPU. Use Chrome, Edge, Safari 26 or Firefox 141 on Windows. Without WebGPU, the gallery and finished bakes still play, but nodes do not render live and bakes do not run.
Windows: the client cannot start npx. Some clients start commands without a shell. Use
"command": "cmd", "args": ["/c", "npx", "-y", "github:NevelStudios/roblox-vfx-lab"].
The hosted lab and other NevelStudios pages. Every page under nevelstudios.github.io shares one browser origin,
so they share storage. The lab keeps its data in the IndexedDB database roblox-vfx-lab and in vfx: keys.
How it works
GPU worker. The MCP renders with Dawn (the
webgpupackage) in a child process. Dawn prints errors on stdout and a runaway shader can hang the device, so the child keeps both away from the MCP stream. A call over 60 s stops the worker, and the next call starts a new one.Shared modules.
src/core.js(parameters, shader assembly, layout),src/pixels.js(dilate, stats, PNG and APNG) andsrc/bake.js(the bake itself) have no Node APIs. The MCP and the browser run the same code, so a sheet baked in the browser has the same pixels as one baked by the MCP.Local mode.
vfx_viewerstarts the page on 127.0.0.1. The page reads and writes the library on disk, and a file watcher pushes every change to the page. Only the page's own origin can post to it.Hosted mode. On GitHub Pages there is no server. The examples are read-only files of the site, your nodes and bakes live in IndexedDB, and bakes run on the browser's WebGPU. Export to Roblox needs the Studio MCP, so it runs only on the local page.
Studio. The lab starts Roblox's Studio MCP as a child process at the first call that needs Studio, and talks to it with
list_roblox_studios,upload_image,execute_luauandscreen_capture. The Luau it runs is fixed code insrc/studio-ops.luau; your values reach it as data, never as code.
Contributing
npm ci
npm test
npm run smokenpm test runs the unit tests (no GPU needed). npm run smoke bakes every example on your GPU and checks that each
one is clean. npm run examples writes the example PNGs, recipes and previews again after you change a node.
Issues and pull requests are welcome. Keep new examples original, with no warnings in their bake.
License
MIT, see LICENSE. Made by Nevel Studios.
Available Tools
12 toolsvfx_applyA
Puts an uploaded bake (or any texture id) on instances in Studio, with the flipbook settings a sheet needs (FlipbookLayout, FlipbookMode, FlipbookFramerate for a loop) on a ParticleEmitter; Texture on a Beam, Trail or Decal, TextureID on a MeshPart. targets: existing instances; create: { parent, name?, className? } makes a new one (default ParticleEmitter). properties: more values set in the same call (same format as set_properties).
Inputs: bake, create, targets, texture, +2 more.
vfx_bakeA
Renders a node into its final PNG: grid 1 (a still) or a 2x2, 4x4 or 8x8 flipbook sheet at size 256, 512 or 1024, or a still sharper than Roblox's 1024 cap as tiles x tiles PNGs of size px (bakes/--), to lay out in one gui, supersampled, straight alpha with the colour spread into transparent pixels (no dark halos). Writes bakes/.png and bakes/.json (the recipe: node, hash, values, grid, mode, duration, stats, warnings, uploads). Answers the paths, the flipbook settings, the warnings and a preview over the dark backdrop. Upload it with vfx_upload.
Inputs: name (required), ss, out, grid, +6 more.
vfx_deleteA
Deletes a node (shaders/.wgsl) or a bake (bakes/.png and its recipe) from the library for good. Only on the developer's request: there is no undo. A bake stays when its node is deleted, and an uploaded asset stays on Roblox.
Inputs: kind (required), name (required).
vfx_guideA
How to write, render, bake, upload, apply and preview VFX lab nodes (WGSL baked into Roblox textures). Without section: the index and the overview. Sections: overview, node, helpers, examples, quality, roblox. Read overview and node first.
Inputs: section.
vfx_previewA
Plays the ParticleEmitters at or under targets in the Edit viewport and freezes them (TimeScale 0) at each moment in at (seconds after the emit), then captures the screen: one image per moment. Burst emitters (Enabled false) emit EmitCount (attribute, default 1, or emit) after EmitDelay; Enabled emitters run from empty. The camera frames the emitters unless camera_position and look_at_position are given. TimeScales are restored after.
Inputs: targets (required), at, emit, studio_id, +2 more.
vfx_renderA
Renders a node on the GPU and shows it as one image, cells in reading order with grey lines between them. Default: the clip as a flipbook would play it (frames cells across phase 0..1). phases: chosen moments instead. sweep: { param, from?, to?, count?, phase? } renders one f32 parameter across a range (default its own range) at one phase. Answers per-cell stats (coverage, peak, edge alpha, full-white share, change) and, for a clip, the quality warnings. backdrop: dark (default, how it reads in game), light, checker, or alpha (the shape as grey). The file is not changed.
Inputs: name (required), ss, mode, size, +7 more.
vfx_shader_editA
Changes a node by exact text replacements, applied in order to the latest version, all or nothing. Each old must occur exactly once, or at least once with all: true. Answers the new hash and the verdict; the source is not echoed back.
Inputs: name (required), edits (required).
vfx_shader_listA
Every node in the VFX library ($VFX_LAB_LIBRARY, default ~/roblox-vfx-lab/shaders): its hash, state (clean, or problems at line:column) and parameters with type, range and default. Compiles each on the GPU.
Inputs: no named parameters.
vfx_shader_readA
A node's source, its hash (what vfx_shader_write's replaces names), its state and problems, and its parameters.
Inputs: name (required).
vfx_shader_writeA
Creates a node, or replaces one whole. Replacing needs replaces: the hash from vfx_shader_read or your last write or edit; if the file changed since, nothing is written and the current hash comes back. Answers the new hash and the verdict (state, problems with line:column in your source, parameters). Read vfx_guide node first.
Inputs: name (required), source (required), replaces.
vfx_uploadA
Uploads a baked PNG through Roblox's own Studio MCP (upload_image, under the Studio user's account) and records the asset id in the recipe. Uploads are public, moderated and permanent: only on an explicit request, after the look is settled. The same PNG is never uploaded twice: the recorded id comes back unless force is true.
Inputs: bake (required), force, studio_id.
vfx_viewerA
Starts the local lab page (once per machine) and answers its URL, for the artist to open in a WebGPU browser (Chrome, Edge, Safari 26, Firefox 141 on Windows). It renders every node live with WebGPU (play, scrub, parameter sliders, flipbook sheet view, alpha view), has a WGSL editor, plays baked sheets as Roblox plays them, and has Export to Roblox (upload, then apply to the Studio selection). It follows the library live: a node or bake that changes updates the open page. With Auto bake on, the page re-bakes bakes/.png after each change the artist makes. Port: $VFX_LAB_PORT, default 4518.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
The tools mostly target distinct stages of the VFX pipeline: node CRUD, GPU render, final bake, upload, Studio apply, Studio capture, and local viewer. The closest overlaps are vfx_render vs vfx_bake and vfx_preview vs vfx_viewer, but the descriptions make the boundaries clear.
All tool names use lower snake_case with a consistent vfx_ prefix, which makes the set readable. There are minor deviations: the shader CRUD tools use a shader_ infix while vfx_delete is generic, and vfx_viewer/vfx_guide are noun-like rather than verb-like.
Twelve tools is well within the ideal range and each one maps to a distinct step in the workflow. Nothing appears redundant or padded.
The surface covers the full node lifecycle (list/read/write/edit/delete) plus rendering, baking, uploading, applying, previewing, viewing, and guidance. A minor gap is the lack of explicit bake listing/reading tools, though bakes can be inspected through the viewer or filesystem.
Related MCP Connectors
Generate 3D models, worlds, PBR materials, and coordinated asset packs from AI agents.
Generate images, video, audio and 3D with FlowNode; results land in your asset library.
Turn prompts into production-ready game assets: animated characters, textures, terrain, VFX, HUD.
Search, generate, refine, and export pixel art VFX for games, including sprite sheets and Godot 4.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenancedo not use this server. i did not upload it here and there's no way to delete it4GPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to build and edit Roblox Studio places by inspecting, generating terrain, geometry, and code, with validation and iteration.MIT
- AlicenseAqualityAmaintenanceEnables AI agents to inspect, create, edit, debug, and playtest projects inside the Roblox editor via 29 lean tools, with push-based SSE transport, editor-safe script edits, and batched undoable writes.35820 npm15MIT
- AlicenseAqualityBmaintenanceEnables AI agents to generate game-ready 3D assets from reference images with PBR textures, and to retexture meshes the user already owns, while recording full provenance for every generated file.2013MIT