陨烬边境 · 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、延迟丢包压力验收、小型航空器停靠释放、伤害引起的内部火灾、完整多层寻路与室内战斗、四套虫族成体、独立双族装备存档、剧情地区和长期经济。详见实现与后续路线。