UE4SS项目中BPModLoaderMod加载失败的Unicode路径问题分析
项目地址: https://gitcode.com/gh_mirrors/re/RE-UE4SS 问题背景
在UE4SS项目（一个用于Unreal Engine游戏的脚本扩展系统）的使用过程中，部分用户报告BPModLoaderMod无法正常加载的问题。该问题主要出现在Escape the Backrooms和PalWorld等基于Unreal Engine 4.27的游戏环境中。
错误现象
当用户启用BPModLoaderMod并启动游戏时，系统会在控制台输出以下错误信息：
[Lua::execute_file] lua_pcall returned No mapping for the Unicode character exists in the target multi-byte code page.
stack traceback:
[C]: in function 'IterateGameDirectories'
...ooms\Binaries\Win64\Mods\BPModLoaderMod\scripts\main.lua:115: in local 'LoadModConfigs'
...ooms\Binaries\Win64\Mods\BPModLoaderMod\scripts\main.lua:163: in main chunk
问题根源
经过技术分析，该问题源于以下两个关键因素：
-
Unicode字符处理缺陷：BPModLoaderMod在遍历游戏目录时，无法正确处理包含非ASCII字符（特别是Unicode字符）的文件路径。
-
路径遍历函数限制：核心问题出在
IterateGameDirectories函数中，该函数在处理UTF-8编码的路径时存在兼容性问题。
具体案例分析
在用户反馈中，发现了两种典型的触发场景：
-
标准路径情况：即使游戏安装在纯ASCII路径下（如
E:\Steam\steamapps\common\EscapeTheBackrooms），如果游戏内容中包含特殊字符的PAK文件，也会触发此错误。 -
特殊字符路径情况：如某用户在PalWorld游戏中发现，
Pal\Content\Paks目录下存在名为╠∞└╟╨╟╕─ <-\Sirius_p.pak的文件，其中的Unicode字符直接导致了加载失败。
技术解决方案
UE4SS开发团队已经针对此问题提出了修复方案：
-
编码转换处理：在目录遍历函数中增加了对UTF-8编码路径的兼容处理。
-
错误处理机制：改进了异常捕获机制，确保遇到特殊字符时能够优雅降级而非直接崩溃。
-
路径规范化：在加载mod前对路径进行规范化处理，消除潜在的编码问题。
用户临时解决方案
在官方修复版本发布前，受影响的用户可以尝试以下临时解决方案：
-
检查游戏安装目录下是否存在包含非ASCII字符的文件或文件夹，特别是
Content/Paks目录。 -
暂时移除或重命名这些特殊字符命名的文件（确保先备份）。
-
如果问题依旧，可以考虑将游戏安装到纯ASCII字符组成的路径下。
总结
此问题揭示了在游戏mod开发中处理国际化路径的重要性。随着游戏全球化程度提高，开发者需要更加重视多语言环境下的路径处理。UE4SS团队对此问题的快速响应也体现了开源社区解决问题的效率。
对于普通用户而言，了解文件路径命名规范的重要性，避免在关键路径中使用特殊字符，可以有效减少此类问题的发生。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
