运行指南
适用于已有本地工程、Windows 和 UE 5.7.4 的环境。
林间岩谷地图
第一版地形效果图，默认 1080p、不限制帧率；也可双击 VoxelDig/PlayTerrainStudy.cmd：
.\VoxelDig\PlayTerrainStudy.ps1关卡 /Game/Maps/TerrainStudy 在进入游戏后生成地形与景物。独立存档为 VoxelDig/Saved/Terrain/study.vdr。查看实现、优化与实测。
原有对齐与实验入口
在工作区根目录打开 PowerShell。原有对齐场景默认 1080p 窗口、不限制帧率：
.\VoxelDig\Play.ps1其他启动选项：
.\VoxelDig\Play.ps1 -Width 3440 -Height 1440
.\VoxelDig\Play.ps1 -FrameCap 120
.\VoxelDig\Play.ps1 -Legacy
.\VoxelDig\Play.ps1 -SurfaceNets脚本中的引擎路径为 C:\Unreal Engine\UE_5.7，换机器时需要调整。目前通过编辑器游戏模式运行，没有公开发行包。
操作
| 输入 | 功能 |
|---|---|
| W A S D / 鼠标 / 空格 | 移动 / 视角 / 跳跃 |
| F；飞行时空格 / Ctrl | 切换飞行；上升 / 下降 |
| 1 / 2 / 3 / 4 | 挖掘 / 填土 / 塑形 / 小范围凿岩 |
| 左键 / 右键 | 当前工具 / 填土 |
| Shift + 左键 | 塑形 |
| 滚轮 / − / = | 调整半径 |
| Z | 撤销，最多 16 步 |
| F5 / F9 | 保存 / 读取 |
| Q / R / Esc | 手电 / 返回起点 / 退出 |
默认存档为 VoxelDig/Saved/Terrain/original.vdr，Legacy 使用单独的 terrain.vdg。
测试命令
.\tools\Run-OriginalCompletionChecks.ps1.\tools\performance\Run-WholeGameBudget.ps1 -Width 1920 -Height 1080 -PhaseSeconds 30
.\tools\performance\Run-WholeGameBudget.ps1 -Width 3440 -Height 1440 -PhaseSeconds 15林间岩谷性能采样
先保存并关闭其他 UE 实例。输出目录必须是新目录；需要带并行游戏测试时才显式添加 -AllowConcurrentGames。
.\tools\performance\Run-TerrainStudyBudget.ps1 -Width 1920 -Height 1080 -PhaseSeconds 30 -OutputDirectory analysis\new-study-run\1080p脚本跑四阶段离屏采样，结果不是屏幕呈现 FPS。测试口径与排除样本说明。