VulcanPinata

插件

· 作者 VulcanStudio

VulcanPinata 是一款适用于 Minecraft 1.21+ 的动态且高度可配置的事件插件,玩家组队击败互动式羊驼皮纳塔以获取史诗级奖励。该插件支持自动调度、Boss 条、自定义 Discord 嵌入消息以及 PlaceholderAPI 兼容功能

0 本站下载 0 关注 更新于 1 周前

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

VulcanPinata 🪅

专为你的 Paper 服务器设计的完全自动化彩罐活动。 一只色彩斑斓、四处逃窜的羊驼会在竞技场中生成,所有玩家蜂拥而上击打它,当它最终破裂时,排名靠前的玩家以及所有参与过的玩家都会获得奖励 🎁。

你可以手动倒计时启动活动,或者将其设置为 每日/每周计划 📅,让服务器自动完成其余工作。所有内容均可配置:奖励、能力、消息、音效、语言,甚至包括 Discord 公告。

要求: Paper 1.21+ 和 Java 21 ☕。此插件仅使用 Paper 专属 API,因此 不支持 Spigot 和 Bukkit。


亮点

  • 快速移动的逃跑羊驼 🦙,不断选择新路径并远离附近的玩家
  • 生命值随在线玩家数量缩放,无论是在安静的服务器还是繁忙的服务器上,活动体验都恰到好处
  • 随机触发能力:每次击中时可能触发传送、击退、抛射以及缩小为幼崽形态的能力
  • 加权奖励池:分别针对参与者和前三名 🏆
  • 倒计时与计划 ⏱️,支持时区设置
  • Boss 栏显示剩余击打次数和时间,世界范围聊天、标题音效和声音提示
  • Discord Webhook 嵌入 🤖,用于活动开始和结束的通知
  • PlaceholderAPI 支持记分板、全息图和标签页列表
  • 多语言 🌐(包含英语和匈牙利语,几分钟内即可添加你自己的语言)
  • 内置更新检查器(Modrinth)

工作原理

  1. 管理员通过 /vp start 启动活动(或按计划自动启动)。
  2. 服务器通过声音向全服播报倒计时。
  3. 彩罐在你配置的出生点生成,并在你的竞技场范围内漫游。
  4. 玩家击打它。每位玩家都有短暂的击中冷却时间,因此疯狂点击毫无意义,公平竞技者获胜。
  5. 当击打次数耗尽或活动计时器结束时,彩罐被摧毁。
  6. 显示 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 分钟快速设置 ⚙️

  1. 将 VulcanPinata-*.jar 放入你的 plugins/ 文件夹并启动服务器。
  2. 站在希望彩罐生成的位置,运行 /vp setspawn。
  3. 运行 /vp wand,左键点击 竞技场的一个角,右键点击 对角。
  4. 运行 /vp setrange 保存漫游区域。
  5. 编辑 plugins/VulcanPinata/config.yml(奖励、计划、语言)并运行 /vp reload。
  6. 使用 /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 上关注或留下评论,这将非常有帮助。谢谢!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源