Skip to main content

Skybox Generation

Getting Started

Start from GUI

Refer to the beginning section of Generate 3D Models.

Start from CLI

Use the generate_skybox tool to generate skyboxes. After generation is complete, the skybox material is automatically saved and can be used in the scene.

Input Modes:

ModeParametersDescription
Text-to-SkyboxpromptPure text description
Image-to-Skyboximage_pathGenerate from reference image

Models

Rodin Skybox

  • Only supported skybox model, no generator_id parameter available
  • Output: PNG imported as TextureCube (Cubemap), automatically creates .mat material file
  • Resolution Options: 512 / 1024 / 2048 / 4096
  • Key Parameters:
    • prompt: Sky environment description (e.g., "sunset over ocean with dramatic clouds")
    • image_path: Reference image path (Assets/...)
    • resolution: Default "2048"
    • high_res: Whether to enable high resolution mode (default false)

Provide at least one of prompt or image_path.


Optimization

Prompt Optimization

  • Emphasize atmosphere: "golden hour sunset with volumetric light rays" is better than "sunset"
  • Specify weather and time of day: "starry night sky with northern lights" / "overcast grey sky with rolling clouds"
  • Describe distant details: such as "distant mountain silhouettes" / "horizon glow"

Resolution Selection

  • Mobile/Mini Games: 512 or 1024, performance-friendly
  • Desktop/PC: 2048 (default, balances quality and performance)
  • High-Quality/Promotional Screenshots: 4096, larger file size

Reference Image Guidance

  • Providing reference images can significantly improve skybox matching with scene style
  • Suitable for scenes that already have existing concept art

Notes

  • ⚠️ Generation time 60–180 seconds
  • ⚠️ Output path: Default Assets/TJGenerators/History/
  • ⚠️ Do not use skybox tools to generate 3D models, sprites, or characters—each has dedicated generation tools
  • ⚠️ Domain Reload: Do not write .cs files to disk during generation, use execute_csharp_script instead
  • ⚠️ Interrupt Recovery: When generation is interrupted, need to regenerate with force_overwrite=true