Trade With Villager

The arc:on_trade_with_villager action type is triggered when a player successfully completes a trade with a Villager or Wandering Trader.

Action Data

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

Action Data Type	Description
arc:entity	Represents an entity in the game, such as a player, mob, or item.
arc:item_stack	Represents a stack of items, including item type and quantity.
arc:trade_offer	The merchant trade offer involved in the transaction.
arc:world	Refers to the world/dimension where the action occurs.

Example

The following example rewards the player with an emerald when they trade with a Librarian.

data/my_datapack/arc/emerald_for_books.json

{
    "holder": {
        "type": "arc:player",
        "id": "arc:player"
    },
    "type": "arc:on_trade_with_villager",
    "conditions": [
        {
            "type": "arc:entity_data",
            "target": "entity",
            "properties": [
                {
                    "id": "arc:villager_profession",
                    "value": "minecraft:librarian"
                }
            ]
        }
    ],
    "rewards": [
        {
            "type": "arc:item",
            "item": {
                "id": "minecraft:emerald"
            }
        }
    ]
}

Compatible Condition Types

🌲 Biome

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

🎲 Chance

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

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

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

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

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

✂️🐑 Ready For Shearing

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

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

❤️ Target Health

The arc:target_health condition type checks the health of the target entity involved in the action.

👥 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

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

🫳 Disarm Entity

The arc:disarm_entity reward type causes the target entity to drop an item from a specific slot.

✨ Enchant Item

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

🔥👤 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.

🍗 Feed

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

🧊 Freeze Entity

The arc:freeze_entity reward type applies a freezing effect (Slowness) to the target entity.

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

👤➡️ 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.

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

🧲 Pull Entity

The arc:pull_entity reward type pulls the target entity towards the player.

💨 Push Entity

The arc:push_entity reward type pushes the target entity away from 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.