Minecraft:Commands/loot: Difference between revisions

← Older edit

VisualWikitext

Latest revision as of 11:04, 9 May 2026

Template:Infobox command

Drops the given Minecraft:loot table into the specified inventory or into the world.

Syntax

Java Edition

loot <TARGET> <SOURCE>

In which:

<TARGET> is:

give <players>

Distributes items to players, ignoring empty item stacks.

insert <targetPos>

Distributes items to a container block, ignoring empty item stacks.

spawn <targetPos>

Spawns item entities. Empty item stacks are also spawned, but disappear instantly.

replace block <targetPos> <slot>

replace entity <entities> <slot>

Replaces item stacks into some consecutive Minecraft:slots in order. An empty item stack generated by the <SOURCE> clears a slot.

replace block <targetPos> <slot> <count>

replace entity <entities> <slot> <count>

Clears some consecutive Minecraft:slots, and then places item stacks into them in order. Empty item stacks are also placed. If the number of item stacks generated by the <SOURCE> exceeds the specified slot number, excess item stacks are ignored.

<SOURCE> is:

fish <loot_table> <pos> [<tool>|mainhand|offhand]

Simulates Minecraft:fishing with a specified tool at a specified position.

loot <loot_table>

Invokes a Minecraft:loot table directly.

kill <target>

Simulates killing a specified entity.

mine <pos> [<tool>|mainhand|offhand]

Simulates mining a block at a specified position with a specified tool.

Minecraft:Loot context provided by each <SOURCE> is:

<SOURCE>	Supplied loot context parameters
fish	Template:Cd entity: (If the executor is an entity) The command executor entity. Origin: The center of the block at the specified position. Tool: The specified item.
kill	Template:Cd entity: The specified entity. Origin: The command execution position. Damage source: The `magic` Minecraft:damage type Template:Cd entity: (If the executor is an entity) The command executor entity. Template:Cd entity: (If the executor is an entity) The command executor entity. Template:Cd entity: (If the executor is a player) The command executor player.
loot	Template:Cd entity: (If the executor is an entity) The command executor entity. Origin: The command execution position.
mine	Template:Cd entity: (If the executor is an entity) The command executor entity. Origin: The center of the block at the specified position. Tool: The specified item. Block state: The specified block. Block entity: (If the block is a block entity.) Block entity data of the block.

Bedrock Edition

loot <TARGET> <SOURCE>

In which:

<TARGET> is:

give <player: target>

Gives items to players, ignoring empty item stacks.

insert <position: x y z>

Distributes items to a container block, ignoring empty item stacks.

spawn <position: x y z>

Spawns item entities, ignoring empty item stacks.

replace block <position: x y z> slot.container <slotId: int>

replace entity <entity: target> <slotType: EntityEquipmentSlot> <slotId: int>

Replaces item stacks into some consecutive Minecraft:slots in order. An empty item stack generated by the <SOURCE> clears a slot.

replace block <position: x y z> slot.container <slotId: int> [count: int]

replace entity <entity: target> <slotType: EntityEquipmentSlot> <slotId: int> [count: int]

Clears some consecutive Minecraft:slots, and then places item stacks into them in order. Empty item stacks are also placed. If the number of item stacks generated by the <SOURCE> exceeds the specified slot number, excess item stacks are ignored. An entity or a container must have all the specified consecutive slots in order to clear and place items in it.

<SOURCE> is:

kill <entity: target> ["<tool>|mainhand|offhand": string]

Simulates killing a specified entity with a specified tool.

loot <loot_table: string> ["<tool>|mainhand|offhand": string]

Invokes a Minecraft:loot table with a specified tool.

mine <TargetBlockPosition: x y z> ["<tool>|mainhand|offhand": string]

Simulates mining the block at the designated position with a specified tool.

Arguments

Template:El: Template:Argument

Specifies which loot table to use.

Template:IN, Template:Arg desc

Template:IN, Template:Arg desc And it refers to a loot table with the path of "loot_tables/loot_table: string.json".

Template:El: Template:Argument

Specifies a tool to simulatively mine or fish.

Template:Arg desc

Template:El: Template:Argument

Specifies a tool to be used to simulatively kill or loot.

Template:Arg desc Can be mainhand and offhand, otherwise it represents an item id.

Template:Argument (in kill source)

Specifies one entity to kill simulatively.

Template:Arg desc

Template:Argument

Specifies one or more players to give.

Template:Arg desc

Template:El: Template:Argument and Template:Argument (in replace block and insert mode)
Template:El: Template:Argument (in replace block and insert mode)

Specifies the position of a block.

