{"id":148418,"date":"2026-06-09T00:56:27","date_gmt":"2026-06-08T21:56:27","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/"},"modified":"2026-06-09T00:56:27","modified_gmt":"2026-06-08T21:56:27","slug":"statusping","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/","title":{"rendered":"StatusPing"},"content":{"rendered":"

\n \n<\/p>\n

\n The ultimate lightweight monitoring, optimization, and utility solution for your server.<\/b><\/p>\n

<\/p>\n

<\/p>\n

<\/p>\n

<\/p>\n

<\/p>\n

## \u26a1 Overview
\n**StatusPing** is a modern utility plugin designed to keep your staff and players updated on the server’s health while providing tools to improve performance. Whether it’s **optimizing server configurations**, scheduling automated restarts with beautiful countdowns, monitoring uptime via status page services, or sending performance alerts to Discord, StatusPing handles it all.<\/p>\n

## \ud83d\udd25 Key Features<\/p>\n

### \ud83d\ude80 Server Optimizer (New!)
\nStop guessing which settings cause lag. The new optimizer module scans your configuration files (`server.properties`, `bukkit.yml`, `spigot.yml`, `paper-global.yml`, etc.) and compares them against optimized presets.
\n* **Presets:** Includes built-in presets (e.g., `example-lobby`) or create your own custom presets.
\n* **Detailed Reports:** Generates text files showing exactly which settings differ from the recommended values.
\n* **Safe Application:** Automatically backs up your config files before applying any changes.
\n* **Safe Gaurds:** Doesn’t save certain entries in configs like server_ip etc.. or anything sensitive.<\/p>\n

### \ud83d\udcc5 Advanced Restart Planning
\nForget basic stop commands. Schedule professional restarts with fully customizable countdowns.
\n* **Visual Countdowns:** Supports **BossBars**, **Action Bars**, **Titles**, and **Chat** notifications.
\n* **Custom Reasons:** Tell players why the server is restarting (e.g., “Daily Maintenance” or “Bug Fixes”).
\n* **Safety:** Automatically kicks players with a custom reason right before the actual shutdown.
\n* **Schedules:** Schedule daily restarts directly within the plugin.<\/p>\n

### \ud83d\udcac Discord Integration
\nKeep your staff team and players in the loop without being in-game.
\n* **Startup & Shutdown Webhooks:** Diverse embed messages when the server opens or closes. (Ability to ignore for quick restarts)
\n* **MSPT\/Lag Alerts:** Automatically alerts your admin channel if server performance drops, with customizable thresholds and duration checks to prevent spam.<\/p>\n

### \ud83d\udc93 Heartbeat & Uptime
\n* **External Monitoring:** Pings a URL (like BetterStack or UptimeRobot) at set intervals to track your uptime percentage accurately.
\n* **In-Game Graph:** View a visual history of heartbeat success\/failures directly in-game.<\/p>\n

### \ud83d\udcca Performance Stats
\n* View real-time **TPS**, **MSPT**, and **RAM Usage** with a single command.
\n* Includes a “Heartbeat Graph” to see network stability over the last few minutes.<\/p>\n

—<\/p>\n

## \ud83d\udcbb Commands & Permissions<\/p>\n

| Command | Usage | Permission | Description |
\n| :— | :— | :— | :— |
\n| **\/statusping** | `\/statusping` | `statusping.view` | View server uptime, RAM, MSPT, and heartbeat graph. |
\n| **\/statusping reload** | `\/statusping reload` | `statusping.reload` | Reloads the configuration and messages. |
\n| **\/plan-restart** | `\/plan-restart

—<\/p>\n

## \ud83e\udde9 PlaceholderAPI Support
\nStatusPing fully supports PlaceholderAPI, allowing you to display stats on scoreboards, tabs, or holograms.<\/p>\n

| Placeholder | Description |
\n| :— | :— |
\n| `%statusping_uptime%` | Formatted server uptime. |
\n| `%statusping_tps%` | Current Server TPS. |
\n| `%statusping_mspt%` | Average tick time (MSPT). |
\n| `%statusping_ram_used%` | RAM used in MB. |
\n| `%statusping_ram_total%` | Total allocated RAM in MB. |
\n| `%statusping_restarting%` | Returns `true` if a restart is scheduled, otherwise `false`. |
\n| `%statusping_restart_time%` | The remaining time until restart (e.g., “2m 30s”). |
\n| `%statusping_heartbeat_status%` | Current status of the heartbeat task (Success\/Failed\/Waiting). |
\n| `%statusping_last_heartbeat%` | Time elapsed since the last successful heartbeat. |<\/p>\n

—<\/p>\n

### \ud83d\udee0\ufe0f Setting up BetterStack
\n1. Sign up at https:\/\/betterstack.com\/
\n2. Create a heartbeat
\n ![Creating Heartbeat](https:\/\/cdn.modrinth.com\/data\/cached_images\/f982067bd60830dabfd0beb85dc8d4cc11e5ae91.png)
\n3. Give it a name and keep the default values for expecting heartbeat and grace period. (The expected heartbeat should match the `interval` in `config.yml`)
\n ![Heartbeat Intervals](https:\/\/cdn.modrinth.com\/data\/cached_images\/699a1129286dd8b60d733c01441ace291893e957.png)
\n4. Copy the url generated, and paste it into the heartbeat section in `config.yml`
\n5. Restart the server and you should have connected it successfully.
\n6. Create a free status page with your new heartbeat, if you have multiple servers you can do the same for each.<\/p>\n

—<\/p>\n

## \u2699\ufe0f Configuration
\nThe plugin is highly configurable. You can toggle every feature, customize every message using **MiniMessage** (gradients, hover events, etc.), and tweak Discord embeds.<\/p>\n

\nClick to view config.yml<\/b><\/summary>\n

“`yaml
\n# ———————————————————————————- #
\n# StatusPing Configuration
\n# ———————————————————————————- #<\/p>\n

# — General Settings —
\n# Enable debug mode to see detailed logs in the console.
\ndebug: false<\/p>\n

# Checks for updates on startup and notifies admins.
\nupdate-checker: true<\/p>\n

# — Integrations —
\nintegrations:<\/p>\n

# Discord Webhook Integration
\n # Sends automated messages to a Discord channel to announce server status.
\n discord:
\n enabled: false
\n webhook-url: “https:\/\/discord.com\/api\/webhooks\/XXXX\/YourSecret”<\/p>\n

# Customization for the startup embed
\n startup:
\n username: “Server Status”
\n avatar-url: “https:\/\/i.imgur.com\/GkTenaK.png”
\n embed:
\n title: “Server Online”
\n description: “The server is now marked as online.”
\n # Color supports standard Hex codes (e.g. #64a338)
\n color: “#64a338”
\n timestamp: true
\n footer:
\n text: “YOUR-SERVER-NAME”
\n icon-url: “”<\/p>\n

# Customization for the shutdown embed
\n shutdown:
\n username: “Server Status”
\n avatar-url: “https:\/\/i.imgur.com\/GkTenaK.png”
\n embed:
\n title: “Server Shutdown”
\n description: “The server is now marked as offline.”
\n color: “#e03b24”
\n timestamp: true
\n footer:
\n text: “YOUR-SERVER-NAME”
\n icon-url: “”
\n fields:
\n – name: “Shutdown Reason:”
\n value: “{shutdown_reason}”
\n inline: false<\/p>\n

# Alerts when Server Performance (MSPT) is high
\n mspt-alert:
\n enabled: false
\n webhook-url: “https:\/\/discord.com\/api\/webhooks\/YYYY\/YourSecret”
\n threshold: 50.0
\n duration: 5
\n username: “Server Performance”
\n avatar-url: “https:\/\/i.imgur.com\/GkTenaK.png”
\n embed:
\n title: “High MSPT Detected!”
\n description: “The server’s MSPT is currently above the configured threshold of {threshold}.”
\n color: “#ffc400”
\n timestamp: true
\n footer:
\n text: “YOUR-SERVER-NAME”
\n icon-url: “”<\/p>\n

# Heartbeat \/ Uptime Monitoring (e.g. BetterStack)
\n heartbeat:
\n enabled: false
\n interval: 180
\n url: “https:\/\/uptime.betterstack.com\/api\/v1\/heartbeat\/”<\/p>\n

# — Modules —<\/p>\n

# Server Restart Planner (\/plan-restart)
\nrestart-system:<\/p>\n

# Default reasons for restarts
\n defaults:
\n planned-reason: “Server is restarting as scheduled.”
\n unplanned-reason: “Server shutdown initiated unexpectedly.”<\/p>\n

# Constraints for the \/plan-restart command
\n # Time format examples: “10s” (seconds), “5m” (minutes), “1h” (hours).
\n constraints:
\n min-delay: “15s”
\n max-delay: “10m”<\/p>\n

# Notification settings
\n notifications:
\n chat: true
\n action-bar: true
\n kick-players: true<\/p>\n

# Times (in seconds) to broadcast a warning
\n intervals:
\n – 120
\n – 60
\n – 30
\n – 10
\n – 5
\n – 4
\n – 3
\n – 2
\n – 1<\/p>\n

boss-bar:
\n enabled: true
\n title: “Server Restarting in

# Available Colors: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
\n color: “RED”<\/p>\n

# Available Overlays: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20
\n overlay: “PROGRESS”<\/p>\n

titles:
\n enabled: true
\n start-at: 10<\/p>\n

sounds:
\n enabled: true
\n tick: “block.note_block.hat”
\n restart: “entity.lightning_bolt.thunder”<\/p>\n","protected":false},"excerpt":{"rendered":"

StatusPing is a lightweight server utility for monitoring uptime, scheduling automated restarts, and sending Discord alerts to keep staff and players informed.<\/p>\n","protected":false},"featured_media":148419,"template":"","meta":{"_minecraft_slug":"statusping","_minecraft_project_id":"RwWJRbqX","_minecraft_author":"shamusau","_minecraft_license":"Apache-2.0","_minecraft_downloads":300,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"statusping.zip","_minecraft_size_bytes":1473037,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T11:46:52.898664Z","_minecraft_date_created":"2025-10-01T03:57:34.894735Z","_minecraft_date_modified":"2026-03-17T09:11:56.333981Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/statusping","_minecraft_icon_attachment_id":148419,"_minecraft_imported_at":"2026-06-08T21:56:28+00:00","_minecraft_import_hash":"cccf52ca4b40cb29661161c84289333f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,128,123,92,985],"mod_loader":[132,133,986],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-148418","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_category-velocity","mod_loader-paper","mod_loader-purpur","mod_loader-velocity","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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":"\nStatusPing - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"StatusPing - Minecraft\" \/>\n<meta property=\"og:description\" content=\"StatusPing is a lightweight server utility for monitoring uptime, scheduling automated restarts, and sending Discord alerts to keep staff and players informed.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/i.imgur.com\/C2tiyYe.png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/\",\"name\":\"StatusPing - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/statusping-icon-8d8b379e3f45ac148e151c4119d19d1bdfd97669_96.webp\",\"datePublished\":\"2026-06-08T21:56:27+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/statusping-icon-8d8b379e3f45ac148e151c4119d19d1bdfd97669_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/statusping-icon-8d8b379e3f45ac148e151c4119d19d1bdfd97669_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/statusping\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"StatusPing\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"StatusPing - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/","og_locale":"en_US","og_type":"article","og_title":"StatusPing - Minecraft","og_description":"StatusPing is a lightweight server utility for monitoring uptime, scheduling automated restarts, and sending Discord alerts to keep staff and players informed.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/i.imgur.com\/C2tiyYe.png","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/","name":"StatusPing - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/statusping-icon-8d8b379e3f45ac148e151c4119d19d1bdfd97669_96.webp","datePublished":"2026-06-08T21:56:27+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/statusping\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/statusping-icon-8d8b379e3f45ac148e151c4119d19d1bdfd97669_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/statusping-icon-8d8b379e3f45ac148e151c4119d19d1bdfd97669_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/statusping\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"StatusPing"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/148418","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/148419"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=148418"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=148418"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=148418"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=148418"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}