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.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 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.

  3. 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.

  4. 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.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

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.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

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
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):

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.
    1. 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.
  2. 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.
  3. InventoryChangeTrigger goes over registered advancement criteria.
  4. 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.
  5. If criterion has only one item requirement, changed stack is checked against this requirement.
  6. 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).
  7. 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.

FAQ

Icterine questions

Question not listed? Ask our team.

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.

Ready for your server with Icterine?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server