Add Effect
The arc:on_add_effect action type is triggered when a player receives a potion effect.
Action Data
When this action is triggered, the following action data is made available:
| Action Data Type | Description |
|---|---|
arc:mob_effect_instance | Describes a specific instance of a mob effect, including type, duration, and amplifier. |
arc:entity | Represents an entity in the game, such as a player, mob, or item. |
arc:world | Refers to the world/dimension where the action occurs. |
arc:block_position | Specifies the coordinates (x, y, z) of a block in the world. |
Example
The following example removes any harmful effect immediately.
{
"holder": {
"type": "arc:player",
"id": "arc:player"
},
"type": "arc:on_add_effect",
"conditions": [
{
"type": "arc:effect_category",
"category": "HARMFUL"
}
],
"rewards": [
{
"type": "arc:remove_effect"
}
]
}
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.
💉 Effect
The arc:effect condition type checks for a specific mob effect.
💉 Effect Category
The arc:effect_category condition type checks the category of a mob effect (BENEFICIAL, HARMFUL, or NEUTRAL).
📊 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.
❤️ 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 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.
💡 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.
✂️🐑 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
❌ Cancel Action
The arc:cancel_action reward type prevents the default outcome of a triggered action.
🕒 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.
🪙 Drop Item
The arc:drop_item reward type drops an item at the location of the action (e.g., where a block was broken).
➕💉 Effect Amplifier Addition
The arc:effectamplifieraddition reward type increases the amplifier of an existing effect on the player.
⏳💉 Effect Duration Multiplier
The arc:effectdurationmultiplier reward type multiplies the duration of an effect a player receives.
✨ 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.
❌💉 Remove Effect
The arc:remove_effect reward type removes a specified effect 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.