[MM] Structure Compass

Description

Tired of the compass pointing you back to a village you already looted? Structure Compass solves that.

Right-click the compass to open a searchable list of every structure in the world — vanilla or modded. Select one, hit Search, and the compass needle spins to life, pointing you towards the nearest match. A small HUD overlay shows the structure name and distance in real time as you travel.

What makes Structure Compass special is its Skip Discovered Structures toggle. When enabled, the compass tracks every structure you visit and automatically excludes them from future searches. Your discoveries are saved persistently, so the compass stays smart across sessions and server restarts.

Searches run asynchronously on the server and use seed-based predictions to locate structures without loading chunks, keeping performance impact minimal even at large search radius.

Features

• Searchable structure list — filter by name or mod namespace to find exactly what you're looking for
• Skip Discovered Structures — toggle to automatically exclude previously visited structures from search results
• Persistent visit tracking — visited structures are remembered per player, across sessions and server restarts
• Real-time HUD overlay — shows structure name and distance while holding the compass
• Animated compass needle — spins while searching, points toward the target when locked on
• Async server-side search — searches run off-thread so the server never freezes
• Wide structure support — works with vanilla and modded structures via the server's structure registry
• Configurable search radius — adjust from 1 to 10,000 chunks (default: 100 chunks / ~1600 blocks)
• Multiplayer compatible — visit data is tracked per player

Crafting recipe

How It Works

Finding structures: When you start a search, the server scans for the nearest matching structure using seed-based predictions — no chunk loading required for most searches. It supports both random-spread structures (villages, temples, etc.) and concentric-ring structures (strongholds). For modded structures that use different placement logic, it falls back to Minecraft's built-in structure finder.

Skipping discovered structures: If Skip Discovered Structures is enabled and the nearest result has already been visited, the compass doesn't just stop there. It runs a search around you — then returns whichever unvisited result is closest to you. Visit detection uses a 64-block radius around structure positions and is stored per player.

Modpacks

Feel free to use this mod in your modpack.