—<\/p>\n
# \ud83e\udded PingCompass<\/p>\n
A lightweight Minecraft plugin that displays player ping using a **compass-like indicator**, helping players and server admins quickly visualize network performance.
\nPerfect for competitive servers, mini-games, or survival communities that value smooth gameplay.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
* \ud83c\udfaf **Compass-Based Ping Display** \u2014 See your ping visually represented through compass directions or colors.
\n* \ud83d\udcca **Live Ping Updates** \u2014 Updates automatically as ping changes.
\n* \u2699\ufe0f **Customizable Display** \u2014 Choose between chat, action bar, boss bar, or scoreboard display.
\n* \ud83e\udde9 **Optimized for Performance** \u2014 Designed to be lightweight and efficient on Paper, Spigot, and Purpur servers.
\n* \ud83d\udd12 **Permission-Based Access** \u2014 Control who can view or use the ping compass.
\n* \ud83d\udcac **Fully Configurable Messages** \u2014 Edit every message and color via `messages.yml`.<\/p>\n
—<\/p>\n
## \ud83e\uddf1 Requirements<\/p>\n
* **Minecraft:** 1.16+
\n* **Server Software:** Paper, Purpur, or Spigot
\n* **Java:** 17 or newer<\/p>\n
—<\/p>\n
## \u2699\ufe0f Commands<\/p>\n
| Command | Description | Permission |
\n| ——————— | ————————————————– | ——————- |
\n| `\/pingcompass` | Toggles the ping compass on or off for the player. | `pingcompass.use` |
\n| `\/pingcompass reload` | Reloads the configuration and messages. | `pingcompass.admin` |<\/p>\n
—<\/p>\n
## \ud83d\udd12 Permissions<\/p>\n
| Permission Node | Description |
\n| ——————- | —————————————————- |
\n| `pingcompass.use` | Allows players to toggle or view their ping compass. |
\n| `pingcompass.admin` | Allows reloading the plugin configuration. |<\/p>\n
—<\/p>\n
## \ud83e\uddfe Configuration<\/p>\n
“`yaml
\n# PingCompass Configuration
\nsettings:
\n update-interval: 2 # seconds between ping updates
\n display-mode: actionbar # options: actionbar, chat, bossbar, scoreboard
\n messages:
\n prefix: “&6PingCompass &7\u00bb ”
\n ping-display: “&eYour ping: &a%ping%ms”
\n“`<\/p>\n
—<\/p>\n
## \ud83e\ude84 Usage<\/p>\n
* Use `\/pingcompass` to toggle your compass display.
\n* The compass or overlay updates automatically to reflect real-time ping changes.
\n* Admins can customize update intervals and display methods.<\/p>\n
—<\/p>\n
## \ud83e\udde9 Compatibility<\/p>\n
* Works seamlessly with **Paper**, **Spigot**, and **Purpur**.
\n* No dependencies required \u2014 simple drop-in installation.<\/p>\n
—<\/p>\n
## \ud83d\udcac Support<\/p>\n
Need help or found a bug?
\nJoin our Discord community for support and updates.<\/p>\n
—<\/p>\n
## \ud83c\udff7\ufe0f Tags<\/p>\n
`ping` \u00b7 `utility` \u00b7 `performance` \u00b7 `hud` \u00b7 `minecraft-plugin`<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight Spigot\/Paper plugin that gives players special compasses which point to the online player with the highest or the lowest ping. Useful for staff, events, or debugging network issues on your server.<\/p>\n","protected":false},"featured_media":165936,"template":"","meta":{"_minecraft_slug":"vexal-ping-compass","_minecraft_project_id":"K9IyctLm","_minecraft_author":"VexalStudios","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":23,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vexal-ping-compass.zip","_minecraft_size_bytes":15550,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:24:16.984525Z","_minecraft_date_created":"2025-10-29T07:41:51.774203Z","_minecraft_date_modified":"2025-10-20T18:26:15.465197Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vexal-ping-compass","_minecraft_icon_attachment_id":165936,"_minecraft_imported_at":"2026-06-09T18:07:37+00:00","_minecraft_import_hash":"ae7cd3b0d60d1c091ab26b16a7472d81","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-165937","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n