Fill Bucket

The arc:on_fill_bucket action type is triggered when a player picks up a liquid or fish with a bucket.

Action Data

When this action is triggered, the following action data is made available:

Action Data Type	Description
arc:item_stack	Represents a stack of items, including item type and quantity.
arc:item	Refers to a single item type without stack information.
arc:block_position	Specifies the coordinates (x, y, z) of a block in the world.
arc:block_state	Represents the state of a block, including its type and properties.
arc:world	Refers to the world/dimension where the action occurs.

Example

The following example gives the player a raw cod when they fill a water bucket.

data/my_datapack/arc/bonus_fish.json

{
    "holder": {
        "type": "arc:player",
        "id": "arc:player"
    },
    "type": "arc:on_fill_bucket",
    "conditions": [
        {
            "type": "arc:item",
            "item": "minecraft:water_bucket"
        }
    ],
    "rewards": [
        {
            "type": "arc:item",
            "item": { "id": "minecraft:cod" }
        }
    ]
}

Compatible Condition Types

🌲 Biome

The arc:biome condition type checks if the player is in one of the specified biomes.

🧱 Block

The arc:block condition type checks if the block involved in the action matches a specific block description.

🪨 Block Hardness

The arc:block_hardness condition type checks if the hardness of a block falls within a specified range.

🧱🧱 Blocks

The arc:blocks condition type checks if a block is one of several specified blocks or belongs to a specified block tag.

🎲 Chance

The arc:chance condition type applies a random percentage chance for the action to proceed.

🌱 Crop Age

The arc:crop_age condition type checks if a crop is at a specific age.

🌾 Crop Fully Grown

The arc:cropfullygrown condition type checks if a crop is fully grown.

🌍 Dimension

The arc:dimension condition type checks if the player is in a specific dimension.

📊 Entity Data

The arc:entity_data condition type checks specific properties of an entity using registered data resolvers.

🍖 Food Level

The arc:food_level condition type checks the player's current food level (0-20).

🛡️ Full Armor Set

The arc:fullarmorset condition type checks if the player is wearing a specific set of armor in all four slots.

✨ Has Enchantment

The arc:has_enchantment condition type checks if the item involved in the action has a specific enchantment.

❤️ Health

The arc:health condition type checks the player's current health.

🈳 Inventory Empty

The arc:inventory_empty condition type checks if the player's inventory is completely empty.

🈵 Inventory Full

The arc:inventory_full condition type checks if the player's inventory has no empty slots.

🛡️ Is Blocking

The arc:is_blocking condition type checks if the player is currently using a shield.

💎 Is Ore

The arcores and cancientdebris and blocks that drop experience.

🏇 Is Riding

The arc:is_riding condition type checks if the player is currently riding an entity (horse, boat, minecart, etc.).

🛏️ Is Sleeping

The arc:is_sleeping condition type checks if the player is currently sleeping in a bed.

🦶 Is Sneaking

The arc:is_sneaking condition type checks if the player is crouching/sneaking.

🌊 Is Underwater

The arc:is_underwater condition type checks if the player is fully submerged in water.

💧 Is Wet

The arc:is_wet condition type checks if the player is wet (in water or rain).

🪙 Item

The arc:item condition type checks if an item matches a specific item, including optional checks for count and components.

📉 Item Durability

The arc:item_durability condition type checks the durability of the item involved in the action.

🪙✅ Item Equipped

The arc:item_equipped condition type checks if the player has a specific item equipped in any armor slot.

🪙✋ Item In Hand

The arc:iteminhand condition type checks if the player is holding a specific item in their main hand, off-hand, or either hand.

🪙📦 Item In Inventory

The arc:itemininventory condition type checks if the player has a specific item anywhere in their main inventory.

🪙🪙 Items

The arc:items condition type checks if an item is one of several specified items or belongs to a specified item tag.

💡 Light Level

The arc:light_level condition type checks the light level at the player's position.

❌🧱 Not In Block Pos Cache

The arc:notinblockposcache condition type checks if a block's position is not in the player's recent placement history. This is useful for preventing rewards from blocks that the player has placed themselves.

🔥 On Fire

The arc:on_fire condition type checks if the player is currently on fire.

🔀 Or

The arc:or condition type is met if at least one of its nested conditions is met.

🏇 Riding Entity Type

The arc:ridingentitytype condition type checks the type of entity the player is currently riding.

🥩 Saturation Level

.---

📋 Scoreboard

The arc:scoreboard condition type checks if a player's score in a specific objective is within a given range.

🏰 Structure

The arc:structure condition type checks if the player is inside a specific structure.

👥 Team

The arc:team condition type checks if a player is on a specific scoreboard team.

⏰ Time of Day

The arc:timeofday condition type checks if the world time is within a specified range (0-24000).

🌦️ Weather

The arc:weather condition type checks the current weather in the world.

↕️ Y Level

The arc:y_level condition type checks if the player's vertical position is within a specified range.

Compatible Reward Types

🧱 Block Drop Multiplier

The arc:blockdropmultiplier reward type multiplies the items dropped when a block is broken.

🕒 Change Time

The arc:change_time reward type changes the time of day in the world.

☀️ Change Weather

The arc:change_weather reward type sets the current weather in the world.

🚿 Cleanse Effects

The arc:cleanse_effects reward type removes specific categories of potion effects from the player.

💻 Command

The arc:command reward type executes a server command.

💥 Create Explosion

The arc:create_explosion reward type creates an explosion at the player's current location.

🪙 Drop Item

The arc:drop_item reward type drops an item at the location of the action (e.g., where a block was broken).

✨ Enchant Item

The arc:enchant_item reward type applies enchantments to an item in a specific slot.

✨ Experience

The arc:exp reward type gives the player a specified range of experience points.

🍗 Feed

The arc:feed reward type restores hunger and saturation to the player.

📖 Give Recipes

The arc:give_recipes reward type unlocks specific crafting recipes for the player.

💖 Heal

The arc:heal reward type restores health points to the player.

🪙 Item

The arc:item reward type gives an item to the player.

🚀 Launch Player

The arc:launch_player reward type applies a velocity vector to the player, launching them in a direction.

🔊 Play Sound

The arc:play_sound reward type plays a specific sound event at a target location.

💉 Potion Effect

The arc:effect reward type applies a potion effect to the player.

🛡️🔧 Repair All Armor

The arc:repairallarmor reward type repairs all equipped armor items.

🔧 Repair Held Item

The arc:repairhelditem reward type repairs the item held in a specific hand.

🏗️ Set Block

The arc:set_block reward type places a specific block at a target location.

🔥🎒 Smelt Inventory

The arc:smelt_inventory reward type smelts all smeltable items currently in the player's inventory.

🧟 Spawn Entity

The arc:spawn_entity reward type spawns a specified entity near the player.

⚡ Strike Lightning

The arc:strike_lightning reward type summons a lightning bolt at a target location.

🔮 Teleport Player

The arc:teleport_player reward type teleports the player randomly within a specified radius.