脚本编辑器（Script Editor）

在GameMaker Studio 2中有许多地方都可以编写代码，无论是对象、场景还是各个实例，并且GML和拖放编程模式都内置了大量函数来让降低编码的难度。但是你仍然会需要自己创建一些特殊的方法来进行调用，或是有个别方法你会在许多地方都要复用，为了方便管理而需要把一部分代码单独存放，这就是脚本存在的意义。

注意：本节所涉及的脚本，在脚本中编写的代码与“事件”、“场景”或“实例”中创建的代码相同，本节所说的功能适用于所有脚本。注意：本页面介绍的都是用GML语言编写脚本，但你也可以用拖放模式来创建脚本。无论用什么方式编写代码，本页介绍的编辑器本身的功能全部适用。

脚本都是用GML语言编写的（详细的GML介绍可参考GML概述），这是GameMaker Studio 2内置的编程语言。一旦你逐渐熟悉了GameMaker Studio 2，并希望能做些更复杂的东西时，建议你开始学习GML语言，因为这可以更大扩展了制作游戏的可能性。你还可以使用拖放编程的方式来编写脚本，但是这需要另一套编辑器，这会在“操作脚本”的章节进行介绍，同样可以使用不同的输入变量、字符串、布尔值和各种特殊的值，这些值通常被称为实参，偶尔也被称为形参。如果你需要在对象中调用这个脚本，你可以把脚本名称作为GML语言的函数名来使用。你可以在资源树中右键单击并选择重命名来给脚本重新命名，需要注意，脚本名称必需符合函数的脚本规则，必需以字母开头，并且名称中只包含字母、数字以及下划线“_”符号。如上所述，你可以通过参数把一个数字传递给一个脚本，并使用这个参数来执行你所编写的任务代码。为了便于理解举一个例子，设想一个拖放操作（或是用GML写的代码），仔细想想它是如何工作的……你把它放在一个事件的代码区中，指定一些参数，它的实例就会根据你的要求行动。其实代码是完全一样的，唯一的区别是这是你自己编写的。我们不仅可以向脚本传递参数，同时也可以要求脚本返回某些值（使用return方法），因此我们可以用这个方法来构建复杂的计算方法（数学方法）或是进行一个复杂的碰撞检测或其它任意事情。但务必注意，返回方法应该在脚本最末的地方，确保在返回值之后没有任何需要执行的代码，因此你需要提前想好脚本的代码结构。当你首次创建资源时，会打开脚本编辑器，其中包含以下选项：

脚本编辑器的窗口顶部有一个标签选项卡，这让你可以同时打开编辑多个脚本（也可以在首选项中修改设置，改为每个脚本一个独立窗口）。你可以单击脚本标签，然后拖放进行排序操作，或者也可以将选项卡从窗口中拖出来形成一个独立窗口并单独放置到工作区中。如果将脚本标签直接拖出IDE窗口，则会生成一个独立的新的IDE窗口来存放该脚本，与主窗口的使用完全一致。

这里是创建脚本编写代码的主要区域，脚本需遵循GML语法规则进行编写（详细需参阅“GML概述”部分），而且编辑器自带补全提示功能：

当你编写代码时，编辑器内会弹出（一般会有少许延迟，可在首选项中设置）提示窗口，其中会以首字母顺序依次排列可能相关的方法、参数等内容，您可以从中选择您需要的那项。在使用代码编辑器时，你还可以选中一行代码，然后使用Ctrl+C，Ctrl+X和Ctrl+V等标准的快捷键来进行复制、剪切和粘贴的操作。在编写代码的过程中，你可能会不小心写错，这时候IDE就会警告你犯错了，它会在出错的那一行前标记红色然后还有一个红色的感叹号“！”图标，此时你把鼠标放到错误提示区可以看到简单的错误描述，在输出窗口则会有完整的错误信息：

另外，你可以在代码中进行注释。注释对代码而言十分重要，它能把代码进行分割，保持更清晰的结构，让人一目了然为什么这些代码会在各自的位置。另外如果你与团队其他成员一起协作时，注释可以作为有效的笔记，让其他人能明白你已经做了些什么。即使你是独自一人进行开发，保留代码注释也十分重要，特别是你有其它事情导致你暂时放下了这个项目，一段时间后再回来看它时，能更快回忆起当初的工作内容。为代码做注释非常简单，你只需要在任何文本行的开头敲下“//”即可，或者也可以用段落注释，格式是“/* 注释内容 */”。另外也可以用快捷键直接操作Ctrl+K是标记注释，Ctrl+Shift+K则是取消注释格式，下图是两种注释格式示例

