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