world-labs-export

SKILL.md

World Labs Export & Integration

Export generated worlds in various formats for use in game engines, 3D software, and web applications.

Export Formats Overview

Format Type Best For
SPZ (2M/500K) Gaussian Splat Native format, highest quality
PLY (2M/500K) Gaussian Splat Wide compatibility
Collider Mesh GLB Physics, collision
High-Quality Mesh GLB Rendering, modification
360 Panorama PNG Skyboxes, previews

How to Export from Marble

  1. Navigate to your generated world viewer
  2. Open the Download Menu
  3. Select desired format:
    • Splats (SPZ) - High resolution
    • Splats (low-res SPZ) - 500K, lighter compute
    • Splats (PLY) - High resolution, universal compatibility
    • Splats (low-res PLY) - 500K, universal
    • Collider Mesh (GLB) - Instant download
    • High-quality mesh (GLB) - Up to 1 hour processing
    • 360 Panorama

Gaussian Splat Exports

SPZ Format (Native)

World Labs' native Gaussian splat format, optimized for file size:

Variant Splat Count Use Case
SPZ 2M ~2,000,000 Maximum quality
SPZ 500K ~500,000 Lightweight, mobile

Advantages:

  • Smallest file size
  • Optimized for Marble rendering
  • Fast loading in supported viewers

PLY Format (Compatible)

Standard point cloud format for broader software support:

Variant Splat Count Compatibility
PLY 2M ~2,000,000 Universal
PLY 500K ~500,000 Universal

Advantages:

  • Wide software support
  • Works with most third-party splat viewers
  • No conversion needed for many tools

Conversion Tool:

Mesh Exports

Collider Mesh (GLB)

Low-poly mesh for physics and collision:

Property Specification
Triangle count 100,000 - 200,000
File size 3-4 MB
UVs None
Use Collision detection, physics
Download Instant

High-Quality Mesh (GLB)

Detailed mesh for rendering—two variants available:

Variant Triangles Features
Textured ~600,000 Texture maps included
Vertex Colors ~1,000,000 Material flexibility
Property Specification
File size 100-200 MB
Processing time Up to 1 hour
Rate limit 4 requests/hour
Availability Only for worlds you own

Image Exports

360 Panorama

Property Specification
Resolution 2560 × 1280
Format Equirectangular PNG
Use Skyboxes, VR preview, presentations

Coordinate System

As of December 2025, World Labs defaults to OpenGL convention:

       -Y (down)
        └───────→ +X (left)
    -Z (forward)
Axis Direction
+X Left
-Y Down
-Z Forward (into screen)

Legacy OpenCV convention (older exports):

  • +X left, +Y down, +Z forward
  • To convert: Scale Y and Z axes by -1

Conversion to Other Systems

To Unity (Left-handed Y-up):

Unity.x = WorldLabs.x
Unity.y = -WorldLabs.y
Unity.z = -WorldLabs.z

Scale: 1 unit = 1 meter

To Unreal (Left-handed Z-up):

Unreal.x = -WorldLabs.z * 100  // cm
Unreal.y = WorldLabs.x * 100
Unreal.z = -WorldLabs.y * 100

Scale: 1 unit = 1 centimeter

To Blender (Right-handed Z-up):

Blender.x = WorldLabs.x
Blender.y = -WorldLabs.z
Blender.z = -WorldLabs.y

Scale: 1 unit = 1 meter

Engine Integrations

Spark.js (Web) — Recommended

Three.js-based web viewer, native integration with World Labs:

  • URL: https://sparkjs.dev/
  • Best for: VR experiences, interactive web games, custom applications
  • Support: Active community in World Labs Discord

Unity

Plugin: aras-p UnityGaussianSplatting (Free)

Setting Recommendation
Unity version 6.0 (for VR) or 6.1
Render pipeline URP with HDR enabled
Graphics API Vulkan (for VR)
File format PLY 2M or SPZ 2M

Notes:

  • 500K SPZ files may require conversion to PLY
  • For VR (Quest 3): 500K splats perform better than 2M
  • Combine multiple splat components into single component for better draw-order

Unreal Engine

Multiple third-party plugins available:

Plugin Notes
Postshot Recommended. Free version available. Requires standalone Windows app, convert SPZ to PSHT format
Volinga Paid. Supports depth of field, nDisplay for virtual production
3D Gaussians (Akiya) Paid. Most reliable, automatic quality splitting, nDisplay support

Note: Convert SPZ to PLY if plugin requires it.

Blender

Multiple third-party plugins:

Plugin URL Notes
KIRI Engine kiriengine.app Most maintained, verified Blender 4.2+
Reshot AI github.com/ReshotAI Better performance, straightforward
SplatForge splatforge.cloud Most performant, separate render pass

Houdini

Plugin: GSOPs

  • URL: github.com/cgnomads/GSOPs
  • Compatibility: Houdini 20.5
  • Features: Splat animation, VDB/mesh conversion

Format Selection Guide

Need Recommended Format
Web viewer SPZ 500K or PLY 500K
Desktop VR PLY 500K
Archive/Quality SPZ 2M or PLY 2M
Game engine physics Collider Mesh GLB
3D editing HQ Mesh GLB + PLY
Quick preview 360 Panorama
Mobile/Quest VR PLY 500K

Troubleshooting

Issue Solution
Assets appear upside-down Check coordinate system; may need Y/Z axis flip
Wrong scale in engine Unity uses meters, Unreal uses centimeters
500K SPZ not loading Convert to PLY using spz-to-ply.netlify.app
Draw-order issues Combine multiple splats into single component

Related Skills

  • world-labs-api - API integration
  • world-labs-studio - Compose and record before export
  • world-labs-chisel - Create geometry for generation
Weekly Installs
1
Installed on
windsurf1
amp1
trae1
opencode1
cursor1
droid1