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

调试菜单

进行中

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

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

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

1. 概览

调试菜单包含面向主要预览系统的专用选项卡:

  • **日志:**显示预览期间的故事事件、动作和系统消息。
  • **物品:**允许你查看并修改故事中使用的物品数量。
  • **变量:**让你实时查看并更改变量值。
  • **事件:**显示事件状态,帮助验证预览期间哪些故事事件处于激活状态。
  • **计时器:**显示计时器状态,包括活动倒计时和循环计时器行为。

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

2. 日志

2. 日志

日志 选项卡显示故事运行时幕后发生的情况。它帮助你跟踪故事流程、测试逻辑并了解特定事件何时发生。

你可以看到:

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

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

3. 物品

3. 物品

物品 选项卡列出故事中可用的所有物品,不仅限于玩家当前持有的那些。你可以自由调整它们的数量以测试合成、谜题或基于物品的条件。

你可以:

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

这让你可以测试诸如:

  • 使用配方合成新物品。
  • 检查当存在某物品时事件是否触发。
  • 验证依赖于收集物品的故事路径。

4. 变量

4. 变量

变量 选项卡显示故事中定义的所有变量及其当前值。你可以修改它们来模拟玩家决策或测试备选故事分支。

你可以:

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

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

5. 测试工作流

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

  • 选择和变量是否按预期工作。
  • 物品与合成逻辑是否正常。
  • 在正确条件下故事分支是否解锁。
  • 事件和计时器是否在预期时刻触发。
  • 玩家状态转换是否一致。

你可以将调试菜单与编辑器检查系统结合,形成发布前的完整验证工作流。

6. 最佳实践

  • 使用 日志 跟踪故事流程并确认事件顺序。
  • 使用 变量 直接跳转到特定分支进行快速测试。
  • 使用 物品 在不重放早期场景的情况下测试合成或物品门控。
  • 使用 事件计时器 来确认计时、触发和倒计时行为。
  • 经常重置以验证故事从全新起点也能正常运行。

调试菜单让你对测试拥有完全控制,可以在故事到达 Dreamers 之前探索每一个分支、决策和结果。

下一步: 自动化校验