JExVote

插件

· 作者 JExcellence

JExVote 处理与服务器投票相关的一切事务,包括从投票网站接收投票、奖励玩家、追踪连投记录以及显示统计数据。它内置了一个兼容 Votifier 的服务器,因此你无需使用 NuVotifier。

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

最新 3.2.0 · 1.21.11 · Folia

一键开服(送7天)

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 将自动处理其余部分。

投票可以:

  • 触发可配置的奖励
  • 计入投票连胜
  • 填充排行榜
  • 奖励里程碑
  • 为商店提供投票点数

管理员可以通过命令和热重载配置文件获得完全的控制权。


功能概览

  • 内置 Votifier 服务器

    • 支持 Votifier v1 (RSA) 和 NuVotifier v2 (HMAC-SHA256)。
    • 无 NuVotifier 依赖。
  • 14 种奖励类型

    • 命令
    • 物品
    • 经验值 (XP)
    • 货币 (JExEconomy)
    • 权限 (LuckPerms)
    • 音效
    • 粒子效果
    • 标题
    • 传送
    • 复合捆绑包
    • 选择菜单
    • 自定义处理器钩子
    • 概率奖励
    • 幸运(加权奖池)奖励
  • 连胜冻结

    • 自动保护连胜。
    • 首次投票赠送一次免费冻结。
    • 额外冻结可使用投票点数购买。
    • 支持通过 jexvote.freeze.max.<n> 设置按权限组限制的冻结数量。
  • 投票赠送

    • /vote gift <player>
    • /vote gift random
    • 将一天的连胜天数传递给其他玩家。
    • 默认每天限用一次。
  • 投票奖池

    • 10 项加权奖池。
    • 每次投票均进行抽奖。
    • 游戏中显示掉落几率。
    • 可在 rewards.yml 中完全编辑。
  • 投票派对(高级功能)

    • 全服共享投票计数器。
    • 达成目标时奖励所有贡献者。
  • 周末倍率(高级功能)

    • 增加投票点数倍率。
    • 增加奖励数量倍率。
    • 可配置的时间表。
  • 投票商店(高级功能)

    • 消耗投票点数购买:
      • 宝箱钥匙
      • 装饰物品
      • 飞行时间
  • 基岩版 (Geyser/Floodgate) 支持

    • 使用可配置的基岩版前缀(默认为 !)匹配用户名。
  • 嵌入式 REST API

    • 可选的本地 API。
    • 默认端口:8096。
    • 暴露投票和连胜统计数据。
  • 投票连胜

    • 可配置的超时时间。
    • 里程碑奖励。
    • 支持无限数量的里程碑。
  • 按站点奖励

    • 针对特定投票站点的额外奖励。
  • 离线投票队列

    • 在玩家离线时存储投票。
    • 下次登录时自动交付。
  • 交互式 GUI

    • 投票概览
    • 排行榜
    • 连胜进度
    • 奖励菜单
  • 投票站点冷却时间

    • 滚动式冷却。
    • 每日固定重置。
    • 向玩家显示剩余时间。
  • 投票点数

    • 可按站点配置数值。
    • 独立于投票次数。
    • 用于冻结和投票商店。
  • 广播与私聊消息

    • 广播模式:
      • 所有人
      • 除投票者外的所有人
      • 禁用
    • 防垃圾信息冷却。
    • 可选的私人感谢消息。
  • 多语言支持

    • 英语
    • 德语
    • 捷克语
    • 斯洛伐克语
    • 支持自定义翻译。
  • 记录保留

    • 自动清理旧的投票记录。
  • 兼容 Spigot / Paper / Folia

    • 使用 FoliaLib 进行调度。
  • 可自定义的命令

    • 别名
    • 命令树
    • 翻译支持

GUI 界面

投票概览

图片: 970516

玩家输入 /vote 时看到的主菜单。

特性:

  • 个人投票统计
  • 当前连胜进度条
  • 已配置的投票站点及可点击链接
  • 导航至:
    • 排行榜
    • 连胜视图

排行榜

图片: 970517

分页的全时间排行榜。

特性:

  • 前三名的玩家头像
  • 总投票数
  • 月度投票数
  • 当前连胜
  • 投票点数
  • 可视化投票条
  • 用于页面导航的箭头按钮

连胜进度

图片: 970518

显示:

  • 当前连胜
  • 最高连胜
  • 所有已配置的里程碑

里程碑颜色:

  • ? 已完成
  • ? 下一个目标
  • ? 未解锁

包含一个 20 段的进度条,显示通往下一个奖励的进度。


安装指南

步骤 1 — 安装

将 JExVote.jar 放入你的 plugins/ 文件夹并重启服务器。

首次启动时,JExVote 会自动生成:

  • 配置文件
  • RSA 密钥对
  • Votifier 令牌

步骤 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>

验证以下内容:

  • 奖励是否执行
  • 广播是否出现
  • GUI 是否正确更新

控制台会记录每一次收到的投票,包括:

  • 协议版本
  • 服务名称

奖励类型

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

已被移除。

现在飞行权限只能通过投票商店购买,而活动期间的飞行权限仍保留给服务器活动使用。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源