VotingPlugin - 投票插件

VotingPlugin 是一款高度可定制的投票监听插件，拥有极其丰富的功能。它支持复杂的奖励系统、多服务器环境、离线投票、数据统计与商店等，是目前功能最全面的 Votifier 监听插件之一。请注意，本插件配置较为复杂，建议对 YAML 文件有一定了解的管理员使用。

💡重要须知

本插件功能强大但配置复杂。如果您不熟悉 YAML 文件，可能会在设置过程中遇到困难。请务必先阅读本页面和 Wiki 文档，大多数问题都能在其中找到答案。

• 确保 Votifier / NuVotifier / VotifierPlus 已正确设置，否则无法接收投票。
• 控制台会始终显示投票信息，这有助于排查设置问题。
• 对于不支持的 Minecraft 版本：

- **1.11 及以下版本**：请使用 v5.13.6。

- **仅限 1.8 版本**：请使用[此特殊构建版本](https://example.com)（功能基于 v6.18.7，但部分功能被禁用以兼容 1.8）。

- **注意**：对于上述旧版本，**不提供任何技术支持**。

获取支持

请注意，作者仅有一人，无法保证即时回复。请只选择一种方式联系。

• 免费支持（请先自行查阅文档）：

- 私信

- 讨论区

- GitHub Issues

- Discord（请创建工单）

• 付费支持：如果您需要作者直接为您配置，可以购买付费支持服务。

在寻求帮助时，请使用 pastebin.com 分享您的配置文件或直接发送文件。如果您缺乏基础的服务器知识，作者可能无法提供帮助。

✨依赖

• Votifier / NuVotifier / VotifierPlus（必需）：只需其中一个，且必须正确配置才能接收投票。
• Vault（可选）：用于直接给予游戏币奖励，需要配合经济插件使用。

⭐核心功能

投票奖励类型

插件支持为多种投票行为发放奖励，配置均在 VoteSites.yml 和 SpecialRewards.yml 中完成。

• 特定/全站点奖励：为在某个或所有投票站点投票设置奖励。
• 全站点奖：奖励给在所有站点都投票的玩家。
• 几乎全站点奖：奖励给在所有站点（仅缺一个）投票的玩家。
• 首次投票奖：玩家第一次投票时的奖励。
• 今日首次投票奖：玩家当天第一次投票的奖励。
• 累计投票奖：玩家投票达到指定次数后获得奖励（可设置每日/每周重置）。
• 里程碑奖：玩家总投票数达到特定里程碑时的一次性奖励（可设置为每月重置）。
• 连续投票奖：奖励连续投票指定次数的玩家。
• 投票派对：全服累计投票达到指定次数后，所有在线玩家（或所有投票者）获得奖励。
• 冷却结束奖：当玩家可以再次投票时给予的奖励。
• 最佳投票者奖：奖励每日/每周/每月的投票冠军。

强大的奖励系统

奖励系统高度模块化，一次学会，全插件通用。

• 基础奖励：

- 执行命令

- 给予物品（支持高级属性）

- 给予游戏币

- 给予经验

- 发送消息（广播/私信）

• 高级奖励：

- 延迟奖励（例如：10分钟后发放）

- 定时奖励（在特定时间点执行）

- 随机物品/命令

- 执行 JavaScript 表达式

- 优先级奖励（按顺序尝试发放第一个符合条件的奖励）

- 高级优先级奖励（简化配置）

- 选择奖励（让玩家自行选择）

- 强制离线发放奖励

- 药水效果

- 幸运奖励

- 指定发放奖励的服务器（适用于多服情况）

- 重复奖励（重复指定次数或直到条件满足）

• 奖励生效条件：

- 权限节点

- 所在世界（白名单）

- 触发几率

- 玩家在线/离线状态

- Vault 权限组

- JavaScript 判断表达式

- 位置要求（需在指定地点附近）

• 奖励表现形式：

- 音效

- 粒子效果

- 标题消息

- Boss 血条

- 动作栏消息

- 烟花

玩家投票信息

玩家可通过命令查询投票相关信息。

• /vote total：查看总投票数。
• /vote last：查看上次投票时间。
• /vote next：查看下次可投票时间。
• /vote today：查看今日的投票者。
• /vote gui：打开主投票 GUI（可禁用）。

最佳投票者统计

支持多种时间维度的统计，并可为最佳投票者发放奖励。

• AllTime：总投票数（终生统计）。
• Monthly：月投票数（默认启用，每月重置）。
• Weekly：周投票数（默认禁用）。
• Daily：日投票数（默认禁用）。
• LastMonthTotal：上月总投票数（默认禁用）。
• 数据存储在 VotingPlugin/TopVoter 目录下（若启用）。
• 支持 TopVoter GUI 查看。

🎮其他特性与兼容性

• 外部编辑器：提供图形化界面辅助配置 (/av gui)。
• 跨服支持：完整支持 BungeeCord、Velocity 及多代理架构。
• 离线投票支持：默认支持，可强制为离线玩家发放奖励。
• Hex 颜色代码：支持使用 &#FF0000 格式的颜色代码。
• UUID 支持
• JSON 消息
• 投票提醒
• 投票告示牌
• PlaceholderAPI 扩展：提供大量占位符。
• 投票点系统：

- 内置投票商店。

- 支持 BossShop。

- 支持 LeaderHeads。

• 登录插件兼容：支持 AuthMe / LoginSecurity。
• 管理 GUI：/av gui。
• 网页支持
• 数据库：支持 SQLite 和 MySQL，并可相互迁移且保留数据。
• Folia 支持
• Tab 补全
• 简体中文：简体中文用户可在此下载本地化文件。

🔧配置文件

主要配置文件如下，建议通过 Wiki 了解详细配置方法。

• Config.yml
• VoteSites.yml
• SpecialRewards.yml
• BungeeSettings.yml
• GUI.yml
• Shop.yml

❓开发与构建

如果您想参与开发或自行构建，可以使用以下 Maven 信息。

主要仓库

<repository>
    <id>BenCodez Repo</id>
    <url>https://nexus.bencodez.com/repository/maven-public/</url>
</repository>
<dependency>
    <groupId>com.bencodez</groupId>
    <artifactId>votingplugin</artifactId>
    <version>LATEST</version>
    <scope>provided</scope>
</dependency>

备用仓库（可能已失效）

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>
<dependency>
    <groupId>com.github.BenCodez</groupId>
    <artifactId>VotingPlugin</artifactId>
    <version>LATEST</version>
    <scope>provided</scope>
</dependency>

**版本说明**

• LATEST：最新的稳定版本。
• BRANCH-SNAPSHOT：不稳定的开发构建。

🔧最后

• 如果您喜欢这个插件，请留下好评。
• 如果您想支持作者开发更多功能并保持插件免费，欢迎捐赠。
• 请将问题、疑问和功能请求发布在讨论区或 GitHub。
• 请勿在未寻求帮助前留下差评！
• 资源图标和艺术作品由 @Grizz 制作。