EMI Accelerator

Caches the EMI item stack list to disk and defers search index building to a background thread, drastically reducing EMI reload time.

Overview

Every time you join a world or reload resources, EMI rebuilds the entire item stack list and search index. For modpacks with a large number of mods, this process can take tens of seconds, and the game UI freezes completely while the search index is being built.

EMI Accelerator solves this problem with the following optimizations:

• Stack Caching: Serializes EmiStackList.stacks to JSON and caches it to disk on the first load. Subsequent game launches skip the full reload (around 130ms compared to ~40 seconds).
• Deferred Search: Defers EmiSearch.bake() to a background thread, eliminating roughly 10 seconds of UI blocking.
• Auto Refresh: Automatically updates EMI search results once background indexing finishes, with no manual re-input required.

Usage

Command Description /emiacc status View cache status, file size, and hit count /emiacc clear Delete the cache (rebuilds on next launch) /emiacc reload Trigger an EMI reload manually /emiacc reload --force Clear cache and force a full EMI reload

Configuration

Config file path: config/emi-accelerator/emi-accelerator.properties

Option Type Default Description cacheEnabled boolean true Enable item stack caching autoClearOnModChange boolean true Automatically clear cache when mod list changes maxFileSizeMb int 100 Maximum cache file size (MB) diagnosticsEnabled boolean false Write stage timings to reload-timings.json deferredSearchEnabled boolean true Enable background deferred search indexing

How It Works

1. EMI tag sync triggers → EmiReloadManager.reload() → ReloadWorker.run() starts
2. Check if the cache exists and is valid (SHA-256 mod list hash verification)
3. Cache hit: Deserialize stack list directly → skip full reload → build search index in background → complete
4. Cache miss: Proceed with normal EMI reload → asynchronously write cache after completion
5. Automatically refresh the EMI UI after search build finishes, showing [EMI Accelerator] Search Ready

Dependencies

Mod Version Required EMI 1.1.22+ Yes

• Loader: NeoForge 21.1.228+
• Side: Client-only
• Environment: Minecraft 1.21.1

Build

./gradlew build

License

GNU AGPL 3.0