COWMODSКаталог модов

StatusPing

StatusPing is a lightweight server utility for monitoring uptime, scheduling automated restarts, and sending Discord alerts to keep staff and players informed.

Автор: shamusau5907обновлён 22 июл. 2026 г.
УправлениеТехнологииУтилиты

Описание

The ultimate lightweight monitoring, optimization, and utility solution for your server.

⚡ Overview

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.

🔥 Key Features

  • Presets: Includes built-in presets (e.g., example-lobby) or create your own custom presets.
  • Detailed Reports: Generates text files showing exactly which settings differ from the recommended values.
  • Safe Application: Automatically backs up your config files before applying any changes.
  • Safe Gaurds: Doesn't save certain entries in configs like server_ip etc.. or anything sensitive.

📅 Advanced Restart Planning

Forget basic stop commands. Schedule professional restarts with fully customizable countdowns.

  • Visual Countdowns: Supports BossBars, Action Bars, Titles, and Chat notifications.
  • Custom Reasons: Tell players why the server is restarting (e.g., "Daily Maintenance" or "Bug Fixes").
  • Safety: Automatically kicks players with a custom reason right before the actual shutdown.
  • Schedules: Schedule daily restarts directly within the plugin.

💬 Discord Integration

Keep your staff team and players in the loop without being in-game.

  • Live Embed Status Panel: Show all your server status' within a simple panel on discord.
  • Startup & Shutdown Webhooks: Diverse embed messages when the server opens or closes. (Ability to ignore for quick restarts)
  • MSPT/Lag Alerts: Automatically alerts your admin channel if server performance drops, with customizable thresholds and duration checks to prevent spam.

💓 Heartbeat & Uptime

  • External Monitoring: Pings a URL (like BetterStack or UptimeRobot) at set intervals to track your uptime percentage accurately.
  • In-Game Graph: View a visual history of heartbeat success/failures directly in-game.

📊 Performance Stats

  • View real-time TPS, MSPT, and RAM Usage with a single command.
  • Includes a "Heartbeat Graph" to see network stability over the last few minutes.

💻 Commands & Permissions

CommandUsagePermissionDescription
/statusping/statuspingstatusping.viewView server uptime, RAM, MSPT, and heartbeat graph.
/statusping reload/statusping reloadstatusping.reloadReloads the configuration and messages.
/plan-restart/plan-restart <time> [reason]statusping.planrestartSchedule a server restart (e.g., /plan-restart 5m Maintenance).
/plan-restart cancel/plan-restart cancelstatusping.planrestartCancel a currently scheduled restart.
(Notification)N/Astatusping.updateReceive a notification on join when a new update is available.

🧩 PlaceholderAPI Support

StatusPing fully supports PlaceholderAPI, allowing you to display stats on scoreboards, tabs, or holograms.

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

🛠️ Setting up BetterStack

  1. Sign up at https://betterstack.com/
  2. Create a heartbeat Creating Heartbeat
  3. 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) Heartbeat Intervals
  4. Copy the url generated, and paste it into the heartbeat section in config.yml
  5. Restart the server and you should have connected it successfully.
  6. Create a free status page with your new heartbeat, if you have multiple servers you can do the same for each.

⚙️ Configuration

The plugin is highly configurable. You can toggle every feature, customize every message using MiniMessage (gradients, hover events, etc.), and tweak Discord embeds.

Click to view config.yml
# ---------------------------------------------------------------------------------- #
# StatusPing Configuration
# ---------------------------------------------------------------------------------- #

# --- General Settings ---
# Enable debug mode to see detailed logs in the console.
debug: false

# Checks for updates on startup and notifies admins.
update-checker: true

# --- Integrations ---
integrations:
  
  # Discord Webhook Integration
  # Sends automated messages to a Discord channel to announce server status.
  discord:
    enabled: false
    webhook-url: "https://discord.com/api/webhooks/XXXX/YourSecret"
    
    # Customization for the startup embed
    startup:
      username: "Server Status"
      avatar-url: "https://i.imgur.com/GkTenaK.png"
      embed:
        title: "Server Online"
        description: "The server is now marked as online."
        # Color supports standard Hex codes (e.g. #64a338)
        color: "#64a338"
        timestamp: true
        footer:
          text: "YOUR-SERVER-NAME"
          icon-url: ""

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

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

    # Server Status Embed
    # Posts an embed showing this server's live status, and edits that same message
    # on an interval instead of posting a new one each time.
    network-status:
      enabled: false
      webhook-url: "https://discord.com/api/webhooks/ZZZZ/YourSecret"
      # How often (in seconds) to refresh and edit the embed. Minimum enforced: 15.
      refresh-interval: 60
      username: "Server Status"
      avatar-url: "https://i.imgur.com/GkTenaK.png"
      title: "Server Status"
      # Optional text shown above the status line. Leave empty to disable. Supports the same placeholders as the other embeds.
      description: ""
      # Display name shown for this server in the embed.
      server-name: "YOUR-SERVER-NAME"
      online-emoji: "🟢"
      show-player-counts: true
      footer-text: "Last updated"
      color: "#64a338"

      # Extra custom lines appended to the embed after the status line (e.g. links, notices).
      # Leave empty to disable. Supports the same placeholders as the other embeds.
      # Markdown links work here, e.g. "[View Status Page](https://status.mythic.gg/)".
      extra-lines: []
        # - ""
        # - "[View Status Page](https://status.mythic.gg/)"

  # Heartbeat / Uptime Monitoring (e.g. BetterStack)
  heartbeat:
    enabled: false
    interval: 180
    url: "https://uptime.betterstack.com/api/v1/heartbeat/"

