[TOC] * * * * * ## 腳本編輯器（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 > > 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腳本注釋中自定義了幫助信息，這里也會進行相應的提示。