简介

BlocklyAts 目前提供的插件调试功能有限，因此排查运行时错误和意外行为可能具有一定挑战性。本章节提供了一些技巧，旨在帮助开发者从源头避免常见错误。

一般提示

• 您可以在软件目录的 example 文件夹中找到一些示例项目。
• 在编辑器中按 Shift 键可查看快捷键列表。
• 尝试使用未赋值的变量将导致运行时错误。为避免此类问题，建议在“插件加载”或“初始化”事件中为所有变量设置一个明确的默认值。

值类型

类型是编程中的一个核心概念。如果您的插件仅处理数字，类型错误通常不是问题。但当涉及到文本和列表时，理解类型系统就变得至关重要。 请阅读关于类型的专门文档。

BVE ATS 值的含义

在 BVE ATS API 中，许多状态和数据都通过整数来表示。 请阅读此文档以了解这些整数的具体含义。

简单调试

本软件提供了一些基础的调试功能以辅助开发。 请阅读关于调试的专门文档。

操作手柄

手柄状态只能在“状态更新”事件中进行设置。此操作仅影响单次渲染帧，如果在下一帧没有持续设置，手柄将恢复至玩家的输入状态。 与之不同，声音和面板的状态在设置后会保持不变。 使用“移动手柄”逻辑块不会影响“手柄位置”逻辑块的返回值。

警笛

• 对于音乐警笛（Music Horn），事件会在其开始和停止播放时触发。
• 对于其他类型的警笛，事件仅在开始播放时触发。