文档 | MineBuff

投票奖励（Votifier）

当有人对你的列表投票时，MineBuff 可以立即通知你的 Minecraft 服务器，以便你的奖励插件可以发放物品、等级或钥匙。

在你的 Minecraft 服务器上安装 Votifier
使用经典版 Votifier 或 NuVotifier。在防火墙/主机面板中开放端口 8192（或您选择的端口），以便公共互联网可以访问。
复制您的密钥或令牌
v1: 粘贴到 plugins/Votifier/rsa/public.key（或 NuVotifier rsa/public.key）。v2: 从 NuVotifier config.yml（通常为默认）复制令牌。
在您的列表中启用它
仪表盘 → 编辑服务器 → Votifier。开启转发，设置主机（留空以使用您的 Java IP）、端口和协议，然后粘贴密钥/令牌并保存。
发送测试投票
在同一表单上使用“发送测试投票”。如果该功能有效，真实投票也会有效。

当挑战 + 令牌可用时选择 NuVotifier v2；否则回退到 v1 RSA。

经典 Votifier 和 NuVotifier RSA。需要公钥文件内容。

来自 config.yml 的 NuVotifier HMAC 令牌。如果你已经使用 NuVotifier，则快速且简单。

按列表网站过滤的奖励插件应允许服务名称“MineBuff”。如果交付失败，网站投票仍然有效 — 请检查你的防火墙和凭据。

询问“这个 IP 今天是否已经为我的服务器投票？” 免费、公开，无需 API 密钥。

这不会投票

玩家仍然在 MineBuff 投票页面投票。这些 URL 只读取今天是否已有投票（UTC）。

GET

最适合简单插件 — 整个响应是一个字符。

https://minebuff.com/api/vote/{slug}/{ip}

示例 curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"

GET

相同的答案，加上他们投票的时间以及距离每日重置还有多久。

https://minebuff.com/api/vote/{slug}/{ip}/json

字段	含义
`vote`	“1”或“0”（字符串）——今天是否投票。
`voted_at`	今天投票的时间，或为 null。
`reset_at_midnight`	始终为真 — 每日投票检查窗口在 00:00 UTC 重置（排名总数是独立的，大约每月重置一次）。
`time_until_next_vote`	如果已经投票，则距离下一个 UTC 午夜的秒数；否则为 0。

示例

{
  "vote": "1",
  "voted_at": "2026-09-12T14:32:01Z",
  "reset_at_midnight": true,
  "time_until_next_vote": 34199
}

在网址中	含义
`{slug}`	您服务器在列表 URL 中的标识（例如 /servers/your-slug）。
`{ip}`	玩家 IP 地址。我们会对其进行哈希处理；每个 IP 每个服务器每天只能投一次票（UTC 日）。

也可通过浏览器访问（CORS）。未知服务器会返回纯文本 0，或 HTTP 404 JSON 并显示错误 server_not_found。

一个简短的检查清单，以确保你的插件时间与我们的匹配。

当奖励或 API 行为异常时的常见问题。

测试投票失败或游戏内没有任何到账

确认端口 8192（或你的端口）已向互联网开放，主机匹配可访问的地址，并且密钥/令牌与插件文件完全匹配（没有额外空格）。

我应该选择哪种协议？

从自动开始。如果你只有 NuVotifier 令牌，请使用 v2。如果你只有 RSA 公钥，请使用 v1。

API 始终返回 0。

检查列表是否已发布，slug 是否完全正确，并且你传递的是玩家的真实 IP（除非玩家从同一台机器投票，否则不要使用 127.0.0.1）。

失败的 Votifier 投票会取消投票吗？

不会。MineBuff 投票仍然有效。修复连接问题后再次尝试仪表板测试投票。

我可以通过 API 投票吗？

投票在公共投票页面进行。API 仅可读，用于查看今天的投票。