VulcanPinata 🪅
专为你的 Paper 服务器设计的完全自动化彩罐活动。 一只色彩斑斓、四处逃窜的羊驼会在竞技场中生成,所有玩家蜂拥而上击打它,当它最终破裂时,排名靠前的玩家以及所有参与过的玩家都会获得奖励 🎁。
你可以手动倒计时启动活动,或者将其设置为 每日/每周计划 📅,让服务器自动完成其余工作。所有内容均可配置:奖励、能力、消息、音效、语言,甚至包括 Discord 公告。
要求: Paper 1.21+ 和 Java 21 ☕。此插件仅使用 Paper 专属 API,因此 不支持 Spigot 和 Bukkit。
亮点
- 快速移动的逃跑羊驼 🦙,不断选择新路径并远离附近的玩家
- 生命值随在线玩家数量缩放,无论是在安静的服务器还是繁忙的服务器上,活动体验都恰到好处
- 随机触发能力:每次击中时可能触发传送、击退、抛射以及缩小为幼崽形态的能力
- 加权奖励池:分别针对参与者和前三名 🏆
- 倒计时与计划 ⏱️,支持时区设置
- Boss 栏显示剩余击打次数和时间,世界范围聊天、标题音效和声音提示
- Discord Webhook 嵌入 🤖,用于活动开始和结束的通知
- PlaceholderAPI 支持记分板、全息图和标签页列表
- 多语言 🌐(包含英语和匈牙利语,几分钟内即可添加你自己的语言)
- 内置更新检查器(Modrinth)
工作原理
- 管理员通过
/vp start 启动活动(或按计划自动启动)。
- 服务器通过声音向全服播报倒计时。
- 彩罐在你配置的出生点生成,并在你的竞技场范围内漫游。
- 玩家击打它。每位玩家都有短暂的击中冷却时间,因此疯狂点击毫无意义,公平竞技者获胜。
- 当击打次数耗尽或活动计时器结束时,彩罐被摧毁。
- 显示 TOP 3 排行榜 🏆,播放标题和烟花 🎆,并发放奖励 🎁。
如果在彩罐被摧毁之前时间耗尽,仍会根据已取得的进度发放奖励。
彩罐详情
| 特性 |
说明 |
| 实体 |
一只驯服的羊驼 🦙,无敌、无声、无掉落、无经验值,无法被骑乘或成为怪物攻击目标 |
| 生命值 |
可配置的基础生命值,可选择性地乘以在线玩家数量,并设有最大上限 |
| 移动方式 |
具备持续重新规划路径的路径寻找算法,速度可调,具有逃跑行为(半径和强度),并可定义漫游区域 |
| 闲置返回 |
如果在规定时间内无人击打,它会返回出生点 |
| 视觉效果 |
循环变化的地毯颜色、发光颜色、彩虹 Boss 栏、循环变化的羊驼毛色和名字颜色、粒子效果以及烟花终章 |
| 全息图 |
在其头顶显示剩余击打次数 |
能力
每次击中都有可配置的概率触发随机能力。每种能力都可以单独启用或禁用,并具有各自的发生概率、强度和音效。
- 传送 - 瞬移到竞技场内的随机安全位置
- 击退 - 将附近的玩家推开
- 抛射 - 飞向空中
- 幼崽变形 - 短暂缩小为幼崽羊驼,持续几秒(独立掷骰判定,拥有独立的发生概率和持续时间范围)
奖励
奖励是普通的 控制台命令,因此它们适用于任何经济插件、宝箱插件、钥匙插件或物品插件。
- 参与奖励:给予达到最小击打次数的每位在线玩家
- 名次奖励:给予前三名的玩家
- 每个奖励列表都是一个 加权池:根据
chance 值精确抽取一个选项
- 每个选项可以执行 多条命令
- 命令中支持的占位符:
%player%、%hits%、%place%
rewards:
hit:
min-hits: 10
options:
- chance: 50
commands:
- "give %player% diamond 1"
- chance: 30
commands:
- "give %player% emerald 2"
- chance: 20
commands:
- "give %player% gold_ingot 5"
places:
1:
- chance: 60
commands:
- "give %player% diamond 10"
- chance: 40
commands:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
倒计时与计划
带倒计时的手动启动
/vp start # 默认延迟(1 分钟)
/vp start 5m
/vp start 1h 10m
时间格式:s(秒)、m(分)、h(小时)、d(天),可以组合使用。玩家会收到你设定的时间点公告,每个时间点都可配置独立的音效。
countdown:
default-delay: "1m"
announcements: ["60m", "30m", "10m", "5m", "1m", "30s", "10s", "5s", "3s", "2s", "1s"]
自动计划 📅
schedule:
enabled: true
timezone: "Europe/Budapest"
start-delay: "1m"
skip-if-active: true
skip-if-countdown: true
require-players:
enabled: false
minimum: 5
events:
- days: [MONDAY, WEDNESDAY, FRIDAY]
time: "18:00"
- days: [SATURDAY, SUNDAY]
time: "15:30"
- 多个计划槽位,支持任意天数组合
- 感知时区
- 可选的 最低在线玩家数 要求
- 如果已有活动或倒计时正在进行,则自动跳过
- 使用
/vp schedule 查看 upcoming 的计划槽位
2 分钟快速设置 ⚙️
- 将
VulcanPinata-*.jar 放入你的 plugins/ 文件夹并启动服务器。
- 站在希望彩罐生成的位置,运行
/vp setspawn。
- 运行
/vp wand,左键点击 竞技场的一个角,右键点击 对角。
- 运行
/vp setrange 保存漫游区域。
- 编辑
plugins/VulcanPinata/config.yml(奖励、计划、语言)并运行 /vp reload。
- 使用
/vp start 10s 进行测试。
漫游范围是必需的。 在设置好出生点和范围之前,活动不会启动。
命令与权限 ⌨️
别名: /vulcanpinata, /pinata, /vpinata, /vp
| 命令 |
描述 |
/vp help |
显示命令列表 |
/vp setspawn |
将皮纳塔刷新点保存至你所在的位置 |
/vp wand |
获取选择法杖(金斧) |
/vp setrange |
基于你用法杖选择的区域保存漫游范围 |
/vp clearrange |
清除漫游范围 |
/vp start [time] |
在倒计时后开始活动(别名:spawn) |
/vp stop |
停止倒计时并移除当前的皮纳塔(别名:removeall) |
/vp schedule |
列出已计划的活动 |
/vp info |
显示当前活动的状态(别名:status) |
/vp reload |
重载配置文件、语言、刷新点和计划表 |
| 权限 |
默认值 |
描述 |
vulcanpinata.admin |
OP |
所有命令,以及加入时收到更新通知 |
普通玩家不需要任何权限。他们只需击打羊驼即可。
PlaceholderAPI 🔌
安装 PlaceholderAPI(可选)以便在任何地方使用这些占位符:
| 占位符 |
描述 |
%vulcanpinata_active% |
yes 或 no |
%vulcanpinata_hits_left% |
剩余打击次数 |
%vulcanpinata_hits% |
皮纳塔初始的总打击次数 |
%vulcanpinata_time_left% |
活动中剩余的秒数 |
%vulcanpinata_my_hits% |
当前查看玩家在本次活动中获得的打击次数 |
%vulcanpinata_top1%, _top2%, _top3% |
排行榜条目(名称和打击次数) |
%vulcanpinata_next_event% |
下一次计划的活动,以文本形式显示 |
%vulcanpinata_next_event_seconds% |
距离下一次计划活动的秒数 |
Discord 集成 🤖
在你的 Discord 服务器中通过完全可自定义的嵌入消息来公告活动。设置一个 Webhook URL 并编辑 start 和 end 嵌入消息:颜色、标题、描述、图片和缩略图。
discord:
enabled: true
webhook-url: "https://discord.com/api/webhooks/..."
embeds:
start:
color: "#C084FC"
title: "Pinata event started"
description: "World: **%world%**\nCoordinates: `%x% %y% %z%`"
end:
color: "#F472B6"
title: "Pinata event over"
description: "**TOP 3**\n1. %top1%\n2. %top2%\n3. %top3%"
若要将图片或缩略图留空,请将 image-url 或 thumbnail-url 设为空。
消息与语言 🌐
所有面向玩家显示的文本都位于 lang/<code>.yml 文件中:聊天信息、Boss 栏、全息图、标题、排行榜、帮助信息和时间单位。
- 内置语言:English (
en) 和 Hungarian (hu)
- 在
config.yml 中使用 language: hu 切换语言
- 要添加新语言,请复制
lang/en.yml 到 lang/de.yml,进行翻译,然后设置 language: de
- 支持 MiniMessage(渐变、悬停、点击等)、十六进制颜色(
&#RRGGBB, <#RRGGBB>)以及传统的 & 代码
兼容性与安全性
- Paper 1.21+,Java 21
- 兼容 WorldGuard: 即使在被禁止刷怪的区域,插件也能生成皮纳塔
- 防崩溃安全: 皮纳塔实体带有标签,崩溃或强制停止后的残留物会在启动时自动清理
- 仅限世界范围: 消息、标题、音效和 Boss 栏仅发送给处于皮纳塔所在世界的玩家
- 同一时间只能有一个皮纳塔
- 皮纳塔和全息图受到保护,免受伤害、骑乘和怪物攻击
- 无依赖项。 PlaceholderAPI 为可选
指标与更新
- 使用 bStats 收集匿名使用统计数据(语言、计划表开关、Discord 开关)。不收集任何玩家数据。你可以在全局的
plugins/bStats/config.yml 中选择退出。
- 内置的更新检查器会查询 Modrinth API,并在玩家加入时向拥有
vulcanpinata.admin 权限的管理员发送通知。可通过设置 update-checker.enabled: false 禁用此功能。
支持
发现错误或有任何功能请求?请使用本页面的 Issues 标签页或直接联系作者。
作者: VulcanStudio
如果你喜欢这个插件,请在 Modrinth 上关注或留下评论,这将非常有帮助。谢谢!
VulcanPinata 🪅
A fully automated pinata event for your Paper server. A colorful, fleeing llama spawns in your arena, everyone rushes to hit it, and when it finally pops, the top players and everyone who took part get rewarded 🎁.
Run events manually with a countdown, or put them on a daily/weekly schedule 📅 and let the server do the rest. Everything is configurable: rewards, abilities, messages, sounds, languages, and even Discord announcements.
Requirements: Paper 1.21+ and Java 21 ☕. This plugin uses Paper-only APIs, so Spigot and Bukkit are not supported.
Highlights
- Fast, fleeing llama 🦙 that constantly picks new paths and runs away from nearby players
- Health scales with online players, so the event feels right on a quiet server and a busy one
- Random abilities on hits: teleport, knockback, launch, and a baby-size transform
- Weighted reward pools for participation and for the top 3 places 🏆
- Countdowns and schedules ⏱️ with timezone support
- Boss bar with remaining hits and time, world-scoped chat, titles, and sounds
- Discord webhook embeds 🤖 for event start and end
- PlaceholderAPI support for scoreboards, holograms, and tab lists
- Multi-language 🌐 (English and Hungarian included, add your own in minutes)
- Built-in update checker (Modrinth)
How it works
- An admin starts an event with
/vp start (or the schedule does it automatically).
- A countdown is announced to the world with sounds.
- The pinata spawns at your configured spawn point and roams inside your arena.
- Players hit it. Each player has a short hit cooldown, so spam-clicking is pointless and fair play wins.
- The pinata is destroyed when its hits run out, or the event timer expires.
- A TOP 3 leaderboard is shown 🏆, titles and fireworks play 🎆, and rewards are handed out 🎁.
If time runs out before the pinata is destroyed, rewards are still given for the progress made.
The pinata
| Feature |
Details |
| Entity |
A tamed llama 🦙, invulnerable, silent, no loot, no XP, cannot be ridden or targeted by mobs |
| Health |
Configurable base health, optionally multiplied by the number of online players, with a configurable cap |
| Movement |
Pathfinding with constant re-routing, adjustable speed, flee behavior (radius and strength), and a roam area you define |
| Idle return |
Returns to spawn if nobody hits it for a configurable time |
| Visuals |
Cycling carpet colors, cycling glow colors, rainbow boss bar, cycling llama coat and name colors, particles, and a firework finale |
| Hologram |
Shows the remaining hits above its head |
Abilities
Each hit has a configurable chance to trigger a random ability. Every ability can be enabled or disabled and has its own chance, strength, and sound.
- Teleport - jumps to a random nearby safe spot inside the arena
- Knockback - shoves nearby players away
- Launch - flies up into the air
- Baby transform - briefly shrinks to a baby llama for a few seconds (rolled separately, with its own chance and duration range)
Rewards
Rewards are plain console commands, so they work with any economy, crate, key, or item plugin.
- Participation reward for every online player who reaches the minimum hit count
- Placement rewards for the top 3 players
- Each reward list is a weighted pool: exactly one option is picked using the
chance values
- Each option can run multiple commands
- Supported placeholders in commands:
%player%, %hits%, %place%
rewards:
hit:
min-hits: 10
options:
- chance: 50
commands:
- "give %player% diamond 1"
- chance: 30
commands:
- "give %player% emerald 2"
- chance: 20
commands:
- "give %player% gold_ingot 5"
places:
1:
- chance: 60
commands:
- "give %player% diamond 10"
- chance: 40
commands:
- "eco give %player% 5000"
- "crate key give %player% rare 1"
Countdowns and schedule
Manual start with countdown
/vp start # default delay (1 minute)
/vp start 5m
/vp start 1h 10m
Time formats: s, m, h, d, and they can be combined. Players get announcements at the times you choose, each with its own configurable sound.
countdown:
default-delay: "1m"
announcements: ["60m", "30m", "10m", "5m", "1m", "30s", "10s", "5s", "3s", "2s", "1s"]
Automatic schedule 📅
schedule:
enabled: true
timezone: "Europe/Budapest"
start-delay: "1m"
skip-if-active: true
skip-if-countdown: true
require-players:
enabled: false
minimum: 5
events:
- days: [MONDAY, WEDNESDAY, FRIDAY]
time: "18:00"
- days: [SATURDAY, SUNDAY]
time: "15:30"
- Multiple schedule slots with any combination of days
- Timezone aware
- Optional minimum online players requirement
- Skips automatically if an event or countdown is already running
- Use
/vp schedule to list upcoming slots
Setup in 2 minutes ⚙️
- Drop
VulcanPinata-*.jar into your plugins/ folder and start the server.
- Stand where the pinata should spawn and run
/vp setspawn.
- Run
/vp wand, left-click one corner and right-click the opposite corner of your arena.
- Run
/vp setrange to save the roam area.
- Edit
plugins/VulcanPinata/config.yml (rewards, schedule, language) and run /vp reload.
- Test it with
/vp start 10s.
The roam range is required. An event will not start until both a spawn point and a range are set.
Commands and permissions ⌨️
Aliases: /vulcanpinata, /pinata, /vpinata, /vp
| Command |
Description |
/vp help |
Show the command list |
/vp setspawn |
Save the pinata spawn at your location |
/vp wand |
Get the selection wand (golden axe) |
/vp setrange |
Save the roam area from your wand selection |
/vp clearrange |
Clear the roam area |
/vp start [time] |
Start an event after a countdown (alias: spawn) |
/vp stop |
Stop the countdown and remove the active pinata (alias: removeall) |
/vp schedule |
List scheduled events |
/vp info |
Show the status of the current event (alias: status) |
/vp reload |
Reload config, language, spawn and schedule |
| Permission |
Default |
Description |
vulcanpinata.admin |
OP |
All commands, plus update notifications on join |
Regular players need no permissions. They simply hit the llama.
PlaceholderAPI 🔌
Install PlaceholderAPI (optional) to use these anywhere:
| Placeholder |
Description |
%vulcanpinata_active% |
yes or no |
%vulcanpinata_hits_left% |
Hits remaining |
%vulcanpinata_hits% |
Total hits the pinata started with |
%vulcanpinata_time_left% |
Seconds left in the event |
%vulcanpinata_my_hits% |
The viewing player's hits this event |
%vulcanpinata_top1%, _top2%, _top3% |
Leaderboard entries (name and hits) |
%vulcanpinata_next_event% |
Next scheduled event, as text |
%vulcanpinata_next_event_seconds% |
Seconds until the next scheduled event |
Discord integration 🤖
Announce events in your Discord server with fully customizable embeds. Set a webhook URL and edit the start and end embeds: color, title, description, image, and thumbnail.
discord:
enabled: true
webhook-url: "https://discord.com/api/webhooks/..."
embeds:
start:
color: "#C084FC"
title: "Pinata event started"
description: "World: **%world%**\nCoordinates: `%x% %y% %z%`"
end:
color: "#F472B6"
title: "Pinata event over"
description: "**TOP 3**\n1. %top1%\n2. %top2%\n3. %top3%"
Leave image-url or thumbnail-url empty to leave them out.
Messages and languages 🌐
Every player-facing text lives in lang/<code>.yml: chat, boss bar, hologram, titles, leaderboard, help, and time units.
- Included languages: English (
en) and Hungarian (hu)
- Switch with
language: hu in config.yml
- To add a language, copy
lang/en.yml to lang/de.yml, translate it, and set language: de
- Supports MiniMessage (gradients, hover, click, and so on), hex colors (
&#RRGGBB, <#RRGGBB>), and legacy & codes
Compatibility and safety
- Paper 1.21+, Java 21
- WorldGuard friendly: the plugin can spawn its pinata even in regions where mob spawning is denied
- Crash safe: pinata entities are tagged, and leftovers from crashes or forced stops are cleaned up automatically on startup
- World scoped: messages, titles, sounds, and the boss bar only go to players in the pinata's world
- Only one pinata at a time
- Pinata and hologram are protected from damage, mounting, and mob targeting
- No dependencies. PlaceholderAPI is optional
Metrics and updates
- Uses bStats for anonymous usage statistics (language, schedule on/off, Discord on/off). No player data is collected. You can opt out in the global
plugins/bStats/config.yml.
- The built-in update checker queries the Modrinth API and notifies admins with
vulcanpinata.admin on join. Disable it with update-checker.enabled: false.
Support
Found a bug or have a feature request? Please use the Issues tab on this page or contact the author.
Author: VulcanStudio
If you enjoy the plugin, a follow or a review on Modrinth helps a lot. Thank you!
评论 0
登录后参与评分
还没有评论,来抢沙发吧