脚本校验

脚本校验可以帮助你在导出之前尽早发现问题。

它是什么

校验是 GenPy 的自动检查系统。你可以在写作过程中反复运行它，及时发现错误、警告和优化建议，避免问题积累到发布前才集中爆发。

INFO

最好的做法不是“最后再校验一次”，而是把校验当成日常创作流程的一部分。

它会检查什么

• 游戏脚本中的语法错误
• jump 或 call 指向不存在场景时的未定义 label
• 没有出口、会让玩家卡住的死路场景
• 条件判断或剧情逻辑里使用的未定义变量
• 缺失的角色定义
• 存档兼容性问题，包括 pickle 安全相关问题
• 永远无法进入的代码或场景

如何使用

1. 在 Publish 模式或 Tools 中打开 Validation。
2. 对当前项目运行校验。
3. 按分类和严重程度查看问题列表。
4. 点击任意问题，直接跳转到对应行或场景。
5. 修复问题后再次运行校验。
6. 重复这个过程，直到剩余问题都已经确认无误。

严重程度说明

• Errors：必须修复的问题，可能导致故事无法正常运行
• Warnings：建议尽快处理的问题，可能会影响分支或玩家体验
• Info：用于提升脚本质量和一致性的提示

什么时候适合使用

• 每次导出之前
• 大幅修改剧情或路线结构之后
• QA 或试玩准备阶段
• 导入旧脚本、重组章节之后

它为什么有帮助

• 能尽早发现断掉的场景连接
• 帮你找出已经和当前结构不一致的旧逻辑
• 降低存档或路线推进出错的风险
• 在发布前提供一份清晰的修正清单

使用建议

• 越早校验、越频繁校验，修问题就越轻松。
• 先修复 Errors，再处理 Warnings。
• 大量修改 menu、label 或变量后，一定要重新运行一次校验。

TIP

把脚本校验和 Story Graph、Branch View、Variables 面板结合使用，排查问题会更全面。