教程:制作附加包/函数

函数

系列教程

所属系列

制作附加包

难度

初级

前置知识

• 开始之前
• 包的构建
• 运行、调试与导出

适用版本

国际版

所有版本

实践设备

◄◄ 迷雾

◄ 实体生成规则

特殊字符 ►

结构 ►►

函数的功能与命令方块类似，用于在游戏中执行命令。

创作者可以在命令方块中通过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函数时，方块变化（例如摧毁或被覆盖）并不影响函数的执行。