管理员网络仪表盘

管理员网络仪表盘

一个强大的基于网页的Hytale服务器管理面板，通过精美的Hytale主题界面提供实时监控和管理功能。

实用

管理员网络仪表盘预览查看大图

Admin WebDash

一个功能强大的基于网页的 Hytale 服务器管理面板，通过精美的 Hytale 主题界面提供实时监控和管理功能。

特性

玩家管理

  • 实时玩家监控，显示实时状态（生命值、耐力、法力、防御值）
  • 玩家操作：踢出、封禁、切换 OP 权限、传送玩家
  • 游戏模式切换：通过可视化按钮选择创造模式和冒险模式
  • 治疗玩家：瞬间将生命值、耐力和法力恢复至最大值
  • 给予物品：可视化物品浏览器，支持搜索、图标展示和数量选择
  • 清空背包：移除玩家背包中的所有物品
  • 背包查看器：可视化物品展示，并支持悬浮提示
  • 玩家坐标和游戏模式追踪
  • 即时搜索和过滤玩家

管理工具

  • 封禁/解封玩家，可自定义封禁原因
  • 禁言系统，支持时长选项（5分钟、30分钟、1小时、1天、永久）
  • 查看被禁言玩家，显示剩余时间
  • 踢出玩家，暂时移除出服务器
  • 查看被封禁玩家列表，附带时间戳
  • 直接文件访问，可查看 bans.json 文件进行验证
  • 自动同步封禁和禁言列表

世界管理

  • 时间控制：瞬间设置时间为白天、夜晚、正午或午夜
  • 天气控制：将天气设置为晴天、雨天或暴风雨
  • 传送点系统：创建已命名的传送点，并将玩家传送到该位置
  • 传送点管理：查看、创建和删除带有坐标的传送点

服务器通讯

  • 广播消息给所有玩家
  • 实时服务器聊天监控
  • 实时消息更新

服务器统计

  • 实时 TPS 监控，带有颜色编码的性能指示器
  • 内存使用情况追踪，自动进行国际单位制转换
  • 在线玩家数量
  • 服务器运行时间显示

已安装模组

  • 自动检测已安装的插件
  • CurseForge 集成，获取丰富的模组元数据
  • 显示模组图标、作者和下载次数
  • 直接链接到 CurseForge 页面
  • 按字母顺序排列的模组列表

网页界面

  • 与官方网站匹配的 Hytale 主题设计
  • 响应式布局，支持桌面端和移动端
  • 实时连接状态，支持自动重连
  • 键盘快捷键（Ctrl+R 刷新，Ctrl+F 搜索）
  • 可视化物品浏览器，支持搜索功能

安装

标准安装

  1. 从发布页面下载 AdminWebDash-1.0.jar
  2. 将 JAR 文件放入 Hytale 服务器的 Mods 文件夹
  3. 启动或重启 Hytale 服务器
  4. 在控制台查看仪表盘 URL 和管理员令牌
  5. 通过显示的 URL 访问仪表盘（默认：http://localhost:9081）

Docker 安装

如果你在 Docker 中运行 Hytale 服务器：

  1. 放置模组至挂载的模组目录
  2. 暴露端口 9081 至你的 docker-compose.yml 中：
services:
  hytale:
    image: ghcr.io/machinastudios/hytale
    stdin_open: true
    tty: true
    ports:
      - "5520:5520/udp"
      - "9081:9081"  # Admin WebDash
    volumes:
      - ./mods:/hytale/mods
      - ./logs:/hytale/logs
      - ./universe:/hytale/universe
    environment:
      - SERVER_ACCEPT_EARLY_PLUGINS=true
      - SERVER_BIND=0.0.0.0:5520
  1. 重启容器，然后通过 http://localhost:9081 访问仪表盘

注意： 如果在配置中将 port 设为 0 以随机分配端口，Docker 无法动态映射随机端口。必须在配置文件和 docker-compose.yml 中同时使用固定端口号（如 9081）。

配置

模组会在 mods/AdminWebDash/config.json 创建配置文件：

{
  "port": 9081,
  "adminToken": "your-secure-token-here",
  "loggingEnabled": false
}

配置选项

  • port：网页仪表盘的端口号
    • 默认值：9081
    • 有效范围：1024-65535
    • 设为 0 使用随机可用端口（用于避免端口冲突）
  • adminToken：访问仪表盘所需的安全令牌（首次运行时自动生成）
  • loggingEnabled：启用/禁用自定义日志记录到 logs/dashboard.log（默认：禁用）

注意： 更改端口后，请重启服务器使更改生效。如果使用端口 0，请查看控制台输出以获取实际分配的端口。

首次设置

  1. 启动服务器后，查看控制台输出或 mods/AdminWebDash/config.json 中的管理员令牌和仪表盘 URL
  2. 打开浏览器，访问显示的 URL（默认：http://localhost:9081）
  3. 输入配置文件中的管理员令牌
  4. 准备就绪，开始管理服务器！

提示： 将仪表盘 URL 添加到书签以便快速访问。

安全

  • 所有 API 端点均受令牌身份验证保护
  • 可以在配置文件中更改自动生成的管理员令牌
  • 请妥善保管管理员令牌
  • 默认情况下，仅可从服务器所在网络访问仪表盘

日志

自定义日志会写入 logs/dashboard.log。默认禁用，可在配置中将 loggingEnabled 设为 true 来启用。

键盘快捷键

  • Ctrl/Cmd + R：刷新仪表盘数据
  • Ctrl/Cmd + F：聚焦搜索框
  • Escape：关闭弹窗

要求

  • Hytale 服务器（兼容版本）
  • Java 25 或更高版本
  • 现代网页浏览器（Chrome、Firefox、Edge、Safari）

支持

需要帮助或有疑问？

Discord 社区：https://discord.gg/YUxuTa4ZzX - 获取帮助、报告错误和讨论功能

致谢

由 Patrick Jr. 创作

CurseForge：https://www.curseforge.com/members/patrickjr/projects

许可

保留所有权利。本模组按原样提供，用于 Hytale 服务器。