FiveM Enhanced (GTA V Enhanced)：它是什么以及如何运行

FiveM Enhanced 是为 GTA V Enhanced 构建的 FiveM — 2025 年随 GTA VI 营销周期发布的 GTA V 重制版。如果您的玩家运行 GTA V Enhanced，他们需要连接到 Enhanced FiveM 服务器；Legacy 版本将不接受他们。其他一切 — 您的 Cfx.re 许可证、您的资源、您的 server.cfg — 都与 Legacy FiveM 几乎相同。

何时选择 Enhanced 与 Legacy

• Enhanced：如果您或您的社区使用 GTA V Enhanced，请选择此项。现代客户端，Cfx.re 的所有新更新都首先在此处发布，这也是 FiveM 开发的方向。
• Legacy：如果您的社区使用原始 GTA V（Enhanced 之前）或您依赖的关键角色扮演框架尚未针对 Enhanced 进行更新，请选择此项。

您可以随时在 ServerPrism 上在这两者之间切换 — 面板会处理运行时交换，并且您的文件会保留在原位。

启动新的 Enhanced 服务器

1. 在结账时（或在现有 FiveM 服务器的更改版本选项卡上），选择 FiveM Enhanced 作为运行时。
2. 等待安装完成 — 面板直接从 FiveM 文档中拉取最新的推荐 Enhanced 构建版本，因此您无需关注构建版本号。
3. 打开文件管理器，编辑 server.cfg，并将您的 Cfx.re 许可证密钥粘贴到 sv_licenseKey 行中。如果您还没有密钥，请参阅FiveM 许可证密钥设置。
4. 从控制台选项卡启动服务器。

这就是完整的首次运行流程。基础 FiveM 指南中的所有内容（许可证密钥、ensure 行、资源布局、数据库设置）也适用于此处。

使其成为 Enhanced 的那一行代码

在 server.cfg 中，靠近顶部：

sv_enforceGameBuild 2944

2944 是当前推荐的 GTA V Enhanced 构建版本。此行告诉服务器“拒绝任何客户端不在此 GTA V 构建版本上的玩家”。没有它，Legacy 客户端可能会尝试连接并出现版本不匹配。

• 在 Enhanced 服务器上：保留此行，或在 Cfx.re 推广新的 Enhanced 构建版本时更新数字。
• 在 Legacy 服务器上：删除此行（或将数字更改为 Legacy 构建版本，例如 2545、2802、2699）。

如果您完全跳过此行，服务器将接受其所在运行时的默认构建版本，这通常是大多数社区的安全选择。

在 Enhanced 和 Legacy 之间切换

您无需重新安装或重新上传任何内容即可在 ServerPrism 上切换运行时。在服务器的更改版本下，选择 FiveM (Legacy) 或 FiveM Enhanced。面板将：

• 交换底层运行时二进制文件。
• 保留您的 resources/ 文件夹、server.cfg、txAdmin 配置以及服务器上的任何 MySQL 数据。
• 使用新的二进制文件集重新启动容器。

切换完成后，如果您想更改构建目标，只需调整 server.cfg 中的 sv_enforceGameBuild 行：

• Legacy → Enhanced：添加（或更新）sv_enforceGameBuild 2944。
• Enhanced → Legacy：删除该行，或将其更改为 Legacy 构建版本号。

保存 server.cfg，从控制台选项卡重新启动，您就运行在新运行时上了。

资源兼容性

大多数 FiveM 资源 — chat、mapmanager、spawnmanager、oxmysql、ESX、QBCore、VORP 等 — 均可在 Enhanced 和 Legacy 上运行。少数特殊情况：

• 硬编码 Legacy 构建版本号的旧资源：检查资源的 fxmanifest.lua 中是否有 game 'gta5' 行以及任何 gameVersion 限制。如果资源明确针对 Legacy 构建版本，则可能需要其作者更新后才能在 Enhanced 上运行。
• 挂钩 GTA V 特定内存偏移的资源：一些作弊/处理程序依赖于 Legacy 内存布局。如果资源仅在 Enhanced 下启动时出错，则其原生调用可能需要更新。
• 带有 NUI 的 UI 资源：这些通常无需更改即可工作 — NUI 在浏览器覆盖层中运行，而不是在游戏引擎中运行。

如果资源仅在 Enhanced 上出错，控制台中的第一行 error 通常会指出需要更新的内容。检查资源的 GitHub 或 Cfx.re 论坛帖子，查找“Enhanced 支持”问题。

获取推荐的构建版本号

Cfx.re 在其文档中发布当前推荐的 Enhanced 构建版本。我们的 egg 安装程序在安装时会抓取此信息，因此全新的 Enhanced 安装始终会使用当前推荐的构建版本，而无需您查找。如果您想运行特定的 Enhanced 构建版本进行兼容性测试，请在重新安装之前在启动选项卡上设置 FIVEM_VERSION 变量。

客户端要求

• 玩家必须拥有 GTA V Enhanced（2025 年重制版）并安装 Enhanced FiveM 客户端。FiveM 启动器会根据玩家拥有的 GTA V 构建版本自动检测要使用的客户端。
• 原始 GTA V (Legacy) 上的玩家无法连接到 Enhanced 服务器。请引导他们连接到您的 Legacy 服务器，或要求他们升级到 Enhanced。

常见问题

• sv_licenseKey 错误：与 Legacy 相同 — 在 keymaster.fivem.net 重新生成。
• 玩家连接时出现“服务器构建版本不受支持”：您的 sv_enforceGameBuild 与玩家的客户端不匹配。确认已设置 2944 且玩家使用的是 Enhanced。
• 服务器未显示在 Enhanced 浏览器中：启动后服务器列表可能需要一分钟才能显示您的服务器。检查是否已设置 sv_hostname 并且没有资源在启动时致命错误。
• 某个资源在 Enhanced 上出错但在 Legacy 上正常工作：检查该资源的文档以获取 Enhanced 支持，或提交工单，我们将帮助识别失败的具体原生调用。

仍然遇到问题？

提交支持工单并附上您的控制台输出 — 包括第一行 error 及其提及的资源。如果您正在 Enhanced 和 Legacy 之间切换，请告诉我们您切换的方向，我们可以快速发现配置偏差。