CreeperConfettiPro:CreeperConfetti 的非官方分支,专为高版本服务器打造

作为 Minecraft 服务器管理员,你是否曾因为经典的 CreeperConfetti 插件无法在现代服务器上运行而感到失望?你是否希望 1.20+ 甚至 1.21+ 服务器上的苦力怕爆炸不再是单调的破坏,而是满屏绚烂的烟花和彩纸?
CreeperConfettiPro —— CreeperConfetti 的升级版分支,专为高版本服务器构建,将经典乐趣带入现代时代!
Wiki
欢迎加入我们的 Discord 社区服务器:
我可以在哪里使用 CreeperConfettiPro?
提供两个独立的构建版本——Bukkit 和 Folia。请选择与你的服务器核心相匹配的版本。
I. 插件用途
CreeperConfettiPro 是原版 CreeperConfetti 插件的官方升级版分支,其核心目标是完全兼容高版本的 Minecraft 服务器。
在保留原版所有趣味功能的同时,它解决了原版在 1.20 及以上版本中不兼容的问题——如无法运行、报错、命令无响应等——并彻底重构了命令系统、烟花系统和配置结构,让高版本服务器也能享受五彩斑斓的苦力怕爆炸。
II. 功能亮点
1. 广泛的跨版本支持
- 版本覆盖范围:
- Bukkit 构建版:支持包括 Spigot / Paper / Purpur 在内的主流服务器核心;
- Folia 构建版:原生支持 Folia 1.19.4 ~ 最新版本,通过区域化线程调度进行适配——不再出现“安装了却跑不起来”的情况。
2. 多种烟花样式 + 加权随机(4.0.0 新增)
- 随机样式:可配置任意数量的烟花样式;当苦力怕爆炸时,按概率随机抽取一种——每次都不重样;
- 独立概率:每种样式拥有独立的触发几率,并带有自动补偿机制——无论你怎么调整,总和始终保持在恰好 100%,永远不会出现“某个样式永远无法触发”或“概率浪费掉”的情况;
- 三种颜色格式:颜色名称(
RED,LIME, …)、十六进制(#FF0000/#f00)或 RGB 映射({RED: 255, GREEN: 0, BLUE: 0})——随你喜好选择; - 可调节形状:支持
BALL、BALL_LARGE、STAR、BURST和CREEPER等烟花形状,并可独立开启闪烁和拖尾效果。
3. 图形化管理 GUI(4.0.0 新增)
运行 /cc gui 打开完全交互式的界面——全程鼠标操作,无需再手动编辑配置文件:
- 样式列表:浏览每种样式及其概率,支持分页;
- 一键添加:将你手持的烟花转化为新样式;
- 概率调整:提供
-10 / -5 / -1 / +1 / +5 / +10 %按钮,并具备自动补偿功能; - 预览 / 删除 / 均分概率——全部包含在内。
III. 安装与使用
安装
- 下载与你服务器匹配的 CreeperConfettiPro JAR 文件(Bukkit 或 Folia 构建版);
- 将 JAR 文件放入服务器目录下的
plugins文件夹中; - 启动服务器。
命令
主要命令为 /creeperconfetti,别名为 /cc 和 /confetti。
| 命令 | 功能 | 权限 |
|---|---|---|
/cc help [page|command] |
显示帮助信息;聊天中的页码按钮可点击 | creeperconfetti.command |
/cc gui |
打开图形化管理器 | creeperconfetti.command.effect |
/cc effect list |
列出所有烟花样式及其概率 | creeperconfetti.command.effect |
/cc effect add [name] |
将你手中的烟花添加为新样式 | creeperconfetti.command.effect |
/cc effect set <name> |
用你手中的烟花覆盖指定样式 | creeperconfetti.command.effect |
/cc effect remove <name> |
删除一个样式 | creeperconfetti.command.effect |
/cc effect reset |
恢复默认样式 | creeperconfetti.command.effect |
/cc effect preview [name] |
预览某个样式 | creeperconfetti.command.effect |
/cc effect chance [name] [percent] |
查看 / 设置每个样式的概率 | creeperconfetti.command.effect |
/cc chance [0-100] |
查看 / 设置整体彩纸触发概率 | creeperconfetti.command.chance |
/cc language <info|list|set|reload> |
语言管理 | creeperconfetti.command.language |
/cc reload |
重新加载配置和烟花样式(无需重启服务器) | creeperconfetti.command.reload |
所有这些权限默认仅 OP 可用;授予父级权限
creeperconfetti.command即可解锁所有子命令。
IV. 为什么选择 CreeperConfettiPro?
- 完美的兼容性:Bukkit 构建版覆盖 1.8 ~ 最新版本,另配有原生 Folia 构建版(1.19.4 ~ 最新版本);
- 超越经典:保留了原版的所有内容,并增加了多种烟花样式、独立概率、图形化 GUI 和分页帮助;
- 持续维护:紧跟 Minecraft 新版本发布,确保长期可用性。
总结
要点
- CreeperConfettiPro 是 CreeperConfetti 的一个升级分支。其核心价值在于完全兼容高版本服务器,并提供 Bukkit 构建版(1.13 ~ 最新版) 和 Folia 构建版(1.19.4 ~ 最新版);
- 在保留原版所有乐趣(Creeper 爆炸彩纸效果、可配置参数、权限控制等)的同时,增加了大量新功能,包括多种带有加权随机性的烟花样式以及图形化管理 GUI。
在哪里获取 CreeperConfettiPro?
本插件是 CreeperConfetti 的非官方分支。请勿将本插件的问题反馈给官方 CreeperConfetti 团队——请将其反馈至官方 CreeperConfettiPro 仓库。
原始 CreeperConfetti 插件
原始插件页面:
Spoiler
使用统计
CreeperConfettiPro: An Unofficial Fork of CreeperConfetti for High-Version Servers

As a Minecraft server administrator, have you ever been disappointed that the classic CreeperConfetti plugin simply won't run on modern servers? Do you wish that Creeper explosions on 1.20+ and even 1.21+ servers were no longer dull destruction, but a screen full of dazzling fireworks and confetti?
CreeperConfettiPro — an upgraded branch of CreeperConfetti, built for high-version servers, bringing the classic fun into the modern era!
Wiki
Feel free to join our Discord community server:
Where can I use CreeperConfettiPro?
Two separate builds are provided — Bukkit and Folia. Choose the one that matches your server core.
I. What the Plugin Is For
CreeperConfettiPro is the official upgraded branch of the original CreeperConfetti plugin, and its core goal is full compatibility with high-version Minecraft servers.
While keeping every fun feature of the original version, it resolves the compatibility problems the original has on 1.20 and above — not working, throwing errors, unresponsive commands and so on — and it completely rebuilt the command system, the firework system and the configuration structure, so high-version servers can enjoy Creeper explosions in full color too.
II. Feature Highlights
1. Broad Multi-Version Support
- Version coverage:
- Bukkit build: supports mainstream server cores including Spigot / Paper / Purpur;
- Folia build: natively supports Folia 1.19.4 ~ latest, adapted through regionized thread scheduling — no more "installed it, but it won't run".
2. Multiple Firework Styles + Weighted Random (new in 4.0.0)
- Random styles: configure any number of firework styles; when a Creeper explodes, one is picked at random by probability — it is never the same every time;
- Independent chances: every style has its own trigger chance, with an automatic compensation mechanism — however you tune them, the total always stays at exactly 100%, so you will never end up with "a style that can never trigger" or "probability left unused";
- Three color formats: color names (
RED,LIME, …), hex (#FF0000/#f00) or RGB maps ({RED: 255, GREEN: 0, BLUE: 0}) — whichever you prefer; - Adjustable shapes: supports firework shapes such as
BALL,BALL_LARGE,STAR,BURSTandCREEPER, with independent flicker and trail toggles.
3. Graphical Management GUI (new in 4.0.0)
Run /cc gui to open a fully interactive interface — everything by mouse, no more hand-editing config files:
- Style list: browse every style and its chance, with pagination;
- One-click add: turn the firework you are holding into a new style;
- Chance tuning:
-10 / -5 / -1 / +1 / +5 / +10 %buttons with automatic compensation; - Preview / delete / equalize — all included.
III. Installation & Usage
Installation
- Download the CreeperConfettiPro JAR that matches your server (Bukkit or Folia build);
- Drop the JAR into the
pluginsfolder of your server directory; - Start the server.
Commands
The main command is /creeperconfetti, with the aliases /cc and /confetti.
| Command | What it does | Permission |
|---|---|---|
/cc help [page|command] |
Show help; page buttons are clickable in chat | creeperconfetti.command |
/cc gui |
Open the graphical manager | creeperconfetti.command.effect |
/cc effect list |
List all firework styles and their chances | creeperconfetti.command.effect |
/cc effect add [name] |
Add the firework in your hand as a new style | creeperconfetti.command.effect |
/cc effect set <name> |
Overwrite a style with the firework in your hand | creeperconfetti.command.effect |
/cc effect remove <name> |
Delete a style | creeperconfetti.command.effect |
/cc effect reset |
Restore the default styles | creeperconfetti.command.effect |
/cc effect preview [name] |
Preview a style | creeperconfetti.command.effect |
/cc effect chance [name] [percent] |
View / set the chance of each style | creeperconfetti.command.effect |
/cc chance [0-100] |
View / set the overall confetti chance | creeperconfetti.command.chance |
/cc language <info|list|set|reload> |
Language management | creeperconfetti.command.language |
/cc reload |
Reload the config and firework styles (no restart needed) | creeperconfetti.command.reload |
All of these permissions default to OP only; granting the parent permission
creeperconfetti.commandopens up every subcommand.
IV. Why Choose CreeperConfettiPro?
- Compatibility done right: the Bukkit build covers 1.8 ~ latest, plus a native Folia build (1.19.4 ~ latest);
- More than the classic: keeps everything from the original and adds multiple firework styles, independent chances, a graphical GUI and paginated help;
- Continuously maintained: keeps up with new Minecraft releases to guarantee long-term usability.
Summary
Key Points
- CreeperConfettiPro is an upgraded branch of CreeperConfetti. Its core value is full compatibility with high-version servers, and it ships a Bukkit build (1.13 ~ latest) and a Folia build (1.19.4 ~ latest);
- While keeping all the fun of the original (Creeper explosion confetti effects, configurable parameters, permission control, etc.), it adds a great deal of new capability, including multiple firework styles with weighted randomness and a graphical management GUI.
Where can I get CreeperConfettiPro?
This plugin is an unofficial fork of CreeperConfetti. Please do not report issues with this plugin to the official CreeperConfetti team — report them to the official CreeperConfettiPro repository instead.
Original CreeperConfetti plugin
Original plugin page:
Spoiler
Usage Statistics
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CreeperConfettiPro
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
CreeperConfettiPro 4.2.0 官方发布
4.2.0 是首个专注于“服务器运维体验”的正式版本:它增加了自动更新检查、GitHub Token 支持、配置文件自动迁移以及控制台消息改进,同时移除了未达预期的实验性爆炸保护功能。
下载
| 平台 | 文件 |
|---|---|
| Spigot / Paper | CreeperConfettiPro-4.2.0-bukkit.jar |
| Folia | CreeperConfettiPro-4.2.0-folia.jar |
- 仓库:
- Issue 追踪器:
- Discord:
- Wiki:
本版新增内容
1. 自动更新检查
- 启动后 5 秒,在后台异步请求 GitHub Releases,不阻塞主线程
- 发现新版本时,控制台会输出最新版本号和下载链接
- 当有 OP(管理员)加入服务器时,他们会收到一次包含可点击下载链接的通知
- 可以分别禁用更新检查和通知:
update-checker:
enabled: true
notify-ops: true
2. GitHub Token 支持 (60 次/小时 → 5000 次/小时)
对 GitHub API 的匿名访问配额仅为每个 IP 每小时 60 次请求。托管提供商和云服务器上的共享出口 IP 经常耗尽此配额,导致控制台出现 HTTP 403 错误。现在您可以输入个人访问令牌来提高配额:
update-checker:
github-token: "ghp_xxxxxxxx"
您也可以使用环境变量(推荐;令牌不会写入配置文件,也不会包含在 backups/ 备份中):
CREEPERCONFETTI_GITHUB_TOKEN
- 令牌仅需
public_repo作用域: - 当配额耗尽时,插件会清晰报告原因、当前配额和重置时间,而不仅仅是抛出异常
- 令牌相当于密码。如果泄露,请立即在 GitHub 上撤销它
3. 配置文件自动迁移 (config-version 6)
- 升级期间,旧配置文件会自动备份到
plugins/CreeperConfettiPro/backups/ - 缺失的条目会根据捆绑的默认配置进行填充,并且您已填写的所有值都会保留
- 新的
github-token条目会自动出现在您的配置文件中
4. 可配置的命令别名
/cc 和 /confetti 现在在运行时动态注册,可以根据需要禁用以避免与其他插件在命令上发生冲突:
command-aliases:
enabled: true
cc: true
confetti: true
5. 控制台消息改进
启动横幅包括版本号、作者、Discord、Java 版本和当前语言;当 debug: true 时,还会额外输出烟花样式列表和概率分布。
现有 4.x 功能回顾
- 多种烟花样式:内置
classic、starburst、rainbow和creeper,可以自由添加或删除 - 自动概率权重归一化:
firework_chances可以使用任意权重,插件会自动补偿它们以总计 100% - 游戏内管理:
/cc effect list、/cc effect add <name>(手持烟花时执行)、/cc effect chance - 可视化 GUI:通过
/cc gui查看和编辑所有样式 - 18 种语言:简体中文、繁体中文、英文、日文、韩文、法文、德文、西班牙文、俄文等,支持自动 GeoIP 匹配
- 完整 Folia 支持:所有调度都通过实体 / 区域 / 全局调度器进行,不再残留任何
Bukkit.getScheduler()调用
变更与移除
- 移除
explosion-protection(no-damage/no-destroy):此实验性功能不可靠,4.2.0 正式发行版不再包含它。旧配置中残留的相关部分将被忽略,可以手动删除 - 控制台不再打印 Website 行
兼容性
| 构建 | 服务器 | 字节码 |
|---|---|---|
-bukkit |
Spigot / Paper 1.9.4 及以上 (api-version: 1.13) |
Java 8 |
-folia |
Folia 1.19.4 及以上 | Java 17 |
升级步骤
- 备份旧的 jar 文件和
plugins/CreeperConfettiPro/目录 - 用对应平台的 4.2.0 jar 替换旧文件
- 重启服务器(配置文件将自动迁移到版本 6)
- 可选:填写
update-checker.github-token,或设置环境变量CREEPERCONFETTI_GITHUB_TOKEN
CreeperConfettiPro 4.1.0 官方发布
下载构建版本: CreeperConfettiPro-4.1.0-bukkit.jar / CreeperConfettiPro-4.1.0-folia.jar
4.1.0 是重大重构版本 4.0 之后的首个功能更新,重点在于“命令兼容性”:它解决了在某些服务器上 /cc 和 /confetti 与其他插件的命令发生冲突且管理员无法禁用它们的问题,并使帮助文本能够自动适应别名状态。
本次更新亮点
1. 命令别名可自由切换
现在可以在配置文件中单独启用或禁用 /cc 和 /confetti,以避免与其他插件产生命令冲突。
command-aliases:
enabled: true # 总开关
cc: true # /cc
confetti: true # /confetti
- 默认全部启用,因此升级后的行为与旧版本完全一致;
- 禁用某个别名后,该命令将不再存在,而其他命令继续正常工作;
- 在注册之前,会检查该命令是否已被其他插件占用:如果被占用,则自动跳过注册并打印警告信息,从而不会劫持其他插件的命令;
- 修改完成后,运行
/cc reload(如果/cc已禁用,则运行/creeperconfetti reload)即可立即生效,无需重启服务器。
2. 帮助文本自动适配
当 /cc 不可用时,帮助和通知消息中的所有 /cc 引用都会自动替换为 /creeperconfetti,这样用户就不会再因为提示输入 /cc 却被告知命令不存在而感到困惑。
| 场景 | 帮助中的显示方式 |
|---|---|
/cc 已注册(默认) |
/cc effect list |
/cc 通过配置文件禁用 |
/creeperconfetti effect list |
/cc 被其他插件占用 |
/creeperconfetti effect list |
这涵盖了所有帮助行、使用提示、未知子命令消息和控制台分页提示,并且在所有 18 种语言中自动生效。
3. 修复损坏的帮助分页按钮
可点击的页面导航/页码按钮此前硬编码执行 /cc help N,在 /cc 被禁用后会执行不存在的命令;现在它们遵循实际可用的标签,因此点击始终有效。
升级说明
- 只需替换 jar 文件并重启服务器,无需手动更改配置;
- 配置版本
config-version已从 2 提升至 3:首次启动时,旧配置会自动备份到plugins/CreeperConfettiPro/backups/,并在config.yml中添加command-aliases部分。您现有的所有设置均得以保留; - 如果您之前手动删除了
command-aliases部分,插件将以默认值运行(全部启用)。
兼容性
| 构建版本 | 编译依赖 | 支持版本 |
|---|---|---|
| Bukkit | spigot-api 1.9.4 (api-version: 1.13) |
Spigot / Paper / Purpur 1.13 ~ 最新版 |
| Folia | folia-api 1.19.4, Java 17 字节码 |
Folia 1.19.4 ~ 最新版 |
这两个构建版本不能互换使用:Folia 构建依赖于区域化调度 API,只能在 Folia 上运行;Bukkit 构建未声明
folia-supported,将被 Folia 拒绝加载。
安装
- 选择与您的服务器匹配的构建版本(Bukkit 构建或 Folia 构建);
- 将 jar 文件放入
plugins目录; - 重启服务器;
这是一个重大版本更新:命令系统、烟花系统、国际化以及兼容性层进行了全面重构。
新增内容
-
子命令系统:
/cc help | effect | gui | chance | language | reload。支持别名、分层标签补全以及细粒度权限控制(creeperconfetti.command.{effect,chance,language,reload})。 -
多种烟花样式:每种样式可包含一个或多个烟花效果。当苦力怕爆炸时,会根据权重随机选择一种样式。颜色支持三种格式:颜色名称 / 十六进制值(
#FF0000)/ RGB 值。 -
样式概率系统:使用
/cc effect chance <style> <percentage>自由配置每种样式的触发概率。包含自动平衡机制,确保总概率始终保持在 100%。 -
GUI 视觉管理器:通过
/cc gui进行可视化操作——分页列表、预览、创建新样式、删除样式、按 ±1/5/10% 调整概率,以及均匀分配概率。 -
分页帮助界面:聊天栏中可点击的
[Prev] [1] [2] [3] [Next]页码控件。同时也支持/cc help <页码> -
备用 GeoIP 区域检测:并行查询 6 个 GeoIP 端点,采用最快成功响应。单个端点失败不会导致检测中断
-
配置迁移系统:使用
config-version标识符。升级时,旧配置文件会自动备份至backups/文件夹,新的配置项会被合并,同时保留现有的用户数据。 -
完整的 18 语言支持(
zh_cn/zh_tw/en_us/ja_jp/ko_kr/fr_fr/de_de/es_es/it_it/pt_pt/ru_ru/nl_nl/pl_pl/sv_se/tr_tr/ar_sa/hi_in/th_th)。所有消息均可完全自定义 -
debug开关:默认禁用,以保持控制台输出整洁 -
原生 Folia 支持(Folia 构建版)
更新内容
- 命令结构从扁平命令重构为子命令。旧版命令如
reseteffect/seteffect/setlanguage已合并至effect/language下 - 配置结构:
confetti_effect→ 拆分为firework_styles(样式)+firework_chances(概率)。旧配置会自动迁移,且不会丢失数据 - 语言代码切换为
xx_yy格式(zh→zh_cn,zht→zh_tw,en→en_us…)。旧版代码仍可用;旧语言文件会自动重命名,同时保留您的翻译内容 - 语言文件键名统一为标准化的 99 个键,分布在 6 个部分中(
command/help/effect/language/chance/gui)。未翻译的键将自动回退到英文 - 版本命名标准化为
4.0.0-SNAPSHOT+N-<platform>
修复内容
- 损坏的可点击帮助分页:点击事件缺少前导
/,导致页面控件发送普通聊天消息而非执行命令 - 区域检测失败:在单端点超时或响应无效时检测会失败;不可靠的 JSON 解析已被并行多端点请求 + 正则表达式解析取代
- GUI 物品名称显示原始
&f:颜色代码未转换为§;现已统一处理颜色代码 - 启动时控制台日志过多:移除了样式列表、概率及区域探测详情的冗长日志记录
兼容性
| 构建类型 | 编译依赖 | 支持的运行环境 |
|---|---|---|
| Bukkit | spigot-api 1.9.4 (api-version: 1.13) |
Spigot / Paper 1.9.4 ~ 最新版 |
| Folia | folia-api 1.19.4 + Java 17 字节码 |
Folia 1.19.4 ~ 最新版 |
升级说明:只需替换 JAR 文件即可。您现有的 config.yml 将自动迁移并备份。旧的 confetti_effect 将被转换为名为 default 的样式。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
ExyliaPlugins 的库。
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
插件
创建用户友好的菜单以前往不同的世界
评论 0
登录后参与评分
还没有评论,来抢沙发吧