StatusPing

插件

· 作者 shamusau

StatusPing 是一款轻量级的服务器工具,用于监控在线状态、安排自动重启,并发送 Discord 通知,以便让工作人员和玩家及时了解信息。

0 本站下载 0 关注 更新于 3 个月前

最新 3.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

为您的服务器打造的终极轻量级监控、优化和实用工具解决方案。

⚡ 概述

StatusPing 是一款现代化的实用插件,旨在让您的工作人员和玩家随时了解服务器的运行状况,同时提供提升性能的工具。无论是优化服务器配置、安排带有精美倒计时的自动重启、通过状态页服务监控正常运行时间,还是向 Discord 发送性能警报,StatusPing 都能为您处理一切。

? 主要功能

  • 预设模板: 包含内置的预设模板(例如 example-lobby),您也可以创建自己的自定义预设。
  • 详细报告: 生成文本文件,精确显示哪些设置与推荐值存在差异。
  • 安全应用: 在应用任何更改之前,会自动备份您的配置文件。
  • 安全保护: 不会保存配置文件中的某些条目,如 server_ip 等敏感信息。

? 高级重启计划

忘掉基本的停止命令吧。安排专业的重启,并支持完全自定义的倒计时。

  • 视觉倒计时: 支持 BossBars、Action Bars、Titles 和 Chat 通知。
  • 自定义理由: 告知玩家服务器重启的原因(例如,“日常维护”或“修复漏洞”)。
  • 安全性: 在实际关闭之前,会自动以自定义理由踢出玩家。
  • 计划任务: 直接在插件内安排每日重启。

? Discord 集成

无需进入游戏,即可让您的工作人员团队和玩家保持同步。

  • 实时嵌入状态面板: 在 Discord 上的简单面板中展示所有服务器状态。
  • 启动与关闭 Webhook: 当服务器开启或关闭时发送多样化的嵌入消息。(支持忽略快速重启的情况)
  • MSPT/延迟警报: 如果服务器性能下降,会自动向您的管理员频道发送警报,支持自定义阈值和持续时间检查,以防止垃圾信息刷屏。

? 心跳检测与正常运行时间

  • 外部监控: 按设定的间隔 ping 一个 URL(如 BetterStack 或 UptimeRobot),以准确跟踪您的正常运行时间百分比。
  • 游戏内图表: 在游戏内直接查看心跳成功/失败的历史可视化记录。

? 性能统计

  • 使用单个命令查看实时的 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

  1. 在 注册账号
  2. 创建一个心跳检测 Creating Heartbeat
  3. 为其命名,并保持期望的心跳间隔和宽限期的默认值。(期望的心跳间隔应与 config.yml 中的 interval 匹配) Heartbeat Intervals
  4. 复制生成的 URL,并将其粘贴到 config.yml 的心跳部分中
  5. 重启服务器,您应该已成功连接。
  6. 使用新创建的心跳检测创建一个免费的状态页面,如果您有多个服务器,可以对每个服务器执行相同的操作。

⚙️ 配置

该插件高度可配置。您可以切换每个功能,使用 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"

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源