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
  • Output resolution is determined by the backend model — custom resolution is NOT supported (no resolution parameter)
  • Key Parameters:
    • prompt: Sky environment description (e.g., "sunset over ocean with dramatic clouds")
    • image_path: Reference image path (Assets/...)
    • high_res: High-resolution mode toggle (enabled by default on the backend when omitted)

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 Notes​

  • ⚠️ Custom resolution is NOT supported (any resolution value such as "512"/"1024"/"2048"/"4096" is ignored). The backend model outputs a fixed tier; set high_res: true for the high-resolution output
  • For 4K-class equirectangular output: after generation, call upscale_image (Real-ESRGAN 4x) to scale up to 4096 wide

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