__ __ _ _ __ __
\ \ / /__ | |_ ___| |\/| | \/ | ___
\ 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 获取全文。
__ __ _ _ __ __
\ \ / /__ | |_ ___| |\/| | \/ | ___
\ V / _ \| __/ _ \ |\/| | |\/| |/ _ \
\_/ \___/\__\___/_| |_||_| |_|\___/
Turn every vote into a reward. No ports. No daemons. Just a clean API.
What is VoteMe?
VoteMe is a lightweight, pure API-based voting plugin for Java Edition servers. Players open a clean chest GUI, click a site, and their reward lands in their inventory — no port forwarding, no external listener, no daemon process needed.
It supports two of the biggest Minecraft server listing sites out of the box, and every single piece of behavior — sounds, messages, rewards, GUI title, vote party threshold — is configurable down to the last character.
Feature Overview
/vote Opens a 27-slot chest GUI
/vote list Lists all vote site links in chat
Join Reminder Tells players how many votes they haven't claimed yet
Dual API Support Minecraft Pocket Servers + Minecraft-MP, one or both
Fully Async Zero impact on main thread — all API calls are non-blocking
Reward System Any console command as a reward (items, money, permissions)
Vote Party Server-wide reward event when a vote milestone is hit
Sound Feedback Villager + XP Orb sounds for every vote outcome
PlaceholderAPI 4 ready-to-use placeholders for scoreboards
Hot Reload /votereload — no restart needed after config changes
Requirements
| Requirement |
Version |
Notes |
| Java |
21+ |
|
| Paper or Spigot |
1.21.1 |
Also runs on Purpur, Pufferfish, and other forks |
| PlaceholderAPI |
Any |
Optional — unlocks %voteme_*% placeholders |
Installation
Step 1. Drop VoteMe.jar into your /plugins folder.
Step 2. Start the server once to generate the config file at plugins/VoteMe/config.yml.
Step 3. Open the config and fill in your API key(s) and server page URL(s).
Step 4. Run /votereload in-game or from console. Done.
Configuration
# ╔══════════════════════════════════════════════════════════╗
# VoteMe Configuration — by Herza
# ╚══════════════════════════════════════════════════════════╝
# ── Vote Sites ─────────────────────────────────────────────
# Set api-key to "" to disable that site.
# You can run one site, or both at the same time.
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 ──────────────────────────────────────────
# When a player joins, VoteMe checks all enabled sites.
# If unclaimed votes exist, the player gets a private message.
# Set to false to disable.
join-reminder: true
# ── Rewards ────────────────────────────────────────────────
# Console commands executed when a player claims a vote.
# Variable: {player}
rewards:
- "give {player} diamond 1"
- "eco give {player} 500"
# ── Messages ───────────────────────────────────────────────
# Supports & color codes. Variables: {player}, {link}
# Set any value to "" to disable that message.
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 ──────────────────────────────────────────────
# Sent to ALL online players when someone claims a vote.
# Variables: {player}, {link}. Set to [] to disable entirely.
broadcast:
- "&6[Vote] &e{player} &fjust claimed their vote rewards! Vote at &e{link}&f."
# ── Vote Party ─────────────────────────────────────────────
# Fires every time total votes hit a multiple of this number.
# Set to 0 to disable vote party entirely.
vote-party: 50
# Console commands run for EVERY online player when the party fires.
# Variable: {player}
vote-party-rewards:
- "give {player} diamond 5"
# ── GUI ────────────────────────────────────────────────────
gui:
title: "&8» &6&lVoteMe &8«"
# ╔══════════════════════════════════════════════════════════╗
# PlaceholderAPI — requires PlaceholderAPI plugin
#
# %voteme_total_votes% All-time total votes recorded
# %voteme_party_progress% Votes in the current party cycle
# %voteme_party_target% Target to trigger a party (N/A if off)
# %voteme_party_needed% Remaining votes until next party (N/A if off)
#
# 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"
# ╚══════════════════════════════════════════════════════════╝
Where to get your API key
Minecraft Pocket Servers — Log into your dashboard at minecraftpocket-servers.com, open your server settings, and copy the API key from the voting section.
Minecraft-MP — Log into minecraft-mp.com, go to your server panel, and find the API key under the voting/API tab.
Commands
| Command |
What it does |
Permission |
/vote |
Opens the vote chest GUI |
voteme.vote |
/vote list |
Lists all vote site names and links in chat |
voteme.vote |
/votereload |
Reloads config without restarting the server |
voteme.admin |
Permissions
| Node |
Default |
Description |
voteme.vote |
All players |
Access to /vote and /vote list |
voteme.admin |
OP only |
Access to /votereload |
PlaceholderAPI
Install PlaceholderAPI and VoteMe registers its expansion automatically on startup — no extra commands needed.
| Placeholder |
Returns |
%voteme_total_votes% |
All-time total votes recorded by the plugin |
%voteme_party_progress% |
Votes counted in the current party cycle |
%voteme_party_target% |
Vote count target to fire a party (N/A if disabled) |
%voteme_party_needed% |
Votes remaining until the next party (N/A if disabled) |
Works with any scoreboard plugin that supports PlaceholderAPI — CMI, FeatherBoard, AnimatedScoreboard, etc.
&fTotal Votes &e%voteme_total_votes%
&fParty &e%voteme_party_progress%&7/&6%voteme_party_target%
&fNext Party &e%voteme_party_needed% &fvotes
How the Vote API Works
VoteMe talks directly to each site's HTTP API. There is no listener port, no webhook server, and no firewall rules to configure.
Minecraft Pocket Servers — two-step flow
Step 1 GET /api/?object=votes&element=claim&key=KEY&username=PLAYER
Response: "1" = unclaimed | "2" = already claimed | "0" = not voted
Step 2 (only if step 1 returns "1")
GET /api/?action=post&object=votes&element=claim&key=KEY&username=PLAYER
Response: "1" = success
Minecraft-MP — single-step flow
GET /api/?action=post&object=votes&element=claim&key=KEY&username=PLAYER
Response: "1" = claimed | "2" = already claimed | "0" = not voted
All requests run on a separate async thread. The main server thread is never touched.
Sound Feedback
Every vote outcome plays a distinct sound sequence so players always know what happened without even reading the chat.
| Event |
Sound Sequence |
| Vote claimed |
VILLAGER_YES → XP_ORB pitch 1.2 → XP_ORB pitch 1.5 → VILLAGER_CELEBRATE |
| Not voted / already claimed / error |
VILLAGER_NO |
| Vote party fires |
VILLAGER_CELEBRATE → XP_ORB x3 rising → VILLAGER_YES (all online players) |
Vote Party
Every time a vote is claimed, the server-wide counter goes up by one. When it hits a clean multiple of your configured vote-party number, every player currently online receives the vote-party-rewards commands and a full sound sequence.
Between milestones, a broadcast keeps everyone in the loop:
[VoteParty] 23/50 votes reached! 27 more needed.
Set vote-party: 0 to turn it off entirely.
Join Reminder
Two seconds after a player joins (delayed to not overlap with other join messages), VoteMe checks all enabled vote sites in the background. If any site has an unclaimed vote waiting for that player, they get a private message:
[VoteMe] You still have 2 votes on our voting service. Use /vote list
[VoteMe] You still have 1 vote on our voting service. Use /vote list
The count reflects exactly how many sites have an unclaimed vote — not how many times they voted. Set join-reminder: false to disable.
Adding a New Vote Site
Feel free to request an more Vote Service
Contact me at herzfnf@gmail.com
License
MIT License — Copyright (c) 2025 Herza
Free to use, fork, modify, and redistribute with attribution.
See LICENSE for full text.
评论 0
登录后参与评分
还没有评论,来抢沙发吧