? MangoVotes 插件
由 Modrnith Publication 发布
MangoVotes 是一款精简的、基于临时数据的 Minecraft 插件,旨在促进本地服务器端的投票奖励系统。它安全地处理投票代码生成、玩家唯一领取以及通过可自定义的控制台命令执行奖励。
本插件适合那些希望内部管理投票奖励,而不依赖外部复杂投票服务或数据库的服务器。
✨ 主要功能
- 临时数据存储: 所有投票代码和已领取的玩家数据都存储在临时的
data.yml 文件中,并在每次服务器重启时自动清除,确保每个游戏会话都有一个全新的状态。
- 安全领取: 使用玩家 UUID 来防止玩家领取为他人生成的代码。
- 自定义奖励: 奖励通过控制台命令发放,允许执行自定义物品、货币(
/eco)、效果、称号和声音。
- 管理工具: 包含
/mangovote reload 和 /mangovote reset,便于在运行时轻松管理配置。
- 投票冷却: 防止玩家滥用
/vote 命令。
?️ 安装
- 下载: 从构建输出(
target/ 文件夹)获取最新的 MangoVotes.jar 文件。
- 部署: 将
MangoVotes.jar 文件放入服务器的 plugins/ 目录中。
- 启动/重启: 启动或重启你的 Spigot/Paper 服务器。插件将在新的
MangoVotes 文件夹中生成 config.yml 和 data.yml 文件。
? 配置 (config.yml)
主要配置在 plugins/MangoVotes/config.yml 中处理。
| 设置项 |
描述 |
默认示例 |
vote-message |
玩家运行 /vote 时显示的链接/消息。 |
&9&nhttps://YOUR-VOTING-SITE.com |
vote-cooldown-seconds |
玩家在使用 /vote 之间必须等待的时间(秒)。 |
180 |
messages.prefix |
所有插件消息的标准前缀。 |
&9[MangoVotes] &f |
rewards |
成功领取后执行的控制台命令列表。 |
give %player% diamond 3 |
注意: 记得将 vote-message 中的占位 URL 更改为你实际的投票网站 URL。
? 命令与权限
| 命令 |
用法 |
权限 |
描述 |
/vote |
/vote |
mangovotes.vote |
为玩家生成唯一的投票代码。 |
/claim |
/claim <username> <code> |
mangovotes.claim |
领取与该代码关联的奖励。 |
/mangovote |
/mangovote version |
mangovotes.admin |
显示插件版本。 |
/mangovote |
/mangovote stats |
mangovotes.admin |
显示在线玩家数量、未领取的代码数量以及本次会话中已投票的玩家数量。 |
/mangovote |
/mangovote reload |
mangovotes.admin |
无需重启服务器即可从磁盘重新加载 config.yml 设置。 |
/mangovote |
/mangovote reset |
mangovotes.admin |
手动清除 data.yml 中的所有活动代码和玩家数据。 |
? 开发者与贡献
本插件由 OmHackz 开发。如需关于定制开发或 Modrnith Publication 授权方面的咨询,请联系 omhackz@outlook.com。
? MangoVotes Plugin
Published by Modrnith Publication
MangoVotes is a streamlined, temporary-data-based Minecraft plugin designed to facilitate a local, server-side vote reward system. It securely handles vote code generation, unique player claiming, and reward execution via customizable console commands.
This plugin is ideal for servers that want to manage vote rewards internally without relying on external, complex voting services or databases.
✨ Key Features
- Temporary Data Storage: All vote codes and claimed player data are stored in a temporary
data.yml file and automatically cleared on every server restart, ensuring a fresh slate for each play session.
- Secure Claiming: Uses player UUIDs to prevent players from claiming codes generated for others.
- Customizable Rewards: Rewards are delivered via console commands, allowing for the execution of custom items, money (
/eco), effects, titles, and sounds.
- Admin Tools: Includes
/mangovote reload and /mangovote reset for easy configuration management during runtime.
- Vote Cooldown: Prevents players from spamming the
/vote command.
?️ Installation
- Download: Obtain the latest
MangoVotes.jar file from the build output (target/ folder).
- Deploy: Place the
MangoVotes.jar file into your server's plugins/ directory.
- Start/Restart: Start or restart your Spigot/Paper server. The plugin will generate the
config.yml and data.yml files in a new MangoVotes folder.
? Configuration (config.yml)
The primary configuration is handled in plugins/MangoVotes/config.yml.
| Setting |
Description |
Default Example |
vote-message |
The link/message displayed when a player runs /vote. |
&9&nhttps://YOUR-VOTING-SITE.com |
vote-cooldown-seconds |
Time (in seconds) a player must wait between using /vote. |
180 |
messages.prefix |
The standard prefix for all plugin messages. |
&9[MangoVotes] &f |
rewards |
A list of console commands executed upon successful claim. |
give %player% diamond 3 |
Note: Remember to change the dummy URL in vote-message to your actual voting website URL.
? Commands and Permissions
| Command |
Usage |
Permission |
Description |
/vote |
/vote |
mangovotes.vote |
Generates a unique vote code for the player. |
/claim |
/claim <username> <code> |
mangovotes.claim |
Claims the reward associated with the code. |
/mangovote |
/mangovote version |
mangovotes.admin |
Shows the plugin version. |
/mangovote |
/mangovote stats |
mangovotes.admin |
Shows count of online players, unclaimed codes, and players voted this session. |
/mangovote |
/mangovote reload |
mangovotes.admin |
Reloads config.yml settings from disk without restarting the server. |
/mangovote |
/mangovote reset |
mangovotes.admin |
Manually clears all active codes and player data in data.yml. |
? Developers and Contribution
This plugin was developed by OmHackz. For inquiries regarding custom development or licensing under Modrnith Publication, please contact omhackz@outlook.com.
评论 0
登录后参与评分
还没有评论,来抢沙发吧