# --- Modules ---

# Server Restart Planner (/plan-restart)
restart-system:
  
  # Default reasons for restarts
  defaults:
    planned-reason: "Server is restarting as scheduled."
    unplanned-reason: "Server shutdown initiated unexpectedly."
  
  # Constraints for the /plan-restart command
  # Time format examples: "10s" (seconds), "5m" (minutes), "1h" (hours).
  constraints:
    min-delay: "15s"
    max-delay: "10m"

  # Commands to execute just before the final 'restart' command
  # Use console-level commands (e.g. "save-all", "backup start")
  pre-restart-commands:
    - "save-all"

  # Scheduled Restarts (Automatic)
  scheduled-restarts:
    enabled: false
    # List of times in 24h format (HH:mm).
    # Times are matched against the server's JVM timezone (set via -Duser.timezone or system default).
    # On most hosted servers this is UTC. Adjust your times accordingly.
    times:
      - "04:00"
    # The countdown duration for the scheduled restart (e.g. "10m", "5m")
    # This will use the /plan-restart logic.
    restart-delay: "10m"
    # Whether to skip sending the Discord shutdown embed for this scheduled restart.
    skip-discord-embed: false
    # Reason shown in-game and on Discord
    reason: "Daily scheduled maintenance."

  # Notification settings
  notifications:
    chat: true
    action-bar: true
    kick-players: true
    
    # Times (in seconds) to broadcast a warning
    intervals: 
      - 120
      - 60
      - 30
      - 10
      - 5
      - 4
      - 3
      - 2
      - 1

    boss-bar:
      enabled: true
      title: "<red><bold>Server Restarting in <time></bold></red>"
      
      # Available Colors: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
      color: "RED"
      
      # Available Overlays: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20
      overlay: "PROGRESS"

    titles:
      enabled: true
      start-at: 10

    sounds:
      enabled: true
      tick: "block.note_block.hat"
      restart: "entity.lightning_bolt.thunder"

Галерея

Main Command OutputUptime WebpageDiscord WebhooksLive Embed Status Panel

Последние версии

Все версии →
release

3.0.0

