

Modrinth · Fabric, Forge, NeoForge, Quilt
Icterine on your Minecraft server
Icterine runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
Advancements optimization (specifically, InventoryChangeTrigger)
- Downloads
- 4.1M
- Author
- Mephodio
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 1.18.2 – 1.20.4
- Updated
- –
Screenshots
What Icterine looks like
Images: Icterine on Modrinth, published by the project team.
Setup
Install Icterine on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 1.20.4.
- 03
Install the mod
Search the mod browser for “Icterine” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
Icterine is not needed on the client. Players connect using the server address from the panel.
- On the server
- Required
- On the client
- Not needed
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 1.20.4, 1.20.3, 1.20.2 +8 more
- License
- GNU General Public License v3.0 or later
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
Icterine · Modrinth- Icterine 1.3.0 NeoForge 1.20.3 - 1.20.4February 10, 2024Minecraft 1.20.3, 1.20.4 · NeoForge
- Icterine 1.3.0 NeoForge 1.20.2February 10, 2024Minecraft 1.20.2 · NeoForge
- Icterine 1.3.0 Fabric 1.20.3 - 1.20.4February 10, 2024Minecraft 1.20.3, 1.20.4 · Fabric, Quilt
- Icterine 1.3.0 Fabric 1.20.2February 10, 2024Minecraft 1.20.2 · Fabric, Quilt
- Icterine 1.3.0 Fabric 1.20 - 1.20.1February 10, 2024Minecraft 1.20, 1.20.1 · Fabric, Quilt
Original description by the project author
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):

How vanilla InventoryChangeTrigger works
- 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.
- 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.
- 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.
- InventoryChangeTrigger goes over registered advancement criteria.
- 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.
- If criterion has only one item requirement, changed stack is checked against this requirement.
- 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).
- 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
- 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_stacksparameter in config file. - 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. - 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. - 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. - 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. - 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.
Icterine server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does Icterine run on?
According to Modrinth, Icterine supports Fabric, Forge, NeoForge, Quilt for Minecraft 1.20.4, 1.20.3, 1.20.2. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.
How much RAM does a server with Icterine need?
As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Client only
Sodium
by jellysquid3
A high-performance rendering engine replacement for Minecraft, which greatly improves frame rates and reduces micro-stutter.
Client only
Iris Shaders
by coderbot
A modern shader pack loader for Minecraft intended to be compatible with existing OptiFine shader packs
Client only
Entity Culling
by tr7zw
Using async path-tracing to hide Block-/Entities that are not visible
Server-ready
FerriteCore
by malte0811
Memory usage optimizations
Ready for your server with Icterine?
4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.