模组生命周期

来源信息

• 原文仓库：github.com/nernar/nernar.github.io
• 许可说明：以原仓库或原站点公开许可声明为准。

署名信息

• 该页面内容翻译自nernar.github.io
• 原文档采用GNU通用公共许可证第3版（GPL-3.0）授权

模组生命周期描述了从点击启动到进入世界后的完整运行阶段。原文档将其拆分为预加载、启动脚本、主脚本和运行期自定义脚本四个层次。

启动前阶段

点击Play后，InnerCore会先扫描模组、收集脚本并确定资源加载清单。此时游戏尚未正式进入世界，但资源准备已开始。

预加载脚本

preloader类型脚本用于在游戏加载前处理资源，例如批量改色、生成缓存纹理或预处理界面资源。该阶段应避免重复重建同一批资源，以免增加启动耗时。

加载阶段

游戏加载过程中会执行launcher类型脚本。常见职责包括：

• 声明多人配置；
• 判断依赖是否满足；
• 决定是否执行Launch()进入主逻辑。

主逻辑阶段

main类型脚本承载核心玩法代码，例如物品与方块注册、回调监听、界面初始化和配方注册。

运行期扩展

custom类型脚本可在需要时通过runCustomSource按需调用，用于将可选逻辑拆分出主流程，降低主脚本复杂度。

实务建议

• 不要重复调用Launch()。
• 把高频逻辑与重运算拆分，减少单刻压力。
• 生命周期配置应与build.config中的sourceType保持一致。