Place Block

The arc:on_place_block action type is triggered when a player places a block.

Action Data

When this action is triggered, the following action data is made available to be used by conditions and rewards:

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

Example

The following example will give the player a diamond every time they place a stone block.

data/my_datapack/arc/diamond_for_placing_stone.json

{
    "holder": {
        "type": "arc:player",
        "id": "arc:player"
    },
    "type": "arc:on_place_block",
    "conditions": [
        {
            "type": "arc:block",
            "block": "minecraft:stone"
        }
    ],
    "rewards": [
        {
            "type": "arc:item",
            "item": {
                "id": "minecraft:diamond"
            }
        }
    ]
}

Compatible Condition Types

The following condition types can be used with this action type:

🧱 Block

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

🪨 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.

🌱 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.

💎 Is Ore

The arcores and cancientdebris and blocks that drop experience.

🪙✅ 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.

🚫 Not

The arc:not condition type inverts the result of its nested conditions. It is met if none of the specified conditions are met.

❌🧱 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.

🔀 Or

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

📋 Scoreboard

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

👥 Team

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

Compatible Reward Types

The following reward types can be used with this action type:

🧱 Block Drop Multiplier

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

❌ Cancel Action

The arc:cancel_action reward type prevents the default outcome of a triggered action.

💻 Command

The arc:command reward type executes a server command.

🪙 Drop Item

The arc:drop_item reward type drops an item at a specified location.

✨ Experience

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

🪙 Item

The arc:item reward type gives an item directly to the player's inventory.

💉 Potion Effect

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