HitaleStats GG

HytaleStats 插件

一个轻量级的服务端统计数据收集插件，适用于 Hytale 服务器。

HytaleStats 会自动追踪 Hytale 服务器上的玩家活动和战斗数据，并将其上报至 https://hytalestats.gg 平台，玩家可在此查看排行榜、个人资料和详细统计信息。

---

功能特性

自动数据收集

该插件会被动收集游戏事件，不会影响服务器性能。
三个内置收集器分别处理不同类别的游戏事件：

• 战斗收集器
  追踪 PvP 击杀、PvE 击杀、死亡以及造成的/受到的伤害。
  每个事件包含武器信息、实体类型和位置数据。

• 会话收集器
  记录玩家登录、登出和累计游戏时长。
  游戏时长按可配置的时间间隔进行追踪（默认：60 秒）。

• 进度收集器
  捕获等级提升和成就解锁事件，包含所达到的具体成就或等级。

所有收集器可在配置中单独启用或禁用。

---

自动注册

首次启动时，如果未配置服务器凭证，插件会自动使用配置中的服务器名称和联系邮箱向 HytaleStats 后端注册。

返回的令牌和密钥将保存到 config.yml 中 —— 无需手动设置 API 密钥。

---

玩家隐私

• 玩家可随时使用 /hytalestats optout 选择退出数据收集。
• 已选择退出的玩家将被排除在所有事件追踪之外。
• 玩家可使用 /hytalestats optin 重新选择加入。
• IP 地址默认已匿名化处理（可配置）。

---

命令

命令	描述
/hs status	显示插件状态、连接状态和队列大小
/hs optout	选择退出统计数据追踪
/hs optin	重新选择加入统计数据追踪
/hs help	显示可用命令

---

配置

插件在首次运行时，会生成带合理默认设置的 config.yml 文件。

api:
  endpoint: "https://hytalestats.gg/api/v1"
  server_name: "我的 Hytale 服务器"
  contact_email: "admin@example.com"
  server_token: ""   # 首次启动时自动生成
  server_secret: ""  # 首次启动时自动生成

batching:
  batch_size: 100
  flush_interval: 30 # 秒

collectors:
  combat:
    enabled: true
  session:
    enabled: true
  progression:
    enabled: true
  blocks:
    enabled: false # 高数据量，仅限选择加入

privacy:
  respect_optout: true
  anonymize_ips: true

debug:
  verbose: false
  dry_run: false # 设为 true 时，事件被收集但不上报

安装

1. 从 https://hytalestats.gg/about 下载 hytalestats-1.0.1.jar
2. 将 JAR 文件放入服务器的 plugins/ 目录
3. 启动服务器 —— 插件将生成 config.yml 并自动注册
4. 编辑 config.yml 设置您的服务器名称和联系邮箱
5. 重启服务器 —— 数据收集将立即开始