JHS-Votifier

JHS-Votifier

一个现代、安全的Votifier插件，适用于Hytale，支持V1（RSA）、V2（HMAC）和HTTP投票，具备自动奖励、投票提醒、GUI菜单和服务器列表兼容性。

杂项

JHS-Votifier预览查看大图

JHS-Votifier

JHS-Votifier 是一款针对 Hytale 设计的现代化、安全、网络就绪的 Votifier 插件，允许投票网站通知您的服务器玩家已投票——自动奖励玩家并提升参与度。

专为 Hytale 构建，JHS-Votifier 支持多种投票协议、中心节点到后端节点转发（TCP 与轮询）、完整本地化、原生 UI 弹窗、高级奖励系统，以及与服务器列表网站的无缝兼容性。

快速入门： https://joinhytaleservers.com/how-to-install-votifier-for-hytale

🚀 更新内容 (1.3.2 – 2026-02-24)

🔁 基于轮询的投票转发（适用于 Docker / Pterodactyl）

一种专为容器环境设计的、基于拉取模式的 TCP 转发替代方案。

为何重要： 后端节点仅发起出站 HTTP 请求——无需入站端口，无需处理 Docker IP 问题。

✔ 工作原理

  • 中心节点运行一个内嵌的 HTTP 服务器（无需 WebServer 依赖）
  • 后端节点轮询中心节点以获取排队的投票
  • 成功处理后，投票即被认领
  • 持久化队列在重启后依然存在
  • 后端侧具备重复投票保护

🔐 内置安全机制

  • 每个后端节点的身份验证令牌
  • 恒定时间令牌比较
  • IP 速率限制（60 请求/分钟）
  • 4KB 请求体限制
  • 可配置的投票存活时间
  • 可配置的队列限制
  • 清理间隔
  • 详细的中枢和客户端日志记录
  • 在 /votifieradmin status 中显示状态可见性

📁 新增配置文件

  • forward_poll_hub.json
  • forward_poll_client.json

🆚 何时使用轮询 vs TCP

使用场景 推荐方法
Docker / Pterodactyl ✅ 轮询转发
静态 IP 网络 ✅ TCP 转发
混合设置 两者可同时运行

轮询转发默认禁用。

✨ 核心功能

🔌 多协议投票接收

  • Votifier V1 (RSA)
  • Votifier V2 (HMAC 令牌)
  • HTTP POST 端点（可选 WebServer）
  • 从投票网站拉取投票 (1.3.1+)
  • 中心节点 → 后端节点转发 (TCP + 轮询)

🎁 高级奖励系统

  • 基于命令的奖励
  • 加权随机奖励
  • 可选的“无奖励”随机结果
  • 投票聚会里程碑
  • 投票连胜里程碑
  • 离线投票存储 + /claimvotes
  • 投票排行榜追踪

JHS-Votifier 投票公告

💬 消息与 UI

  • 全局投票广播
  • 私人感谢消息
  • 定时投票提醒
  • 原生弹窗通知
  • 完全可本地化的消息系统（约90个键）
  • TaleMessage 渐变 + 可点击格式化

JHS-Votifier 投票消息

🖥 原生弹窗通知

  • 使用 Hytale 内置的弹窗系统
  • 按通知类型切换聊天和弹窗
  • 样式：成功、警告、危险、默认
  • 完全可配置的标题和描述

弹窗示例 1 弹窗示例 2

🌍 完整本地化系统

  • messages.json 使用点号标记键
  • 支持 TaleMessage 格式化
  • 占位符支持 (%player%、%service% 等)
  • 更新时安全地自动合并新键
  • 升级期间不会丢失翻译

🏗 网络支持（中心节点与后端节点）

TCP 转发 (1.3.0+)

  • 异步投票转发至多个目标
  • 每个后端节点的 HMAC-SHA256 身份验证
  • 指数退避重试
  • /forwardtest 诊断命令
  • 适用于静态容器 IP

轮询转发 (1.3.2+)

  • 后端节点通过 HTTP 轮询中心节点
  • 无需后端入站端口
  • 适用于 Docker 和 Pterodactyl
  • 持久化投票队列
  • 内置速率限制和验证

📦 安装

  1. 下载最新的 JHS-Votifier JAR 文件
  2. 将其放入服务器的 mods/ 目录
  3. 启动服务器一次以生成配置文件
  4. 配置您选择的协议
  5. 重启或运行 /votifieradmin reload

🧾 命令

命令 描述
/vote 打开投票菜单
/claimvotes 领取离线投票奖励
/voteleaderboard 查看投票排行榜
/voteleaderboardadmin 管理投票排行榜
/voteparty 投票聚会工具
/testvote <player> 触发测试投票
/forwardtest 测试 TCP 转发
/votifieradmin status 查看协议和转发状态
/votifieradmin reload 重新加载配置

🔐 安全

  • RSA 加密 (V1)
  • HMAC 身份验证 (V2)
  • 专用 HTTP 令牌
  • 每个服务的令牌
  • 重放攻击防护
  • 时间戳验证（自动检测秒和毫秒）
  • 请求大小限制
  • 扫描器限流
  • 安全的 JSON 响应处理
  • 测试投票与奖励和转发隔离

🧱 依赖项

开箱即用。

内置： TaleMessage 可选： Nitrado WebServer（仅 HTTP 端点）

🧪 故障排除

  • 确认已启用正确的协议
  • 检查 /votifieradmin status
  • 为 TCP 网络使用 /forwardtest
  • 在配置中启用调试以获取详细日志
  • 更改协议配置后需要重启

🆘 支持

Discord： https://discord.gg/KPzSCm83Km

快速入门指南： https://joinhytaleservers.com/how-to-install-votifier-for-hytale

📜 许可证

MIT 许可证