Template:IN: Template:Arg desc

Template:Argument (in spawn mode)

Specifies the location where item entities drop.

Template:Arg desc

Template:Argument

Specifies one or more entities to modify.

Template:Arg desc

Template:Argument

Specifies the number of consecutive slots to be cleared.

Template:Arg desc

Template:El: Template:Argument
Template:El: Template:Argument, slot.container, and Template:Argument

Specifies the inventory slot to be modified.

Template:Arg desc

Result

Output

Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table

History

Java Edition

Template:HistoryTable

Bedrock Edition

Template:HistoryTable

External links

Template:Cite

Navigation

Template:Navbox commands

Minecraft:de:Befehl/loot Minecraft:es:Comandos/loot Minecraft:fr:Commandes/loot Minecraft:ja:コマンド/loot Minecraft:ko:명령어/loot Minecraft:pt:Comandos/loot Minecraft:ru:Команды консоли/loot Minecraft:uk:Команди консолі/loot Minecraft:zh:命令/loot

@@ Line 4: / Line 4: @@
 * 2 {{only|java|short=1}}
 * 1 {{only|bedrock|short=1}}
-|others=Cheats only{{only|bedrock|short=1}}
+|others=[[Minecraft:Cheats]] only{{only|bedrock|short=1}}
 }}
-Drops the given loot table into the specified inventory or into the world.
+Drops the given [[Minecraft:loot table]] into the specified inventory or into the world.
 ==Syntax==
@@ Line 29: / Line 29: @@
 ::<code><''SOURCE''></code> is:
 ::: <code>fish <loot_table> <pos> [<tool>|mainhand|offhand]</code>
-:::: Simulates fishing with a specified tool at a specified position.
+:::: Simulates [[Minecraft:fishing]] with a specified tool at a specified position.
 ::: <code>loot <loot_table></code>
-:::: Invokes a loot table directly.
+:::: Invokes a [[Minecraft:loot table]] directly.
 ::: <code>kill <target></code>
 :::: Simulates killing a specified entity.
@@ Line 37: / Line 37: @@
 :::: Simulates mining a block at a specified position with a specified tool.
