如何在 FiveM 服务器上安装 MLO

什么是 FiveM MLO

MLO 是社区对添加到 GTA V 地图中的自定义室内场景的称呼，其制作方式与 Rockstar 自带的可进入室内场景相同。玩家从街上直接无缝走进去，无需传送，也没有加载画面。

MLO 由地图作者制作，有的在 Cfx.re 论坛免费发布，有的收费，通常通过 Tebex 出售。对 FiveM 来说，MLO 只是一个流式加载地图文件的资源，因此安装方式与其他地图相同。

MLO 资源的结构

地图资源就是一个文件夹，里面有一个清单文件和一个存放游戏文件的 stream 文件夹：

my_mlo/
├── fxmanifest.lua
└── stream/
    ├── my_mlo.ymap
    ├── my_mlo.ytyp
    ├── my_mlo.ybn
    ├── my_mlo.ydr
    └── my_mlo.ytd

FiveM 文档给出的地图清单如下：

fx_version 'cerulean'
game 'gta5'
lua54 'yes'
this_is_a_map 'yes'

大多数下载的 MLO 已经包含这两部分。如果作者的清单里有额外的行，例如 data_file 条目，请原样保留。

安装 MLO

1. 解压下载的文件，找到包含 fxmanifest.lua 的文件夹。这个文件夹就是资源；有些下载包会在外面再套一层文件夹。
2. 将其上传到服务器的 resources 文件夹，文件夹名称保持简单：不要有空格。
3. 添加到 server.cfg：

   ensure my_mlo

4. 加载资源。重启服务器，或在服务器控制台运行 refresh 识别新文件夹，然后运行 ensure my_mlo。
5. 在游戏中前往该地点并走进去。如果墙壁缺失或从地板掉下去，请查看控制台中与该资源相关的错误。

完整重启服务器是加载新地图资源最稳妥的方式。

来自 Tebex 的加密 MLO

许多付费 MLO 使用 Cfx.re asset escrow：文件经过加密，只能在许可证密钥（license key）属于购买账户的服务器上运行。

• 用正确的账户购买。结账时关联的 Cfx.re 账户必须是拥有你服务器许可证密钥的那个账户。
• 上传所有文件，包括隐藏的 .fxap 文件。有些 FTP 程序会跳过隐藏文件，缺少它时资源会报错 "Failed to verify protected resource"。
• 控制台出现 "You lack the required entitlement"，说明许可证密钥和购买记录属于不同账户。请检查密钥，或在 Cfx.re 门户中将购买转移到正确账户；一次购买只能转移一次。
• 加密文件无法编辑，作者通常会让配置文件保持未加密，供你修改需要调整的设置。

需要更新游戏版本的 MLO

有些 MLO 使用了较新 GTA Online 更新中的道具或室内场景，需要服务器运行对应的 game build；在旧版本上，会缺少部分内容或资源无法启动。作者页面通常会注明所需版本。

在 server.cfg 中设置，例如：

sv_enforceGameBuild 3407

该设置只在服务器启动时生效，且每个版本都包含之前版本的内容，因此请使用你的 MLO 所需的最高版本。玩家加入时，FiveM 会自动将其切换到该版本。

冲突与性能

• 一个地点只用一个 MLO。两个替换同一建筑的 MLO 通常会冲突：墙壁闪烁、地板隐形、门的位置错误。只保留一个，或向作者索取兼容版本。
• 留意控制台中的超大资源。FiveM 会对占用内存超过 16 MB 的流式文件发出警告，超过 48 MB 时会提示这将导致流式加载问题，例如模型无法加载。尽量选择经过优化的 MLO。
• 不要一次全部安装。先添加几个 MLO，测试后再继续添加。出问题时，你就能知道是哪一个造成的。

只使用你拥有权利的 MLO

FiveM 的平台许可禁止以侵犯他人权利的方式使用平台，Cfx.re 论坛也不允许发布侵犯第三方知识产权的内容，例如真实品牌和从其他游戏中提取的 3D 模型。实际操作中：

• 免费 MLO 从其官方发布页面获取，付费 MLO 从作者处购买；
• 切勿使用付费 MLO 的泄露版或"破解版"：它们违反作者的许可，而且加密版本本来也无法运行；
• 在资源中保留作者的署名和许可证文件。

HytHost FiveM 服务器上的 MLO

在 HytHost FiveM 主机上，服务器由 txAdmin 运行，你的 server.cfg 和 resources 文件夹位于 txAdmin 的数据文件夹 txData 中。通过面板的文件管理器或 SFTP 将 MLO 上传到那里，并在 txAdmin 的 CFG 编辑器中编辑 server.cfg。

• 不要修改顶层文件夹中的 server.cfg：面板每次启动时都会重写它，而且 txAdmin 运行的也不是这个文件。
• 当 MLO 需要时，请自行将 sv_enforceGameBuild 添加到 txAdmin 的 server.cfg 中。
• 默认情况下，服务器每次启动都会更新到最新的 FiveM artifacts。

刚接触 FiveM？请先阅读如何搭建 FiveM 服务器。