命令/function

来自Minecraft Wiki
跳转至: 导航搜索
function
需要的权限等级

2‌‌[仅Java版]
1‌‌[仅基岩版]

限制条件

启用作弊‌‌[仅基岩版]

运行1个函数或者数据包内1个标签的所有函数。‌‌[仅Java版]

运行行为包内的1个函数。‌‌[仅基岩版]

语法[编辑 | 编辑源代码]

  • Java版
function <名称>
  • 基岩版
function <名称:路径>

参数[编辑 | 编辑源代码]

名称(基岩版:名称:路径

Java版:
格式是namespace:path/to/function/file#namespace:path/to/function/tag
没有#前缀的namespace:path/to/function/file格式会运行[data_pack]/data/namespace/functions/path/to/function/file.mcfunction处的函数。
#前缀的#namespace:path/to/function/tag格式会运行所有[data_pack]/data/namespace/tags/functions/path/to/function/tag.json标签下的函数。
基岩版:
格式是path/to/function/file
运行[behavior_pack]/functions/path/to/function/file.mcfunction处的函数。

效果[编辑 | 编辑源代码]

若参数未正确指定、所选的函数不存在(包括无效)或标签不存在(包括为空以及含有无效函数)时命令失败。

成功时,以实体或命令方块的身份运行指定的函数。

示例[编辑 | 编辑源代码]

  • Java版中:
    • 运行data/custom/functions/example/test.mcfunction处的函数:/function custom:example/test
    • 运行所有data/custom/tags/functions/example/test.json标签下的函数:/function #custom:example/test
    • 如果半径2格内存在羊,则运行函数:/execute if entity @e[type=sheep,distance=..2] run function custom:example/test
    • 执行者不是玩家时,运行函数:/execute unless entity @s[type=player] run function custom:example/test

历史[编辑 | 编辑源代码]

Java版
1.12pre1加入了/function
1.1317w49b/function现在接受数据包的标签作为其参数。
/execute [if/unless]的存在而移除了[if/unless]
基岩版
1.8.0beta 1.8.0.8加入了/function