Minecraft server plugin · Bukkit & Folia

Every creeper blast,
a firework instead.

CreeperConfettiPro cancels the creeper's block-breaking explosion and sets off a fully configurable firework in the same spot. Shape, colours, flicker, trail and how often each style appears all live in config.yml.

Enter the wiki Download 4.2.0

5: firework shapes
18: languages built in
54: slots in the in-game GUI
2: branches: Bukkit & Folia

What it does

One event, one decision,
one firework.

The plugin listens on EntityExplodeEvent. When the exploding entity is a creeper and the random roll lands inside your configured chance, the blast is replaced. When it misses, vanilla behaviour is left alone.

Note

The plugin hooks EntityExplodeEvent and cancels it, so the terrain stays intact. The firework is a real entity, spawned one block above the creeper and detonated one tick later. See Build & extend for ways to customise the block list.

What you can tune

Everything is a config key,
or a click.

Styles and weights

Define as many styles as you like. Values are weights, normalised on load, so the chances always add up to 100% without you doing the maths.

A 54-slot in-game GUI

Left-click to edit a style, right-click to preview it, hold a firework to import it. No YAML required for day-to-day tuning.

Config migration

Versioned upgrades back up the old file, merge new keys and keep every value you set. Nothing silently resets.

Native Folia support

All scheduling goes through region schedulers, entity work stays on its owning region, config reads use volatile caches.

Install

Drop it in, restart,
open the GUI.

Pick the jar that matches your server. Both builds share the plugin name, so never install them side by side.

Stop the server — do not hot-swap jars.
Drop the jar into plugins/ — leave it zipped.
Start the server — the first run writes config.yml and all 18 language files.
Run /cc gui in game, or edit the config and run /cc reload.

plugins/

# Bukkit family: Spigot, Paper, Purpur, Leaves
CreeperConfettiPro-4.2.0-bukkit.jar

# Folia only
CreeperConfettiPro-4.2.0-folia.jar

# in game
/cc gui
/cc chance 35

Java 8+ for Bukkit, Java 17+ for Folia. Wrong branch fails at startup, not silently.

Documentation

Read the wiki.

Every key, command, permission node and edge case is documented. Start with the overview, or jump straight to what you need.

OverviewWhat the plugin does and how the flow works InstallationRequirements, first start, verification config.ymlEvery key, its range and migration Commands & permissionsSix subcommands and their nodes Styles & chancesShapes, colours and weights FAQTwelve problems and their fixes

Enter the wiki

Minecraft 服务端插件 · Bukkit 与 Folia

苦力怕炸开的那一刻，
换成一场烟花。

CreeperConfettiPro 取消苦力怕的方块破坏，并在原地放出一支完全可配置的烟花。形状、颜色、闪烁、轨迹，以及每种样式出现的频率，全都写在 config.yml 里。

进入 Wiki 下载 4.2.0

5: 种烟花形状
18: 种内置语言
54: 格游戏内界面
2: 个分支：Bukkit 与 Folia

它做什么

一次事件，一次判定，一支烟花。

插件监听 EntityExplodeEvent。当爆炸实体是苦力怕、且随机数落在你配置的概率区间内时，爆炸被替换；没命中时，保持原版行为不动。

注意

插件监听 EntityExplodeEvent 并将其取消，因此地形保持原样。烟花是真实实体，生成在苦力怕头顶一格，并在 1 tick 后引爆。想进一步控制方块列表，见构建与二次开发。

可以调什么

一切不是配置项，就是一次点击。

样式与权重

想写几种写几种。配置里填的是权重，加载时自动归一化，概率恒为 100%，不用自己算。

54 格游戏内界面

左键编辑、右键预览、手持烟花直接入库。日常调整完全不用碰 YAML。

配置自动迁移

带版本号的升级：备份旧文件、合并新增字段、保留你填过的每一个值，不会悄悄重置。

Folia 原生支持

调度全部走区域调度器，实体操作锁定所属区域，配置读取使用 volatile 缓存。

安装

放进去，重启，打开界面。

选与服务端匹配的 jar。两个分支的插件名相同，不要同时安装。

停止服务端——不要在运行时热替换 jar。
把 jar 放进 plugins/——保持压缩包原样。
启动服务端——首次运行会生成 config.yml 和全部 18 个语言文件。
执行 /cc gui，或改配置后 /cc reload。

plugins/

# Bukkit 系：Spigot、Paper、Purpur、Leaves
CreeperConfettiPro-4.2.0-bukkit.jar

# 仅 Folia
CreeperConfettiPro-4.2.0-folia.jar

# 游戏内
/cc gui
/cc chance 35

Bukkit 需 Java 8+，Folia 需 Java 17+。装错分支会在启动时直接失败，不会静默出错。

文档

去读 Wiki。

每个配置项、指令、权限节点和边界情况都有说明。从概览开始，或者直接跳到你要找的那一页。

项目概览插件做什么，流程如何走 安装与部署环境要求、首次启动、验证 配置文件每个字段、取值范围与迁移 指令与权限六个子命令与权限节点 烟花样式与概率形状、颜色与权重 常见问题十二个问题与对应解法

进入 Wiki

Every creeper blast,a firework instead.

One event, one decision,one firework.

Everything is a config key,or a click.