指标

Hytale 的 Metrics Mod

Metrics Mod 是一款轻量级高效工具，专为希望深入了解服务器性能与运行状态的 Hytale 服务器管理员设计。无论你运行的是小型社区服务器还是大型网络，此 Mod 都能提供实时健康监测所需的工具。

---

🎮 命令与权限

该 Mod 提供了几个用于游戏内监测的命令。每个命令都需要特定的权限节点：

命令	描述	权限
/tps	查看实时性能统计、内存使用情况和世界摘要。	metrics.command.tps
/status	服务器健康状态和玩家数量的快速摘要。	metrics.command.status
/uptime	精确追踪服务器已运行的时间。	metrics.command.uptime
/list	包含玩家名称的详细玩家列表。	metrics.command.list
/metricsdebug	诊断工具，用于验证 API 健康状态并排查错误。	metrics.command.debug

---

🚀 主要特性

• 滚动平均值：自动随时间追踪性能，提供过去 1、5、10 和 15 分钟 的滚动平均值。
• 深度性能洞察：使用基于 Delta 的方法进行高精度 TPS 计算，确保与内部工具相当的准确性。
• 内存与资源追踪：实时监测 JVM 内存使用情况（已用、总计、最大）和世界指标（实体和已加载区块）。
• 网络与延迟监测：追踪平均 Tick 时间、“长 Tick”（延迟峰值）、网络连接数和流量错误。
• 内置安全 HTTP API：
  • 实时状态：通过简洁的 JSON 端点（/api/status）访问服务器状态，可轻松集成到网站、Discord 机器人或监控面板中。
  • 企业级安全：包含可配置的 速率限制、IP 黑名单/白名单 和 数据包大小验证，保护 API 免遭滥用。
  • 可配置可见性：通过简单的配置开关，精确选择暴露哪些信息（性能、玩家、世界、运行时间或服务器信息）。
• 无缝集成：自动与 Hytale 核心配置同步，报告 MOTD、服务器名称、游戏模式和游戏模式、白名单状态。
• 更新检查器：集成了 CurseForge 更新检查，确保你始终拥有最新的改进。

---

🛠️ 配置

该 Mod 可通过 mods/MetricsMod/config.json 文件进行完全自定义。你可以轻松开关 API、更改端口、设置安全阈值以及管理数据可见性。

{
  "apiPort": 8080,
  "apiEnabled": true,
  "rateLimitEnabled": true,
  "maxRequestsPerSecond": 50,
  "whitelistEnabled": false,
  "whitelistedIps": [],
  "showPerformance": true,
  "showPlayers": true,
  "showWorlds": true,
  "showUptime": true,
  "showNetwork": true,
  "updateCheckerEnabled": true
}

---

📦 快速入门

1. 将 MetricsMod.jar 放入服务器的 mods 目录。
2. 启动服务器以生成默认配置。
3. （可选）编辑 mods/MetricsMod/config.json 来自定义你的 API 设置或安全规则。
4. 尽情享受对 Hytale 世界的实时洞察力！

---

📡 API 示例

向 /api/status 发送 GET 请求即可获得全面的概述：

{
  "server_name": "我的 Hytale 服务器",
  "motd": "冒险在等待！",
  "gamemode": "ADVENTURE",
  "hytale_port": 30000,
  "whitelist_enabled": true,
  "players": {
    "online": 5,
    "max": 100,
    "list": [{"name": "Dralle", "uuid": "..."}]
  },
  "performance": {
    "tps": 30.0,
    "tps_1m": 29.95,
    "tps_5m": 29.98,
    "memory": {
      "used": 450,
      "total": 1024,
      "max": 4096,
      "percentage": 11.0
    },
  },
  "worlds": [
    {
      "name": "game_world",
      "entities": 150,
      "chunks": 400
    }
  ],
  "uptime": 3600000
}