# SAM FollowMe 安装 + 排错（分步指南）

> 适用：**X-Plane 11**（SAM 不支持 XP12；XP12 用免费开源的 openSAM，见文末）。
> 本文把「怎么装 SAM Suite → 怎么装/激活 FollowMe → 怎么用 → 出错怎么查」拆成一步步操作，照着做即可。

---

## 0. 先搞清楚概念（1 分钟）

**FollowMe（引导车）不是单独一个插件**，它是 **SAM 套件**里的一个模块。要让它跑起来，必须**三样齐全**，缺哪个都会出现「菜单能点、但没车」：

| 组件 | 作用 | 是否必须 |
|---|---|---|
| **SAM Base Plugin**（本体） | SAM 主程序（3.1.8+，最新 3.1.10） | ✅ 必须 |
| **SAM_Library** | 地景库（放 `Custom Scenery/`） | ✅ 必须 |
| **AirportVehicles** | **引导车模型的来源** | ✅ 必须（**不装就没车**） |
| **FollowMe** | 引导车功能本身（约 1.0.4） | ✅ 必须 |
| WorldJetways | 默认机场动态廊桥 | 选装（付费） |
| GroundService | 地勤车辆 | 选装 |

> SAM 全家桶由 **Stairport** 出品，**Aerosoft 是发行/分发方**。所以「用 Aerosoft 装」= 用 **Aerosoft One** 客户端装，或从 Aerosoft 商店买 Key。

---

## 一、准备

1. 确认是 **X-Plane 11**（XP12 请直接跳到文末用 openSAM）。
2. **Windows 先装 VC++ 2015–2022 x64 运行库**——很多「闪退 / 黑窗口」就是缺它。
   下载：微软官网搜 “Visual C++ Redistributable 2015-2022 x64”。
3. 全程**必须联网**（SAM 要在线拉组件、校验授权）。
4. 关掉杀软对 X-Plane 目录的实时扫描（避免安装被拦截）。

---

## 二、方式 A：用 **Aerosoft One** 安装 SAM Suite（推荐，最省事）

> 适用：你在 Aerosoft 商店买过 SAM / 有 Aerosoft 账号。

1. **下载安装 Aerosoft One 客户端**
   - 地址：<https://one.aerosoft.com/>（或 <https://www.aerosoft.com/en/one>）
   - 装好后**登录你的 Aerosoft 账号**。
2. **设置 X-Plane 路径**
   - 进 `Settings（设置）→ Simulator Paths（模拟器路径）`，指向含 **`X-Plane.exe`** 的那层目录（不是子文件夹）。
3. **找到 SAM**
   - 进 `Library（库）→ X-Plane → Available / Dependencies → Optional`。
   - 搜索 **SAM / SAM Suite / SAM3**。
4. **点 Install 安装**
   - 选择安装方式：
     - **One Library Install**：文件另存，用符号链接挂进 XP，便于启用/停用；
     - **Direct Install**：直接装进 X-Plane 目录（**新手选这个**，最直观）。
   - 把要装的组件逐个点 **Download/Install**：
     `SAM Base Plugin` → `SAM_Library` → `FollowMe` → `AirportVehicles`（→ 需要的话再装 WorldJetways / GroundService）。
5. **如果是外站购买的（非 Aerosoft 商店）**
   - 先在 Aerosoft One 里用 **“Activating an external product（激活外部产品）”** 注册你的产品 Key，再回到第 3~4 步安装。
6. **激活**
   - 通过 Aerosoft 商店购买的，通常**自动激活**（授权绑定账号）；
   - 若提示要 Key：游戏内进 `Plugins → SAM → Content Manager → 输入序列号 → Activate`。

---

## 三、方式 B：用 **SAM Suite 独立安装器**（没走 Aerosoft One 时）

1. 下载 **SAM Suite**（那个独立的安装器程序，**不是**插件本体）：
   - Stairport 官网 / x-plane.org 文件页 / Aerosoft 商店均有；官方入口可查 <https://stairport-sceneries.com/>。
2. 打开 SAM Suite，把 **X-Plane 主目录路径**指对，联网后它会**自动列出可装组件**。
3. 逐一点击下载安装（同方式 A 第 4 步）：
   `SAM Base Plugin` → `SAM_Library` → `FollowMe` → `AirportVehicles`。
