Compass Coordinates — a lightweight Paper/Spigot plugin that shows your coordinates only while you are holding a compass. It renders coordinates in the action bar and toggles F3 coordinates visibility via a “fake” reduceDebugInfo using ProtocolLib. When no compass is in hand, coordinates are hidden everywhere (including F3).

Features

Action bar coordinates while holding a compass (either hand).
F3 coordinates on/off via ProtocolLib without touching server configs.
Fully customizable message format, colors, update interval, and direction labels.

Requirements

Java 17+
Paper or Spigot matching your Minecraft version
ProtocolLib on the server

Installation

Put the plugin .jar into your server’s plugins folder.
Ensure ProtocolLib is installed and compatible.
Start or restart the server.
Edit plugins/CompassCoords/config.yml if needed and restart.
Run the command: /gamerule reducedDebugInfo

Behavior:

Coordinates appear only while a compass is held.
When no compass is held, the plugin hides coordinates in both Action Bar and F3 via ProtocolLib.

Config file

# This file explains every option. Copy the keys to `plugins/CompassCoords/config.yml`.
#
# Placeholders available in the `text` value:
#   %x, %y, %z          - player coordinates (integers)
#   %dx, %dy, %dz       - player coordinates with one decimal
#   %world              - world name
#   %yaw, %pitch        - player rotation (integers)
#   %dyaw, %dpitch      - player rotation with one decimal
#   %dir                - cardinal direction derived from yaw (uses `directions` mapping below)
#
# Color codes:
#   Use `&`-codes (e.g. &6, &r). They will be converted to §-codes at runtime.
#   You can also write §-codes directly if you prefer.

# Whether the plugin is enabled at all.
enabled: true

# How often to update the Action Bar (in ticks). 20 ticks = 1 second.
# Lower values update more frequently but may be noisier.
delay: 5

# The Action Bar message format shown while holding a compass.
# Combine any placeholders listed above. Colors: use &-codes or §-codes.
# Example with integer coords:
#   "&6%dir&r | &6X:&r %x &6Y:&r %y &6Z:&r %z"
# Example with one-decimal coords:
#   "§6%dir§r | §6X:§r %dx §6Y:§r %dy §6Z:§r %dz"
text: "§6%dir§r | §6X:§r %x §6Y:§r %y §6Z:§r %z"

# Labels for the 8 compass directions used by %dir.
# Customize them to your language or style if you want.
directions:
  north: "N"
  northeast: "NE"
  east: "E"
  southeast: "SE"
  south: "S"
  southwest: "SW"
  west: "W"
  northwest: "NW"

Compass Сoordinates