SimpleVotifier (现代投票和奖励插件，附带排行榜)

SimpleVotifier (现代投票和奖励插件，附带排行榜)

SimpleVotifier 是一款现代且灵活的投票插件，兼容任何投票网站。完全可配置和可扩展，它使得奖励玩家和管理排行榜变得简单、快速且毫不费力。

实用

SimpleVotifier (现代投票和奖励插件，附带排行榜)预览查看大图

SimpleVotifier – 适用于 Hytale 的现代投票插件（Votifier）

SimpleVotifier 是一款专为 Hytale 服务器设计的现代、轻量且功能强大的投票插件。它允许任何投票网站在玩家投票时安全地通知你的服务器，并通过可配置的奖励和实时排行榜即时奖励玩家，提升参与度。

SimpleVotifier 以简洁和灵活性为设计理念，完全可配置、高度可扩展，并且即使对于新手来说也极其易于设置。无论你想要一个简单的投票通知系统，还是一个完整的奖励和排行榜解决方案，SimpleVotifier 都能完美适配你的服务器需求。

🌐 官方 Top-Games 支持

SimpleVotifier 得到了 Top-Games 的官方支持，确保了与该平台的最大兼容性和可靠性。

✨ 主要特性

  • ✅ 兼容任何投票网站
  • 🔐 通过带 HMAC 认证的 HTTP 实现安全投票处理
  • 🎁 内置且完全可配置的奖励系统
  • 📊 实时排行榜（HTML 或 JSON 格式）
  • 🌍 多语言支持
  • 🔌 基于事件的 API，用于自定义扩展
  • ⚡ 轻量、快速、开箱即用

🔧 依赖与网络设计

SimpleVotifier 依赖于官方的 Hytale WebServer 插件：

为何重要

  • 使用 HTTP 协议
  • 在 与 WebServer 插件相同的端口 上运行
  • 🚫 无需额外端口
  • 非常适合共享主机和简单的服务器设置

这种设计使得 SimpleVotifier 极其易于部署，并避免了复杂的防火墙或网络配置。

 

📦 安装

  1. 从 GitHub Releases 下载最新的 SimpleVotifier.jar。
  2. 将 JAR 文件放入服务器的 mods/ 目录。
  3. 如果尚未安装官方的 WebServer 插件，请安装它。
  4. 启动一次服务器以生成默认配置文件。
  5. 停止服务器并编辑配置。
  6. 重启服务器 —— 你的投票系统已就绪！

 

⚙️ 配置

首次启动后，配置文件将创建于：

mods/SimpleVotifier/config.json

基本配置示例

{
  "language": "en",
  "token": "YOUR_SECURE_TOKEN",
  "broadcastVotes": true,
  "logVotes": true,
  "voteSites": [
    {
      "service": "Top-Games",
      "url": "https://top-games.net/hytale/my-server"
    },
    ... 任何其他服务器列表
  ]
}

高级配置示例

{
  "language": "en",
  "token": "YOUR_SECURE_TOKEN",
  "allowedIps": [],
  "logVotes": true,
  "broadcastVotes": true,
  "rewards": {
    "enabled": true,
    "monthlyReset": true,
    "everyVoteCommands": [
      "give {player} Plant_Crop_Carrot_Item"
    ],
    "tiers": [
      {
        "votesRequired": 10,
        "commands": [
          "give {player} Container_Bucket"
        ]
      },
      {
        "votesRequired": 50,
        "commands": [
          "give {player} Armor_Iron_Head"
        ]
      },
      {
        "votesRequired": 100,
        "commands": [
          "give {player} Rock_Gem_Diamond"
        ]
      }
    ]
  },
  "leaderboard": {
    "enabled": true,
    "format": "html",
    "showVoteSites": true,
    "limit": 100
  },
  "voteSites": [
    {
      "service": "Top-Games",
      "url": "https://top-games.net/hytale"
    },
    {
      "service": "Top-Serveurs",
      "url": "https://top-serveurs.net/hytale"
    }
  ]
}

 

主要配置选项

  • 🌍 语言： 选择插件语言
  • 🔑 令牌： 用于 HMAC 投票认证的安全令牌（自动生成）
  • 📢 广播投票： 向所有在线玩家宣布投票
  • 🧾 记录投票： 在控制台记录收到的投票
  • 🔗 投票网站： 添加无限数量的投票平台

所有内容都设计得简洁、易读且易于自定义。

配置选项

主要设置

  • language (字符串)：语言代码 - en, fr, es, de, it, pt, ru, uk, zh, ja
  • token (字符串)：用于 HMAC 认证的安全令牌（自动生成）
  • allowedIps (数组)：IP 白名单（为空则允许所有）
  • logVotes (布尔值)：记录投票到控制台
  • broadcastVotes (布尔值)：向所有玩家广播投票
  • voteSites (数组)：包含 service（名称）和 url（链接）的投票网站列表

奖励系统

  • rewards.enabled (布尔值)：启用/禁用奖励系统
  • rewards.monthlyReset (布尔值)：每月第一天重置投票计数
  • rewards.everyVoteCommands (数组)：每次投票时执行的命令
  • rewards.tiers (数组)：投票里程碑奖励

排行榜

  • leaderboard.enabled (布尔值)：启用/禁用排行榜端点（默认：false）
  • leaderboard.format (字符串)：排行榜的输出格式 - html 或 json（默认：html）
  • leaderboard.showVoteSites (布尔值)：显示/隐藏排行榜上的投票网站部分（默认：true）
  • leaderboard.limit (整数)：要显示的最大投票者数量（默认：10，最大：10000）

占位符：

  • {player} - 替换为投票者的用户名

🎮 玩家命令

/rewards

领取待处理的投票奖励。

用法： /rewards

输出：

  • 显示已领取的奖励数量
  • 执行所有待处理的奖励命令

/vote

列出配置文件中配置的可用的投票网站。

用法： /vote

输出：

  • 显示所有已配置的投票网站及其 URL

/voteinfo

查看你的投票统计和等级进度。

用法： /voteinfo

输出：

  • 总投票次数
  • 待处理奖励数量
  • 等级进度及状态（已达成/未达成）

🌍 支持的语言

代码 语言 代码 语言
en 英语 pt 葡萄牙语
fr 法语 ru 俄语
es 西班牙语 uk 乌克兰语
de 德语 zh 中文
it 意大利语 ja 日语

修改 config.json 中的 language 设置即可切换语言。

🎁 奖励系统（可选）

启用内置奖励系统，为投票的玩家自动发放奖励：

  • 在每次投票时执行命令
  • 创建投票等级（10 票、50 票、100 票等）
  • 通过待处理奖励支持离线玩家
  • 为竞技性服务器提供可选的每月重置功能

如果你更倾向于通过自己的插件使用事件 API 来处理奖励，可以完全禁用奖励系统。

🏆 排行榜

此 Votifier 插件包含一个 HTTP 排行榜端点：

  • 📄 HTML 或 JSON 输出
  • 🎨 可自定义的 HTML 模板
  • 📈 支持大型排行榜
  • 🌐 非常适合网站集成

demo

排行榜有助于激励玩家并增加重复投票率。

💡 为什么选择 SimpleVotifier？

  • ⚡ 极其易于安装和配置
  • 🔧 完全可配置和可扩展
  • 🌐 适用于任何投票网站
  • 🔒 设计安全
  • 🧩 由拥有超过 10 年经验的游戏服务器列表网站 Top-Games 官方支持

SimpleVotifier 是服务器所有者的完美解决方案，他们希望获得一个简单、可靠且现代的投票系统，而无需不必要的复杂性。

💬 支持

需要帮助或有疑问？