InventoryAdvancementAccelerator

Source-provided project description. FreeMinecraftMods keeps creator credit and adds separate compatibility and decision guidance below.

Project overview

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

FreeMinecraftMods decision guide

This mod is most relevant to players looking for Performance, Bug Fixes on NeoForge. Treat those labels as discovery hints, then verify the exact file and dependency list on the official project page.

The source record was updated on Jul 20, 2026, which is a recent freshness signal. A recent date does not guarantee support for every loader or Minecraft version, so still inspect the current file list.

What to verify before choosing a file

• Confirm that the file is published by the credited creator on the linked official source.
• Match the Minecraft version exactly instead of relying only on a broad category label.
• Read dependencies, incompatibilities, and changelog notes before updating an existing instance.
• Match the loader or server platform and its required version. Forge and NeoForge are not interchangeable.
• Back up worlds and configuration files before testing the project in a long-term save or public server.

Compatibility at a glance

Minecraft versions in this snapshot: 1.21.1

Loaders and platforms: NeoForge

Before you install

Match the exact Minecraft version and loader, install every required dependency, and test in a separate profile before opening an important world. Keep a backup before changing a working mod list.

Source, licensing, and corrections

FreeMinecraftMods does not mirror the project files. Use the official source for downloads, release notes, dependencies, support, and licensing details. Project names, images, and creator-written descriptions remain the property of their respective owners.

How listings are reviewed | Report incorrect project information | Rights-holder and DMCA information