Compass Сoordinates

Minecraft is a game of endless exploration, but constantly checking your coordinates can break immersion. The debug screen clutters your view, and many players prefer a cleaner HUD. Compass Сoordinates solves this elegantly by displaying your position only when you hold a compass. This lightweight plugin for Paper and Spigot servers brings intuitive navigation without sacrificing the vanilla feel.

What Is Compass Сoordinates?

Compass Сoordinates is a server-side plugin that ties coordinate display to the compass item. When you hold a compass in either hand, your coordinates appear in the action bar. The moment you put the compass away, the coordinates vanish completely — even from the F3 debug screen. It uses ProtocolLib to create a seamless, “fake” reducedDebugInfo state, so you never need to toggle game rules manually. The result is a polished, roleplay-friendly way to navigate your world.

Key Features

• Action bar coordinates while holding a compass in main or off hand.
• Automatic F3 toggle via ProtocolLib — hides coordinates when compass is not held, without altering server configs.
• Fully customizable message format, colors, update interval, and direction labels.
• Lightweight and efficient — minimal performance impact, designed for Paper/Spigot servers running Java 17+.
• Multi-world support — works across all dimensions, showing the world name if desired.

How It Works

The plugin listens for when a player holds a compass. It then sends a formatted string to the action bar using placeholders like %x, %y, %z, and %dir for cardinal direction. Behind the scenes, ProtocolLib intercepts the debug info packet to enforce the “reduced” state, so even if a player opens F3, coordinates stay hidden unless a compass is in hand. This dual-layer approach ensures consistency and prevents accidental coordinate peeking.

Installation Guide

Getting Compass Сoordinates for Minecraft up and running is straightforward. Follow these steps to install it on your server:

1. Ensure your server runs Paper or Spigot for Minecraft 1.17 or newer, with Java 17+.
2. Install ProtocolLib — this is a required dependency. Place its .jar in your plugins folder and restart the server once.
3. Download Compass Сoordinates and place the plugin .jar into your server’s plugins folder.
4. Start or restart the server. A default configuration file will be generated at plugins/CompassCoords/config.yml.
5. Optionally, edit the config to customize the display text, colors, or update speed, then restart the server again.
6. Run the command /gamerule reducedDebugInfo to verify the plugin is managing the state — it should now be controlled automatically.

If you use the foxygame.net launcher, you can skip the manual download entirely. The launcher’s built-in add-on catalog lets you find Compass Сoordinates and install it with a single click, while its auto-update system keeps the plugin compatible with the latest Minecraft versions without any extra effort.

Configuration Options

The config.yml file gives you full control over how coordinates appear. Here are the most important settings:

• enabled — turn the plugin on or off globally.
• delay — update interval in ticks (20 ticks = 1 second). Lower values give smoother updates.
• text — the action bar message format. Use placeholders like %x, %y, %z for integer coordinates, or %dx, %dy, %dz for one decimal. Add %world for the world name, and %dir for the cardinal direction.
• directions — customize the labels for N, NE, E, SE, S, SW, W, NW to match your language or style.

Color codes using & or § are fully supported, so you can match your server’s aesthetic. For example, &6%dir&r | &6X:&r %x &6Y:&r %y &6Z:&r %z produces a gold-colored direction and labels.

Why Choose Compass Сoordinates?

Unlike other coordinate mods that require client-side installations or resource packs, Compass Сoordinates works purely on the server. Every player on your server benefits automatically, with no extra setup. It respects the vanilla gameplay loop — you still need a compass to navigate, which adds a layer of immersion. The integration with ProtocolLib means you never have to worry about players bypassing the system through F3. It’s the perfect middle ground between hardcore no-coordinate play and always-on HUDs.

Whether you run a survival server, an RPG world, or just want a cleaner screen for building, Compass Сoordinates delivers. The plugin is actively maintained and compatible with modern Paper/Spigot builds. To get started, simply download Compass Сoordinates and drop it into your plugins folder — or use the foxygame.net launcher for an even faster setup. Once installed, you’ll wonder how you ever explored without it.