教學:製作附加包/函式

函式

系列教學

所屬系列

製作附加包

難易度

初級

前置知識

• 開始之前
• 包的構建
• 執行、除錯與匯出

適用版本

國際版

所有版本

實踐裝置

◄◄ 迷霧

◄ 實體生成規則

特殊字元 ►

結構 ►►

函式的功能與指令方塊類似，用於在遊戲中執行指令。

創作者可以在指令方塊中透過function指令來執行函式，在函式中也可以透過function指令來執行函式。將大量的指令透過函式來執行是一個不錯的選擇，方便編輯、檢視、使用和移植到其他存檔。

準備

在行為包的根目錄下建立一個資料夾並將其命名為functions，在這個資料夾裡面存放函式檔案。

使用方法

• 使用副檔名為.mcfunction的純文字檔案來儲存指令。
• 每一行寫入一條指令，這些指令將被按順序依次在遊戲中執行。
  • 增加空行不會影響遊戲對檔案的讀取。遊戲在讀取檔案時會跳過空行。
• 請在一行的開頭使用#來表示注釋行。遊戲在讀取檔案時也會跳過以#開頭的行。
• 在遊戲中使用/function指令來執行行為包中的函式。該指令也可以在指令方塊中執行。
• 在遊戲中使用/reload指令來重新載入行為包中已載入的函式，因此您無需退出遊戲就可以更新修改後的函式。該指令不能在指令方塊中執行。
  • 如果增加了新的函式，則需要重新進入遊戲才能被載入，而不是只使用/reload指令。

例子教學

在functions資料夾下新建文字檔，將其副檔名變更為.mcfunction。檔案的名稱將用於在遊戲中使用/function指令時識別檔案。如：hello.mcfunction。

使用文字編輯器開啟hello.mcfunction，在第一行寫入title @p title Hello!，儲存檔案。

在遊戲中載入包含了該函式檔案的行為包，進入遊戲後使用指令/function hello。如果沒有意外的話，你的畫面上應該正常顯示出了Hello主標題。

接下來放置一個指令方塊，在裡面輸入/function hello並啟動，結果是一樣的。

不需要退出遊戲，回到資料夾中，開啟hello.mcfunction，在第二行寫入title @p subtitle Hello Wiki!，儲存檔案。

回到遊戲使用/reload指令來重新載入函式檔案，再次執行指令/function hello。這時你的畫面上應該正常顯示出了Hello主標題和Hello Wiki!副標題。

至此，您可以發揮想象，自由創作只屬於您的函式了！

注意事項

如果檔案中包含中文字元，那麼請用UTF-8編碼格式儲存檔案，否則會導致中文在遊戲中顯示亂碼。

如果使用/function指令執行函式時顯示「沒有找到功能XXX」，請檢查檔案中是否有格式錯誤的指令，檔案中存在格式錯誤的指令會導致遊戲無法載入該函式檔案。

使用方塊呼叫function函式時，方塊變化（例如摧毀或被覆蓋）並不影響函式的執行。