unity/README.md

IRONSPORE · 机甲搜打撤原型

Windows PC 键鼠原型，工程版本为 Unity 6000.6.8f1。机体支持越肩与简化驾驶舱视角，包含轻、中、重三类底盘、部件配装、战区搜刮、货舱运送与整机撤离。

启动

• 扩充训练场可从 Builds/Windows/x64/TrainingRange/Ironspore.exe 启动，保留完整 TrainingRange 目录。机库点「驾驶试验场」，右侧坡道练习计时穿门，左侧练习翻板和横移靶，靶区后方可搜索示范箱、试装和寄送。训练场功能验收

• 地图光影优化构建入口为 Builds/Windows/x64/Lighting/Ironspore.exe，使用完整 Lighting 目录运行。默认 1080p、中等画质、60 FPS 上限，采用独立测试存档命名空间；实际画面、动态阴影与本机性能结果见 光影验收。

• 当前多语言构建入口为 Builds/Windows/x64/Localization/Ironspore.exe。

• 完整压缩包为 Builds/Windows/x64/Ironspore-Localization-Win64.zip。运行时使用完整 Localization 目录，其中包含 Ironspore_Data 与 UnityPlayer.dll 等依赖。

• 在 Unity 打开 Assets/Scenes/Bootstrap.unity 并进入 Play 可从机库开始。Assets/Scenes/MechTestRange.unity 会直接进入驾驶试验场。

• 驾驶试验场使用独立的 range.json，正式出击使用 profile.json。存档位于 Application.persistentDataPath 下的 Ironspore 目录。

• 试验场提供被动目标，便于学习操作。正式出击中的敌人会主动交战。

• 首页右下角 语言 / Language 可即时切换简体中文与 English，重启后保留选择。语言列表支持鼠标、Tab / Shift+Tab、Enter / Space 与 Esc，点击外部可收起。

操作与一局流程

输入	动作
WASD、鼠标	移动、转向瞄准。
左键、右键	主武器、精瞄。
V、左 Shift、空格	切换视角、推进、跳跃。轻型按住空格可短时升空。
Q、F	副武装、主动防护。
E	搜索、取回导航数据、选路、呼叫接应或主动登机。
Tab、按住 G	打开货仓选择物资，回到驾驶状态后原地按住 G 发射货舱。
Esc	关闭界面或暂停。

机库中选择底盘和四个槽位的装备，载重与功率符合预算后出击。搜索绿色箱体获得材料和蓝图，部分箱体提供可以立即安装的部件。普通战区中央的导航设备开放下一站，第二站后选择首领或护送路线。

每次出击配发一个两格货舱，成功升空后立即把选中物资送入机库。准备期间移动、受击或松开 G 可中断并重试。之后的新物资需要随整机带回。每个战区都有橙色撤离坪，按 E 呼叫并等待 15 秒，运输机抵达后再按 E 登机。机毁会损失随身物资，之前送回的货物保留。

带回蓝图后，可用材料在机库研究对应的初始装备选项。局内换上的部件和临时强化随当次出击结束重置。

工程与验证

• AGENTS.md 保存 Unity MCP、Blender MCP、资产存放、验证和 Git 提交的协作约定。
• 玩法设计 与 开发任务 保存约定和阶段验收。
• 文件规范 与 素材台账 记录模型、代码和声音的来源与存放路径。
• Tools/Unity/McpClient.py 使用已安装的 Unity MCP 服务。命令文件位于 Tools/Unity/Commands，Unity 对象与场景由 MCP 操作。
• Tools/Blender/CreatePrototypeMech.py 通过 Blender MCP 生成机体源文件和 FBX，源文件位于 SourceAssets/Blender/Mechs。
• Assets/Tests/EditMode 包含存档与结算测试。Docs/QA/Prototype 归档测试结果、输入回放及截图。
• 原型验收记录 列出已完成的检查及后续内容制作、节奏与性能测试。
• 多语言计划 与 多语言验收 记录双语文本、字体、偏好、UI 回归及本轮构建。运行时不依赖联网。

本版本用于验证完整玩法循环。单局 20–30 分钟与 1080p／60 FPS 是后续节奏和性能调试的验收目标。