-::Loot context provided by each <code><''SOURCE''></code> is:
+::[[Minecraft:Loot context]] provided by each <code><''SOURCE''></code> is:
 :::{|class="wikitable collapsible collapsed
 ! <''SOURCE''> !!  Supplied loot context parameters
@@ Line 43: / Line 43: @@
 | fish
 |
-* '''{{MC/Cd|this}} entity:''' (If the executor is an entity) The command executor entity.
+* '''{{cd|this}} entity:''' (If the executor is an entity) The command executor entity.
 * '''Origin:''' The center of the block at the specified position.
 * '''Tool:''' The specified item.
@@ Line 49: / Line 49: @@
 | kill
 |
-* '''{{MC/Cd|this}} entity:''' The specified entity.
+* '''{{cd|this}} entity:''' The specified entity.
 * '''Origin:''' The command execution position.
-* '''Damage source:''' The <code>magic</code> damage type
+* '''Damage source:''' The <code>magic</code> [[Minecraft:damage type]]
-* '''{{MC/Cd|attacker}} entity:''' (If the executor is an entity) The command executor entity.
+* '''{{cd|attacker}} entity:''' (If the executor is an entity) The command executor entity.
-* '''{{MC/Cd|direct_attacker}} entity:''' (If the executor is an entity) The command executor entity.
+* '''{{cd|direct_attacker}} entity:''' (If the executor is an entity) The command executor entity.
-* '''{{MC/Cd|attacking_player}} entity:''' (If the executor is a player) The command executor player.
+* '''{{cd|attacking_player}} entity:''' (If the executor is a player) The command executor player.
 |-
 | loot
 |
-* '''{{MC/Cd|this}} entity:''' (If the executor is an entity) The command executor entity.
+* '''{{cd|this}} entity:''' (If the executor is an entity) The command executor entity.
 * '''Origin:''' The command execution position.
 |-
 | mine
 |
-* '''{{MC/Cd|this}} entity:''' (If the executor is an entity) The command executor entity.
+* '''{{cd|this}} entity:''' (If the executor is an entity) The command executor entity.
 * '''Origin:''' The center of the block at the specified position.
 * '''Tool:''' The specified item.
@@ Line 91: / Line 91: @@
 :::: Simulates killing a specified entity with a specified tool.
 :::<code>loot <loot_table: string> ["<tool>|mainhand|offhand": string]</code>
-:::: Invokes a loot table with a specified tool.
+:::: Invokes a [[Minecraft:loot table]] with a specified tool.
 :::<code>mine <TargetBlockPosition: x y z> ["<tool>|mainhand|offhand": string]</code>
 :::: Simulates mining the block at the designated position with a specified tool.
 ==Arguments==
-{{MC/El|je|short=1}}: {{MC/Argument|loot_table|loot_table}}
+{{el|je|short=1}}: {{argument|loot_table|loot_table}}
-{{MC/El|be|short=1}}: {{MC/Argument|loot_table: string|basic_string|be=1}}
+{{el|be|short=1}}: {{argument|loot_table: string|basic_string|be=1}}
 :Specifies which loot table to use.
-:{{MC/In|java}}, {{lcfirst:{{MC/Arg desc|je=loot_table}}}}
+:{{IN|java}}, {{lcfirst:{{arg desc|je=loot_table}}}}
-:{{MC/In|bedrock}}, {{lcfirst:{{MC/Arg desc|be=string}}}} And it refers to a loot table with the path of "loot_tables/<code>loot_table: string</code>.json".
+:{{IN|bedrock}}, {{lcfirst:{{arg desc|be=string}}}} And it refers to a loot table with the path of "loot_tables/<code>loot_table: string</code>.json".
-{{MC/El|je|short=1}}: {{MC/Argument|tool|item_stack}}
+{{el|je|short=1}}: {{argument|tool|item_stack}}
 :Specifies a tool to simulatively mine or fish.
-:{{MC/Arg desc|je=item_stack}}
+:{{arg desc|je=item_stack}}
-{{MC/El|be|short=1}}: {{argument|be=1|"<tool>{{!}}mainhand{{!}}offhand": string|basic_string}}
+{{el|be|short=1}}: {{argument|be=1|"<tool>{{!}}mainhand{{!}}offhand": string|basic_string}}
 :Specifies a tool to be used to simulatively kill or loot.
-:{{MC/Arg desc|be=string}} Can be <code>mainhand</code> and <code>offhand</code>, otherwise it represents an item id.
+:{{arg desc|be=string}} Can be <code>mainhand</code> and <code>offhand</code>, otherwise it represents an item id.
-{{MC/Argument|target|entity|entity: target|CommandSelector<Actor>}} (in <code>kill</code> source)
+{{argument|target|entity|entity: target|CommandSelector<Actor>}} (in <code>kill</code> source)
 : Specifies one entity to kill simulatively.
-:{{MC/Arg desc|je=entity|amount=single|type=entities|actor}}
+:{{arg desc|je=entity|amount=single|type=entities|actor}}
-{{MC/Argument|players|entity|player: target|CommandSelector<Player>}}
+{{argument|players|entity|player: target|CommandSelector<Player>}}
 :Specifies one or more players to give.
-:{{MC/Arg desc|je=entity|amount=multiple|type=players|be=CommandSelector<Player>}}
+:{{arg desc|je=entity|amount=multiple|type=players|be=CommandSelector<Player>}}
-{{MC/El|je|short=1}}: {{MC/Argument|pos|block_pos}} and {{MC/Argument|targetPos|block_pos}} (in <code>replace block</code> and <code>insert</code> mode)<br>
+{{el|je|short=1}}: {{argument|pos|block_pos}} and {{argument|targetPos|block_pos}} (in <code>replace block</code> and <code>insert</code> mode)<br>
-{{MC/El|be|short=1}}: {{MC/Argument|be=1|position: x y z|CommandPositionFloat}} (in <code>replace block</code> and <code>insert</code> mode)
+{{el|be|short=1}}: {{argument|be=1|position: x y z|CommandPositionFloat}} (in <code>replace block</code> and <code>insert</code> mode)
 :Specifies the position of a block.
-:{{MC/In|java}}: {{lcfirst:{{MC/Arg desc|je=block_pos}}}}
+:{{IN|java}}: {{lcfirst:{{arg desc|je=block_pos}}}}
-:{{MC/In|bedrock}}: {{lcfirst:{{MC/Arg desc|be=CommandPositionFloat}}}}
+:{{IN|bedrock}}: {{lcfirst:{{arg desc|be=CommandPositionFloat}}}}
-{{MC/Argument|targetPos|block_pos|position: x y z|CommandPositionFloat}} (in <code>spawn</code> mode)
+{{argument|targetPos|block_pos|position: x y z|CommandPositionFloat}} (in <code>spawn</code> mode)
 :Specifies the location where item entities drop.
-:{{MC/Arg desc|je=vec3|be=CommandPositionFloat}}
+:{{arg desc|je=vec3|be=CommandPositionFloat}}
-{{MC/Argument|entities|entity|entity: target|CommandSelector<Actor>}}
+{{argument|entities|entity|entity: target|CommandSelector<Actor>}}
 :Specifies one or more entities to modify.
-:{{MC/Arg desc|je=entity|amount=multiple|type=entities|be=actor}}
+:{{arg desc|je=entity|amount=multiple|type=entities|be=actor}}
-{{MC/Argument|count|integer|count: int|int}}
+{{argument|count|integer|count: int|int}}
 :Specifies the number of consecutive slots to be cleared.
-:{{MC/Arg desc|je=integer|min=0|be=int}}
+:{{arg desc|je=integer|min=0|be=int}}
-{{MC/El|je|short=1}}: {{MC/Argument|slot|item_slot}}<br>
+{{el|je|short=1}}: {{argument|slot|item_slot}}<br>
-{{MC/El|be|short=1}}: {{MC/Argument|be=1|slotType: EntityEquipmentSlot|enum}}, <code>slot.container</code>, and {{MC/Argument|be=1|slotId: int|int}}
+{{el|be|short=1}}: {{argument|be=1|slotType: EntityEquipmentSlot|enum}}, <code>slot.container</code>, and {{argument|be=1|slotId: int|int}}
 :Specifies the inventory slot to be modified.
-:{{MC/Arg desc|je=item_slot|be=enum}}
+:{{arg desc|je=item_slot|be=enum}}
 ==Result==
@@ Line 167: / Line 167: @@
 ==Output==
-{{MC/Output table}}
+{{Output table}}
-{{MC/Output table|edition=je|On fail|0|0|0}}
+{{Output table|edition=je|On fail|0|0|0}}
-{{MC/Output table|cmd=/loot spawn ...|On success|1|1|the number of item stacks got from loot}}
+{{Output table|cmd=/loot spawn ...|On success|1|1|the number of item stacks got from loot}}
-{{MC/Output table|cmd=/loot give ...|On success|1|1|the total number of item stacks successfully allocated to each player}}
+{{Output table|cmd=/loot give ...|On success|1|1|the total number of item stacks successfully allocated to each player}}
-{{MC/Output table|cmd=/loot insert ...|On success|1|1|the number of item stacks successfully distributed to the container}}
+{{Output table|cmd=/loot insert ...|On success|1|1|the number of item stacks successfully distributed to the container}}
-{{MC/Output table|cmd=/loot replace block ...|On success|1|1|the number of item stacks successfully distributed to the container}}
+{{Output table|cmd=/loot replace block ...|On success|1|1|the number of item stacks successfully distributed to the container}}
-{{MC/Output table|On error|0|unchanged|unchanged}}
+{{Output table|On error|0|unchanged|unchanged}}
-{{MC/Output table|cmd=/loot replace entity ...|On success|1|1|the total number of item stacks successfully allocated to each entity}}
+{{Output table|cmd=/loot replace entity ...|On success|1|1|the total number of item stacks successfully allocated to each entity}}
-{{MC/Output table|On error|0|unchanged|unchanged}}
+{{Output table|On error|0|unchanged|unchanged}}
-{{MC/Output table|edition=be|cmd=|On fail|0}}
+{{Output table|edition=be|cmd=|On fail|0}}
-{{Output table|cmd=loot give ...|On success|{{MC/Needs testing}}}}
+{{Output table|cmd=loot give ...|On success|{{needs testing}}}}
-{{MC/Output table|cmd=loot spawn ...<br>loot insert ...|On success|1}}
+{{Output table|cmd=loot spawn ...<br>loot insert ...|On success|1}}
 {{Output table|cmd=-{}-/loot replace entity ... <slotId: int> <''SOURCE''>|On success|When zero item stack is got, outputs 1.<br>Otherwise, outputs the number of targeted entities that have the specified slot}}
 {{Output table|cmd=-{}-/loot replace entity ... <slotId: int> <count: int> <''SOURCE''>|On success|When zero item stack is got, outputs 1.<br>Otherwise, outputs the number of targeted entities that have all the specified consecutive slots}}
-{{MC/Output table}}
+{{Output table}}
 == History ==
 === ''Java Edition'' ===
 {{HistoryTable
-|{{MC/HistoryLine|java}}
+|{{HistoryLine|java}}
-|{{HistoryLine||1.14|dev=18w43a|Added {{MC/Cmd|drop|link=none}}.}}
+|{{HistoryLine||1.14|dev=18w43a|Added {{cmd|drop|link=none}}.}}
-|{{HistoryLine|||dev=18w45a|Renamed {{MC/Cmd|drop|link=none}} to {{MC/Cmd|loot|link=none}}.
+|{{HistoryLine|||dev=18w45a|Renamed {{cmd|drop|link=none}} to {{cmd|loot|link=none}}.
-|{{MC/Cmd|loot|link=none}} got reworked.}}
+|{{cmd|loot|link=none}} got reworked.}}
-|{{HistoryLine||1.20.5|dev=24w12a|{{MC/Cmd|loot|link=none}} now also accepts an inline SNBT-formatted loot table definition for the {{MC/Argument|loot_table|loot_table}} argument.}}
+|{{HistoryLine||1.20.5|dev=24w12a|{{cmd|loot|link=none}} now also accepts an inline SNBT-formatted loot table definition for the {{argument|loot_table|loot_table}} argument.}}
 }}
 === ''Bedrock Edition'' ===
 {{HistoryTable
-|{{MC/HistoryLine|bedrock}}
+|{{HistoryLine|bedrock}}
-|{{HistoryLine||1.18|dev=beta 1.18.0.21|Added {{MC/Cmd|loot spawn ... loot ...|link=none}}.}}
+|{{HistoryLine||1.18|dev=beta 1.18.0.21|Added {{cmd|loot spawn ... loot ...|link=none}}.}}
-|{{HistoryLine||1.18|dev=beta 1.18.0.22|Removed {{MC/Cmd|loot|link=none}}.}}
+|{{HistoryLine||1.18|dev=beta 1.18.0.22|Removed {{cmd|loot|link=none}}.}}
-|{{HistoryLine||1.18.10|dev=beta 1.18.10.21|Re-added {{MC/Cmd|loot|link=none}}.}}
+|{{HistoryLine||1.18.10|dev=beta 1.18.10.21|Re-added {{cmd|loot|link=none}}.}}
-|{{HistoryLine||1.18.10|dev=beta 1.18.10.24|Added {{MC/Cmd|loot spawn ... kill ...|link=none}}}}
+|{{HistoryLine||1.18.10|dev=beta 1.18.10.24|Added {{cmd|loot spawn ... kill ...|link=none}}}}
-|{{HistoryLine||1.18.30|dev=beta 1.18.20.21|Added {{MC/Cmd|loot give ...|link=none}}}}
+|{{HistoryLine||1.18.30|dev=beta 1.18.20.21|Added {{cmd|loot give ...|link=none}}}}
-|{{HistoryLine|||dev=beta 1.18.30.20|Added {{MC/Cmd|loot insert ...|link=none}}}}
+|{{HistoryLine|||dev=beta 1.18.30.20|Added {{cmd|loot insert ...|link=none}}}}
-|{{HistoryLine||1.19.0|dev=beta 1.19.0.30|Added {{MC/Cmd|loot replace entity ...|link=none}}}}
+|{{HistoryLine||1.19.0|dev=beta 1.19.0.30|Added {{cmd|loot replace entity ...|link=none}}}}
-|{{HistoryLine||1.19.40|dev=Preview 1.19.40.20|Added {{MC/Cmd|loot replace block ...|link=none}}}}
+|{{HistoryLine||1.19.40|dev=Preview 1.19.40.20|Added {{cmd|loot replace block ...|link=none}}}}
 }}
 == See also==
-*{{MC/Cmd|give}} — give specific items to players without specifying a loot table
+*{{cmd|give}} — give specific items to players without specifying a loot table
-*{{MC/Cmd|item}}{{only|je}} — modify specific item slots of entities or container
+*{{cmd|item}}{{only|je}} — modify specific item slots of entities or container
-*{{MC/Cmd|replaceitem}}{{only|be}} — modify specific item slots of entities or container
+*{{cmd|replaceitem}}{{only|be}} — modify specific item slots of entities or container
 == External links ==
@@ Line 217: / Line 217: @@
 == Navigation ==
-{{MC/Navbox commands}}
+{{Navbox commands}}
-de:Befehl/loot
+[[Minecraft:de:Befehl/loot]]
-es:Comandos/loot
+[[Minecraft:es:Comandos/loot]]
-ja:コマンド/loot
+[[Minecraft:fr:Commandes/loot]]
-ko:명령어/loot
+[[Minecraft:ja:コマンド/loot]]
-pt:Comandos/loot
+[[Minecraft:ko:명령어/loot]]
-ru:Команды консоли/loot
+[[Minecraft:pt:Comandos/loot]]
-uk:Команди консолі/loot
+[[Minecraft:ru:Команды консоли/loot]]
-zh:命令/loot
+[[Minecraft:uk:Команди консолі/loot]]
+[[Minecraft:zh:命令/loot]]