Biome Compass Item

A Minecraft Forge mod for 1.20.1 that adds a craftable compass capable of locating any biome in your world. Point it, tune your search range, lock onto a target, and navigate - all from a clean in-game UI.

Server-friendly! An optimised algorithm to retain TPS.

---

Biome selection UI

Adjustable search range - tune the scan radius from 100m up to 10,000m.

---

Crafting

---

Controls

Input	Action
Left Click	Increase search range (+200 m)
Right Click	Decrease search range (−200 m)
Shift + Left Click	Toggle lock / unlock
Shift + Right Click	Open biome selector menu

All controls work from both the main hand and the offhand.

---

How It Works

Selecting a Biome

Press Shift + Right Click to open the biome selector. The left panel lists every biome loaded in your world, sorted alphabetically and scrollable with the mouse wheel. Click any entry to immediately begin searching for it. Selecting a new biome always unlocks the compass so the search can run freely.

Searching

Once a biome is selected the compass scans outward from your position in rings, checking blocks in steps of around 32m. The scan is incremental - only a small slice of work happens each tick - so it stays smooth even at the 10,000 m maximum range.

Lock Mode

IMPORTANT Don't forget to LOCK your compass when you get a trail to your biome.

• State - TRACKING (actively pointing) or LOCKED (frozen on the last found position)

Press Shift + Left Click to lock the compass. When locked:

• No new searches run, keeping server load at zero while navigating

Press Shift + Left Click again to unlock and resume live tracking.

Search Range

The range defines the annular band the compass searches within - a minimum and maximum radius around you. This lets you skip nearby biomes you have already visited and hunt for ones further away.

• Minimum inner radius: 100m
• Maximum outer radius: 10,000m

The range is shown in the action bar and in the item tooltip so you always know what window is active.

---

Sound Effects

Sound effects are tied to the Player source.

---

Compatibility

• Minecraft: 1.20.1
• Mod loader: Forge 47.x
• Modded biomes: fully supported — the biome list is read directly from the world's registry at runtime, so any biome added by another mod appears automatically in the selector
• Multiplayer: fully server-authoritative; all searches run on the server and results are synced to the client

---

Installation

1. Install Minecraft Forge 47.x for 1.20.1
2. Drop the mod .jar into your mods/ folder
3. Launch the game — no configuration required

---

License

MIT — see LICENSE for details.

---

Made by @LukieD4 — source available at github.com/LukieD4/BiomeCompassMod