promotional bannermobile promotional banner

Async Locator Refined

Changes the searching of features to be asynchronous to mitigate associated lag. Maintained version
Back to Files

1.21.1-1.6.0 NeoForge

File nameasync-locator-refined-neoforge-1.21.1-1.6.0.jar
Uploader
Alvaro842DEVAlvaro842DEV
Uploaded
Jul 24, 2026
Downloads
8.6K
Size
292.3 KB
Mod Loaders
NeoForge
File ID
8501111
Type
R
Release
Supported game versions
  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:async-locator-refined-1331921:8501111"

Learn more about Curse Maven

What's new

 This version brings overall improvements to the mod.

Fixes:

  • ExplorationMapFunction.run performed the search before calling MapItem.create, meaning the original mixin never prevented the blocking operation from running on the main thread and instead started a redundant asynchronous search afterwards. The injection has now been moved to run before ServerLevel#findNearestMapStructure, cancelling the synchronous search entirely so exploration maps are now located asynchronously. This was a critical issue since first version of AsyncLocator-Refined.
  • Fixed thread safety races in structure lookups that could corrupt state or crash when locating off-thread.
  • Fixed a race where locate callbacks could run before the map item was placed, producing broken maps in chests and villager trades.
  • Eyes of Ender are now refunded if the stronghold search fails, times out (60s), or errors, like vanilla.
  • Dolphins no longer lose their treasure target when their search goal restarts, and handle failed searches like vanilla.
  • Villager trade offers now refresh correctly for the trading player once a map search completes.
  • /locate errors are now reported to the command sender instead of being swallowed, while preserving the client's language.

Added:

  • Expanded the public API for other mods, adding configurable locate timeouts and support for biome searches using custom biome predicates.
  • Identical concurrent locate requests (same dimension, target, position, radius) now share one search instead of running duplicates.
  • Game tests for both Fabric and NeoForge, run automatically on pull requests.
  • Sources jars are now published for mod developers.
  • Added configurable limits for concurrent and queued locate searches, preventing unbounded locate work during request bursts. The default allows 2 active searches and 128 queued searches.

This mod has no additional files