openSAM 插件安装与廊桥连接完整教程

Alexcaptainhe

由于原版 SAM3 插件已不再更新，且与 x-plane 12 存在兼容性问题，现在在 XP12 中驱动动画廊桥主要依靠 openSAM 方案。这个帖子就专门讲一下 openSAM 怎么装、怎么用。

一、了解 openSAM

openSAM 是一个轻量级开源插件，用于替代 SAM 的基础功能：廊桥动画、VDGS 和 Marshaller 引导等。它在启动时会扫描启用了 SAM 的地景并读取原始配置文件，因此可以兼容大多数为 SAM 设计的老地景。

二、准备工作

需要的组件：

• openSAM 插件本体：在 X-Plane.org 论坛搜索“openSAM: an open source replacement for SAM”下载最新版本
• SAM_Library（资源库）：openSAM 本身不包含廊桥模型文件，需要调用 SAM_Library 中的模型
• 目标地景：本次以 Taimodels ZGSZ 或 NSS ZGSZ 为例
  
  

三、安装步骤（分步操作）

第一步：获取 SAM_Library

• 下载原版 SAM 插件压缩包（可以在 X-Plane.org 搜索相关资源帖找历史备份，或通过国内网盘资源获取）
• 解压后，在文件夹中找到名为 LIB 的文件夹
• 复制 LIB 文件夹中的 SAM_Library 文件夹
• 将 SAM_Library 粘贴到 X-Plane 12/Custom Scenery 目录下
• 注意：不要安装原版 SAM 插件，只需要 SAM_Library
  
  

第二步：安装 openSAM

• 下载 openSAM 压缩包后解压
• 将 openSAM 文件夹放入 X-Plane 12/Resources/plugins
• 将 openSAM_Library 文件夹放入 X-Plane 12/Custom Scenery
  
  

第三步：调整 scenery_packs.ini 排序

用记事本打开 X-Plane 12/Custom Scenery/scenery_packs.ini，确保以下顺序：

• SCENERY_PACK Custom Scenery/ZGSZ - ... （你的机场地景，放在最上面）
• SCENERY_PACK Custom Scenery/openSAM_Library/ （放在 SAM_Library 上面）
• SCENERY_PACK Custom Scenery/SAM_Library/
• SCENERY_PACK Custom Scenery/Global Airports/
• （其他依赖库和地景）
  
  

注意：openSAM_Library 和 SAM_Library 都需要放在 Custom Scenery 中，且 openSAM_Library 必须在 SAM_Library 之上。

四、飞行中如何使用

• 将飞机滑行到停机位，关闭发动机并拉起驻车制动
• 在 X-Plane 12 顶部菜单栏中，找到 Plugins -> openSAM -> Toggle UI
• 在弹出的控制窗口中点击 Dock Jetway 按钮，廊桥会自动移动连接到飞机舱门
• 准备起飞时，再次打开控制窗口点击 Undock Jetway 即可断开廊桥
  
  

五、常见问题

Q1：openSAM 安装后没有显示菜单或无法加载？

• 检查插件文件夹名称是否为 openSAM（注意大小写），以及是否放在了正确的目录 Resources/plugins 下
  
  

Q2：点击连接后廊桥没有反应？

• 检查飞机是否完全停在了廊桥感应范围内，有时需要微调停机位位置
• 检查机场地景是否支持 SAM 廊桥
• 检查 SAM_Library 是否已正确放入 Custom Scenery 并在 scenery_packs.ini 中有对应条目
• 建议查看 X-Plane 12/Log.txt，搜索 opensam 相关错误信息
  
  

Q3：多舱门飞机怎么连接多个廊桥？

• openSAM 支持连接多个廊桥，前提是飞机的舱门坐标已正确配置。可在 openSAM 的控制窗口中查看可用的廊桥列表
  
  

Q4：和 X-Organizer 一起使用注意事项

• 使用 X-Organizer 时，建议手动提高 SAM_Library 和 openSAM_Library 的排序优先级，或在软件中设置排除规则，防止自动排序打乱依赖库顺序
  
  

六、备选方案

如果你不想折腾 openSAM 的配置，也可以尝试使用 XP12 自带的原生廊桥（Shift+G 调出地面设备窗口），但此方式对大量依赖 SAM 的地景支持有限，且无法提供 VDGS 引导等高级功能。

大家还有没有遇到其他奇怪的问题？欢迎在下面讨论～

插件女侠

谢了，XP12换上openSAM确实比原版稳多了，不过装完记得去插件设置里手动指定原SA SAM的config路径，廊桥和VDGS才能正常联动。

kevinzg

感谢分享经验，非常有用                  

ty5050

感谢分享学习了

EZA

感谢楼主分享，实用性很强

yaphet9527

学习了，很好

kevinzg

可以试试                       

JackTang233

插件女侠 发表于 2026-6-15 10:09
谢了，XP12换上openSAM确实比原版稳多了，不过装完记得去插件设置里手动指定原SA SAM的config路径，廊桥和V ...

请问这个具体的设置在哪里？

，_HXW2F

学习了，感觉蛮麻烦的

goofydds

好复杂啊 有没有一键安装的方法 简单易懂一点的