欢迎阅读我们 2025 年 3 月的 FiveM、RedM 和 FXServer 发行说明。

关键发展变化

改进的游戏客户端身份验证

在经历了三月份类似此次服务中断等几次重大发布尝试后，我们推出了与 Rockstar Games Launcher 更强大的集成功能，在启动 FiveM 和 RedM 时验证玩家是否拥有有效的 GTAV 或 RDR2 授权。这项新的集成解决了许多之前可能出现的身份验证失败问题。

除此之外，在过去两个月里，我们还逐步向所有玩家推出了新的身份验证算法。这项新算法是我们持续努力解决提供虚假夸大单服务器玩家数量的服务问题所采取的措施之一。

加载屏幕旋转器切换

社区成员tens0rfl0w添加了一个新的控制台变量 (ConVar)，以在连接到服务器时禁用默认的加载屏幕微调器。

您现在可以通过在服务器配置文件中添加此行来禁用它：setr sv_showBusySpinnerOnLoadingScreen false

突出显示的提交

公民外汇/fivem

• 修复（net/five）：修复 CTaskNMShot 补丁 b3407 – 纠正 CTaskNMShot 补丁的内存偏移，确保它与版本 b3407 正确对齐并防止相关问题。
• 修复（code/rdr3）：修复旧版本的 SimpleAllocator 模式– 调整 SimpleAllocator 模式以有条件地为旧 RDR3 版本选择正确的偏移量，避免可能的内存损坏。
• feat（脚本）：创建 CfxThread 来抽象 GtaThread – 进一步增强新的 CfxThread 概念来取代直接使用 GtaThread，改进多构建运行时支持。
• 修复（fxserver）：合并调整后– 删除 FXServer 数据包处理中的过时案例，解决数据包统计的潜在问题。
• 调整：迁移 Linux 构建的本机数据源– 更新 Linux 构建过程以从 HTTPS 端点下载本机数据，从而提高安全性和可靠性。
• fix(mono)：本机声明更改后修复包装器– 更正 Mono 包装器函数参数以匹配更新的本机声明，确保正确的调用行为。
• fix(ext/natives)：修复资源清单文档的链接– 将资源清单文档 URL 更新到正确的位置，提高开发人员参考的准确性。
• 修复（scripting-rdr3）：将所有 GtaThreads 初始化为零– 修复 RedM 中 CfxThread 之后的回归。

CitizenFX/Fivem文档

• 调整：更新文档 URL – 修改多个文档链接以将开发人员引导至较新的http://docs.fivem.net域。
• 游戏服务器更新– 修改服务器设置文档，广泛指导用户使用授权托管服务提供商，而不是专注于单一服务。

公民外汇/原住民

• 调整：更新文档 URL – 更新 gamerTagId 引用的文档 URL，将用户引导至当前文档域。
• 更新部署– 添加安全措施以掩盖日志中的部署机密，防止未经授权的访问。
• 更新部署– 通过在 rsync 命令中合并 SSH 来改进部署，以实现安全文件传输。

社区贡献

本月，我们在三个 GitHub 存储库上收到并合并了 33 个社区贡献，感谢大家！

公民外汇/fivem

• 阿瓦里安骑士
  • 修复（mumble）：将 MAX_USERNAME 长度与 FXServers 限制相匹配– 将 Mumble 的用户名长度限制与 FXServers 规范对齐，防止意外断开连接。
• DaniGP17
  • feat(gta-streaming-five)：允许编辑场景图池– 支持场景图池的动态编辑、修补天空门户标志，并优化内存偏移以改善流媒体。
• 埃布韦
  • 修复（五/游戏）：乘客的自定义电台同步– 纠正乘客自定义电台的同步，确保准确的元数据检索。
  • 修复（v8/脚本）：不要将 int64 编码为 BigInt – 通过将 int64 保留为数字来增强脚本一致性，提高与 msgpack-lite 的兼容性。
• 不懒惰
  • tweak（本机）：更新 ExecuteCommand 文档– 阐明 ExecuteCommand 使用的权限要求，添加 Lua 示例和 ACL 设置指南。
• 亚历克斯·吉雷
  • 修复（core/rdr3）：AMV 硬编码限制导致闪烁– 动态调整 RDR3 中用于 AMV 状态的位集大小，修复潜在的越界内存问题和闪烁效果。
