Modrinth · NeoForge

InventoryAdvancementAccelerator on your Minecraft server

InventoryAdvancementAccelerator runs on Minecraft servers with NeoForge. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

invadvopt is a dedicated-server NeoForge mod for Minecraft 1.21.1. It accelerates the hot inventory_changed advancement trigger without replacing Minecraft's predicate or award logic. Clients do not install it.

Downloads
4.0K
Author
vicuna
Loader
NeoForge
Minecraft
1.21.1
Updated
–

Setup

Install InventoryAdvancementAccelerator 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 NeoForge and choose the matching Minecraft version, for example 1.21.1.

  3. 03

    Install the mod

    Search the mod browser for “InventoryAdvancementAccelerator” 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

    InventoryAdvancementAccelerator 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
NeoForge
Minecraft
1.21.1
License
MIT License

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.

InventoryAdvancementAccelerator · Modrinth
Original description by the project author

🚀 Inventory Advancement Accelerator

When a server has a large number of advancements, data packs, or online players, vanilla Minecraft frequently iterates through the relevant advancement conditions. This mod creates a per-player item index and filters only the conditions that may match the current inventory change, while continuing to use Minecraft’s vanilla predicates and reward logic for the final evaluation.

Simply put: fewer unnecessary checks, while preserving vanilla behavior. ⚡

🚀 Significantly Fewer Candidate Checks

Relevant advancement conditions are located based on the items that actually changed in the player’s inventory, avoiding a full scan of every listener each time.

🎯 Precise Vanilla Evaluation

Final matching is still performed by Minecraft’s vanilla TriggerInstance, ItemPredicate, and context predicates. The vanilla reward logic is not replaced.

🧩 Support for Complex Item Conditions

Correctly handles item counts, tags, data components, empty-slot changes, item removal, and combinations of multiple conditions.

🖥️ Server-Side Installation Only

Clients do not need to install this mod. Vanilla clients can connect to the server directly.

🛡️ Safe Fallback Mechanism

When unknown conditions, asynchronous calls, resource reloads, Mixin injection failures, or internal exceptions are encountered, the mod preserves or falls back to the vanilla processing flow.

🔍 Shadow Verification and Circuit-Breaker Protection

By default, the mod samples and compares optimized results against full evaluation results. If a mismatch is detected, the full result is used, and the mod can automatically disable the affected index or switch back to vanilla mode.

📊 Built-In Runtime Metrics

View trigger counts, candidate reduction ratios, full-scan counts, fallback reasons, latency distributions, and the most active players and items.

💾 No World Data Modifications

The mod does not add player attachments, capabilities, save-format changes, or network channels. Removing the mod does not require save migration.

The project includes a deterministic candidate-layer microbenchmark with:

  • 5,000 item-condition listeners
  • 1,000 unique item IDs
  • 50 simulated players
  • One item type changed per player per operation

Test results:

  • Approximately 5.014 candidate conditions generated per operation on average
  • Approximately 99.9% reduction in candidate count
  • Approximately 4.04× speedup in candidate-layer testing

⚠️ These results are from a microbenchmark of the candidate-filtering layer and do not mean that every server will receive the same MSPT improvement. Actual performance depends on data packs, advancement count, online player count, and the modpack environment.

After the first startup, NeoForge generates:

config/invadvopt-common.toml

The safe EXACT mode is enabled by default:

mode = "EXACT"
enabled = true
shadowVerifyRate = 0.01
periodicFullScanTicks = 200
fallbackOnUnknownPredicate = true
fallbackOnOffThreadCall = true
disableOnMismatch = true
metricsEnabled = true
debugLogging = false

To disable the optimization immediately, switch the mode to VANILLA. You do not need to uninstall the mod or restart the server.

The following commands require server administrator permission level 4:

/invadvopt status
/invadvopt stats
/invadvopt verify
/invadvopt mode vanilla
/invadvopt mode exact
/invadvopt reset-stats

🎮 Minecraft 1.21.1

🔧 NeoForge 21.1.x

☕ Java 21

🖥️ Dedicated Server

👤 No Client Installation Required

Place the mod JAR in the server’s mods folder and start the server.

The mod is specifically designed with hybrid NeoForge/Bukkit/Paper server environments in mind, including servers such as Youer:

  • Does not use @Overwrite
  • Does not depend on Bukkit internals
  • Does not use Unsafe or ClassLoader hacks
  • Automatically preserves vanilla logic when Mixin targets change
  • Provides sampled verification and circuit-breaker protection for possible runtime differences

The following similar advancement-optimization mods are incompatible with this mod:

  • achiopt
  • cerulean
  • icterine

When a conflict is detected, this mod logs an error and preserves the vanilla trigger-processing flow.

This mod is especially suitable for:

📚 Servers with large data packs

🏆 Modpacks with a large number of custom advancements

👥 Multiplayer survival servers

🧱 Modded servers that frequently modify player inventories

📉 Servers seeking to reduce advancement-evaluation overhead

You can revert at any time by:

  • Using /invadvopt mode vanilla to switch back to vanilla mode
  • Setting mode = "VANILLA" in the configuration file
  • Stopping the server and removing the mod JAR directly

Real-World Test Results on a Server with 380 Mods:

in-game test
spark

FAQ

InventoryAdvancementAccelerator questions

Question not listed? Ask our team.

InventoryAdvancementAccelerator 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 InventoryAdvancementAccelerator run on?

According to Modrinth, InventoryAdvancementAccelerator supports NeoForge for Minecraft 1.21.1.

How much RAM does a server with InventoryAdvancementAccelerator 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 InventoryAdvancementAccelerator?

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

Order server