为您的服务器打造的终极轻量级监控、优化和实用工具解决方案。
⚡ 概述
StatusPing 是一款现代化的实用插件,旨在让您的工作人员和玩家随时了解服务器的运行状况,同时提供提升性能的工具。无论是优化服务器配置、安排带有精美倒计时的自动重启、通过状态页服务监控正常运行时间,还是向 Discord 发送性能警报,StatusPing 都能为您处理一切。
? 主要功能
- 预设模板: 包含内置的预设模板(例如
example-lobby),您也可以创建自己的自定义预设。
- 详细报告: 生成文本文件,精确显示哪些设置与推荐值存在差异。
- 安全应用: 在应用任何更改之前,会自动备份您的配置文件。
- 安全保护: 不会保存配置文件中的某些条目,如 server_ip 等敏感信息。
? 高级重启计划
忘掉基本的停止命令吧。安排专业的重启,并支持完全自定义的倒计时。
- 视觉倒计时: 支持 BossBars、Action Bars、Titles 和 Chat 通知。
- 自定义理由: 告知玩家服务器重启的原因(例如,“日常维护”或“修复漏洞”)。
- 安全性: 在实际关闭之前,会自动以自定义理由踢出玩家。
- 计划任务: 直接在插件内安排每日重启。
? Discord 集成
无需进入游戏,即可让您的工作人员团队和玩家保持同步。
- 实时嵌入状态面板: 在 Discord 上的简单面板中展示所有服务器状态。
- 启动与关闭 Webhook: 当服务器开启或关闭时发送多样化的嵌入消息。(支持忽略快速重启的情况)
- MSPT/延迟警报: 如果服务器性能下降,会自动向您的管理员频道发送警报,支持自定义阈值和持续时间检查,以防止垃圾信息刷屏。
? 心跳检测与正常运行时间
? 性能统计
- 使用单个命令查看实时的 TPS、MSPT 和 RAM 使用情况。
- 包含“心跳图表”,可查看过去几分钟的网络稳定性。
? 命令与权限
| 命令 |
用法 |
权限 |
描述 |
| /statusping |
/statusping |
statusping.view |
查看服务器正常运行时间、RAM、MSPT 和心跳图表。 |
| /statusping reload |
/statusping reload |
statusping.reload |
重新加载配置和消息。 |
| /plan-restart |
/plan-restart <time> [reason] |
statusping.planrestart |
安排服务器重启(例如,/plan-restart 5m Maintenance)。 |
| /plan-restart cancel |
/plan-restart cancel |
statusping.planrestart |
取消当前已计划的重启。 |
| (通知) |
N/A |
statusping.update |
当有新更新可用时,在加入服务器时收到通知。 |
? PlaceholderAPI 支持
StatusPing 完全支持 PlaceholderAPI,允许您在记分板、标签页或全息图块上显示统计数据。
| 占位符 |
描述 |
%statusping_uptime% |
格式化的服务器正常运行时间。 |
%statusping_tps% |
当前服务器 TPS。 |
%statusping_mspt% |
平均刻耗时 (MSPT)。 |
%statusping_ram_used% |
已使用的 RAM(MB)。 |
%statusping_ram_total% |
分配的总 RAM(MB)。 |
%statusping_restarting% |
如果安排了重启则返回 true,否则返回 false。 |
%statusping_restart_time% |
距离重启的剩余时间(例如,“2m 30s”)。 |
%statusping_heartbeat_status% |
心跳任务的当前状态(成功/失败/等待中)。 |
%statusping_last_heartbeat% |
自上次成功心跳以来经过的时间。 |
?️ 设置 BetterStack
- 在 注册账号
- 创建一个心跳检测

- 为其命名,并保持期望的心跳间隔和宽限期的默认值。(期望的心跳间隔应与
config.yml 中的 interval 匹配)

