/summon

原文：Commands/summon；源修订：3831367。

权限等级：Java 版为 2，基岩版为 1；基岩版需要开启作弊。召唤实体。

语法

Java 版：

summon <entity> [<pos>] [<nbt>]

基岩版：

summon <entityType: EntityType> [spawnPos: x y z] [yRot: value] [xRot: value] [spawnEvent: string] [nameTag: string]
summon <entityType: EntityType> <nameTag: string> [spawnPos: x y z]
summon <entityType: EntityType> [spawnPos: x y z] facing <lookAtEntity: target> [spawnEvent: string] [nameTag: string]
summon <entityType: EntityType> [spawnPos: x y z] facing <lookAtPosition: x y z> [spawnEvent: string] [nameTag: string]

参数

entity（resource，注册表为 minecraft:entity_type）或 entityType: EntityType（枚举）：指定要召唤的实体。Java 版不能召唤玩家或钓鱼浮漂，尝试召唤它们的命令总是失败。基岩版只允许召唤特定实体类型，可召唤类型会出现在自动补全建议中；尝试召唤不允许的类型时，命令无法解析。

pos（vec3）或 spawnPos: x y z（CommandPositionFloat）：指定召唤实体的位置，省略时默认为命令执行位置。

Java 版的 nbt（nbt_compound_tag）：指定实体的数据标签，可以包含实体格式中的任意 NBT。

基岩版的 yRot: value 与 xRot: value（RelativeFloat）：指定被召唤实体的旋转朝向。

基岩版的 lookAtEntity: target（CommandSelector<Actor>）：指定被召唤实体要面向的实体。

基岩版的 lookAtPosition: x y z（CommandPositionFloat）：指定被召唤实体要面向的坐标。

基岩版的 spawnEvent: string（basic_string）：指定实体的游戏内事件，应为生成事件，即行为包中实体的事件名称。

基岩版的 nameTag: string（basic_string）：指定实体名称。

结果

命令不完整或任意参数指定不正确时无法解析。基岩版指定不可召唤的实体类型时无法解析。

Java 版中，<entity> 是 minecraft:player 或 minecraft:fishing_bobber、指定位置未加载、尝试生成与现有实体 UUID 相同的实体、X 或 Z 超出 [-30000000, 30000000)、Y 超出 [-20000000, 20000000) 时失败。基岩版指定位置未加载时失败；上述坐标范围不适用于基岩版结果表。

源修订的结果表将“在和平难度下尝试召唤敌对生物”列为成功。其他情况成功。

输出

Java 版失败时成功次数、success、result 均为 0，成功时均为 1。基岩版失败时成功次数为 0，成功时为 1。

示例

在执行玩家当前位置以西 10 格处召唤闪电：

summon lightning_bolt ~-10 ~ ~

Java 版中，在当前位置召唤名为 Powered Creeper 的闪电苦力怕（CustomName 是原始 JSON 文本）：

summon creeper ~ ~ ~ {powered:true,CustomName:"Powered Creeper"}

召唤一把无法破坏的钻石镐：

summon item ~ ~ ~ {Item:{id:"minecraft:diamond_pickaxe",count:1,components:{"minecraft:unbreakable":{}}}}

召唤蜘蛛骑士：

summon spider ~ ~ ~ {Passengers:[{id:"minecraft:skeleton",HandItems:[{id:"minecraft:bow",count:1}]}]}

召唤一只旋转 -90° 朝东、且没有 AI 的唤魔者：

summon evoker ~ ~ ~ {Rotation:[-90f,0f],NoAI:1}

召唤一名用 1 个泥土换取 5 颗钻石的村民：

summon villager ~ ~ ~ {Offers:{Recipes:[{buy:{id:"minecraft:dirt",count:1},sell:{id:"minecraft:diamond",count:5},rewardExp:false}]}}

召唤一只具有无限时长速度 II 效果的幼年僵尸：

summon zombie ~ ~ ~ {IsBaby:true,active_effects:[{id:"minecraft:speed",amplifier:1b,duration:-1,show_particles:true}]}

在前方 5 格召唤一个发光、将在 30 秒后爆炸、但不伤害方块或实体的激活 TNT：

summon tnt ^ ^ ^5 {Glowing:true,fuse:600s,explosion_power:0.0f}

基岩版中，在当前位置召唤掠夺者巡逻队长：

summon pillager ~ ~ ~ ~ ~ minecraft:spawn_as_patrol_captain

召唤一只名称为金色 Dolphin 的海豚：

summon dolphin §6Dolphin ~ ~ ~

召唤旋转 180 度的船：

summon boat ~ ~ ~ 180 180

外部链接

Microsoft Learn：/summon 命令（2024 年 8 月 1 日）。

来源为 Minecraft Wiki；本中文翻译/改编按 CC BY-NC-SA 3.0 共享。