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 ### 🚀 Server Optimizer (New!) Stop 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. * **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. * **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 | Command | Usage | Permission | Description | | :--- | :--- | :--- | :--- | | **/statusping** | `/statusping` | `statusping.view` | View server uptime, RAM, MSPT, and heartbeat graph. | | **/statusping reload** | `/statusping reload` | `statusping.reload` | Reloads the configuration and messages. | | **/plan-restart** | `/plan-restart [reason]` | `statusping.planrestart` | Schedule a server restart (e.g., `/plan-restart 5m Maintenance`). | | **/plan-restart cancel** | `/plan-restart cancel` | `statusping.planrestart` | Cancel a currently scheduled restart. | | **/optimize** | `/optimize [apply]` | `statusping.optimize` | Generate an optimization report or apply a preset. | | **/optimize save** | `/optimize save preset ` | `statusping.optimize` | Save your current server settings as a new preset. | | **(Notification)** | N/A | `statusping.update` | Receive 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. | Placeholder | Description | | :--- | :--- | | `%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

```yaml # ---------------------------------------------------------------------------------- # # 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: "" # 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" # 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: "Server Restarting in " # 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"

shamusau

StatusPing

Информация