StatusBot / PlayerCounter /

StatusBot / PlayerCounter /

StatusBot 是一个 Hytale 服务器插件，可将您的服务器连接到 Discord，并动态更新机器人的状态，显示当前玩家数量

实用

StatusBot Hytale Discord 插件

适用于 Hytale 的 Discord 状态与服务器信息机器人

StatusBot 是一个 Hytale 服务器插件，可直接将你的服务器连接到 Discord。
它会自动更新机器人的状态，显示实时在线玩家数量，并提供美观的 /status 斜杠命令，以富文本嵌入形式显示详细的服务器信息。

设计时考虑了 稳定性、可定制性 和 速率限制安全性。

如需支持、功能建议或投诉，请加入我们的 Discord：https://discord.gg/f3WsEF6UNE

想看看机器人如何实时工作？
加入我们的 Discord：https://discord.gg/f3WsEF6UNE

如果你只想使用仅显示机器人状态的简化版本，请下载最早的版本。

✨ 功能 ✨

  • ✅ 实时 Discord 状态更新
  • ✅ /status 斜杠命令，带富文本嵌入
  • ✅ 在线玩家数量追踪（感知加入/离开）
  • ✅ 服务器运行时间追踪
  • ✅ 完全可配置的嵌入（颜色、文字、Logo、页脚）
  • ✅ 轮换的 Discord 活动消息
  • ✅ 安全的 Discord 速率限制处理
  • ✅ 兼容 Java 21（可在 Java 21-25 上运行）

🤖 创建 Discord 机器人 🤖

前往 Discord 开发者门户

https://discord.com/developers/applications

点击“New Application”并为其命名。

打开应用程序 → Bot 选项卡

点击“Add Bot”

选择一个头像和名称

复制 Bot Token（请保密！）

启用 Presence Intent、MESSAGE CONTENT INTENT 和 Server member intent

进入“OAuth2”

启用“Bot and administrator”

滚动到底部，复制链接并在浏览器中粘贴，以将其邀请到你的服务器。

⚠️⚠️ 不要分享你的 Bot Token。⚠️⚠️ 任何拥有此令牌的人都可以完全控制你的机器人。

安装 "StatusBotByBanan.jar" 并将其放入你的 mods 文件夹中

将在同一文件夹中生成一个新的配置文件，你可以在其中更改以下内容：

StatusBot 配置指南

现在 statusbot 文件夹中有一个 Statusbotdata.json 文件

仅当 persistent embed 设置为 true 且提供了 channelID 时，才会生成此文件。

已添加语言支持，可将语言更改为：en, es 或 fr

🔐 Discord 设置

  • 🔑 discordToken
    来自 Discord 开发者门户的 Discord Bot Token
    ❗ 必需 — 没有此项机器人将无法启动

🖥️ 服务器信息

  • 🏷️ serverName — 显示为嵌入标题的名称
  • 🌍 serverIp — 显示在 /status 和轮换消息中
  • 👥 maxPlayers — 嵌入中显示的最大玩家数量

🎮 Discord 机器人状态（在线状态）

  • 🟢 statusMessage — 默认机器人状态消息
  • 🔁 rotateStatuses — 启用轮换状态消息 (true / false)
  • 📝 statusMessages — 轮换消息列表
  • ⏱ updateIntervalSeconds — 状态更新的频率
    • ⚠️ 最小值：30 秒（速率限制安全）

🔤 可用占位符：

  • {online} → 当前在线玩家数
  • {ip} → 配置文件中的服务器 IP

🎨 嵌入外观

  • 🟩 embedColorOnline — 服务器在线时的嵌入颜色
  • 🟧 embedColorOffline — 服务器启动/离线时的嵌入颜色
    • 必须是 HEX 颜色（示例：#2ecc71）
  • 🧾 embedFooter — 嵌入底部显示的文本

🖼️ 嵌入图片 / Logo

  • embedThumbnailUrl — 小 Logo（右上角）
  • embedImageUrl — 大型横幅图片（可选）

⚠️ 图片 URL 规则（非常重要）：

  • 必须以 https:// 开头
  • 必须以 .png、.jpg、.jpeg、.webp 或 .gif 结尾
  • 必须是 直接的图片链接

✅ 示例：

https://i.imgur.com/PLLLb9m.png

❌ 无效（会破坏 /status）：

https://imgur.com/PLLLb9m https://imgur.com/a/xxxx

🚨 如果无效，StatusBot 会在控制台打印警告并安全地跳过该图片。

🧩 可选嵌入字段

  • ⏱ showUptime — 显示服务器运行时间
  • 📡 showProtocol — 显示协议版本
  • 📝 showMotd — 显示 MOTD 文本
  • 🔢 protocolVersion — 手动协议值
  • 💬 motd — 嵌入中显示的本日消息

⏳ 运行时间说明

  • 显示服务器已运行了多长时间
  • 示例：
    • 5m
    • 2h 15m
    • 1d 4h 20m
  • 帮助玩家了解服务器稳定性。

📌 持久状态嵌入（可选）

（如果启用）

  • 📍 机器人在一个频道中发布一个嵌入
  • 🔄 嵌入会自动更新
  • 🚫 无刷屏
  • 📢 非常适合 #server-status 频道

即将到来的更新：

  • 移除 /status 命令，仅保留持久嵌入（使用 /status 构建的版本仍可用，但不再支持）
  • 启动状态
  • 更多游戏集成/聊天转 Discord