脚本中还可以支持JSDoc类型的注释，这样你就可以现在JSDoc中定义好一些通用的内容，然后在编辑代码时会显示在自动完成提示列表中。

你可能已经注意到了，脚本中的文本颜色有些是彩色的。这是脚本编辑器在解析了对象中内置的变量、函数等内容，然后根据配置对不同内容进行了颜色编码，这种颜色编码有助于你看的更加清晰不容易出错，假如你拼写了错误的名称或关键词就会立刻得到提示，但如果你不喜欢这种颜色编码也可以在首选项中选择关闭（或使用F10），其中也可以自定义不同的颜色编码。

在编辑器中任意位置右键单击可以打开以下菜单

除了常规的剪切、复制和粘贴等功能外，你还可以选择将选中的文本设置为注释格式，添加或删除缩进，或将代码窗口分割为1、2、3行来显示。最后的这些选项可以让你把窗口分割显示以方便在其中拖放不同的脚本来比对其中的内容：

这种浏览方式在比对或需要同时查看两个脚本时会非常有效，可以避免再开一个窗口或在几个标签之间来回切换。菜单里还有一个在Debug模式下使用断点的选项，最后是一个将脚本在GML代码模式和DnD拖放模式下切换的选项。要注意，如果把代码转换为DnD拖放代码块时，并不会为每一行代码单独创建独立的操作，而是用一个专门的区块把原先所有的代码都存放在其中。在编辑脚本时，你还可以使用代码片段的功能来提高效率。按下F4（译者注：官方手册写的是F2但已经过时了，现在应该是F4）键就会弹出一个代码片段窗口，你可以自定义自己需要的代码片段，只需要把他们保存到GameMaker Studio 2的目录下：\GameMaker Studio 2\TextEditor\snippets.txt中即可，你可以用任何文本编辑器来编辑这个文件：

• 每个代码片段都是单独的一行（不能有空行）
• 每个代码片段都以片段名称为开头（会显示在弹出列表中），名称后跟一个冒号“：”，后面再接具体的代码段
• 使用"#"号作为换行符，并把需要被选中的文字放到两个"|"号之间（译者目测无效）

请参考文件中现成的代码段例子，以了解该如何按照上述规则来编写自己的代码段，强烈建议你在进行修改操作之前首先备份一下该文件，并备份你所做的任何修改操作，因为一旦重新安装或更新GameMaker Studio 2都会重置该文件，此时你可以用你备份的文件来恢复你之前所做的修改。

译者注：下面贴出来的这段是目前默认的snippets文件中的预设内容

1 - block:{# |STATEMENT|;#}#

2 - if:if (|CONDITION|)#{# STATEMENT;#};#

3- if-else:if (|CONDITION|)#{# STATEMENT;#}#else#{# STATEMENT;#};#

4 - for:for (|INITIALISATION|; CONDITION; INCREMENT)#{# STATEMENT;#};#

5 - for i:for (i=0; i<|CONDITION|; i+=1)#{# STATEMENT;#};#

6 - while:while (|CONDITION|)#{# STATEMENT;#};#

7 - do:do#{# |STATEMENT|;#}#until (CONDITION);#

8 - repeat:repeat (|EXPRESSION|)#{# STATEMENT;#};#

9 - switch:switch (|EXPRESSION|)#{# case EXPRESSION: STATEMENT; break;# default: STATEMENT;#}#0 - with:with (|EXPRESSION|)#{# STATEMENT;#};#comment:// |TEXT|multiline comment:/*************************************************# |TEXT|# *************************************************/

IDE底部的信息栏会显示你当前编辑的行数以及所在的位置。同时也是一个代码提示器，它会以文本的形式提示你正在编辑的功能或函数所需的参数等信息。当你在编辑器中编写相关函数代码时，此处会突出显示该函数对应所需的参数。如果你在JSDoc脚本注释中自定义了帮助信息，这里也会进行相应的提示。