UE4SS项目在Abiotic Factor游戏中的BPModLoaderMod崩溃问题分析

UE4SS项目在Abiotic Factor游戏中的BPModLoaderMod崩溃问题分析

【免费下载链接】RE-UE4SS Injectable LUA scripting system, SDK generator, live property editor and other dumping utilities for UE4/5 games 项目地址: https://gitcode.com/gh_mirrors/re/RE-UE4SS

问题概述

在Abiotic Factor游戏（基于Unreal Engine 5.3.2）中使用UE4SS项目的BPModLoaderMod时，发现了一个奇怪的崩溃问题。当BPModLoaderMod被启用且特定用户mod存在于Mods目录中时，游戏会在启动时立即崩溃。值得注意的是，这个崩溃甚至不需要用户mod被显式启用，只要它存在于Mods目录就会触发。

问题表现

崩溃的具体表现是：

1. 当BPModLoaderMod被启用（在mods.txt中设置为BPModLoaderMod : 1）
2. 同时特定用户mod（如MyPlayground）存在于Mods目录中
3. 游戏会在启动时立即崩溃

技术分析

从崩溃日志和代码分析来看，这个问题似乎与Lua脚本执行环境有关。核心问题出现在BPModLoaderMod尝试加载mod时，特别是在调用UEHelpers.GetWorld()函数时。

在原始代码中，BPModLoaderMod有一个手动加载mod的函数：

local function LoadModsManual()
    LoadMods(UEHelpers.GetWorld())
end

这个函数通过Insert键注册：

RegisterKeyBind(Key.INS, LoadModsManual)

虽然理论上这个函数应该只在按下Insert键时才会被调用，但实际表现表明在游戏启动时就有某些因素触发了相关逻辑。

问题根源

深入分析后发现，问题的根本原因可能与以下因素有关：

1. UEHelpers.GetWorld()的不稳定性：在游戏主菜单阶段调用此函数可能导致异常
2. Lua环境初始化顺序：mod加载顺序可能影响了某些关键组件的初始化
3. 内存或栈损坏：崩溃日志显示可能存在栈损坏问题，这在Unreal Engine插件开发中是常见问题

解决方案

这个问题最终通过UEHelpers模块的改进得到了解决。具体来说：

1. 改进了UEHelpers.GetPlayerController的实现，使其在主菜单阶段不会抛出错误
2. 优化了mod加载逻辑的执行时机
3. 增强了错误处理和边界条件检查

经验总结

这个案例提供了几个有价值的经验教训：

1. 环境敏感的函数调用：在游戏不同阶段（如主菜单、游戏中等）调用某些引擎函数可能有不同表现
2. 隐式依赖关系：即使代码看起来不会在特定情况下执行，环境因素仍可能导致意外行为
3. 崩溃诊断：UE4SS的崩溃有时表现为栈损坏等难以直接诊断的问题，需要系统性排查

对于UE4SS开发者来说，这个案例强调了在mod开发中考虑游戏状态和生命周期的重要性，以及需要谨慎处理那些可能在不同游戏阶段表现不同的引擎函数调用。

【免费下载链接】RE-UE4SS Injectable LUA scripting system, SDK generator, live property editor and other dumping utilities for UE4/5 games 项目地址: https://gitcode.com/gh_mirrors/re/RE-UE4SS