Item Obliterator — Guide

Regular expressions

Start an entry with an exclamation mark and the rest is read as a regular expression rather than a literal id.

"!minecraft:.*_sword"

That single line removes every sword in the game. The advantage over listing them is not just brevity: the pattern keeps matching when another mod adds a sword later, so a pack does not silently spring a leak the next time its mod list grows.

The same syntax works in every list described below.

The narrower lists

Total removal is often too blunt, so there are three lists that take away one behaviour and leave the rest:

• only_disable_interactions — the item can be held and crafted, but right-clicking with it does nothing. Useful for something whose effect you want gone while the item stays as a trade good or ingredient.
• only_disable_attacks — the item cannot be swung at anything. The item is otherwise normal.
• only_disable_recipes — the recipe disappears but the item itself still works, so existing copies stay usable and it can still be found or traded for.

An item can appear in more than one list; the effects stack.

Matching on component data

Sometimes the id is not specific enough — you want one potion gone, not every potion. blacklisted_component_data matches against an item's component data instead of its id.

"Potion:\"minecraft:regeneration\""

If the text appears anywhere in the item's components, the item is removed. Regular expressions work here too, with the same leading !.

This check is much more expensive than an id lookup, because every component of every stack has to be examined. Use it for the handful of cases that need it rather than as a general tool.

To find the right value, turn on debug_print_components. It logs the components of whatever you are holding once a second, so you can copy the exact text out of the log.

Performance

use_hashmap_optimizations switches the plain id lists from a linear scan to a hash lookup. For a pack with a long blacklist that is a worthwhile difference, since the lists are consulted whenever inventories tick.

It does not apply to entries written as regular expressions or to component matching, both of which have to be evaluated one at a time.