入门

安装

构建好的包已提交到仓库。只有修改代码时才需要工具链。

安装包#

  1. 克隆或下载分支 claude/737ng-xplane-msfs-convert-wel44p。贴图约 700 MB。
  2. 在 MSFS 2024 中打开 Developer Mode(Options → General → Developers),并安装 SDK(Help → SDK installer)。
  3. Tools → Project Editor → File → Open project → msfs2024\LevelUp737NG.xml。
  4. 选中包 levelup-aircraft-737ng,按 Build All。第一次构建要转换约 85 张大贴图,需要一些时间。
  5. 把 msfs2024\Packages\levelup-aircraft-737ng 复制或用 junction 链接到 MSFS 2024 的 Community 文件夹,然后重启模拟器。
  6. 选择 LevelUp 737-800 (CFM56-7B26)。

确认已加载#

  • 控制台(Developer Mode → Tools → Console)显示 LU737 systems: initialised。
  • L:LU737_WASM_BUILD 显示 build 号,应为 75。
  • L:LU737_WASM_ALIVE 为 1,L:LU737_WASM_FRAME 和 L:LU737_WASM_TIME 不断增加。

L:var 可以在 Developer Mode → Tools → Behaviors → LocalVariables 中读取,也可以用任何 L:var 工具读取。

构建失败时#

问题 处理方法
SDK 拒绝 8192 px 的贴图,或显存紧张(全部贴图约需 2.5 GB) python3 tools/build_package.py --max-tex 4096
模块化 SimObject 布局(common/、presets/、liveries/)被拒绝 python3 tools/build_package.py --skip-models --legacy,然后构建 msfs2024-legacy\LevelUp737NG.xml

首次飞行须知#

  • 驾驶舱操纵只用左键和滚轮。见驾驶舱操纵。
  • IRS 校准默认按真实时间进行(随纬度 5 到 17 分钟)。把 L:LU737_IRS_ALIGN_TIME 设为 1 是 60 秒,设为 2 是瞬间完成。见选项。
  • 在 CDU 中输入机场:第一次输入时,Zibo 的 FMS 会显示 NOT IN DATA BASE,此时正在从 MSFS 读取该机场的程序。稍等片刻再输入一次。
  • 硬件油门:默认情况下,移动硬件油门会超控自动油门;停止移动 2 秒后,自动油门收回油门杆。可用 L:LU737_THR_HW_MODE 更改。
  • 目前没有声音。GPWS 和 TCAS 警告只显示在 PFD 和 ND 上。

从源码构建#

要求:Python 3.11+,带 numpy 和 Pillow;clang 18 和 lld 18,支持 wasm32;Node.js 20+。

python3 tools/build_package.py

这一步重新生成配置,转换模型和贴图(第一次约 12 分钟),写出驾驶舱交互行为,构建系统模块和显示组件。

wasm/build.sh test
wasm/build.sh install

第一条运行原生单元测试。第二条构建 lu737_systems.wasm 并复制到包中。每次 push 时 GitHub Actions 都会执行这两步。

完整说明(包括 oracle(对照基准)和反编译器)见构建与安装。