✨ BenthPinata ✨
一款高级且完全可自定义的 Minecraft Piñata 事件插件
专为 Spigot、Paper、Purpur 及所有兼容的服务端分支设计。
BenthPinata 是一款功能全面的 Spigot 插件,为您的 Minecraft 服务器增添了有趣、富有回报且完全可定制的 Piñata(彩罐)事件。该插件面向服务器管理员,允许您将社区聚集在一起,共同攻击一个目标,争夺榜首位置并赢得丰厚奖励。通过简单的配置和强大的功能,为您的服务器注入新的活力!
? 为什么选择 BenthPinata?
- ? 高性能: 采用现代编码实践和异步操作构建,确保对服务器性能的影响降至最低。
- ? 智能依赖处理: 没有僵化的要求!BenthPinata 使用智能全息图系统。它优先使用 ProtocolLib 来实现流畅的基于数据包的全息图。如果未找到,则回退到 DecentHolograms。如果两者都不可用,插件将在没有全息图的情况下完美运行,确保不会破坏您的服务器。
- ? 终极灵活性: 通过在
config.yml、rewards.yml 和 abilities.yml 中自定义几乎所有设置,打造您梦想中的事件。
- ✅ 活跃开发: 一个持续更新并重视社区反馈的项目。
? 核心功能
- 无限种类的 Piñata: 可以创建任意数量的 Piñata 类型,每种都有不同的生命值、位置和特殊能力。
高级生物支持: 让您的 Piñata 不仅仅是一只绵羊,还可以是 僵尸、马、羊驼,甚至使用 NBT 标签 创建的完全自定义实体!
- 高级能力系统: 随着 Piñata 生命值的降低触发特殊能力,例如击退附近的玩家、致盲他们或施加负面药水效果。
- 全面的奖励机制:
- 每次命中奖励: 玩家每次命中都有机会获得小型随机奖励。
- 伤害阈值: 为达到特定伤害里程碑的玩家提供保证奖励。
- 最终奖励: 在活动结束时,以惊人的奖品致敬伤害最高的玩家。
- 动态视觉反馈:
- 智能全息图系统: 动态显示 Piñata 的生命值。它使用高性能的基于数据包的全息图(推荐 ProtocolLib),回退到 DecentHolograms,或者在没有全息图依赖的情况下也能正常工作。
- Boss Bar: 内置的 Boss Bar 为所有附近玩家提供实时生命值追踪。
- 震撼特效: 引人入胜的粒子和音效让事件充满生机。
- 自动事件系统:
- 按固定间隔自动开始事件(例如每 2 小时一次)。
- 当服务器玩家数量达到一定阈值时触发事件。
- 安排特定日期和时间的事件(例如每周五晚上 8:00)。
- 统计信息与排行榜: 追踪玩家的总伤害量和 Piñata 击杀数。使用
/pinata stats top 命令列出最佳玩家。
- PlaceholderAPI 支持: 在其他插件(如记分板、菜单等)中显示插件统计信息和排行榜。
- 轻松管理: 使用简单且基于权限的命令轻松管理事件。
✅ 支持版本
本插件基于现代服务端 API 构建,并已测试与广泛版本的兼容性。
| Minecraft Version |
Support Status |
Minecraft Version |
Support Status |
| 1.21.X |
✅ Compatible |
1.16.X |
✅ Compatible |
| 1.20.X |
✅ Compatible |
1.15.X |
✅ Compatible |
| 1.19.X |
✅ Compatible |
1.14.X |
✅ Compatible |
| 1.18.X |
✅ Compatible |
1.13.X |
✅ Compatible |
| 1.17.X |
✅ Compatible |
1.12.X & Older |
❌ Incompatible |
? 安装
- 下载插件: 从 Releases 页面 获取最新的
.jar 文件。
- 安装依赖项(可选但推荐):
- 上传文件: 将下载的
BenthPinata.jar 文件(以及任何依赖项)放入服务端的 plugins 文件夹中。
- 启动服务器: 启动您的服务器。必要的配置文件(
config.yml、messages.yml 等)将自动生成在 plugins/BenthPinata 文件夹中。
- 配置: 编辑
config.yml 以设置 Piñata 的生成位置和其他设置。在游戏中使用 /pinata reload 命令应用更改。
? 命令与权限
注意: 您可以使用 /pinataevent 或 /pinyata 作为主命令 /pinata 的别名。
| 命令 |
描述 |
权限 |
/pinata help |
显示帮助菜单。 |
benthpinata.command.help |
/pinata start <type> [location] |
开始指定类型的 Piñata 事件。 |
benthpinata.command.start |
/pinata list |
列出所有活跃的 Piñatas。 |
benthpinata.command.list |
/pinata kill <id> |
杀死指定 ID 的 Piñata。 |
benthpinata.command.kill |
/pinata killall |
杀死所有活跃的 Piñatas 并停止所有任务。 |
benthpinata.command.killall |
/pinata reload |
重新加载整个插件配置。 |
benthpinata.command.reload |
/pinata stats |
显示你自己的 Piñata 统计数据。 |
benthpinata.stats |
/pinata stats top <damage|kills> |
按伤害或击杀数列出排名前列的玩家。 |
benthpinata.stats.top |
/pinata stats reset <player|all> |
重置某个玩家或所有玩家的统计数据。 |
benthpinata.stats.reset |
| (所有权限) |
授予上述所有命令的访问权限。 |
benthpinata.admin |
⚙️ 配置文件
该插件将其所有设置存储在 plugins/BenthPinata/ 目录中。
config.yml: 包含主要设置,如 Piñata 类型、位置、生命值、效果以及自动事件系统。
messages.yml: 包含所有面向用户的消息、标题和全息文本。完全可翻译。
rewards.yml: 定义所有奖励命令及其在每次命中、伤害阈值和最终奖励中的概率。
abilities.yml: 定义你的 Piñata 类型的特殊能力。
stats.yml: 存储玩家统计数据的数据文件。不建议手动编辑此文件。
?️ 示例配置
以下是 config.yml 中的一小段代码,以展示其灵活性:
pinata-types:
# 一个名为 'dungeon' 且发光且没有 AI 的僵尸 Piñata
dungeon:
spawn-location: 'world;15;70;25'
health: 250
entity-type: 'ZOMBIE'
mob-options:
is-baby: false
glowing: true
custom-name: '&4&lDUNGEON PIÑATA'
custom-name-visible: true
# 这确保 Piñata 保持沉默且不移动。
nbt-data: '{ "Silent": 1b, "NoAI": 1b }'
? PlaceholderAPI 支持
如果服务器上安装了 PlaceholderAPI,你可以使用以下占位符在其他插件中显示 BenthPinata 数据。
玩家统计数据
%bp_stats_damage% - 显示玩家对 Piñatas 造成的总伤害。
%bp_stats_kills% - 显示玩家的 Piñata 击杀总数。
排行榜
%bp_top_damage_<rank>_name% - 显示伤害排行榜上 <rank> 位置的玩家名称(例如 %bp_top_damage_1_name%)。
%bp_top_damage_<rank>_value% - 显示伤害排行榜上 <rank> 位置玩家的伤害值。
%bp_top_kills_<rank>_name% - 显示击杀排行榜上 <rank> 位置的玩家名称。
%bp_top_kills_<rank>_value% - 显示击杀排行榜上 <rank> 位置的击杀计数。
? 支持与反馈
如果你发现错误或有任何功能建议,请在 GitHub Issues 页面提交问题。
? 许可证
本项目根据 MIT 许可证 许可,支持自由和开源软件。请查看 LICENSE 文件了解更多详情。
✨ BenthPinata ✨
An Advanced and Fully Customizable Minecraft Piñata Event Plugin
Designed for Spigot, Paper, Purpur, and all compatible server forks.
BenthPinata is a comprehensive Spigot plugin that adds fun, rewarding, and fully customizable Piñata events to your Minecraft server. Designed for server owners, this plugin allows you to bring your community together to attack a common goal, compete for the top spot, and win amazing rewards. Breathe new life into your server with easy configuration and powerful features!
? Why Choose BenthPinata?
- ? High Performance: Built with modern coding practices and asynchronous operations to ensure the lowest possible impact on your server's performance.
- ? Smart Dependency Handling: No rigid requirements! BenthPinata uses a smart hologram system. It prioritizes ProtocolLib for smooth, packet-based holograms. If not found, it falls back to DecentHolograms. If neither is available, the plugin runs perfectly without holograms, ensuring it never breaks your server.
- ? Ultimate Flexibility: Create the event of your dreams by customizing nearly every setting across
config.yml, rewards.yml, and abilities.yml.
- ✅ Active Development: A project that is consistently updated and values community feedback.
? Core Features
- Unlimited Piñata Types: Create as many Piñata types as you want, each with different health, locations, and abilities.
Advanced Mob Support: Make your Piñata not just a sheep, but a Zombie, Horse, Llama, or even a fully custom entity using NBT tags!
- Advanced Ability System: Trigger special abilities as the Piñata's health drops, such as knocking back nearby players, blinding them, or applying negative potion effects.
- Comprehensive Reward Mechanics:
- Per-Hit Rewards: Players can win small, chance-based rewards with every hit.
- Damage Thresholds: Give guaranteed rewards to players who reach specific damage milestones.
- Final Rewards: Honor the top damage dealers with incredible prizes when the event ends.
- Dynamic Visual Feedback:
- Smart Hologram System: Displays the Piñata's health dynamically. It uses high-performance, packet-based holograms with ProtocolLib (recommended), falls back to DecentHolograms, or works without any hologram dependency.
- Boss Bar: A built-in Boss Bar provides real-time health tracking for all nearby players.
- Stunning Effects: Engaging particle and sound effects make the event feel alive.
- Automatic Event System:
- Start events automatically at set intervals (e.g., every 2 hours).
- Trigger an event when the server's player count reaches a certain threshold.
- Schedule events for specific days and times (e.g., every Friday at 8:00 PM).
- Statistics & Leaderboards: Track players' total damage and Piñata kills. Use the
/pinata stats top command to list the best players.
- PlaceholderAPI Support: Display plugin stats and leaderboards in other plugins like scoreboards, menus, and more.
- Easy Management: Manage events effortlessly with simple, permission-based commands.
✅ Supported Versions
This plugin is built on modern server APIs and has been tested for compatibility across a wide range of versions.
| Minecraft Version |
Support Status |
Minecraft Version |
Support Status |
| 1.21.X |
✅ Compatible |
1.16.X |
✅ Compatible |
| 1.20.X |
✅ Compatible |
1.15.X |
✅ Compatible |
| 1.19.X |
✅ Compatible |
1.14.X |
✅ Compatible |
| 1.18.X |
✅ Compatible |
1.13.X |
✅ Compatible |
| 1.17.X |
✅ Compatible |
1.12.X & Older |
❌ Incompatible |
? Installation
- Download the Plugin: Grab the latest
.jar file from the Releases page.
- Install Dependencies (Optional but Recommended):
- For the best experience (Packet Holograms): Install ProtocolLib.
- For an alternative (Block-based Holograms): If you don't use ProtocolLib, you can install DecentHolograms.
- For placeholder support: It is highly recommended to install PlaceholderAPI.
- Reminder: The plugin works perfectly even if no hologram plugin is installed!
- Upload Files: Place the downloaded
BenthPinata.jar file (and any dependencies) into your server's plugins folder.
- Start the Server: Start your server. The necessary configuration files (
config.yml, messages.yml, etc.) will be automatically generated in the plugins/BenthPinata folder.
- Configure: Edit
config.yml to set your Piñata's spawn location and other settings. Use the /pinata reload command in-game to apply your changes.
? Commands and Permissions
Note: You can use /pinataevent or /pinyata as aliases for the main command /pinata.
| Command |
Description |
Permission |
/pinata help |
Shows the help menu. |
benthpinata.command.help |
/pinata start <type> [location] |
Starts a Piñata event of the specified type. |
benthpinata.command.start |
/pinata list |
Lists all active Piñatas. |
benthpinata.command.list |
/pinata kill <id> |
Kills the Piñata with the specified ID. |
benthpinata.command.kill |
/pinata killall |
Kills all active Piñatas and stops all tasks. |
benthpinata.command.killall |
/pinata reload |
Reloads the entire plugin configuration. |
benthpinata.command.reload |
/pinata stats |
Shows your own Piñata statistics. |
benthpinata.stats |
/pinata stats top <damage|kills> |
Lists the top players by damage or kills. |
benthpinata.stats.top |
/pinata stats reset <player|all> |
Resets the stats for a player or for everyone. |
benthpinata.stats.reset |
| (All Permissions) |
Grants access to all of the commands above. |
benthpinata.admin |
⚙️ Configuration Files
The plugin stores all its settings in the plugins/BenthPinata/ directory.
config.yml: Contains main settings like Piñata types, locations, health, effects, and the auto-event system.
messages.yml: Contains all user-facing messages, titles, and hologram texts. Fully translatable.
rewards.yml: Defines all reward commands and their chances for per-hit, damage-threshold, and final rewards.
abilities.yml: Defines the special abilities for your Piñata types.
stats.yml: The data file where player statistics are stored. It's not recommended to edit this file manually.
?️ Example Configuration
Here is a small snippet from config.yml to show its flexibility:
pinata-types:
# A Zombie Piñata named 'dungeon' that glows and has no AI
dungeon:
spawn-location: 'world;15;70;25'
health: 250
entity-type: 'ZOMBIE'
mob-options:
is-baby: false
glowing: true
custom-name: '&4&lDUNGEON PIÑATA'
custom-name-visible: true
# This ensures the Piñata is silent and does not move.
nbt-data: '{ "Silent": 1b, "NoAI": 1b }'
? PlaceholderAPI Support
If PlaceholderAPI is installed on your server, you can use the following placeholders to display BenthPinata data in other plugins.
Player Statistics
%bp_stats_damage% - Shows the player's total damage dealt to Piñatas.
%bp_stats_kills% - Shows the player's total number of Piñata kills.
Leaderboards
%bp_top_damage_<rank>_name% - Shows the name of the player at <rank> on the damage leaderboard (e.g., %bp_top_damage_1_name%).
%bp_top_damage_<rank>_value% - Shows the damage value of the player at <rank>.
%bp_top_kills_<rank>_name% - Shows the name of the player at <rank> on the kills leaderboard.
%bp_top_kills_<rank>_value% - Shows the kill count of the player at <rank>.
? Support and Feedback
If you find a bug or have a feature suggestion, please open an issue on the GitHub Issues page.
? License
This project is licensed under the MIT License, which supports free and open-source software. Check the LICENSE file for more details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