Structure Compass Mod — Guide

Mechanics

The Structure Compass operates through a dedicated Graphical User Interface (GUI) and real-time tracking mechanics.

Selecting a Structure

To use the compass, the player must right-click while holding the item. This action opens a selection menu containing a list of every structure available in the current dimension.

• Search Bar: Located at the top of the GUI, this allows players to filter structures by name (e.g., typing "Village" or "Bastion").
• Structure List: A scrollable list displaying the internal names of all registered structures.
• Start Search: After selecting a structure from the list, clicking this button initiates the tracking process.

Tracking and Navigation

Once a search is active, the compass provides several pieces of information: 1. The Needle: The red needle on the item icon will point toward the nearest instance of the chosen structure. 2. Distance Display: While the compass is in the player's main hand or off-hand, the distance to the target (in blocks) is displayed in the action bar above the hotbar. 3. Status Messages: If the structure cannot be found within the search radius, the game will display a "Structure not found" message in the chat.

Resetting the Compass

To clear the current target and stop the tracking, players can Shift + Right-click with the compass in hand. This will reset the needle to its default spinning state, allowing for a new search to be initiated.

Items

The mod adds a single, highly functional item to the game.

Structure Compass

The Structure Compass is the core tool of the mod. It functions as a handheld radar that identifies the coordinates of the nearest specified structure and directs the player toward it using its dynamic needle.

When held, the compass needle will spin aimlessly until a target structure is selected. Once a target is set, the needle behaves like a traditional compass, pointing toward the horizontal coordinates of the structure's center.

Crafting Recipes

The Structure Compass is designed to be accessible in the mid-game, requiring materials that encourage early exploration of the world.

Structure Compass Recipe

To craft the compass, players need a standard Minecraft Compass and four blocks of Mossy Cobblestone. The Mossy Cobblestone represents the "ancient" nature of the structures the compass is designed to find.

Note: In some modpack configurations, the recipe may be altered to use Mossy Stone Bricks or Dried Kelp, but Mossy Cobblestone is the default for version 26.1.1.