测试与调试 » 调试菜单
March 13, 2026

调试菜单

进行中

本指南仍在扩展和完善中。功能、截图和说明可能会在 Talescape 正式发布前发生变化。若有疑问或需要帮助,请在 官方 Talescape Discord 提问。我们会根据需要澄清或更新页面。

调试菜单 是一个测试工具,可在编辑器中预览故事时检查并修改故事状态。它允许你查看日志、编辑变量并模拟库存变化,以测试故事在不同条件下的反应。

你可以在故事预览期间通过选择 调试 图标打开调试菜单。

1. 概览

调试菜单包含三个主要标签页:

  • 日志: 在预览过程中显示故事事件、动作和系统消息。
  • 库存: 查看并修改故事中使用的物品数量。
  • 变量: 实时查看并更改变量的值。

通过调试菜单所做的任何更改仅影响当前预览会话。它们不会保存到你的故事中,重启预览后会重置。

2. 日志

2. 日志

日志 标签显示故事运行时幕后发生的情况,帮助你跟踪故事流程、测试逻辑并了解某些事件何时发生。

你可以看到:

  • 触发器激活和动作结果
  • 对话进度和条件检查
  • 由玩家选择引起的变量或物品变化

日志标签主要是讲故事的辅助工具,帮助 Bards 确认故事逻辑按预期顺序运行。它不会显示技术或运行时错误。

3. 库存

3. 库存

库存 标签列出故事中所有可用物品,不仅限于玩家当前持有的。你可以自由调整它们的数量来测试制造、谜题或基于物品的条件。

你可以:

  • 使用 + / − 按钮添加或移除任意物品的数量。
  • 按名称搜索物品。

这允许你测试以下场景:

  • 使用配方合成新物品。
  • 检查在物品存在时事件是否触发。
  • 验证依赖已收集物品的剧情分支。

4. 变量

4. 变量

变量 标签显示故事中定义的所有变量及其当前值。你可以修改它们以模拟玩家决策或测试替代剧情路径。

你可以:

  • 切换 flags(true/false)。
  • 直接修改 数值
  • 编辑 文本 值。
  • 重置 单个变量。

当新变量被创建或更改时,变量列表会自动更新。

5. 测试流程

调试菜单是为创意测试设计的,而不是技术调试。它帮助你验证:

  • 选项和变量按预期工作。
  • 物品和合成逻辑正常工作。
  • 剧情分支在满足条件时解锁。
  • 玩家状态转换保持一致。

你可以将调试菜单与编辑器检查系统结合使用,在发布前执行完整的验证流程。

6. 最佳实践

  • 使用 日志 跟踪故事流程并确认事件顺序。
  • 使用 变量 直接跳转到特定分支以快速测试。
  • 使用 库存 测试合成或物品限制,而无需重放早期场景。
  • 经常重置以验证从全新开始故事能否正常运行。

调试菜单让你完全掌控测试,在故事到达 Dreamers 之前探索每个分支、决策和结局。

下一步: 自动化校验