陨烬边境 · Ashfall Frontier
Unity 纯二维斜俯视合作生存游戏的阶段 0 可运行原型工程。主工程目标编辑器为 Unity 6000.3.24f1。本阶段实现空间、楼层、虫族蠕虫成长、载具岗位、改装、库存和持久化的第一条技术闭环；完整策划中的六地区、八主角、全部武器及四十小时内容仍是后续开发目标。
打开与运行
- 使用 Unity Hub 打开本目录，等待包导入和脚本编译。工程位置虽然含
Godot，实际是 Unity 项目。 - 首次导入会创建 URP 2D 渲染配置及
Assets/Ashfall/Scenes/Frontier.unity。也可执行菜单 Ashfall → Configure project。 - 打开 Frontier 场景并按 Play。选择人类或 虫族 · 蠕虫幼体，开始新远征或继续世界。
- 选择合作房间后，其他电脑使用房主的局域网 IP 加入。端口为 UDP 7777。此版本尚未接入 Relay。
本机 6.3 下载暂未完成。可直接运行 Builds/Windows/AshfallFrontier.exe，或执行 Tools/OpenValidation.ps1 打开已通过验证的 Unity 6.1 副本。游戏源码相同；版本差异见 Pipeline 说明。
同一电脑运行多个客户端时分别添加 --profile host、--profile guest1 等参数，避免使用同一个持久身份。普通局域网玩家不需要填写该参数。
第一条游玩路线
- 出生点西南方是前哨基地。走到南侧亮色入口，自动进入。靠近共享仓库按 E 存取材料。
- 虫族初始为蠕虫，可撕咬和短时钻地。在仓库取得生物质与样本，前往东南侧蜕变茧，花费随身生物质 20、样本 1进化成掘袭猎手。原型目前只有这一条成体分支。
- 在基地按 B，选择楼梯，放在中部空地；沿楼梯到二层，铺楼板，安装研究设施。楼梯向画面上方连接约四米远的平台。
- 西北研究站有两层。先在一层开启发电机，再去二层解析样本，解锁机械重型武器。
- 东方机械履带车和生物驮兽可步行进入。底层是货仓和维修制造台，上层是驾驶台、炮手台及医疗设施。
- 驾驶台按 E 操作：W/S 前后，A/D 转向，鼠标独立瞄准，左右键操作主/副武器。另一玩家接管炮手台后获得主武器组，驾驶员保留副武器组。
- 驾驶台按 E 只返回舱内。其他乘员能在行驶中走动、上下楼、制造和维修；车辆停稳落地后才可走出舱门。
- 北方有三层飞行样机。驾驶台按 2 切换地面、低空、高空，按 1 开关巡航。停驻维修台可以安装兼容模块。
- 南部有资源，东南有敌群和小型首领。M 查看位置。
操作
| 按键 | 功能 |
|---|---|
| WASD / 鼠标 | 移动 / 瞄准 |
| 左键 / 右键 | 主攻击 / 载具副武器 |
| Shift / Space | 冲刺或车辆加速 / 制动 |
| E | 设备交互、采集、进入或离开操作台 |
| 1 / 2 | 徒步技能或载具巡航 / 航空高度 |
| B / R | 建造模式 / 构件转向 |
| Tab / M / Esc | 背包 / 地图 / 菜单 |
| 滚轮 | 缩放 |
开发与验证
不依赖 Unity 的权威模拟测试：
dotnet run --project Tests/Ashfall.Specs/Ashfall.Specs.csproj
Unity CLI（可执行文件默认位于 %LOCALAPPDATA%\Unity\bin\unity.exe）：
& "$env:LOCALAPPDATA\Unity\bin\unity.exe" pipeline install --project-path .
& "$env:LOCALAPPDATA\Unity\bin\unity.exe" run . -- -executeMethod Ashfall.Editor.ProjectSetup.Configure
& "$env:LOCALAPPDATA\Unity\bin\unity.exe" test . --help
& "$env:LOCALAPPDATA\Unity\bin\unity.exe" run . -- -executeMethod Ashfall.Editor.ProjectSetup.BuildWindows
run 自动处理 batchmode 和 quit，不要重复传入这些参数。已打开编辑器时优先使用 unity command --project-path . 的 Pipeline 命令，避免第二个编辑器争用工程。
核心测试覆盖岗位竞争、空间转移二次校验、楼层隔离、蠕虫成长、模块与库存事务、生产满仓、存档备份和四角色十五分钟模拟。模拟测试不是四进程联机或性能实测，引擎测试和网络运行结果见 验证记录。
已通过 33 项独立核心测试、3 项 Unity EditMode 测试、2 项 Play Mode 测试，以及 Windows 房主加三个独立客户端的联机测试。正式 6.3 和延迟丢包压力场景尚待验收。
Windows 打包输出：Builds/Windows/AshfallFrontier.exe。运行 Tools/NetworkSmoke.ps1 可启动一个房主和三个独立客户端完成自动联机测试，输出在 TestResults，独立使用 validation.sav。
工程结构
| 目录 | 内容 |
|---|---|
Assets/Ashfall/Core |
纯 C# 数据和房主权威模拟，无引擎依赖 |
Assets/Ashfall/Runtime |
输入、NGO、投影显示、界面、独立楼层物理场景 |
Assets/Ashfall/Editor |
初始配置、Windows 构建 |
Assets/Ashfall/Tests |
Unity 序列化与资源测试 |
Assets/Ashfall/Resources |
原型图集及生成的 ScriptableObject 内容表 |
Tests/Ashfall.Specs |
可单独运行的核心行为测试 |
Docs |
实现范围、后续路线、资源来源、验证记录 |
正常存档位于 %USERPROFILE%\AppData\LocalLow\XFEstudio\Ashfall Frontier\Worlds\frontier.sav。每五分钟及关键变更后保存，三个轮换备份；开始新远征前额外归档旧世界。身份数据在同级 Profiles 文件夹。不要将身份文件作为公开项目资源发布。
当前范围
原型使用 256×256 米逻辑地图、三辆实验载具、两层研究站、最多四层的限定基地建造区。角色与载具目前使用四向静态图集、少量程序动画、接触阴影与二维灯光。最终八/十六方向动作、法线图、专门日照投影、完整写实环境和音频仍需制作。
尚未完成：互联网会话与 Relay、延迟丢包压力验收、小型航空器停靠释放、伤害引起的内部火灾、完整多层寻路与室内战斗、四套虫族成体、独立双族装备存档、剧情地区和长期经济。详见 实现与后续路线。