穿越火线 UCC 文件导入导出工具

简介与版本

穿越火线 UCC 文件导入导出工具用于在 Blender 与地图工坊之间传递对象名称、位置、旋转和缩放数据。本文依据原备份的 2.0.0 版说明整理，适用于关卡设计、地图制作和坐标转换工作流。

安装与入口

要求 Blender 3.0.0 或更高版本，原说明推荐 Windows。 1. 下载插件 ZIP 文件，在“编辑 → 偏好设置 → 插件”中安装并启用。 2. 在“三维视口 → 侧边栏 → CF 工具”中找到 UCC 文件操作面板。

面板参数

• Z 轴旋转角： 导出时以全部对象的综合中心旋转，范围为 -360°—360°，默认 90°。
• 位置倍率： 0.1—1000.0，默认 1.0，用于坐标单位换算。
• 位置偏移： 分别设置 X、Y、Z 偏移，范围为 -1000.0—1000.0，用于地图对齐。
• 缩放倍率： 0.1—1000.0，默认 1.0，作用于对象的各轴尺寸。
• 负缩放转正： 自动处理镜像对象的负缩放，并在日志中记录发生转换的轴。
• 源模板： mf5 为快速精简模板，mf6 为标准模板，位于 Core/ 文件夹。

导入 UCC

点击“导入 UCC”，选择 .ucc 文件并确认。插件读取坐标、四元数旋转和缩放数据，验证非数值、无穷值及文件边界，在文本数据块中保存导入信息并报告对象数。 文本记录包含对象名称、位置、四元数、尺寸，以及坐标、旋转、尺寸在文件中的索引位置。

标准导出

1. 在场景中创建或导入网格并摆放对象。 2. 建议把对象旋转模式设置为四元数；插件也会自动进行必要的模式转换。 3. 选择模板并配置位置、旋转和缩放参数。 4. 点击“导出 UCC”，选择保存位置与文件名。 5. 查看导出日志，确认对象和变换信息正确。

快速导出测试

配置场景后选择 mf5 或 mf6，点击“快速导出测试”。原说明的默认目标为：

~/Documents/CFSystem/UCC/untitled.ucc

适合反复测试；正式交付时使用标准导出并显式选择文件名。

坐标与对象处理

导出过程创建临时场景，以综合中心执行 Z 轴旋转，再换算坐标、应用位置和缩放倍率、处理负缩放，最后清空模板中未使用的对象槽。 原说明的坐标换算为：

UCC_X = Blender_X * 35 * Position_Multiplier
UCC_Y = Blender_Y * 35 * Position_Multiplier
UCC_Z = Blender_Z * 35 * Position_Multiplier

对象按名称字母顺序处理，各自的变换信息分别保留。原文给出的容量约为 10,000 个对象，实际不得超过所选模板容量。

文件结构与性能

• UCC 使用二进制格式，每个对象占固定 200 字节。
• 坐标为三个浮点数，占 12 字节；四元数旋转为四个浮点数，占 16 字节；缩放为三个浮点数，占 12 字节。
• 导出完成后清理临时场景，原场景保持不变，操作记录存入文本数据块。
• 超过 1,000 个对象的场景处理时间可能增加；迭代时优先使用快速导出，需要时可减少日志开销。

故障排除

• 找不到源文件： 检查 Core/mf5.ucc、Core/mf6.ucc 是否存在，以及文件权限是否正确。
• 对象超过文件容量： 减少对象数或改用容量更大的模板。
• 无法创建目录： 检查写权限、剩余磁盘空间和路径可达性。
• 旋转异常： 核对四元数模式及复杂父子层级的旋转顺序。
• 尺寸异常： 检查缩放倍率，镜像对象启用负缩放转正，并排除零值或无穷缩放。