Actions

The action decides what happens to the items your rule matches.

Removing items

remove

Does everything: hides the item from creative tabs and recipe viewers, removes its recipes and tags, and deletes it from inventories, chests, the ground, loot, trades and mobs.

{
  "action": "remove",
  "items": ["minecraft:tnt"]
}

You can turn individual parts of this off (for example, keep removed items in recipe viewers) in Settings.

More remove examples

remove_creative

Hides the item from creative tabs and recipe viewers, but it still works normally. Good for items you give out with commands.

Also works on status effects, which hides them from effect viewers like JEED.

{
  "action": "remove_creative",
  "items": ["minecraft:command_block"],
  "effects": ["minecraft:wither"]
}

remove_recipe

Hides every recipe that makes the item. The item itself stays. Players just can't craft it.

{
  "action": "remove_recipe",
  "items": ["minecraft:beacon"]
}

remove_info

Hides the item's info page in EMI, JEI and RRV. The item itself stays visible.

{
  "action": "remove_info",
  "items": ["quark:trowel"]
}

Deleting items from the world

These four can also swap the item instead of deleting it. Add replace_with, and players who pick up a Netherite Sword get a Diamond Sword instead:

{
  "action": "remove_inventory",
  "items": ["minecraft:netherite_sword"],
  "replace_with": "minecraft:diamond_sword"
}

remove_inventory

Deletes the item from player inventories as soon as they have it.

{
  "action": "remove_inventory",
  "items": ["minecraft:bedrock"]
}

remove_storage

Deletes the item from chests, barrels, shulker boxes and other containers when a player opens them.

{
  "action": "remove_storage",
  "items": ["minecraft:tnt"]
}

remove_drops

Deletes the item the moment it lands on the ground. Good for cutting down item lag.

{
  "action": "remove_drops",
  "items": ["minecraft:cobblestone"]
}

remove_equipment

Takes the item out of mobs' hands and armor slots, so they can't spawn with it or pick it up.

{
  "action": "remove_equipment",
  "items": ["minecraft:netherite_sword"]
}

Loot and trades

remove_loot

Removes the item from every loot table: chests, mob drops, fishing, archaeology, and also block drops. Removing diamonds this way means diamond ore stops dropping them too.

{
  "action": "remove_loot",
  "items": ["minecraft:enchanted_golden_apple"]
}

You can also remove any loot that comes with a certain enchantment:

{
  "action": "remove_loot",
  "enchantments": ["minecraft:sharpness"]
}

remove_chest_loot

Like remove_loot, but only for chests, barrels and other containers. Mob drops and block drops are untouched.

{
  "action": "remove_chest_loot",
  "items": ["minecraft:diamond"]
}

remove_trade

Removes any villager or wandering trader trade that buys or sells the item.

{
  "action": "remove_trade",
  "items": ["minecraft:emerald"]
}

Restricting use

remove_interactions

Stops players from right-clicking with the item.

{
  "action": "remove_interactions",
  "items": ["minecraft:flint_and_steel", "minecraft:lava_bucket"]
}

Use blocks instead to stop players from right-clicking a placed block. Players can still place it, they just can't use it. This lets you place beds and anvils but not sleep in or use them:

{
  "action": "remove_interactions",
  "blocks": ["minecraft:anvil", "#minecraft:beds"]
}

More interaction examples

remove_placement

Stops players from placing the block. They can still craft, hold and trade it.

{
  "action": "remove_placement",
  "blocks": ["minecraft:tnt"]
}

remove_attacks

Stops players from attacking while holding the item.

{
  "action": "remove_attacks",
  "items": ["minecraft:stick"]
}

More combat examples

remove_hand_swing

Stops the hand swing animation when using the item.

{
  "action": "remove_hand_swing",
  "items": ["minecraft:stick"]
}

Enchantments, potions and effects

remove_enchantment

Stops an enchantment from appearing anywhere: loot, enchanting tables, villager trades and drops. If an enchanted book ends up with nothing left on it, it gets a different allowed enchantment, or turns into a plain book.

{
  "action": "remove_enchantment",
  "enchantments": ["minecraft:mending", "#minecraft:curse"]
}

Add items to only remove it from those items. Fortune is removed from pickaxes, but not from other tools:

{
  "action": "remove_enchantment",
  "enchantments": ["minecraft:fortune"],
  "items": ["#minecraft:pickaxes"]
}

Or use not to keep it on certain items. Fortune is removed from everything except golden pickaxes:

{
  "action": "remove_enchantment",
  "enchantments": ["minecraft:fortune"],
  "not": {
    "items": ["minecraft:golden_pickaxe"]
  }
}

remove_potion

Hides every potion, splash potion, lingering potion and tipped arrow with the effect, in creative tabs, recipe viewers and loot.

{
  "action": "remove_potion",
  "effects": ["minecraft:poison", "minecraft:invisibility"]
}

This only hides the potion items. To stop the effect itself (from mobs, beacons, /effect, etc.), use remove_effect.

remove_effect

Stops a status effect from being applied to anything, from any source: potions, mob attacks, beacons, /effect give, and so on.

{
  "action": "remove_effect",
  "effects": ["minecraft:poison"]
}

Add replace_with to swap it for a different effect instead. Here, anything that would give Poison gives Slowness with the same duration and level. Potion tooltips show Slowness too.

{
  "action": "remove_effect",
  "effects": ["minecraft:poison"],
  "replace_with": "minecraft:slowness"
}

Alternate names

Most actions accept a few spellings, so remove_trades, remove_drop and remove_loot_table all work. For example, remove_effect also accepts remove_effects, remove_status_effect and remove_mob_effect.