Gaussian Splat World Bake Workflow

Use this workflow when you want to merge multiple Gaussian splat assets into one GaussianSplatWorld resource for faster runtime loading.

Scene mode preserves node transforms, while input-list mode does not. Both end in the same baked world resource.

Choose a Bake Mode

Mode	Required input	Transform behavior	Output
Scene mode	--scene=res://...	Preserves each child node transform during merge	.gsplatworld file
Input-list mode	--inputs=res://a.ply,res://b.spz or --input=...	Uses identity transforms for each input	.gsplatworld file

Required Options

Option	When you need it	Notes
--output	Always	Must end with .gsplatworld
--scene	Scene mode	Use this when the scene already contains the splat nodes
--container	Scene mode with multiple containers	Selects the container to bake
--inputs or --input	Input-list mode	Use this when you want to merge assets directly
--chunk_size	Optional	Adjusts chunking in the baked world

Practical Order

1. Choose scene mode if you need the existing scene transforms.
2. Choose input-list mode if you want a direct asset merge.
3. Set the output path first.
4. Run the bake once, then validate the baked world in a clean scene.

Common Failure Modes

Symptom	Likely cause	What to do
Missing --scene or --inputs.	No bake mode was selected	Pass exactly one mode selector and keep --output
No GaussianSplatContainer found in scene.	The scene does not contain a matching container	Add one or pass a valid --container path
Multiple GaussianSplatContainer nodes found...	Auto-discovery is ambiguous	Pass --container=<nodepath>
Output must end with .gsplatworld	Output extension is unsupported	Rename the output file
Misaligned runtime world	The baked world is applied to a transformed runtime node	Reset GaussianSplatWorld3D to identity before applying the world data

Related Pages

• Import workflow
• Recurring issues