跳到主要内容

天空盒生成

开始​

从GUI开始​

参考 生成3D模型 的开始部分。

从CLI开始​

使用 generate_skybox 工具启动天空盒生成任务。提交后立即返回 task_id 和 placeholder_material_path（占位材质），将占位材质应用到 RenderSettings.skybox 即可在场景中预览。生成完成后，真实天空盒材质会自动替换占位材质。

输入模式：

模式参数说明
文生天空盒prompt纯文字描述
图生天空盒image_path从参考图生成

异步流程：

  1. 调用 generate_skybox → 返回 task_id + 占位材质路径
  2. 将占位材质赋值给 RenderSettings.skybox → 场景天空盒立即更新（灰色占位）
  3. 结束当前回合，等待 <bg_task_done> 通知自动到达
  4. 收到通知后，材质自动更新为真实 Cubemap

模型​

Rodin Skybox​

  • 唯一支持的天空盒模型，无 generator_id 参数可选
  • 输出： PNG 导入为 TextureCube（Cubemap），自动创建 .mat 材质文件
  • 分辨率选项： 512 / 1024 / 2048 / 4096
  • 关键参数：
    • prompt：天空环境描述（如 "sunset over ocean with dramatic clouds"）
    • image_path：参考图路径（Assets/...）
    • resolution：默认 2048

优化​

提示词优化​

  • 强调氛围："golden hour sunset with volumetric light rays" 比 "sunset" 效果好
  • 指定天气和时段："starry night sky with northern lights" / "overcast grey sky with rolling clouds"
  • 描述远景细节：如 "distant mountain silhouettes" / "horizon glow"

分辨率选择​

  • 移动端/小游戏：512 或 1024，性能友好
  • 桌面端/PC：2048（默认，平衡质量与性能）
  • 高画质/截图宣传：4096，文件体积大

参考图引导​

  • 提供参考图能显著提升天空盒与场景风格的匹配度
  • 适合项目已有美术设定图的场景

注意事项​

  • ⚠️ 生成耗时 60–180 秒，工具调用立即返回，禁止轮询，等待 <bg_task_done> 通知
  • ⚠️ 占位材质在场景中显示为灰色，这是正常现象，生成完成后自动替换
  • ⚠️ 输出路径：默认 Assets/TJGenerators/History/
  • ⚠️ 不要用天空盒工具生成 3D 模型、精灵或角色——各有专门的生成工具
  • ⚠️ Domain Reload：生成期间不要在磁盘写入 .cs 文件，使用 execute_csharp_script 代替
  • ⚠️ 中断恢复：status="interrupted" 时需用 force_overwrite=true 重新生成