# IRONSPORE · 机甲搜打撤原型

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

## 启动

- 本分支设置界面构建入口为 Builds/Windows/x64/Settings/Ironspore.exe；请保留完整 Settings 目录。多语言基线构建入口为 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，点击外部可收起。
- 主页和 Esc 暂停菜单均可进入设置，调整总音量、画质、分辨率、窗口／全屏、鼠标灵敏度与精瞄倍率，并修改键鼠绑定。点击“应用并保存”后生效并持久化；显示变化需在 15 秒内确认。返回放弃未应用的修改，恢复默认也需应用后保存。
- 设置内支持中英文即时切换、鼠标和键盘导航。改绑后的操作提示同步更新；Esc 可取消改绑并返回菜单。设置架构见 [游戏设置](Docs/Design/Settings.md)。
- 设置界面、持久化、键盘返回和 Windows 构建的验证结果见 [设置验收](Docs/QA/Settings/Acceptance.md)。

## 操作与一局流程

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

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

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

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

## 工程与验证

- [AGENTS.md](AGENTS.md) 保存 Unity MCP、Blender MCP、资产存放、验证和 Git 提交的协作约定。
- [玩法设计](Docs/Design/GameDesign.md) 与 [开发任务](Docs/Production/ImplementationPlan.md) 保存约定和阶段验收。
- [文件规范](Docs/Production/ProjectConventions.md) 与 [素材台账](Docs/Production/AssetSources.md) 记录模型、代码和声音的来源与存放路径。
- 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 归档测试结果、输入回放及截图。
- Unity 编辑器的进度与设置使用本工程 `UserSettings/Ironspore/`；独立程序可用 `-ironspore-data-path <绝对路径>` 隔离测试数据。普通 Windows 玩家的现有存档路径保持兼容。
- [原型验收记录](Docs/QA/Prototype/Acceptance.md) 列出已完成的检查及后续内容制作、节奏与性能测试。
- [多语言计划](Docs/Production/LocalizationPlan.md) 与 [多语言验收](Docs/QA/Localization/Acceptance.md) 记录双语文本、字体、偏好、UI 回归及本轮构建。运行时不依赖联网。

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