VoteMe

插件

· 作者 herza.ori_

一个无需额外端口即可使用的投票奖励插件。本插件通过调用投票系统网站的 API 实现功能,因此不需要占用第二个端口,设置简单且非常实用。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.2 · 1.21.11 · Bukkit / Paper

一键开服(送7天)
 __   __    _       _       __  __      
 \ \ / /__ | |_ ___| |\/|  |  \/  | ___
  \ V / _ \| __/ _ \ |\/| | |\/| |/ _ \
   \_/ \___/\__\___/_|  |_||_|  |_|\___/

让每一次投票都变成奖励。无需端口转发,无需守护进程,只需一个简洁的 API。


VoteMe 是什么?

VoteMe 是一个轻量级的、纯基于 API 的 Java 版服务器投票插件。玩家打开一个整洁的箱子 GUI,点击网站链接,奖励就会直接送到他们的物品栏中——无需端口转发,无需外部监听器,也无需守护进程。

它开箱即用支持两个最大的 Minecraft 服务器列表网站,并且每一个行为细节——音效、消息、奖励、GUI 标题、投票派对阈值——都可以精确配置到最后一个字符。


功能概览

  /vote                    打开一个 27 格的箱子 GUI
  /vote list               在聊天中列出所有投票网站链接
  Join Reminder            告知玩家还有多少投票奖励未领取
  Dual API Support         同时支持 Minecraft Pocket Servers 和 Minecraft-MP,可单独或同时启用
  Fully Async              零主线程影响——所有 API 调用均为非阻塞
  Reward System            任何控制台命令均可作为奖励(物品、货币、权限)
  Vote Party               当投票达到里程碑时触发全服奖励事件
  Sound Feedback           每次投票结果都会播放村民 + 经验球的音效
  PlaceholderAPI           提供 4 个即插即用的记分板占位符
  Hot Reload               /votereload —— 配置文件更改后无需重启即可生效

依赖要求

要求项 版本 备注
Java 21+
Paper 或 Spigot 1.21.1 同样兼容 Purpur、Pufferfish 及其他分支
PlaceholderAPI 任意版本 可选——用于解锁 %voteme_*% 占位符

安装步骤

第 1 步。 将 VoteMe.jar 放入你的 /plugins 文件夹。

第 2 步。 启动一次服务器以在 plugins/VoteMe/config.yml 生成配置文件。

第 3 步。 打开配置文件,填入你的 API 密钥和服务器页面 URL。

第 4 步。 在游戏中或从控制台运行 /votereload。完成。


配置说明

# ╔══════════════════════════════════════════════════════════╗
#   VoteMe Configuration — by Herza
# ╚══════════════════════════════════════════════════════════╝

# ── Vote Sites ─────────────────────────────────────────────
# 将 api-key 设置为 "" 以禁用该网站。
# 你可以只运行一个网站,也可以同时运行两个。

minecraft-pocket:
  api-key: ""
  name: "Minecraft Pocket Servers"
  url: "https://minecraftpocket-servers.com/server/YOUR_ID"

minecraft-mp:
  api-key: ""
  name: "Minecraft-MP"
  url: "https://minecraft-mp.com/server/YOUR_ID"

# ── Join Reminder ──────────────────────────────────────────
# 当玩家加入时,VoteMe 会检查所有已启用的网站。
# 如果存在未领取的投票,玩家会收到一条私聊消息。
# 设置为 false 以禁用此功能。
join-reminder: true

# ── Rewards ────────────────────────────────────────────────
# 玩家领取投票奖励时执行的控制台命令。
# 变量:{player}
rewards:
  - "give {player} diamond 1"
  - "eco give {player} 500"

# ── Messages ───────────────────────────────────────────────
# 支持 & 颜色代码。变量:{player}, {link}
# 将任意值设置为 "" 以禁用该消息。
messages:
  success:         "&a[Vote] &fThank you for voting, &e{player}&f! Rewards sent."
  already-claimed: "&e[Vote] &fYou already claimed your reward today."
  not-voted:       "&c[Vote] &fYou haven't voted yet. Head to: &e{link}"
  error:           "&c[Vote] &fCould not reach the voting API. Try again later."

# ── Broadcast ──────────────────────────────────────────────
# 当有人领取投票奖励时,发送给所有在线玩家的消息。
# 变量:{player}, {link}。设置为 [] 以完全禁用。
broadcast:
  - "&6[Vote] &e{player} &fjust claimed their vote rewards! Vote at &e{link}&f."

# ── Vote Party ─────────────────────────────────────────────
# 每当总投票数达到此数字的倍数时触发。
# 设置为 0 以完全禁用投票派对。
vote-party: 50

# 派对触发时为每个在线玩家执行的控制台命令。
# 变量:{player}
vote-party-rewards:
  - "give {player} diamond 5"

# ── GUI ────────────────────────────────────────────────────
gui:
  title: "&8» &6&lVoteMe &8«"

