Icterine Wiki

Icterine is a small server-side performance mod. It optimizes the way Minecraft handles advancement triggers that fire when items enter your inventory (the InventoryChangeTrigger). On busy worlds and servers these checks run constantly and can add up to real tick lag; Icterine removes the unnecessary work while keeping every advancement working exactly as before.

• Skips pointless scans: when a stack is emptied or its size decreases, no advancement can be completed, so the scan is cancelled.
• Count thresholds: Icterine reads your loaded advancements and remembers which item counts actually matter, so increasing a stack only triggers a check when it could complete an advancement.
• Multi-predicate short-circuit: when a trigger has several item predicates, it first checks the changed item and skips the full-inventory scan if none can match.
• Faster predicate matching: it compares stack counts before the expensive item/tag matching.

Icterine only needs Fabric API. It runs on the server side (single-player integrated server or a dedicated server) and does not change gameplay - it is purely an optimization. Just drop it into the mods folder. It is safe to add to existing worlds and compatible with virtually all other mods.

On first launch Icterine creates a config file (config/icterine.yml) where each optimization can be toggled individually - ignoring emptied or decreased stacks, optimizing increased stacks by threshold, short-circuiting multi-predicate triggers, and checking count before predicate matching. A debug option is also available for troubleshooting. The defaults are safe and recommended for most servers.