投票奖励设置指南

了解如何为在 Hylist 上为您的服务器投票的玩家设置游戏内奖励。

什么是 Votifier2？

Votifier2 是一种协议，允许像 Hylist 这样的服务器列表网站直接向您的游戏服务器发送投票通知。当玩家为您的服务器投票时，Hylist 会向您的服务器发送安全消息，然后服务器可以自动奖励玩家。

要求

  • 在您的服务器上安装兼容 Votifier2 的插件
  • 为 Votifier 监听器开放的端口（默认：8192）
  • 用于向投票者发放物品/特权的奖励插件（可选但推荐）

步骤 1：安装 Votifier2 插件

首先，您需要在 Hytale 服务器上安装兼容 Votifier2 的插件。我们推荐：

下载 Hytale Votifier

按照插件的安装说明将其添加到您的服务器。

步骤 2：在 Hylist 中启用游戏内奖励

在您的 Hylist 仪表板中启用游戏内奖励以获取您的 Votifier 令牌。

  1. 在 Hylist 仪表板中转到您服务器的编辑页面
  2. 将「启用游戏内奖励」切换为开启
  3. 设置 Votifier 端口（默认：8192）
  4. 保存您的更改
  5. 复制您的 Votifier 令牌以供下一步使用

步骤 3：配置插件

将 Hylist 的 Votifier 令牌粘贴到插件的配置文件中。

示例配置（config.json）：

{
  "BindHost": "0.0.0.0",
  "BindPort": 8192,
  "DisableV1Protocol": false,
  "RewardCommands": [
    "gm adventure %player%"
  ],
  "RewardMessages": [
    "<gray>Thanks for your vote on <gold>%from%</gold>!"
  ],
  "Tokens": {
    "Hylist.io": "<YOUR_TOKEN_FROM_HYLIST>"
  }
}

可选：投票命令配置（voteCommand.json）：

{
  "Enabled": true,
  "OpenCustomGui": true,
  "SendChatMessage": true,
  "ChatMessageHeader": [
    "<gold><b>Vote for our server!</b></gold>"
  ],
  "ChatMessageTemplate": "<yellow><click:%link%>%name% (Click)</click></yellow>",
  "VoteLinks": {
    "Hylist.io": "https://hylist.io/vote/<YOUR_SERVER_SLUG>"
  }
}

将 <YOUR_SERVER_SLUG> 替换为您服务器的 slug（例如「my-awesome-server」）。您可以在 Hylist 上您服务器的 URL 中找到它。

提示：预填用户名以获得更好的用户体验

您可以在投票 URL 中添加 ?username=玩家名 以自动填写玩家的用户名：

https://hylist.io/vote/your-server?username=PlayerName

注意：这需要自定义插件支持，因为大多数插件默认不支持此功能。

步骤 4：开放端口

确保 Votifier 端口已开放并可从互联网访问。

确保端口在服务器防火墙中已开放。如果您使用托管服务商，可能需要配置端口转发。

测试您的设置

要验证一切正常运行：

  1. 确保您的服务器在线且 Votifier 插件正在运行
  2. 在 Hylist 上为您的服务器投票并输入您的游戏内用户名
  3. 检查服务器控制台是否有投票通知
  4. 验证您是否在游戏中收到了配置的奖励

安全提示

切勿公开分享您的 Votifier 令牌！任何拥有您令牌的人都可以向您的服务器发送虚假投票通知。

  • 保持您的 Votifier 令牌私密且安全
  • 如果您怀疑令牌已泄露，请立即重新生成
  • 如果可能，只向受信任的 IP 地址开放 Votifier 端口

故障排除

没有收到投票？

  • 验证端口已开放且可从互联网访问
  • 检查您服务器的 IP 地址在 Hylist 中是否正确
  • 确保 Votifier 插件正在运行（检查服务器日志）
  • 验证令牌完全匹配（没有多余空格）

收到投票但没有奖励？

  • 确保玩家在处理投票时在线
  • 检查用户名拼写是否正确（区分大小写！）
  • 验证您的奖励插件配置是否正确

重要：用户名区分大小写

玩家必须完全按照游戏中显示的方式输入用户名，包括正确的大小写。例如，「Player123」和「player123」被视为不同的用户。

Best Practices for Voting Rewards

Setting up voting rewards is just the first step. To maximize the impact on your server's ranking and player retention, follow these proven strategies that top-ranked Hytale servers use.

Choose Meaningful Rewards

Give rewards that players actually want but can't easily get otherwise. Exclusive cosmetics, bonus currency, or temporary boosters work better than common items. The goal is to make voting feel rewarding without making it mandatory for progression.

Create Vote Streaks

Consider implementing escalating rewards for consecutive daily votes. For example, voting 7 days in a row could unlock a special reward. This encourages habitual voting and dramatically increases your monthly vote count.

Announce Rewards In-Game

When a player receives a vote reward, broadcast it to the server. A message like "[Player] voted and received 500 coins!" reminds other players that voting rewards exist and encourages them to vote too.

Use Discord Reminders

Set up the Hylist Discord bot to post your server's vote link in a dedicated channel. Players who see a daily reminder are significantly more likely to vote consistently. You can also pin your vote link for easy access.

Frequently Asked Questions

What happens if my server is offline when a player votes?
The vote is still counted toward your server's ranking. However, the Votifier2 notification cannot be delivered while your server is offline, so the player won't receive their in-game reward immediately. Most Votifier2 plugins queue missed notifications and deliver them when the server comes back online, but this depends on your plugin's configuration.
Can I give different rewards to different players?
Yes, through your rewards plugin configuration. Most plugins support permission-based rewards, where players with certain ranks or groups receive different rewards. You can configure your voteCommand.json to run different commands based on player permissions or implement rank-based reward tiers.
Is Votifier2 compatible with proxy networks (BungeeCord/Velocity)?
Yes. Install the Votifier2 plugin on your proxy server (BungeeCord or Velocity) and configure it to forward vote notifications to backend servers. The vote port should be opened on the proxy machine. Most reward plugins support receiving forwarded votes from the proxy.
How do I test if voting rewards are working?
After setting up Votifier2 and enabling rewards in your Hylist dashboard, simply vote for your own server. Join your game server and check if you receive the configured reward. If the reward doesn't arrive, check your server console for Votifier2 connection logs and ensure the port is open and the token matches.
返回我的服务器