3D Gaussian Splatting (3DGS) displays photoreal scenes and objects without building polygon meshes. A Gaussian Splat is made of millions of small, semi-transparent, colored 3D blobs called splats. Each splat has its own position, size, orientation, opacity, and view-dependent color. Together they reproduce a scene with photoreal detail, including fine structures such as foliage, hair, and reflective surfaces that are hard to rebuild as meshes.
Splats are most often created from photos or video of real-world places and objects, using capture and reconstruction tools. Some AI-based tools can also generate splats from text prompts or images. You can import these splat files into UEFN as Gaussian Splat assets and place them in your level.
What You Can Do
With the Gaussian Splats experimental setting enabled, you can:
Import splat files in .ply and .spz format as Gaussian Splat assets.
Place splats in your level with the Gaussian Splat actor, then move, rotate, and scale them like any other actor.
Adjust the overall splat size and opacity of each placed Gaussian Splat actor.
Reduce the memory a splat uses on lower-end platforms with per-platform Min LOD settings.
Enable Gaussian Splats
Gaussian Splats are turned off by default. To enable them for your project:
Open your project in UEFN.
From the menu bar, choose Project > Project Settings.
In the Experimental section, select the Gaussian Splats checkbox.
When this setting is enabled, the project is marked as experimental and cannot be published. The Publishing Report lists Gaussian Splats under Experimental Features. To make the project publishable again, remove all Gaussian Splat content from your levels, then disable the setting.
Build Your First Splat Scene
Follow these steps to add a splat to your level and test it in a session.
Enable Gaussian Splats in Project Settings.
Import your splat file (.ply or .spz). Splat assets can be large, so check your island's size in the Project Size tool after you launch a session.
Drag the Gaussian Splat asset into your level. If it appears upside down or at the wrong size, rotate or scale the Gaussian Splat actor.
Click Launch Session to see the splat in game. After later changes, use Push Changes to update the running session.
For an object splat, such as a statue or a prop, no further setup is required. To use a splat as a full environment that surrounds the player, continue with Use a Splat as an Environment, below.
Use a Splat as an Environment
An environment splat surrounds the player, often including the sky, and becomes the world players move through. Because splats have no collision and aren't lit by your level's lights, an environment splat needs some extra setup.
An empty level is the easiest place to start. Existing terrain, props, and collision can show through or conflict with the environment splat.
1. Set up the ground and collision
If your splat comes with a collision mesh (some tools that create splats export one alongside the splat):
Import the collision mesh, place it with the same location, rotation, and scale as the Gaussian Splat actor, and attach it to the Gaussian Splat actor in the Outliner.
Add collision to the mesh.
Select the collision mesh actor and turn on Actor Hidden In Game.
Remove the level's existing floor, so players stand on the splat's ground and not on a hidden floor underneath it.
If your splat doesn't have a collision mesh:
Use a floor, and adjust its height until the ground in the splat sits on it. Check from a low camera angle, so characters don't appear to float or sink.
Turn on Actor Hidden In Game for the floor. If the splat is thin or has gaps where players can see through to the ground, leave the floor visible and use a dark material instead, so gaps look dark.
Add invisible walls or Barrier devices for walls and the edges of the playable area.
This works best for mostly flat ground. For slopes, stairs, or uneven ground, use a collision mesh if your tool can create one.
2. Choose a sky
If your splat includes a sky that you want to use: open Window > World Settings and select Disable All Time of Day Managers. This turns off all environment lighting, including the default sky, sun, and clouds, so the splat's sky shows without the default sky behind it. Then add an Environment Light Rig to light your characters and props, or a Directional Light for simpler lighting.
If your splat has no sky, or you want to use the default sky: keep the default Day Night Cycle. Keep in mind:
If the splat includes a sky, it draws in front of the default sky. Remove the sky from the splat in the tool you used to create it.
The lighting in the splat doesn't change with the time of day. To match it, use a Day Sequence device with Day / Night Cycle set to Fixed Time.
Splats aren't lit by the Environment Light Rig, a Directional Light, or any other light in your level. Their lighting comes only from the splat.
Turning off the Time of Day Managers also turns off automatic exposure, which affects how bright the splat looks. If colors look brighter or more washed out than in the tool you created the splat with, try adding a Lumen Exposure Manager.
3. Place spawn pads
Place your Player Spawn Pads above the splat's ground, so players don't start inside or below the collision.
Prepare Your Splat File
UEFN imports splat files in these formats:
| Format | Details |
|---|---|
.ply | The common 3DGS training output format, produced by the original 3DGS reference code and many capture tools. The file must be binary little-endian. ASCII PLY files are not supported. |
.spz | A compressed Gaussian Splat format. SPZ versions 2, 3, and 4 are supported. |
Keep the following in mind when you prepare a splat file:
Clean up the splat first. UEFN imports every splat in the file and does not remove stray or floating splats. Crop and clean the splat in the tool you used to create it, or in a splat editing tool, before you export it.
Fewer splats perform better. Rendering cost grows with the number of splats on screen. A splat file with a few hundred thousand to a few million splats is a reasonable starting point.
Import a Splat File
In the Content Browser, click Import, or drag a .ply or .spz file into a Content Browser folder.
In the Gaussian Splat Import Options window, set the options below.
Click Import.
| Option | Description |
|---|---|
Import Scale | Scale applied to the splat during import. The default of 100 converts splats authored in meters (used by most tools) to Unreal units (centimeters). Range: 0.01 to 1000. |
SH Max Degree | When enabled, limits the spherical harmonics degree that is imported (0 to 3). Use a lower value to reduce memory use. This setting can only lower the degree stored in the file, not raise it. |
Spherical harmonics (SH) store how a splat's color changes with viewing angle. Degree 0 has a single flat color per splat, and degree 3 gives the richest view-dependent color but uses about four times the memory of degree 0. Compared to degree 3, an asset uses about 65% of the memory at degree 2, 40% at degree 1, and 25% at degree 0.
UEFN converts the splat's coordinate system automatically: .spz files are treated as Right-Handed Y-Up, and .ply files as COLMAP-style Right-Handed Y-Down. If your splat appears upside down or rotated, rotate the placed actor to correct it.
A new Gaussian Splat asset appears in the Content Browser. The asset stores the splat data in a compressed format and builds levels of detail automatically.
Keep Your Island Under the Size Limit
Splat assets can be large, and those used in your levels count toward your island's download size limit (400 MB). A detailed splat with SH degree 3 can be too large to fit on its own. To reduce asset size:
Import with a lower SH Max Degree. Setting SH Max Degree to 1 or 2 is usually the biggest single saving, and most splats still look good.
Raise Min LOD. Each Min LOD step roughly halves the asset's size for that platform. See Gaussian Splat Asset Settings.
Crop the splat. Remove areas players won't see before you export the splat file.
Reimport
To update a Gaussian Splat asset after you change the splat file, right-click the asset and choose Reimport. The import options window doesn't appear on reimport.
Place a Splat in Your Level
Drag the Gaussian Splat asset from the Content Browser into the viewport. UEFN creates a Gaussian Splat actor that references the asset.
You can move, rotate, and scale the actor with the standard transform tools, including non-uniform scale. Changes to the actor's transform and visibility are applied while the game runs.
Gaussian Splat Component Settings
Select the actor, then select its Gaussian Splat Component in the Details panel to edit these settings:
| Setting | Description |
|---|---|
Asset | The Gaussian Splat asset to display. |
Point Scale Factor | Multiplier on the size of every splat (0 to 1, default 1). Lower values shrink the splats, which gives a sparser, pointillist look. |
Opacity Scale | Multiplier on the opacity of every splat (0 to 1, default 1). Use this to fade a splat in or out. |
Gaussian Splat Asset Settings
Double-click a Gaussian Splat asset to open it. You can edit this setting:
| Setting | Description |
|---|---|
Min LOD | The finest level of detail kept when the project is cooked for each platform. At 0 (default) the full-resolution splat is kept. Each step up removes the finest remaining level, which roughly halves the number of splats and the memory used. Use the per-platform override to reduce memory on lower-end platforms. |
Min LOD only affects cooked builds. The editor always shows the full-resolution splat, so preview your island on each target platform to check the result.
The asset also shows read-only information about the splat, including the number of splats, the SH degree, and its bounds.
Add Collision
Gaussian Splats have no collision, so players fall through a splat's floors and walk through its walls. To make an environment splat playable, pair it with a collision mesh: a static mesh that matches the splat's shape, is hidden in game, and provides the collision.
Some tools that create splats can export a collision mesh alongside the splat. Use that mesh, or a simplified mesh of the same scene.
Imported Meshes Have No Collision by Default
When you import a static mesh into UEFN, it doesn't get player collision automatically. You can add it in one of two ways:
| Method | Best for | Trade-offs |
|---|---|---|
Most environment splats. One setting, and the collision matches the mesh exactly. | Physics objects don't collide with it, only players, weapons, and projectiles. | |
Islands that use physics. | Slower to set up, and the collision approximates the mesh. |
For background on collision in UEFN, see Configuring Collision for a Static Mesh.
Place the Collision Mesh
Import the collision mesh and drag it into your level.
Give it the same location, rotation, and scale as the Gaussian Splat actor, so the two line up.
In the Outliner, drag the collision mesh onto the Gaussian Splat actor to attach it, so they move together.
Option 1: Use Complex Collision As Simple
This option uses the mesh's own triangles as collision, so the collision follows the splat's surfaces exactly.
In the Content Browser, double-click the collision mesh asset to open the Static Mesh Editor. (This setting is on the asset, not on the actor placed in your level.)
In the Details panel, find the Collision section and set Collision Complexity to Use Complex Collision As Simple.
Save the asset.
Keep the following in mind:
Physics objects pass through it. Players, weapons, and projectiles collide with it, but objects simulated with UEFN Physics don't. If your island uses physics on the splat's surfaces, use option 2 instead.
Use a simplified collision mesh. Use a mesh made for collision, rather than a full-detail one.
Option 2: Generate Collision With Mesh To Collision
This option builds simple collision shapes that approximate the mesh. It works with physics.
From the mode selector in the toolbar, switch to Modeling mode.
Select the collision mesh in the level.
Open the Mesh To Collision tool.
Set the following options:
Option Value Notes Geometry Type
Convex Decompositions
Splits the mesh into many convex shapes that follow its surface.
Input Mode
Per Input Object
The default.
Decomposition Method
Volumetric Error
Works best for large meshes.
Max Hulls Per Shape
2048
Large scenes need a high value. The slider stops at 100, so type the value in.
Append to Existing
Off
Replaces any existing collision on the mesh.
If players fall through in some spots, increase Max Hulls Per Shape. Larger or more detailed meshes may need a value higher than 2048. You can also place hidden floor pieces over small gaps.
Wait for the tool to finish. Keep UEFN in the foreground while it works: the tool doesn't calculate while UEFN is in the background, and it doesn't show a progress bar. It's finished when the collision preview appears in the viewport and Accept becomes available.
To check the result, turn off Show Target Mesh in the tool settings. You should see many shapes covering the floors and walls, not a few large ones.
Click Accept, then choose File > Save All.
In the Static Mesh Editor, make sure Collision Complexity isn't set to Use Complex Collision As Simple. Otherwise the game ignores the shapes you just generated.
Check the Collision
In the level viewport's view mode menu, choose Player Collision. This view shows only what players collide with. Look for gaps in walkable areas, or open spaces that have been filled in.
Launch a session and walk the scene, especially areas players will use most.
Hide the Collision Mesh
Select the collision mesh actor (not the Gaussian Splat actor), and in the Details panel:
Turn on Rendering > Actor Hidden In Game. The mesh disappears during play but keeps its collision.
Keep Collision Presets set to FortStaticMesh, Fortnite's standard preset for static level geometry.
Leave the mesh visible in the editor so you can see it while you work. Save, then launch a session to check that the splat looks normal and the collision still works.
How Gaussian Splats Look in Your Island
Gaussian Splats render differently from meshes. Keep these behaviors in mind when you design with them:
Built-in lighting only. Splats show the lighting that's part of the splat. They aren't lit by lights in your level, and they don't cast or receive shadows.
Not in reflections or global illumination. Splats don't appear in Lumen, reflections, or other lighting effects, and they don't contribute to them.
No collision. Splats are visual only. See Add Collision.
Hidden by solid geometry. Opaque meshes in front of a splat hide it correctly. However, splats are drawn on top of translucent surfaces such as glass and water.
Overlapping splats. When two Gaussian Splat actors overlap or intersect, their splats are not blended against each other in depth order, so one can appear to draw through the other. Avoid overlapping Gaussian Splat actors for now. Improved blending between them is planned.
Affected by post-processing. Splats are drawn before depth of field, motion blur, bloom, exposure, and tone mapping, so these effects apply to splats as they do to the rest of the scene. Splats can look different in UEFN than in the tool you created them with, especially under strong exposure or color grading settings.
Automatic level of detail. Distant parts of a splat are drawn with fewer, larger splats to save performance. Splats outside the camera view are skipped.
Performance
Splats are sorted and drawn every frame, so their rendering cost depends mostly on how many splats are visible and how much of the screen they cover.
To keep performance in check:
Import only the parts of a scene you need.
Lower SH Max Degree at import for splats that don't need strong view-dependent color.
Use Min LOD to reduce splat counts on lower-end platforms.
Use a small number of large Gaussian Splat actors rather than many overlapping ones.
Test on your target platforms early.
Platforms
Gaussian Splats work on all platforms. On lower-end platforms, splats rely on level of detail (LOD) to stay within performance and memory limits:
Min LOD removes the finest detail from a Gaussian Splat asset when it's cooked for a platform. Set a higher Min LOD for lower-end platforms in the asset's per-platform override.
While the game runs, distant or small parts of a splat are automatically drawn with fewer, larger splats.
As a result, a splat can look softer or less detailed on lower-end platforms than in the editor. Always preview your island on the lowest-end platform you're targeting.
As a rough guide, on lower-end platforms keep each Gaussian Splat asset to about 1 million splats or fewer to hold 30 frames per second. Use Min LOD to bring larger assets into that range on those platforms.
Use Splats in Niagara
You can also use splats in Niagara visual effects, for example to animate, dissolve, or morph an object splat. Use the Gaussian Splat Reader data interface to read splats from an asset, and the Splat Renderer to draw particles as splats. For details, see Gaussian Splats and Niagara.
FAQ
My PLY file fails to import with "Unknown header line".
The file is probably in ASCII PLY format, or it contains properties that aren't 32-bit floats. Re-export it as a binary little-endian PLY with float properties.
My splat appears upside down or sideways.
The tool that created the splat used a coordinate system UEFN didn't expect. Rotate the Gaussian Splat actor to correct the orientation.
My splat is the wrong size.
Most tools author splats in meters, and the default Import Scale of 100 converts meters to centimeters. If your tool uses different units, reimport with a different Import Scale, or scale the placed actor.
My island is over the size limit after importing a splat.
Reimport the splat file with SH Max Degree set to 1 or 2, raise Min LOD, or crop the splat in the tool you used to create it. See Keep Your Island Under the Size Limit.