• d22tny
  • tweak（gta-core-five）：将 game_useSynchronousAudio convar 默认设置为 true 以默认的无上限 fps – 将默认音频处理切换到无上限 FPS 的同步模式。
  • feat(extra-natives/five): visual settings getter native – 添加 GET_VISUAL_SETTING_FLOAT native 以从游戏的视觉设置中检索特定的浮点值。
• 局外人31000
  • 修复（extra-natives-rdr3）：修复网络对象旋转同步– 纠正远程网络对象的旋转混合，改善同步。
  • 修复（gta-core-rdr3）：防止玩家被删除– 添加检查以避免错误地从游戏中删除玩家角色。
  • feat(extra-natives-rdr3)：为 RedM添加GET_PED_BONE_MATRIX原生功能- 引入用于检索 ped 骨骼变换矩阵的原生功能，帮助进行高级操作。
• tens0rfl0w
  • 修复（核心五）：tmp 禁用构建 <= 2189 上的扩展 blip 类别– 通过关闭旧游戏构建的扩展 blip 类别来防止不稳定。
  • 调整（游戏服务器）：不要强制使用 OneSync 的会话管理器– 如果启用了 OneSync，则停止强制运行会话管理器资源，从而提供配置灵活性。
  • feat(loading-screens-five)：在加载屏幕中隐藏忙碌旋转器的选项– 添加一个开关以在加载期间移除忙碌旋转器，从而提供更清晰的加载屏幕。
  • 修复（核心五）：CWeaponInfo 崩溃缓解– 检查 CWeaponInfo 的指针有效性，减少与无效类实例相关的崩溃。
  • 修复（核心五）：反向移植装饰器崩溃缓解– 反向移植修复程序，以防止旧游戏版本的装饰器系统崩溃。
  • 修复（游戏/五）：修复面具开关上头发消失的问题– 通过调整数组初始化确保头发数据在面具变化期间保持可见。
  • tweak（nui/core）：在 WndProc 上阻止 X-Buttons – 当 NUI 完全聚焦时，防止 X-Button 按下中断相机移动或一键通状态。
  • 调整（输入/五）：仅在完全失去焦点时刷新鼠标按钮– 将鼠标按钮重置限制为真正的失去焦点事件，保留即按即说状态。
  • 调整（nui/core）：在主菜单中禁用光标剪辑– 删除主菜单中不需要的光标剪辑以恢复原始光标自由。
  • 修复（脚本/node-v22）：隔离数据释放排序– 调整清理顺序以避免 node-v22 脚本隔离数据中的内存问题。
  • feat(core-five)：自定义和扩展的 blip 类别– 引入命名（12-133）和未命名（134-254）blip 组，以便通过自定义标签增强地图组织。
  • tweak(github/ci)：使用容器注册表进行身份验证– 将容器注册表登录步骤添加到 CI 管道，以便正确使用 Docker。
  • tweak(github/ci)：将 repo 名称转换为小写– 通过使用小写的存储库名称确保一致的 Docker 映像标记。
  • tweak(github/ci)：重新设计 PR 签出操作– 更新 PR 签出流程和 Docker 构建步骤，提高 CI 效率和清洁度。

CitizenFX/Fivem文档

• Legacy-TacticalGamingInteractive
  • 文档（服务器/命令）：更新 CMoveObject 值并为 fragGtaInst 添加新选项– 根据新反馈调整 CMoveObject 的记录限制并引入 fragInstGta 池大小选项。
• tens0rfl0w
  • 调整（nui/loading-screens）：文档繁忙微调器选项– 指导用户禁用默认加载微调器，增强可能的加载屏幕定制。

公民外汇/原住民

• 科劳拉
  • 更新不正确/误导性的形状测试标志名称– 更正参数名称并澄清跟踪选项标志，使形状测试逻辑更加直观。
• freedy69
  • 文档 DrawHudOverFadeThisFrame – 重命名并正确描述在淡入淡出层上绘制的 HUD 函数。
  • 使用真实名称 0x632B2940C67F4EA9 – 采用 GET_MOUSE_EVENT 作为 scaleform 鼠标事件原生的官方标签。
  • 使用 0x0C5A80A9E096D529 的真实名称– 将警告消息函数别名更新为 SET_WARNING_MESSAGE_OPTION_ITEMS。
  • 文档 RESET_ADAPTATION (0xe3e2c1b4c59dbc77) – 添加正确的名称和使用详情以重置游戏的动画后 FX 适配。
  • 文档 0xEB709A36958ABE0D – 将函数重命名为 IS_UPDATING_MP_GAMER_TAG_NAME_AND_CREW_DETAILS，阐明其用途。