4. 买了 WorldJetways 的，在 SAM Suite 里**输入序列号激活**。

---

## 四、装完检查目录结构（关键，别多套一层）

| 组件 | 正确位置 |
|---|---|
| SAM 本体 | `X-Plane 11/Resources/plugins/SAM/` |
| SAM 地景库 | `X-Plane 11/Custom Scenery/SAM_Library/` |
| DLC/模块 | `X-Plane 11/Resources/plugins/SAM/lib/` |

- ⚠️ 常见错误：变成 `SAM/SAM/…`（多套一层），插件就加载不了。
- **`scenery_packs.ini` 里 `SAM_Library` 要排在依赖它的机场地景之上**（顺序：自定义机场 → SAM_Library → `*GLOBAL_AIRPORTS*`）。

---

## 五、验证 + 激活

1. 启动 X-Plane 11 → 顶部菜单 `Plugins` 里能看到 **SAM** = 插件加载成功。
2. 进 `Plugins → SAM → Version & License` 检查版本、做一次激活（**FollowMe 有时要单独激活一次**）。
3. 进 `Plugins → SAM → Content Manager`，把上面几个组件**再确认下载/更新到最新**。

---

## 六、使用：叫引导车

1. 载入飞机，停在机场。
2. 进 `Plugins → SAM → FollowMe`（或在 `Settings → Keyboard` 里搜 `SAM` 绑定一个快捷键/摇杆键）。
3. 选 **“进场带路”**（从跑道带到停机位）或 **“去停机位/去跑道”**。
4. 黄色引导车就会开过来带你。

---

## 七、排错（按症状查）

| 症状 | 原因 / 解决 |
|---|---|
| **菜单能点，但没车**（最常见，报 `Failed Starting FollowMe Guidance, Vehicle Instance Error`） | 十有八九是 **AirportVehicles 没下全**：回 `SAM → Content Manager` 补下，并把 SAM 本体更新到最新 |
| 插件菜单是**空白窗口** | 删掉 `X-Plane 11/Output/preferences/SAM/`，重启 XP11 重来 |
| 进游戏**直接闪退** | 先删掉 `Resources/plugins/SAM` 文件夹，启动一次 XP，再用最新版重装 |
| **只有某些机场不行** | 机场地景不兼容 SAM。先在**默认机场**（如 KSEA）测：默认能用 = 是那个地景的问题，不是插件问题 |
| **地景库冲突** | `scenery_packs.ini` 里 `SAM_Library` 要排在相关地景**上面** |
| 找不到 SAM 菜单 | 确认装在 `Resources/plugins/SAM`，且没多套一层；插件管理里已启用 |
| 日志定位 | XP 主日志 `X-Plane 11/Log.txt` 搜 `SAM`；SAM 专用日志 `X-Plane 11/Output/SAM/log.txt` |

---

## 八、和你之前那个报错的关系（重要）

你之前在 **JARDesign FollowMe Car** 里遇到的 **“custom scenery error detected”**，本质是插件**读机场地景数据**时失败（去 `Custom Scenery` 找对应包 → 解析 `Earth nav data/apt.dat`）。

**SAM FollowMe 同样依赖机场的滑行道/停机位数据**。所以：
- 换成 SAM 后，如果**在同一个机场**还是带不了路 → 大概率是**那个地景包本身要修**，跟换不换插件无关；
- 该地景包的正确结构应是 `Custom Scenery/包名/Earth nav data/apt.dat`（别多套一层），且不要与默认 Gateway 机场 ICAO 重复。

---

## 附：XP12 用户 → openSAM

SAM **不支持 X-Plane 12**。XP12 请用免费开源的 **openSAM**：
- 项目地址：<https://github.com/hotbso/openSAM>
- 装法：把插件放进 `X-Plane 12/Resources/plugins/`，重启即可（不再需要 SAM Suite）。

---

## 资源

- Aerosoft One 客户端：<https://one.aerosoft.com/>
- Aerosoft One 用户指南：<https://cdnone.aerosoft.com/client/user-guide/en/>
- Stairport 官网 / 支持中心：<https://stairport-sceneries.com/>
- x-plane.org SAM 文件页：<https://forums.x-plane.org/files/file/59782-scenery-animation-manager-suite/>
- openSAM（XP12 免费替代）：<https://github.com/hotbso/openSAM>