CompassLocator

Name: CompassLocator
Author: kasperoid

CompassLocator Mod Banner

CompassLocator is a client-side mod for Minecraft 1.21.6+ that adds useful compass information directly to the action bar. A port of the CompassLocator plugin, now with even more features and an in-game config GUI.

No more opening F3. Just hold a compass and see:

where you are
which direction you're facing
what biome you're in
where you died last time
players around you on the radar

Features

Normal Compass

Coordinates (adjustable precision — integer or decimal)
Current biome
Cardinal direction (North/South or N/S)
Time of day (optional)
World name (optional)
Lodestone support — shows the coordinates your compass is linked to, even if broken (shows last known position)

Recovery Compass

Where you last died (coordinates)
Which world
Time since death
Distance to death location

Combined Mode

Hold a normal compass in one hand and a recovery compass in the other
The action bar shows information from both at once

PvP/HCF-style Locator Bar

See nearby players on your radar
Shows player direction relative to you
Perfect for competitive gameplay

In-Game Configuration GUI

Full configuration menu right in your game
No need to edit files manually (but you still can)
Changes apply instantly

Gallery

Normal Compass

Recovery Compass

Combined Mode

Locator Bar

In-Game Config GUI

Lodestone (Working)

Lodestone (Broken)

Usage

Simply hold a compass in your hand. That's it.

The mod works with both hands — main hand and offhand.

Configuration

The mod offers two ways to configure everything:

Method	What you can do
In-Game GUI	Change settings on the fly, see changes immediately
YAML Files	`config.yml` and `lang.yml` — all original plugin settings preserved

You can toggle every feature individually, change colors, adjust update frequency, and much more.

Installation

Fabric

Install Fabric Loader for Minecraft 1.21.6+
Put Fabric API and CompassLocator in your mods/ folder
Launch the game

Forge

Install Forge for Minecraft 1.21.6+
Put CompassLocator in your mods/ folder
Launch the game

Dependencies

Fabric

Required:

Fabric API

Optional (recommended):

Mod Menu — for the configuration screen
Cloth Config API — for advanced config options

Forge

No required dependencies.

Requirements

Minecraft 1.21.6+
Java 21

There's also a server plugin version!

A server-side plugin for Paper/Spigot/Purpur on Minecraft 1.21+.

👉 CompassLocator — Plugin Version Modrinth

👉 CompassLocator — Plugin Version CurseForge

FAQ

Do I need to install anything on the server? No. This is a client-side mod. It works on any server, even vanilla.

Does it work in multiplayer? Yes. The Locator Bar shows other players even if they don't have the mod installed.

What's the difference between the mod and the plugin? The plugin runs on the server. The mod runs on your client and has access to more features (like the in-game GUI and client-side optimizations).

Do I need Mod Menu and Cloth Config? No, but they're recommended. Without them, you can still edit config.yml manually.

Does the compass work in both hands? Yes, you can hold it in either hand. Both are checked.