Throw Item

The arc:on_throw_item action type is triggered when a player throws an item (e.g. snowball, egg, ender pearl).

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:item_stack	Represents a stack of items, including item type and quantity.
arc:entity	Represents an entity in the game, such as a player, mob, or item.

Example

The following example will give the player a Speed II effect every time they throw a snowball.

data/my_datapack/arc/random_throw.json

{
    "holder": {
        "type": "arc:player",
        "id": "arc:player"
    },
    "type": "arc:on_throw_item",
    "conditions": [
        {
            "type": "arc:item",
            "item": {
                "id": "minecraft:snowball"
            }
        }
    ],
    "rewards": [
        {
            "type": "arc:effect",
            "effect": "minecraft:speed",
            "duration": 200,
            "amplifier": 1
        }
    ]
}

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.

👤🧱 Entity In Block

The arc:entityinblock condition type checks if an entity is currently inside a specific block.

👤 Entity Type

The arc:entity_type condition type checks if an entity matches a specific type.

👥 Entity Types

The arc:entity_types condition type checks if an entity is one of several specified types.

🪙 Item

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

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

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

✂️🐑 Ready For Shearing

The arc:readyforshearing condition type checks if a shearable entity is ready to be sheared.

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

🔥👤 Entity On Fire

The arc:entityonfire reward type sets the target entity on fire.

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

👤➡️ Move To Entity

The arc:movetoentity reward type pulls the player towards the target entity's location.

➡️➡️ Multiple Arrows

The arc:multiple_arrows reward type shoots additional arrows when a player shoots a bow.

💉 Potion Effect

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