UndertaleModTool中脚本引用重编译问题的分析与修复

UndertaleModTool中脚本引用重编译问题的分析与修复

UndertaleModTool The most complete tool for modding, decompiling and unpacking Undertale (and other Game Maker: Studio games!) 项目地址: https://gitcode.com/gh_mirrors/und/UndertaleModTool

问题背景

在UndertaleModTool项目（一个用于修改Undertale引擎游戏的开源工具）中，用户报告了一个关于脚本重编译后导致游戏崩溃的问题。该问题主要出现在处理包含脚本引用的GameMaker脚本时，特别是在2024.2及以上版本的GameMaker项目中。

问题现象

当用户修改并重编译"gamechar_sparkle"脚本后，在游戏运行到特定场景（如故事模式的迷你游戏部分或星光思维选择界面）时，游戏会崩溃并显示以下错误信息：

ERROR in action number 1
of Step Event0 for object obj_sparkle_elevator_cutscene:
Trying to construct something that isn't a function

错误堆栈显示问题起源于脚本引用处理不当，特别是在构造函数和脚本引用链的处理过程中。

技术分析

根本原因

1. GameMaker 2024.2+的变化：新版本的GameMaker对函数和脚本引用的处理方式有所改变，而UndertaleModTool尚未完全适配这些变化。

2. 脚本引用链：错误堆栈显示了一个复杂的脚本引用链，工具在处理这种引用关系时出现了问题。

3. 构造函数处理：虽然最初怀疑与构造函数有关，但进一步分析表明问题核心在于脚本引用的解析和重编译机制。

影响范围

该问题主要影响：

• 使用GameMaker 2024.2及以上版本创建的游戏项目
• 包含复杂脚本引用关系的脚本
• 使用构造函数的脚本（间接影响）

解决方案

项目维护者colinator27提交了修复代码（提交4c99ddf），主要改进包括：

1. 完善脚本引用处理：更新了工具对GameMaker 2024.2+中函数和脚本引用的处理逻辑。

2. 引用链解析优化：改进了对复杂脚本引用链的解析能力，确保重编译后引用关系保持正确。

3. 错误处理增强：增加了对异常情况的检测和处理，避免直接崩溃。

验证结果

修复后经过测试验证：

• 重编译包含脚本引用的脚本不再导致游戏崩溃
• 构造函数能够正常使用
• 复杂的引用关系得到正确处理

技术建议

对于使用UndertaleModTool的开发者：

1. 版本兼容性：注意工具版本与GameMaker项目版本的匹配，特别是使用较新GameMaker版本时。

2. 脚本引用检查：在修改包含复杂引用的脚本时，建议先备份原始脚本。

3. 测试策略：重编译后应在游戏各个相关场景进行全面测试，确保没有隐蔽的引用问题。

总结

这个问题的解决展示了逆向工程工具开发中的常见挑战：随着原引擎更新，工具需要不断适配新特性。UndertaleModTool通过改进脚本引用处理机制，成功解决了这一兼容性问题，为后续支持更高版本的GameMaker项目奠定了基础。

UndertaleModTool The most complete tool for modding, decompiling and unpacking Undertale (and other Game Maker: Studio games!) 项目地址: https://gitcode.com/gh_mirrors/und/UndertaleModTool