如何接入 NuVotifier 并设置投票奖励

· MinecraftRating 管理团队

NuVotifier 接收投票事件,VotingPlugin 等处理插件执行奖励。只安装接收器不会自动发放物品。我们在自己的 Paper 上验证了网站 → 接收器 → 奖励插件 → scoreboard 命令的完整流程。

官方资源

请使用 NuVotifier 发布页、安装指南、VotingPlugin、奖励文档 和 Paper 文档。选择兼容的稳定版本。我们测试使用的 CI 构建不代表生产推荐。

安装与绑定

停止 Minecraft,将两个 JAR 放进 plugins,启动后确认插件均已启用。单服务器配置示例:

host: 0.0.0.0
port: 8192
disable-v1-protocol: false
forwarding:
  method: none

MinecraftRating 当前发送 v1。防火墙和主机面板须允许选定 TCP 端口,尽量限制为监控来源;不要因此开放 RCON。代理网络的 forwarding 需按官方说明另行配置。在“我的服务器”通过 MOTD 验证所有权,再到 Votifier 集成中保存公网地址、端口和 plugins/Votifier/rsa/public.key。绝不能上传 private.key,也不能用 localhost 或容器内部地址代替公网地址。

设置奖励

在 VoteSites.yml 中启用站点,将 ServiceSite 设为 MinecraftRating.com,填写投票网址,并设置例如 DIAMOND 的 DisplayItem。奖励命令示例:

Rewards:
  Commands:
  - 'give %player% minecraft:diamond 1'

该命令需要玩家在线。离线玩家请按 VotingPlugin 文档配置延迟奖励;ForceOffline 允许离线执行命令,却不会让 give 支持离线背包。UUID 模式须与服务器一致。网站按莫斯科日期限制每个账户对每台服务器每天一票,每票计入排名两个自然月;额外冷却规则要单独核对。

验证

先从集成发送测试,再用正确游戏昵称投票。核对 NuVotifier 日志、处理插件及实际命令结果。我们的测试在独立 dummy 目标上使用 scoreboard players add %player% mcr_votes 1,并明确允许离线执行;重复请求没有额外加分。物品、经济与权限插件仍需检查各自命令。

FAQ

v1 的 SENT 只说明发出了数据,不说明解密或奖励执行成功。错误公钥测试中 SENT 出现但 scoreboard 没变化。请检查当前公钥、ServiceSite、昵称、处理插件及离线规则。

连接失败。检查公网地址、端口、Docker 映射和防火墙。关闭端口会触发有限重试,恢复正确端点后奖励再次执行。本地插件测试不能代替网站到服务器的网络测试。

不是。测试容器的 /tmp 带有 noexec,导致 SQLite native 库无法加载。我们使用单独目录及 -Djava.io.tmpdir=/data/cache/native,并设置 JNA/Netty 目录。按自己的路径和权限调整,不要全局关闭系统保护。

当前网站集成需要 v1 兼容模式。v2 支持是独立开发任务。

所有文章