SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedPerformance

Icterine

by Mephodio · for Minecraft

Advancements optimization (specifically, InventoryChangeTrigger)

4.0MDownloads
3 yr agoLast updated
GPL-3.0-or-laterLicense
Fabric · Forge +2Loaders

About Icterine

From Modrinth

Advancements optimization (specifically, InventoryChangeTrigger)

Summary

  • Optimizes triggering advancements for obtaining items;
  • Might break parity with vanilla, but doesn't affect vanilla advancements and shouldn't affect the vast majority of mods/datapacks;
  • Even if it does affect something, advancement still should be obtainable by just dropping and picking up one of required items;
  • Currently, there are no known incompatibilities or issues;
  • Every injection into vanilla code can be disabled in config file.
  • All changes are server-side.

Results

Live test performed on dedicated server with 3 active players online, running custom Forge modpack with over 200 mods and BlazeandCave's Advancements Pack, which adds over 950 advancements. Stats collected using Spark for one hour.

With Icterine, InventoryChangeTrigger executes almost 2.5 times faster (as of version 1.1.0), spending about 7.5% of the tick time instead of 20%.

Stats comparison for Icterine 1.0.0 (~2 times faster):

Statistics

How vanilla InventoryChangeTrigger works

  1. When the game detects that stack in player inventory has changed, it calls InventoryChangeTrigger for it. This includes picking up items, dropping items, dropping whole stacks, moving items in your inventory.
  2. Also, when you open a container (chest, furnace, etc.), game thinks that all the slots in your inventory changed, and calls trigger for all of them, including empty slots.
  3. InventoryChangeTrigger counts empty, non-empty and completely filled slots in your inventory. This information could be used in advancement triggers, but is not used in vanilla.
  4. InventoryChangeTrigger goes over registered advancement criteria.
  5. If criterion has slot count requirements and they don't match values from step 2, or if criterion doesn't have item requirements, criterion is skipped.
  6. If criterion has only one item requirement, changed stack is checked against this requirement.
  7. If criterion has multiple items requirements (e.g., "Cover me with debris" requires having full netherite armor set), every item stack in the inventory is checked against every requirement (but fulfilled requirements get removed and are no longer checked).
  8. Item matching, especially against tag, is very heavy. But the game first checks if the player's item type matches the one from the requirement, and only then checks other parameters like count, enchants and other NBT data.

How Icterine's optimizations work

  1. In step 1, do not call InventoryChangeTrigger when you drop stacks or move them out of your inventory (e.g. to chest). This is controlled by the ignore_triggers_for_emptied_stacks parameter in config file.
  2. Similarly, do not call InventoryChangeTrigger if stack change was caused by decreasing stack but not emptying it (e.g. player dropped single item from the full stack). Controlled by ignore_triggers_for_decreased_stacks.
  3. And also do not call InventoryChangeTrigger if stack size increased, but hasn't passed threshold for any advancement. For example, dirt stack size increased from 52 to 53, but there's no advancement for getting 53 dirt in your modpack. Controlled by optimize_triggers_for_increased_stacks.
  4. Modify how game checks for changed items when player opens container screen, so it doesn't treat all the stack as changed the second you open anything. Controlled by initialize_inventory_last_slots.
  5. In step 6, firstly check if changed slot matches any requirement, and only then check other stack in the inventory. Controlled by optimize_multiple_predicate_trigger.
  6. In step 7, compare the stack count first to avoid unneeded tag matching. Also use previous stack count to avoid even more unneeded matching. Controlled by check_count_before_item_predicate_match.

Further optimizations are planned.

Supported versions

Icterine v1.2.0 works with Minecraft Fabric/Quilt from 1.18.2 to 1.19.4, and Forge from 1.18.2 to 1.19.2 (forge moment).

Icterine v1.3.0 has the same features as v1.2.0 and works with Fabric/Quilt 1.20 - 1.20.4, Forge 1.19.3 - 1.20.4, and NeoForge 1.20.1 - 1.20.4.

Use filter on the versions page to choose the right file.

If you need port to any other version, please open an issue, or ask on Discord server.

Highlights

From source data

Game versions

Supports 11 Minecraft versions, the newest being 1.20.4.

Loaders

Runs on Fabric, Forge, NeoForge and Quilt.

Footprint

Rated a light load on a server.

Icterine on Nxeon

From our catalogue
One-click install
Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
Server side
Required on the server
Server type needed
Fabric, Forge, NeoForge, Quilt
Server load
light
Smallest plan we suggest
Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.3.0, released 2024-02-10

Game versions by loader

LoaderGame versionsNewest
Fabric1.20 to 1.20.4 (5 versions)1.20.4
Quilt1.20 to 1.20.4 (5 versions)1.20.4
NeoForge1.20.2 to 1.20.4 (3 versions)1.20.4

From 5 recorded builds of Icterine.

Recent builds

BuildReleasedGame versionsLoaders
1.3.02024-02-101.20.3 to 1.20.4 (2 versions)NeoForge
1.3.02024-02-101.20.2NeoForge
1.3.02024-02-101.20.3 to 1.20.4 (2 versions)Fabric, Quilt
1.3.02024-02-101.20.2Fabric, Quilt
1.3.02024-02-101.20 to 1.20.1 (2 versions)Fabric, Quilt

Run Icterine on a Minecraft server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Modrinth as “Mods”

Performance

Makes the game or server run faster or lighter without changing how it plays.

Runs on your server

From source side support

Modrinth lists Icterine as required on the server. Check its Modrinth page to see whether players need it too.

Compatibility

Game
Minecraft
Loaders
FabricForgeNeoForgeQuilt
Runs on
Serverrequired on the server
Game versions
1.20.4 and 10 earlier

Verified at the source

  • ✓ModrinthOfficial listing, checked 2026-10-08Open ↗
  • ✓AuthorMephodio, as published on Modrinth
  • ✓LicenseGPL-3.0-or-laterFree

Icterine, answered

Generated from the mod’s own source data.

Do my players need to install Icterine?

Modrinth lists Icterine as required on the server. Check its Modrinth page to see whether players need it too.

Which loaders does it support?

Fabric, Forge, NeoForge and Quilt.

Is it free?

Yes. Icterine is free to download from Modrinth. Its license is GPL-3.0-or-later.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run Icterine on a Minecraft server.

Deploy in about a minute from $4.20 a month, then add Icterine in one click.