- 复制生成的 URL,并将其粘贴到
config.yml 的心跳部分中
- 重启服务器,您应该已成功连接。
- 使用新创建的心跳检测创建一个免费的状态页面,如果您有多个服务器,可以对每个服务器执行相同的操作。
⚙️ 配置
该插件高度可配置。您可以切换每个功能,使用 MiniMessage(渐变、悬停事件等)自定义每条消息,并调整 Discord 嵌入样式。
点击查看 config.yml
# ---------------------------------------------------------------------------------- #
# StatusPing 配置
# ---------------------------------------------------------------------------------- #
# --- 常规设置 ---
# 启用调试模式以在控制台中查看详细日志。
debug: false
# 在启动时检查更新并通知管理员。
update-checker: true
# --- 集成 ---
integrations:
# Discord Webhook 集成
# 向 Discord 频道发送自动消息以公告服务器状态。
discord:
enabled: false
webhook-url: "https://discord.com/api/webhooks/XXXX/YourSecret"
# 启动嵌入的自定义设置
startup:
username: "Server Status"
avatar-url: "https://i.imgur.com/GkTenaK.png"
embed:
title: "Server Online"
description: "The server is now marked as online."
# 颜色支持标准十六进制代码(例如 #64a338)
color: "#64a338"
timestamp: true
footer:
text: "YOUR-SERVER-NAME"
icon-url: ""
# 关闭嵌入的自定义设置
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
# 当服务器性能 (MSPT) 过高时发出警报
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: ""
# 服务器状态嵌入
# 发布一个显示当前服务器实时状态的嵌入,并按间隔编辑该消息,而不是每次都发布新消息。
network-status:
enabled: false
webhook-url: "https://discord.com/api/webhooks/ZZZZ/YourSecret"
# 刷新和编辑嵌入的频率(秒)。最低强制限制:15。
refresh-interval: 60
username: "Server Status"
avatar-url: "https://i.imgur.com/GkTenaK.png"
title: "Server Status"
# 状态行上方显示的可选文本。留空以禁用。支持与上述嵌入相同的占位符。
description: ""
# 嵌入中显示的此服务器的名称。
server-name: "YOUR-SERVER-NAME"
online-emoji: "?"
show-player-counts: true
footer-text: "Last updated"
color: "#64a338"
# 追加到状态行之后的额外自定义行(例如链接、通知)。
# 留空以禁用。支持与上述嵌入相同的占位符。
# Markdown 链接在此处有效,例如 "[View Status Page](https://status.mythic.gg/)".
extra-lines: []
# - ""
# - "[View Status Page](https://status.mythic.gg/)"
# 心跳 / 正常运行时间监控(例如 BetterStack)
heartbeat:
enabled: false
interval: 180
url: "https://uptime.betterstack.com/api/v1/heartbeat/"
# --- 模块 ---
# 服务器重启计划器 (/plan-restart)
restart-system:
# 重启的默认原因
defaults:
planned-reason: "Server is restarting as scheduled."
unplanned-reason: "Server shutdown initiated unexpectedly."
# /plan-restart 命令的限制条件
# 时间格式示例:"10s"(秒)、"5m"(分钟)、"1h"(小时)。
constraints:
min-delay: "15s"
max-delay: "10m"
# 在最终 'restart' 命令执行前运行的命令
# 使用控制台级命令(例如 "save-all", "backup start")
pre-restart-commands:
- "save-all"
# 计划重启(自动)
scheduled-restarts:
enabled: false
# 24 小时制的时间列表 (HH:mm)。
# 时间将与服务器的 JVM 时区进行匹配(通过 -Duser.timezone 或系统默认设置设定)。
# 在大多数托管服务器上,这通常是 UTC。请相应调整您的时间。
times:
- "04:00"
# 计划重启的倒计时持续时间(例如 "10m", "5m")
# 这将使用 /plan-restart 逻辑。
restart-delay: "10m"
# 是否跳过为此计划重启发送 Discord 关闭嵌入。
skip-discord-embed: false
# 游戏中和 Discord 上显示的原因
reason: "Daily scheduled maintenance."
# 通知设置
notifications:
chat: true
action-bar: true
kick-players: true
# 广播警告的时间点(秒)
intervals:
- 120
- 60
- 30
- 10
- 5
- 4
- 3
- 2
- 1
boss-bar:
enabled: true
title: "<red><bold>Server Restarting in <time></bold></red>"
# 可用颜色:PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
color: "RED"
# 可用样式: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"
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
| 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 <time> [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. |
| (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
- Sign up at
- Create a heartbeat

- 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)

- Copy the url generated, and paste it into the heartbeat section in
config.yml
- Restart the server and you should have connected it successfully.
- 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"
评论 0
登录后参与评分
还没有评论,来抢沙发吧