Biome Compass Item

The compass is craftable and works on Forge for Minecraft 1.20.1 – 1.20.6, with files for each release in that range. The mod runs on client and server, so a server needs it and every player who joins needs it as well. The code is open source under the MIT License, and the source code and issue tracker are public.

A player picks a biome with Shift and right click, which opens a selector listing every biome loaded in the world in alphabetical order. Clicking an entry starts a search immediately. The list is built at runtime from the biomes the world currently holds, so biomes added by other mods appear in it as well. Searches run on the server and their results are synced to the client, and new searches keep server load at zero while the player navigates.

Players adjust the search range between 100 and 10,000 blocks, using an inner and an outer radius that define a ring the compass searches within. Shift and left click locks the compass on its current target, freezing the last found position, and a second Shift and left click returns it to live tracking. The controls work with the main hand and the offhand.