====== minecraft:bucket ======
The ''minecraft:bucket'' item component allows the player to place or drain a [[mc>Fluid|fluid]], or place an [[mc>Entity|entity]] or [[mc>Block|block]], or any combination of them.
===== Fields =====
^ Name ^ Description ^ Type ^ Default Value ^
| ''fluid'' | The fluid to place. Note that ''minecraft:empty'' tries to drain a fluid instead. | An optional [[mc>Fluid|fluid]] | |
| ''entity'' | The entity to spawn. | An optional [[#entity_target|entity target]] | |
| ''block'' | The block to place. | An optional [[blocks:block_pickers:start|block picker]] | |
| ''emptying_sound_event'' | The sound event to play when placing a fluid. | An optional [[mc>Sounds.json#Sound_events|sound event]] | |
| ''transforms_into'' | The item to transform into once used. | An optional item | |
===== Example =====
{
"fluid": "minecraft:water",
"emptying_sound_event": "minecraft:item.bucket.empty",
"transforms_into": "minecraft:bucket"
}
===== Entity Target =====
May spawn an entity depending on the previous placement result.
==== Fields ====
^ Name ^ Description ^ Type ^ Default Value ^
| ''entity'' | The entity to spawn. | An [[entities:entity_initializers:|entity initializer]] | |
| ''require_other_successful_placement'' | Whether to require a successful fluid or block placement before placing an entity. | An optional boolean | ''false'' |
==== Example ====
{
"entity": {
"type": "minecraft:salmon"
},
"require_other_successful_placement": true
}