# ╔══════════════════════════════════════════════════════════╗
#   PlaceholderAPI — requires PlaceholderAPI plugin
#
#   %voteme_total_votes%     历史记录中的总投票数
#   %voteme_party_progress%  当前派对周期内的投票进度
#   %voteme_party_target%    触发派对的目標数值(若关闭则为 N/A)
#   %voteme_party_needed%    距离下一次派对所需的剩余票数(若关闭则为 N/A)
#
#   Scoreboard examples:
#     "&fTotal Votes  &e%voteme_total_votes%"
#     "&fParty  &e%voteme_party_progress%&7/&6%voteme_party_target%"
#     "&fNext Party In  &e%voteme_party_needed% &fvotes"
# ╚══════════════════════════════════════════════════════════╝

如何获取 API 密钥

Minecraft Pocket Servers —— 登录 minecraftpocket-servers.com 的管理面板,打开你的服务器设置,并从投票部分复制 API 密钥。

Minecraft-MP —— 登录 minecraft-mp.com,进入你的服务器面板,在投票/API 选项卡下找到 API 密钥。


命令

命令 功能 权限节点
/vote 打开投票箱子 GUI voteme.vote
/vote list 在聊天中列出所有投票网站的名称和链接 voteme.vote
/votereload 无需重启服务器即可重载配置 voteme.admin

权限

节点 默认值 描述
voteme.vote 所有玩家 可访问 /vote 和 /vote list
voteme.admin 仅限 OP 可访问 /votereload

PlaceholderAPI

安装 PlaceholderAPI,VoteMe 会在启动时自动注册其扩展——无需额外命令。

占位符 返回值
%voteme_total_votes% 插件记录的历史总投票数
%voteme_party_progress% 当前派对周期内已计数的票数
%voteme_party_target% 触发派对的票数目标(若禁用则显示 N/A)
%voteme_party_needed% 距离下一次派对还需要的剩余票数(若禁用则显示 N/A)

可与任何支持 PlaceholderAPI 的记分板插件配合使用——例如 CMI、FeatherBoard、AnimatedScoreboard 等。

&f总投票数  &e%voteme_total_votes%
&f派对进度  &e%voteme_party_progress%&7/&6%voteme_party_target%
&f下次派对  &e%voteme_party_needed% &f票

Vote API 工作原理

VoteMe 直接与各站点的 HTTP API 通信。无需监听端口,无需 Webhook 服务器,也无需配置防火墙规则。

Minecraft Pocket Servers —— 两步流程

步骤 1  GET /api/?object=votes&element=claim&key=KEY&username=PLAYER
        响应: "1" = 未领取  |  "2" = 已领取  |  "0" = 未投票

步骤 2  (仅当步骤 1 返回 "1" 时执行)
        GET /api/?action=post&object=votes&element=claim&key=KEY&username=PLAYER
        响应: "1" = 成功

Minecraft-MP —— 单步流程

GET /api/?action=post&object=votes&element=claim&key=KEY&username=PLAYER
响应: "1" = 已领取  |  "2" = 已领取  |  "0" = 未投票

所有请求均在独立的异步线程上运行。主服务器线程绝不会受到影响。


声音反馈

每次投票结果都会播放独特的声音序列,让玩家无需查看聊天信息也能清楚知道发生了什么。

事件 声音序列
投票已领取 VILLAGER_YES → XP_ORB 音调 1.2 → XP_ORB 音调 1.5 → VILLAGER_CELEBRATE
未投票 / 已领取 / 错误 VILLAGER_NO
投票派对触发 VILLAGER_CELEBRATE → XP_ORB x3 渐升 → VILLAGER_YES(所有在线玩家)

投票派对

每当有人领取投票时,全服计数器就会加一。当计数达到你配置的 vote-party 数值的整数倍时,所有当前在线的玩家都会收到 vote-party-rewards 中的命令以及完整的声音序列。

在里程碑之间,广播会让大家保持知情:

[VoteParty] 已达到 23/50 票!还需 27 票。

设置 vote-party: 0 可完全关闭此功能。


加入提醒

玩家加入两秒后(延迟以避免与其他加入消息重叠),VoteMe 会在后台检查所有启用的投票站点。如果该玩家的任何站点有待领取的投票,他们会收到一条私聊消息:

[VoteMe] 你在我们的投票服务上还有 2 张待领取的票。请使用 /vote list
[VoteMe] 你在我们的投票服务上还有 1 张待领取的票。请使用 /vote list

计数准确反映有多少个站点有待领取的投票——而不是他们投票的次数。设置 join-reminder: false 可禁用此功能。


添加新的投票站点

欢迎请求更多投票服务 请联系我:herzfnf@gmail.com

许可证

MIT 许可证 — 版权所有 (c) 2025 Herza
可免费使用、分支、修改和再分发,但需注明出处。
请参阅 LICENSE 获取全文。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源