Receive Advancement

The arc:on_advancement action type is triggered when a player receives an advancement.

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:advancement	Represents an in-game advancement that was earned.

Example

The following example will give the player an apple every time they complete any advancement.

data/my_datapack/arc/apple_for_any_advancement.json

{
    "holder": {
        "type": "arc:player",
        "id": "arc:player"
    },
    "type": "arc:on_advancement",
    "rewards": [
        {
            "type": "arc:command",
            "command": "give %player% minecraft:apple"
        }
    ]
}

Limitation

As of this version, there is no built-in condition to filter by a specific advancement ID. This means the action will trigger for any advancement the player receives. To check for a specific advancement (e.g., minecraft:story/smelt_iron), you would need to create a custom ConditionType that reads the arc:advancement data provided by this action.

Compatible Condition Types

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

🌍 Dimension

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

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

🔀 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:

💻 Command

The arc:command reward type executes a server command.

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