JExVote
投票奖励系统
内置 Votifier 服务器 · 连胜冻结与保号 · 投票奖池与派对 · 投票商店 · 基岩版支持
支持 Votifier v1 (RSA) 和 NuVotifier v2 (HMAC) —— 无需外部 Votifier 插件。
更新日志
自上次更新以来,JExVote 新增了五个系统和完全重构的 GUI:
- 连胜冻结 (Streak Freezes) —— 在错过一天时保护连胜记录。每位玩家首次投票后获得一次免费冻结机会,更多次数可通过
/vote freeze 使用投票点数购买。
- 投票赠送 (Vote Gifting) —— 使用
/vote gift <player> 或 /vote gift random,当好友无法登录时,帮助其保持连胜记录。
- 投票奖池 (Vote Jackpot) —— 每次投票从包含 10 个奖项的加权池中抽取一个奖品,赔率可在菜单中查看,所有配置均可在
rewards.yml 中完全编辑。
- 投票派对 (Vote Party)(高级功能) —— 全服共享投票计数器,当达到目标时奖励所有贡献者。
- 投票商店 (Vote Shop)(高级功能) —— 消耗投票点数购买宝箱钥匙、装饰物品(粒子轨迹、灯笼、蛙明灯)以及飞行时间。
- 基岩版支持 —— 通过可配置的名称前缀(默认为
!)匹配 Geyser/Floodgate 玩家,确保跨平台服务器的投票计数正确无误。
- 所有 GUI 重构 —— 帮助、概览、商店和连胜视图现在共享一套设计体系:统一的渐变标题、固定的分页行、实时进度条。
现在共有 14 种奖励类型(新增“概率”和“幸运”两种,原有 12 种),并附带可选的嵌入式 REST API(默认端口 8096),用于将投票统计数据拉取至网站后端。
什么是 JExVote?
JExVote 处理与服务端投票相关的所有事务,包括从投票网站接收投票、奖励玩家、追踪连胜记录以及显示统计数据。
它自带一个 兼容 Votifier 的服务器,因此你不需要 NuVotifier 或其他任何监听插件。只需将你的投票网站指向配置的端口,JExVote 将自动处理其余部分。
投票可以:
- 触发可配置的奖励
- 计入投票连胜
- 填充排行榜
- 奖励里程碑
- 为商店提供投票点数
管理员可以通过命令和热重载配置文件获得完全的控制权。
功能概览
GUI 界面
投票概览
图片: 970516
玩家输入 /vote 时看到的主菜单。
特性:
- 个人投票统计
- 当前连胜进度条
- 已配置的投票站点及可点击链接
- 导航至:
排行榜
图片: 970517
分页的全时间排行榜。
特性:
- 前三名的玩家头像
- 总投票数
- 月度投票数
- 当前连胜
- 投票点数
- 可视化投票条
- 用于页面导航的箭头按钮
连胜进度
图片: 970518
显示:
里程碑颜色:
包含一个 20 段的进度条,显示通往下一个奖励的进度。
安装指南
步骤 1 — 安装
将 JExVote.jar 放入你的 plugins/ 文件夹并重启服务器。
首次启动时,JExVote 会自动生成:
步骤 2 — 配置 Votifier 服务器
打开 config.yml 并检查 votifier 部分。
votifier:
host: '' # 留空以绑定所有接口
port: 8192 # 投票站点连接的端口
token: '' # 首次运行时自动生成
如果您的主机需要特定的绑定地址,请相应地设置 host。
令牌在首次启动时自动生成。
将其从 config.yml 复制到您的投票站点的 Votifier 配置中。
重要
确保防火墙或托管面板中已开放端口 8192(或您配置的端口)。投票站点必须能够直接连接。
步骤 3 — 添加投票站点
编辑 sites.yml:
sites:
serverliste:
display-name: "Serverliste.net"
service-name: "Serverliste"
vote-url: "https://serverliste.net/vote/12345"
cooldown-minutes: 1440
points-per-vote: 1
mcserverlist:
display-name: "MC Server List"
service-name: "MCServerList"
vote-url: "https://minecraft-server-list.com/server/12345/vote/"
daily-reset: "00:00"
timezone: "Europe/Berlin"
points-per-vote: 2
冷却模式
每个站点选择 一种。
滚动冷却
cooldown-minutes: 1440
玩家可以在指定的分钟数后再次投票。
固定每日重置
daily-reset: "00:00"
timezone: "Europe/Berlin"
每个人可以在配置的时间再次投票。
重要
service-name 必须与 投票站点发送的标识符完全匹配。
如果不确定:
/jexvote fakevote <player> TestService
或者检查服务器日志以查看传入的服务名称。
步骤 4 — 配置奖励
打开 rewards.yml。
示例:
default-rewards:
- type: command
command: "give {player} diamond 1"
as-console: true
- type: sound
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.2
- type: title
title: "<green>Thank you!"
subtitle: "<gray>Your vote has been counted."
fade-in: 10
stay: 40
fade-out: 10
奖励分为三类。
默认奖励
无论来自哪个站点,为 每次投票 发放。
连击奖励
在达到配置的连击里程碑时发放。
站点奖励
针对特定投票站点的额外奖励。
步骤 5 — 验证
运行:
/jexvote fakevote <yourname>
验证以下内容:
控制台会记录每一次收到的投票,包括:
奖励类型
JExVote 包含 14 种奖励类型。
| 类型 |
描述 |
关键字段 |
| command |
执行控制台或玩家命令 |
command, as-console |
| item |
给予带有可选 NBT 的物品堆 |
material, amount, name, lore, enchantments |
| xp |
授予原版经验值 |
amount |
| currency |
存入 JExEconomy 货币 |
currency, amount |
| permission |
授予有时限的 LuckPerms 权限 |
permission, duration, server |
| sound |
播放声音 |
sound, volume, pitch |
| particle |
生成粒子效果 |
particle, count, offset |
| title |
显示标题和副标题 |
title, subtitle, fade-in, stay, fade-out |
| teleport |
传送玩家 |
world, x, y, z, yaw, pitch |
| composite |
捆绑多种奖励 |
rewards |
| choice |
让玩家从 GUI 中选择 |
options |
| custom |
挂钩到自定义插件逻辑 |
handler, data |
| chance |
基于概率的奖励 |
chance, reward |
| lucky |
加权奖励池(投票大奖) |
entries |
命令与权限
玩家命令
/vote 打开投票 GUI
/vote help 显示玩家命令帮助
/vote sites 列出所有投票站点及可点击链接
/vote stats [player] 查看投票统计
/vote top [count] 查看历史排行榜(最多 50 名)
/vote rewards 查看大奖几率、当前倍率和 Vote Party 进度
/vote freeze 使用投票点数购买连击冻结
/vote gift <player> 向玩家赠送一天连击
/vote gift random 向一名随机在线玩家赠送一天连击
/vote shop 打开投票商店(高级版)
权限
jexvote.command.vote
别名
/v
管理员命令
/jexvote 显示管理员帮助
/jexvote info 显示版本、版本号、站点数量和 Votifier 端口
/jexvote reload 热重载 config.yml、rewards.yml 和 sites.yml
/jexvote reset <player> 重置玩家的投票数据
/jexvote resetmonthly 重置所有玩家的月度投票计数
/jexvote fakevote <player> [service] 模拟投票用于测试
别名
/jv
权限节点
jexvote.command.vote /vote 及其所有子命令的访问权限
jexvote.command.admin /jexvote 和 /jexvote info 的访问权限
jexvote.command.admin.reload 重载配置文件
jexvote.command.admin.reset 重置玩家数据和月度计数
jexvote.command.admin.fakevote 模拟测试投票
配置参考
config.yml — 完整参考
# ── Votifier 服务器 ─────────────────────────
votifier:
host: '' # 绑定地址(空 = 所有接口)
port: 8192 # 投票站点连接的端口
token: '' # HMAC 令牌(自动生成)
# ── 广播 ──────────────────────────────
broadcast:
mode: 'all' # all | others | none
cooldown-minutes: 30
# ── 私聊消息 ────────────────────────
private-message:
enabled: true
# ── 离线队列 ───────────────────────────
offline-vote-queue: true
# ── 连胜 ─────────────────────────────────
streak:
timeout-hours: 36
claim-mode: 'auto'
bonus-commands:
7:
- "give {player} diamond 3"
14:
- "give {player} diamond 5"
30:
- "give {player} diamond_block 1"
- "broadcast &6{player} &7reached a &630-day &7vote streak!"
# ── 维护 ────────────────────────────
records:
retention-days: 90
连胜系统
Streaks 用于追踪玩家连续投票的天数。
默认情况下,两次投票之间间隔 36 小时后连胜才会重置,这比严格的 24 小时间隔提供了更大的灵活性。
连胜里程碑可以触发两套独立的奖励系统。
额外指令
在 config.yml 中配置:
streak:
bonus-commands:
旨在执行简单的指令。
示例包括:
连胜奖励
在 rewards.yml 中配置:
streak-rewards:
使用完整的奖励系统,包括:
- 物品
- 货币
- 头衔
- 粒子效果
- GUI 选项
- 自定义奖励
- 任何其他支持的奖励类型
两套系统可以在同一个里程碑同时触发。
例如,30 天连胜可能:
- 广播服务器消息
- 给予物品
- 发放货币
- 打开奖励选择菜单
同时进行。
GUI 集成
连胜进度会显示在插件的各个部分。
投票概览
显示:
连胜 GUI
显示:
- 所有已配置的里程碑
- 已达成的里程碑
- 即将到来的里程碑
- 未解锁的里程碑
- 距离下一份奖励的进度
互动系统
❄ 连胜冻结
Streak Freeze(连胜冻结)会在玩家错过一天时自动保护其连胜状态。
无需任何指令即可激活一次冻结。
如果连胜本应过期后收到了投票,将消耗相应数量的冻结次数,连胜将继续不间断。
玩家可获得:
- 首次投票时获得 1 次免费冻结
- 通过以下指令使用投票点数购买额外冻结:
/vote freeze
可配置选项包括:
- 冻结所需费用
- 最大持有冻结次数
- 每次冻结保护的时长(小时)
按权限组限制的冻结数量由以下权限控制:
jexvote.freeze.max.<n>
投票赠送
向其他玩家赠送一天的连胜。
/vote gift <player>
或
/vote gift random
规则:
- 仅提升接收者的连胜天数
- 发送者仍会获得自己的投票奖励
- 默认每天限赠送一次
- 权限组可提高限制
jexvote.gift.daily.<n>
每位玩家每天只能接受一次赠送。
投票大奖池
每次投票都会从10 个奖位的加权奖池中抽取一个奖品。
可能的奖励范围包括:
使用:
/vote rewards
可查看:
整个奖池在 rewards.yml 中使用 lucky 奖励类型进行配置。
投票派对(高级版)
全服共享的投票计数器。
当达到目标值时:
- 所有贡献过的玩家都会获得奖励
- 在线玩家立即获得奖励
- 离线玩家在下一次登录时获得奖励
之后,计数器会自动重置。
周末倍数可增加:
投票商店(高级版)
使用投票点数兑换独家物品,包括:
- 箱子钥匙
- 永久粒子轨迹
- 灯笼外观
- 萤石粉外观
- 限时飞行权限
每件商品在购买前都提供预览。
之前的基于指令的飞行系统:
/vote fly
已被移除。
现在飞行权限只能通过投票商店购买,而活动期间的飞行权限仍保留给服务器活动使用。
JExVote
The Votifier Reward System
Built-in Votifier server · Streaks & Freezes · Vote Jackpot & Party · Vote Shop · Bedrock support
Supports Votifier v1 (RSA) and NuVotifier v2 (HMAC) — no external Votifier plugin required.
What's New
Since the last update, JExVote gained five new systems and a full GUI rebuild:
- Streak Freezes — protect a streak when a day is missed. Everyone starts with one free freeze, more are bought with vote points via
/vote freeze.
- Vote Gifting —
/vote gift <player> or /vote gift random keeps a friend's streak alive when they can't log in.
- Vote Jackpot — every vote rolls one prize from a 10-entry weighted pool, odds shown in the menu, fully editable in
rewards.yml.
- Vote Party (Premium) — a shared server-wide vote counter rewards every contributor when the target is hit.
- Vote Shop (Premium) — spend vote points on crate keys, cosmetics (particle trails, lanterns, froglights), and fly time.
- Bedrock support — matches Geyser/Floodgate players by their configurable name prefix (default
!) so cross-platform servers get vote credit correctly.
- Every GUI rebuilt — help, overview, shop, and streak views now share one design system: unified gradient headers, fixed pagination row, live progress bars.
There are now 14 reward types (with chance and lucky joining the original 12), plus an optional embedded REST API (default port 8096) for pulling vote statistics into a website backend.
What is JExVote?
JExVote handles everything related to server voting, from receiving votes from voting sites to rewarding players, tracking streaks, and displaying statistics.
It ships with its own Votifier-compatible server, so you do not need NuVotifier or any other listener plugin. Simply point your vote sites at the configured port and JExVote handles the rest.
Votes can:
- trigger configurable rewards
- contribute toward vote streaks
- populate the leaderboard
- reward milestones
- provide vote points for the shop
Administrators receive complete control through commands and hot-reloadable configuration files.
Feature Overview
-
Built-in Votifier server
- Supports both Votifier v1 (RSA) and NuVotifier v2 (HMAC-SHA256).
- No NuVotifier dependency.
-
14 reward types
- Commands
- Items
- XP
- Currency (JExEconomy)
- Permissions (LuckPerms)
- Sounds
- Particles
- Titles
- Teleports
- Composite bundles
- Choice menus
- Custom handler hooks
- Chance rewards
- Lucky (weighted jackpot) rewards
-
Streak Freezes
- Automatic streak protection.
- One free freeze on the first vote.
- Additional freezes purchased with vote points.
- Per-rank limits via
jexvote.freeze.max.<n>.
-
Vote Gifting
/vote gift <player>
/vote gift random
- Pass a streak day to another player.
- Once per day by default.
-
Vote Jackpot
- 10-entry weighted prize pool.
- Rolls every vote.
- Drop chances displayed in-game.
- Fully editable in
rewards.yml.
-
Vote Party (Premium)
- Shared server-wide vote counter.
- Rewards every contributor when the goal is reached.
-
Weekend Multipliers (Premium)
- Multiply vote points.
- Multiply reward amounts.
- Configurable schedule.
-
Vote Shop (Premium)
- Spend vote points on:
- crate keys
- cosmetics
- fly time
-
Bedrock (Geyser/Floodgate) support
- Matches usernames using a configurable Bedrock prefix (default
!).
-
Embedded REST API
- Optional local API.
- Default port:
8096.
- Exposes vote and streak statistics.
-
Vote Streaks
- Configurable timeout.
- Milestone rewards.
- Unlimited milestone support.
-
Per-site Rewards
- Extra rewards for specific voting sites.
-
Offline Vote Queue
- Stores votes while players are offline.
- Delivers them automatically on next login.
-
Interactive GUIs
- Vote overview
- Leaderboard
- Streak progress
- Rewards menu
-
Vote Site Cooldowns
- Rolling cooldowns.
- Fixed daily resets.
- Displays remaining time to players.
-
Vote Points
- Configurable per-site values.
- Separate from vote count.
- Used for freezes and the vote shop.
-
Broadcasts & Private Messages
- Broadcast modes:
- everyone
- everyone except voter
- disabled
- Anti-spam cooldown.
- Optional private thank-you message.
-
Multi-language
- English
- German
- Czech
- Slovak
- Custom translations supported.
-
Record Retention
- Automatically purges old vote records.
-
Spigot / Paper / Folia Compatible
- Uses FoliaLib for scheduling.
-
Customizable Commands
- Aliases
- Command trees
- Translations---
GUIs
Vote Overview
Image: 970516
The main menu players see when they type /vote.
Features:
- Personal vote statistics
- Current streak progress bar
- Configured vote sites with clickable links
- Navigation to:
Leaderboard
Image: 970517
A paginated all-time leaderboard.
Features:
- Player heads for the top 3
- Total votes
- Monthly votes
- Current streak
- Vote points
- Visual vote bar
- Arrow buttons for page navigation
Streak Progress
Image: 970518
Displays:
- Current streak
- Highest streak
- All configured milestones
Milestone colors:
- ? Achieved
- ? Next target
- ? Locked
Includes a 20-segment progress bar showing progress toward the next reward.
Setup Guide
Step 1 — Install
Drop JExVote.jar into your plugins/ folder and restart the server.
On first launch JExVote automatically generates:
- configuration files
- an RSA keypair
- a Votifier token
Step 2 — Configure the Votifier Server
Open config.yml and check the votifier section.
votifier:
host: '' # Leave empty to bind all interfaces
port: 8192 # Port vote sites connect to
token: '' # Auto-generated on first run
If your host requires a specific bind address, set host accordingly.
The token is generated automatically during first startup.
Copy it from config.yml into your voting site's Votifier configuration.
Important
Ensure port 8192 (or your configured port) is open in your firewall or hosting panel. Vote sites must be able to connect directly.
Step 3 — Add Vote Sites
Edit sites.yml:
sites:
serverliste:
display-name: "Serverliste.net"
service-name: "Serverliste"
vote-url: "https://serverliste.net/vote/12345"
cooldown-minutes: 1440
points-per-vote: 1
mcserverlist:
display-name: "MC Server List"
service-name: "MCServerList"
vote-url: "https://minecraft-server-list.com/server/12345/vote/"
daily-reset: "00:00"
timezone: "Europe/Berlin"
points-per-vote: 2
Cooldown Modes
Choose one per site.
Rolling cooldown
cooldown-minutes: 1440
Players may vote again after the specified number of minutes.
Fixed daily reset
daily-reset: "00:00"
timezone: "Europe/Berlin"
Everyone may vote again at the configured time.
Important
service-name must exactly match the identifier sent by the voting site.
If unsure:
/jexvote fakevote <player> TestService
or inspect the server log to see the incoming service name.
Step 4 — Configure Rewards
Open rewards.yml.
Example:
default-rewards:
- type: command
command: "give {player} diamond 1"
as-console: true
- type: sound
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.2
- type: title
title: "<green>Thank you!"
subtitle: "<gray>Your vote has been counted."
fade-in: 10
stay: 40
fade-out: 10
Rewards are divided into three categories.
Default Rewards
Granted for every vote, regardless of site.
Streak Rewards
Awarded when reaching configured streak milestones.
Site Rewards
Additional rewards for a specific vote site.
Step 5 — Verify
Run:
/jexvote fakevote <yourname>
Verify that:
- rewards execute
- broadcasts appear
- GUIs update correctly
The console logs every received vote, including:
- protocol version
- service name
Reward Types
JExVote includes 14 reward types.
| Type |
Description |
Key Fields |
| command |
Execute a console or player command |
command, as-console |
| item |
Give an item stack with optional NBT |
material, amount, name, lore, enchantments |
| xp |
Grant vanilla XP |
amount |
| currency |
Deposit into a JExEconomy currency |
currency, amount |
| permission |
Grant a timed LuckPerms permission |
permission, duration, server |
| sound |
Play a sound |
sound, volume, pitch |
| particle |
Spawn particles |
particle, count, offset |
| title |
Display a title and subtitle |
title, subtitle, fade-in, stay, fade-out |
| teleport |
Teleport the player |
world, x, y, z, yaw, pitch |
| composite |
Bundle multiple rewards |
rewards |
| choice |
Let the player choose from a GUI |
options |
| custom |
Hook into custom plugin logic |
handler, data |
| chance |
Reward based on probability |
chance, reward |
| lucky |
Weighted reward pool (Vote Jackpot) |
entries |
Commands & Permissions
Player Commands
/vote Opens the vote GUI
/vote help Shows player command help
/vote sites Lists all vote sites with clickable links
/vote stats [player] View vote statistics
/vote top [count] View the all-time leaderboard (max 50)
/vote rewards View jackpot odds, active multiplier, and Vote Party progress
/vote freeze Buy a Streak Freeze with vote points
/vote gift <player> Gift a streak day to a player
/vote gift random Gift a streak day to a random online player
/vote shop Open the Vote Shop (Premium)
Permission
jexvote.command.vote
Alias
/v
Admin Commands
/jexvote Shows admin help
/jexvote info Shows edition, version, site count, and Votifier port
/jexvote reload Hot-reloads config.yml, rewards.yml, and sites.yml
/jexvote reset <player> Resets all vote data for a player
/jexvote resetmonthly Resets monthly vote counts for every player
/jexvote fakevote <player> [service] Simulates a vote for testing
Alias
/jv
Permission Nodes
jexvote.command.vote Access to /vote and all subcommands
jexvote.command.admin Access to /jexvote and /jexvote info
jexvote.command.admin.reload Reload configuration files
jexvote.command.admin.reset Reset player data and monthly counts
jexvote.command.admin.fakevote Simulate test votes
Configuration Reference
config.yml — Full Reference
# ── Votifier Server ─────────────────────────
votifier:
host: '' # Bind address (empty = all interfaces)
port: 8192 # Port for vote site connections
token: '' # HMAC token (auto-generated)
# ── Broadcasts ──────────────────────────────
broadcast:
mode: 'all' # all | others | none
cooldown-minutes: 30
# ── Private Messages ────────────────────────
private-message:
enabled: true
# ── Offline Queue ───────────────────────────
offline-vote-queue: true
# ── Streaks ─────────────────────────────────
streak:
timeout-hours: 36
claim-mode: 'auto'
bonus-commands:
7:
- "give {player} diamond 3"
14:
- "give {player} diamond 5"
30:
- "give {player} diamond_block 1"
- "broadcast &6{player} &7reached a &630-day &7vote streak!"
# ── Housekeeping ────────────────────────────
records:
retention-days: 90
Streak System
Streaks track how many consecutive days a player has voted.
By default, players have 36 hours between votes before their streak resets, providing some flexibility beyond a strict 24-hour window.
Streak milestones can trigger two independent reward systems.
Bonus Commands
Configured in config.yml:
streak:
bonus-commands:
Designed for simple command execution.
Examples include:
- Giving items
- Broadcasting messages
- Running console commands
Streak Rewards
Configured in rewards.yml:
streak-rewards:
Uses the complete reward system, including:
- Items
- Currency
- Titles
- Particles
- GUI choices
- Custom rewards
- Any other supported reward type
Both systems can trigger at the same milestone.
For example, a 30-day streak could:
- Broadcast a server message
- Give items
- Award currency
- Open a reward selection menu
simultaneously.
GUI Integration
Streak progress appears throughout the plugin.
Vote Overview
Displays:
- Current streak
- Progress bar toward the next milestone
Streak GUI
Displays:
- Every configured milestone
- Achieved milestones
- Upcoming milestone
- Locked milestones
- Progress toward the next reward
Engagement Systems
❄ Streak Freezes
A Streak Freeze automatically protects a player's streak if they miss a day.
No command is required to activate one.
If a vote arrives after the streak would normally expire, the required number of freezes is consumed and the streak continues uninterrupted.
Players receive:
- 1 free freeze on their first vote
- Additional freezes purchased with vote points using:
/vote freeze
Configurable options include:
- Freeze cost
- Maximum owned freezes
- Hours protected per freeze
Per-rank limits are controlled with:
jexvote.freeze.max.<n>
Vote Gifting
Gift a streak day to another player.
/vote gift <player>
or
/vote gift random
Rules:
- Advances only the recipient's streak
- The sender still receives their own vote rewards
- One gift per day by default
- Rank permissions can increase the limit
jexvote.gift.daily.<n>
A player may only receive one gift each day.
Vote Jackpot
Every vote rolls one prize from a 10-entry weighted prize pool.
Possible rewards range from:
- Small currency prizes
- Rare crate keys
- Top-tier jackpot rewards
Use:
/vote rewards
to view:
- Drop chances
- Reward list
- Historical drop counts
The entire pool is configured in rewards.yml using the lucky reward type.
Vote Party (Premium)
A shared server-wide vote counter.
When the target is reached:
- Every contributing player receives rewards
- Online players are rewarded immediately
- Offline players receive rewards when they next join
Afterwards, the counter resets automatically.
Weekend multipliers can increase:
- Vote points
- Reward amounts
Vote Shop (Premium)
Spend vote points on exclusive items including:
- Crate keys
- Permanent particle trails
- Lantern cosmetics
- Froglight cosmetics
- Timed fly access
Each item includes a preview before purchase.
The previous command-based flight system:
/vote fly
has been removed.
Flight is now exclusively purchased through the Vote Shop, while event-based flight remains reserved for server events.
评论 0
登录后参与评分
还没有评论,来抢沙发吧