3.0.0
22 июл. 2026 г.100Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper, purpur, velocity
Скачать
Что нового
- Added support for 26.1.x and 26.2. - Officially added support for velocity. Limited feature set compared to paper plugin due to velocity limitations. - Added a new velocity or single status live updating embed, more configuration options to come expanding this feature. ![StatusPing updating embed](https://cdn.modrinth.com/data/cached_images/39e152612749a52e76e5af9753766306de07a1c7.png) - Removed server optimizer, this was relatively unused, while still helpful it's better to manaully review server settings. **Check plugin homepage description for config changes.**
beta

Velocity support testing.

3.0.0
17 мар. 2026 г.72Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur, velocity
Скачать
Что нового
**PLEASE NOTE THIS IS A BETA RELEASE, REPORT ALL BUGS** [https://discord.gg/YuvwSWUUY3](https://discord.gg/YuvwSWUUY3) - Added support for velocity. Limited feature set compared to paper plugin due to velocity limitations. See velocity configuration below: ``` # ---------------------------------------------------------------------------------- # # StatusPing Configuration (Velocity) # ---------------------------------------------------------------------------------- # # --- General Settings --- # Enable debug mode to see detailed logs in the console. debug: false # Checks for updates on startup and notifies admins. update-checker: true # --- Integrations --- integrations: # Discord Webhook Integration # Sends automated messages to a Discord channel to announce proxy status. discord: enabled: false webhook-url: "https://discord.com/api/webhooks/XXXX/YourSecret" # Customization for the startup embed startup: username: "Server Status" avatar-url: "https://i.imgur.com/GkTenaK.png" embed: title: "Proxy Online" description: "The proxy is now marked as online." # Color supports standard Hex codes (e.g. #64a338) color: "#64a338" timestamp: true footer: text: "YOUR-SERVER-NAME" icon-url: "" # Customization for the shutdown embed shutdown: username: "Server Status" avatar-url: "https://i.imgur.com/GkTenaK.png" # Reason shown in the {shutdown_reason} placeholder below reason: "Proxy shutdown initiated unexpectedly." embed: title: "Proxy Shutdown" description: "The proxy is now marked as offline." color: "#e03b24" timestamp: true footer: text: "YOUR-SERVER-NAME" icon-url: "" fields: - name: "Shutdown Reason:" value: "{shutdown_reason}" inline: false # Heartbeat / Uptime Monitoring (e.g. BetterStack) heartbeat: enabled: false interval: 180 url: "https://uptime.betterstack.com/api/v1/heartbeat/" ```
release

2.1.0

2.1.0
5 мар. 2026 г.53Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Скачать
Что нового
- Fixed graph symbol in **/statusping** command. - Added boot time in **/statusping** command, shows the time it took for the server to restart. (compares shutdown time with startup time) - Added support skip sending a discord embed on shutdown and startup, example /**plan-restart 1m -d Quick update** - Added a scheduled restarts. ``` # Scheduled Restarts (Automatic) scheduled-restarts: enabled: false # List of times in 24h format (HH:mm) times: - "04:00" # The countdown duration for the scheduled restart (e.g. "10m", "5m") # This will use the /plan-restart logic. restart-delay: "10m" # Whether to skip sending the Discord shutdown embed for this scheduled restart. skip-discord-embed: false # Reason shown in-game and on Discord reason: "Daily scheduled maintenance." ``` - Updated dependencies to latest versions.
release

2.0.3

2.0.3
18 февр. 2026 г.34Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Скачать
Что нового
- Fixed error with Update notifier - Added support to change the language for time units, add this to your existing messages.yml ``` # Time Units time-units: second: "second" seconds-plural: "seconds" minute: "minute" minutes-plural: "minutes" ```
release

2.0.2

2.0.2
17 февр. 2026 г.22Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Скачать
Что нового
- Updated to use 1.21.11 paper dependency. - Fixed issues with config not working for certain things.
release

2.0.1

2.0.1
31 дек. 2025 г.58Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Скачать
Что нового
- Fixed a bug with File Updater (config updater) updating non default values. We highly recommend saving your current config.yml and regenerating the files.
release

MAJOR UPDATE

2.0.0
28 дек. 2025 г.22Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, purpur
Скачать
Что нового
**MAJOR VERSION, BIG NEW FEATURES:** New Server Optimizer System (/optimize): - Added a powerful new module to scan and optimize your server's configuration files (server.properties, bukkit.yml, spigot.yml, paper-global.yml, etc.). ![Report Feature](https://cdn.modrinth.com/data/cached_images/1e265d24aeec189b7774d48a1c15ac17baa09d8e.png) ![Applying Optimization](https://cdn.modrinth.com/data/cached_images/f36665b3b5e8dc0bc8786d9aa9c12d1bef600030.png) - Presets: Includes built-in presets (e.g., example-lobby.yml) and supports custom presets in the presets/ folder. - Reporting: Generates detailed reports comparing your current settings against the selected preset. ![Example Report](https://cdn.modrinth.com/data/cached_images/04b29278b973a3c0219a95d16ee0a98d0170a51b.png) - Added file updater, this will now add new options into your config.yml and messages.yml from new versions of StatusPing, starting from this version onwards. **OTHER CHANGES:** - messages.yml has recieved a heavy update for cleaner formatting. - Update checker fixed error. - Changed image host for discord webhooks default icon.
release

1.1.6

1.1.6
6 дек. 2025 г.27Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10paper, purpur
Скачать
Что нового
- Heavily optismised metrics - Fixed code error with [bstats](https://bstats.org/plugin/bukkit/StatusPing/27462) metrics
release

1.1.5

1.1.5
5 дек. 2025 г.23Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10paper, purpur
Скачать
Что нового
- Code cleanup - Optimisations to bossbar feature - Updated metrics - Fixed tiny messages.yml error
release

1.1.4

1.1.4
29 нояб. 2025 г.23Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10paper, purpur
Скачать
Что нового
**Please renegerate the config.yml and messages.yml to see new changes.** - New feature, placeholders for PlaceholderAPI **Here's the list of available placeholders:** ``` %statusping_restarting% - true or false %statusping_restart_time% - countdown time %statusping_uptime% - server uptime %statusping_tps% - just tps %statusping_mspt% - just the mspt %statusping_ram_used% - server ram used %statusping_ram_total% - total server ram %statusping_last_heartbeat% - last time since heartbeat %statusping_heartbeat_status% - current status of heartbeat (success, failed, waiting etc..) ``` - Added more information for statusping command to show server performance - Added optional bossbar for restarts - Added a update checker, notifies in-game (optional) and in console - Fixed a bug with statusping command sometimes failing to read heartbeat