CreeperConfettiPro
4.0.0-foliaA fork of the CreeperConfetti plugin, adapted for higher game versions
4.0.0-folialatestCreeperConfettiPro 4.0.0-foliaSep 24, 2026 This is a major release: full refactor of the command system, firework system, internationalization, and compatibility layer.
Additions
- Subcommand System:/cc help | effect | gui | chance | language | reload. Supports aliases, layered tab completion, and granular permissions (creeperconfetti.command.{effect,chance,language,reload}) - Multiple Firework Styles: Each style may contain one or more firework effects. When a creeper explodes, one style is randomly selected based on weight. Colors support three formats: color names / hexadecimal (#FF0000) / RGB values - Style Probability System: Use/cc effect chance <style> <percentage>to freely configure trigger chances for each style. Includes an auto-balancing mechanism that keeps the total probability at 100% - GUI Visual Manager:/cc guifor visual management — paginated lists, previews, create new styles, delete styles, adjust probabilities by ±1/5/10%, and evenly distribute chances - Paginated Help Interface: Clickable[Prev] [1] [2] [3] [Next]page controls in chat. Also supports/cc help <page number>- Fallback GeoIP Region Detection: 6 GeoIP endpoints queried in parallel, using the fastest successful response. Failure of a single endpoint does not break detection - Config Migration System:config-versionidentifier. On upgrade, old configs are automatically backed up to thebackups/folder, new config entries are merged, and existing user data is preserved - Complete set of 18 languages (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). All messages are fully customizable - `debug` Toggle: Disabled by default to keep console output clean - Native Folia Support (Folia build)Changes
- Commands restructured from flat commands to subcommands. Legacy commands such asreseteffect/seteffect/setlanguagehave been merged undereffect/language- Config structure:confetti_effect→ split intofirework_styles(styles) +firework_chances(probabilities). Old configurations are automatically migrated without data loss - Language codes switched toxx_yyformat (zh→zh_cn,zht→zh_tw,en→en_us…). Legacy codes remain functional; old language files are automatically renamed while preserving your translations - Language file keys standardized to 99 keys across 6 sections (command/help/effect/language/chance/gui). Untranslated keys fall back to English automatically - Version naming standardized to4.0.0-SNAPSHOT+N-<platform>Fixes
- Broken clickable help pagination: Click events missing the leading/, causing page controls to send plain chat messages instead of running commands - Region detection failures: Detection would fail on single endpoint timeout or invalid response; unreliable JSON parsing replaced with parallel multi-endpoint requests + regex parsing - GUI item names showing raw `&f`: Color codes were not converted to§; color code handling unified - Excessive startup console spam: removed verbose logging of style lists, probabilities, and region probe detailsCompatibility
| Build | Compile Dependency | Supported Runtime | | --- | --- | --- | | Bukkit |spigot-api 1.9.4(api-version: 1.13) | Spigot / Paper 1.9.4 ~ Latest | | Folia |folia-api 1.19.4+ Java 17 bytecode | Folia 1.19.4 ~ Latest | Upgrade Note: Simply replace the JAR file. Your existingconfig.ymlwill be automatically migrated and backed up. The oldconfetti_effectwill be converted into a style nameddefault.4.0.0-bukkitCreeperConfettiPro 4.0.0-bukkitSep 24, 2026 This is a major release: full refactor of the command system, firework system, internationalization, and compatibility layer.
Additions
- Subcommand System:/cc help | effect | gui | chance | language | reload. Supports aliases, layered tab completion, and granular permissions (creeperconfetti.command.{effect,chance,language,reload}) - Multiple Firework Styles: Each style may contain one or more firework effects. When a creeper explodes, one style is randomly selected based on weight. Colors support three formats: color names / hexadecimal (#FF0000) / RGB values - Style Probability System: Use/cc effect chance <style> <percentage>to freely configure trigger chances for each style. Includes an auto-balancing mechanism that keeps the total probability at 100% - GUI Visual Manager:/cc guifor visual management — paginated lists, previews, create new styles, delete styles, adjust probabilities by ±1/5/10%, and evenly distribute chances - Paginated Help Interface: Clickable[Prev] [1] [2] [3] [Next]page controls in chat. Also supports/cc help <page number>- Fallback GeoIP Region Detection: 6 GeoIP endpoints queried in parallel, using the fastest successful response. Failure of a single endpoint does not break detection - Config Migration System:config-versionidentifier. On upgrade, old configs are automatically backed up to thebackups/folder, new config entries are merged, and existing user data is preserved - Complete set of 18 languages (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). All messages are fully customizable - `debug` Toggle: Disabled by default to keep console output clean - Native Folia Support (Folia build)Changes
- Commands restructured from flat commands to subcommands. Legacy commands such asreseteffect/seteffect/setlanguagehave been merged undereffect/language- Config structure:confetti_effect→ split intofirework_styles(styles) +firework_chances(probabilities). Old configurations are automatically migrated without data loss - Language codes switched toxx_yyformat (zh→zh_cn,zht→zh_tw,en→en_us…). Legacy codes remain functional; old language files are automatically renamed while preserving your translations - Language file keys standardized to 99 keys across 6 sections (command/help/effect/language/chance/gui). Untranslated keys fall back to English automatically - Version naming standardized to4.0.0-SNAPSHOT+N-<platform>Fixes
- Broken clickable help pagination: Click events missing the leading/, causing page controls to send plain chat messages instead of running commands - Region detection failures: Detection would fail on single endpoint timeout or invalid response; unreliable JSON parsing replaced with parallel multi-endpoint requests + regex parsing - GUI item names showing raw `&f`: Color codes were not converted to§; color code handling unified - Excessive startup console spam: removed verbose logging of style lists, probabilities, and region probe detailsCompatibility
| Build | Compile Dependency | Supported Runtime | | --- | --- | --- | | Bukkit |spigot-api 1.9.4(api-version: 1.13) | Spigot / Paper 1.9.4 ~ Latest | | Folia |folia-api 1.19.4+ Java 17 bytecode | Folia 1.19.4 ~ Latest | Upgrade Note: Simply replace the JAR file. Your existingconfig.ymlwill be automatically migrated and backed up. The oldconfetti_effectwill be converted into a style nameddefault.4.0.0-SNAPSHOT+1-foliaCreeperConfettiPro 4.0.0-SNAPSHOT+1-foliaSep 24, 2026 Added
- Full port of all features from Bukkit `4.0.0-SNAPSHOT+4`: - Subcommand system:/cc help | effect | gui | chance | language | reload- Multiple firework styles + independent per‑style probabilities (auto-compensated to 100%) + weighted random selection on trigger - Graphical GUI management (list / edit / pagination / add / delete / adjust probability / preview) - Paged Help with clickable chat pagination - Parallel GeoIP lookup across multiple APIs - Config migration + backup (config-version) - 18 language files (xx_yycode format, standardized to 99 keys) -debuglogging toggle - Folia thread model adaptation (Folia has no main thread;Bukkit.getScheduler()does not exist and throws exceptions when invoked): - Newcreeperconfetti.util.Schedulersto wrap four Folia schedulers uniformly: | Usage | Folia API | |---|---| | Entity-owned region (firework detonation, GUI open) |entity.getScheduler().run / runDelayed| | Location-owned region |Bukkit.getRegionScheduler()| | Global thread (≈ main thread, for command/event registration) |Bukkit.getGlobalRegionScheduler()| | Async (GeoIP network requests) |Bukkit.getAsyncScheduler()| - Replaced all six Bukkit scheduler calls: -FireworkUtil.spawnAndDetonate: Changed to detonate with a 1-tick delay on the firework entity’s region scheduler -CreeperExplodeListener: Same as above (explosion event already fires on the creeper’s region thread) -BaseGui.openLater: Open inventory on the player entity’s region scheduler (inventory opening must happen on the player’s region thread) - Region lookup inLanguageManager:runAsync+runGlobal(switch back to global thread to modify Bukkit state after lookup completes) - Language reload callback inLanguageCommand: Changed torunGlobal- Cross-region thread safety (multiple region threads concurrently access shared plugin state under Folia): - All public methods inFireworkStyleManagerwrapped withsynchronized(preventsConcurrentModificationExceptionfrom concurrentLinkedHashMapread/write when region A edits styles while a creeper explodes in region B) -LanguageManager.getMessage / getConsoleMessage / loadMessagesmarkedsynchronized;currentLanguagechanged tovolatile-confetti_chanceanddebugconverted to volatile cached fields, avoiding unsafeFileConfigurationreads during explosions on region threads -plugin.ymldeclaresfolia-supported: true(Folia rejects plugin loading without this field).4.0.0-SNAPSHOT+4-bukkitCreeperConfettiPro 4.0.0-SNAPSHOT+4-bukkitSep 24, 2026 Fixed
- Literal `&f` appearing before GUI item names:BaseGui.item()directly calledsetDisplayName()/setLore()without converting&color codes to§. This caused the hardcoded"&f"prefix to render as plain text. Color conversion is now applied uniformly to item names and lore (this also enables custom&color codes for style names).4.0.0-SNAPSHOT+3-bukkitCreeperConfettiPro 4.0.0-SNAPSHOT+3-bukkitSep 24, 2026 Added
- GUI graphical management interface:/cc gui(alias/cc menu). Reuses permissioncreeperconfetti.command.effect, player-only. - List view: Displays all styles (name / effect count / trigger probability), auto-paginated (45 entries per page). Left-click to edit, right-click to preview, add style from main-hand firework, evenly redistribute probabilities. - Edit view: Preview, adjust probability by-10 / -5 / -1 / +1 / +5 / +10 %, overwrite with main-hand firework, delete style, return to list. - Clicks and drags are intercepted to prevent item movement or duplication. - `debug` config toggle: Defaultfalse. Controls verbose logging including firework style list, probabilities, GeoIP lookup details and more.Fixed
- Help page click not working: Missing leading/inClickEvent.Action.RUN_COMMANDvalue (written ascc help 2). Client sends values without/as chat messages instead of executing commands. Fixed to/cc help <page>. - Region detection failure: - JSON returned byipwho.isfailed to parse withYamlConfiguration(spammed SEVERE stacktraces). -ip-api.comconnection timeouts andipapi.coreturning 403 errors. - Changed to parallel requests for all endpoints, take the fastest successful response. JSON fields extracted via regex (no longer relying on SnakeYAML). Commands/events registered on main thread after lookup completes.Changed
- All 18 language files completed: Standardized to 99 keys across 6 sections (command/help/effect/language/chance/gui). Previously onlyenandzhused the new structure. - Language code format updated to `xx_yy`:zh → zh_cn,zht → zh_tw,en → en_us,ja → ja_jp,ko → ko_kr,fr → fr_fr,de → de_de,es → es_es,it → it_it,pt → pt_pt,ru → ru_ru,nl → nl_nl,pl → pl_pl,sv → sv_se,tr → tr_tr,ar → ar_sa,hi → hi_in,th → th_th. - Legacy codes kept as aliases; existinglanguage: zhin config requires no manual edits. - Old language files on server (e.g.zh.yml) are automatically renamed tozh_cn.yml, preserving user translations.4.0.0-SNAPSHOT+2-bukkitCreeperConfettiPro 4.0.0-SNAPSHOT+2-bukkitSep 24, 2026 Added
- Paged Help GUI: Content expanded to list all subcommands plus their subactions. Clickable[<< Prev] [1] [2] [3] [Next >>]pagination controls inside chat, also supports/cc help <page number>. Automatically downgrades to plain-text prompts for console. - Independent probability for each firework style: -/cc effect chance(view probabilities) -/cc effect chance <style> <percentage>(set probability for a style) -/cc effect chance reset(redistribute probabilities evenly) - Config entry:firework_chances- Auto-compensation mechanism: After setting one style’s probability, remaining styles proportionally split the leftover percentage with rounding adjustments, total always equals 100%. Values are normalized on load. Manually editing config to totals above or below 100 will not cause styles to never trigger or probability gaps. - Weighted random selection on trigger. - Multiple fallback APIs for region detection: Switched from onlyip-api.comto sequential attempts:ipwho.is→api.country.is→ipinfo.io→ipapi.co→ip-api.com→ip.zxinc.org. Uses the first successful response; falls back to English only if all fail. Expanded country-to-language mapping covering all 18 supported languages. - Config migration system: - Addedconfig-versionversion marker. - When old config version is detected, the old configuration is first backed up toplugins/CreeperConfettiPro/backups/config-backup-<timestamp>.yml. - Merge missing keys based on bundled default config (existing user values are preserved). - Legacy single-effectconfetti_effectautomatically converted to a style nameddefault, while populating new default styles and probability entries.4.0.0-SNAPSHOT+1-bukkitCreeperConfettiPro 4.0.0-SNAPSHOT+1-bukkitSep 24, 2026 Added
- Command system refactored to subcommand mode (no longer a single root command listing all functions): | Command | Description | | --- | --- | |/cc help [page | subcommand]| | `/cc effect <list | add | |/cc chance [0-100]| View / set global confetti trigger chance (new) | | `/cc language <info | list | |/cc reload| Reload configuration and firework styles | - Aliases supported:effect→style/styles/firework;language→lang; root command →cc/confetti. - Hierarchical tab completion. - Permissions split into fine-grained nodes:creeperconfetti.command.{reload,effect,chance,language}(parent permission grants all child permissions by default viachildren). - Multiple firework styles + random triggering: Configuration changed from a singleconfetti_effecttofirework_styles(mapping structure). Each style may contain one or more firework effects. When a creeper explodes, one style is randomly selected to play. - Colors support three formats: color names (RED/LIME…), hex (#FF0000/#f00), RGB object ({RED: 255, GREEN: 0, BLUE: 0}). - 4 built-in default styles:classic/starburst/rainbow/creeper. - In-game/cc effect add <name>saves all firework effects from your main hand as a new style. - Backward compatibility: Old configs with onlyconfetti_effectwill be automatically migrated into a style nameddefault. Empty config falls back to built-in default styles. - Language manager improvements: Supports recursive reading of nested keys. Untranslated keys automatically fall back to English; raw keys will no longer be displayed.3.1.0-foliaCreeperConfettiPro 3.1.0-foliaAug 20, 2026 Bug Fixes • Fixed the issue where fireworks converted from creepers did not explode: when the firework effect in the configuration is missing or the format is invalid, it now automatically falls back to the default burst effect, ensuring the firework always produces a visible explosion. • Fixed the issue where /cc reseteffect resetting the effect list to empty caused fireworks to be permanently "dud": after reset, the default effect is now automatically written back. • Fixed a potential type conversion exception that could occur when /cc seteffect displays fireworks. • After a creeper triggers a conversion, the original entity is now removed, preventing a non-exploding creeper from remaining. • bStats initialization failure no longer affects the plugin's normal startup. Compatibility • Bukkit version: Supports Spigot/Paper 1.9.4 ~ latest (Java 8+, compiled based on spigot-api 1.9.4). • Folia version: Supports Folia 1.19.4 ~ latest; all Bukkit scheduler calls have been removed, replaced with Folia thread-safe scheduling (entity scheduler / global region scheduler), and fixed thread safety issues in asynchronous language detection callbacks.3.1.0-bukkitCreeperConfettiPro 3.1.0-bukkitAug 20, 2026 Bug Fixes • Fixed the issue where fireworks converted from creepers did not explode: when the firework effect in the configuration is missing or the format is invalid, it now automatically falls back to the default burst effect, ensuring the firework always produces a visible explosion. • Fixed the issue where /cc reseteffect resetting the effect list to empty caused fireworks to be permanently "dud": after reset, the default effect is now automatically written back. • Fixed a potential type conversion exception that could occur when /cc seteffect displays fireworks. • After a creeper triggers a conversion, the original entity is now removed, preventing a non-exploding creeper from remaining. • bStats initialization failure no longer affects the plugin's normal startup. Compatibility • Bukkit version: Supports Spigot/Paper 1.9.4 ~ latest (Java 8+, compiled based on spigot-api 1.9.4). • Folia version: Supports Folia 1.19.4 ~ latest; all Bukkit scheduler calls have been removed, replaced with Folia thread-safe scheduling (entity scheduler / global region scheduler), and fixed thread safety issues in asynchronous language detection callbacks.2.2.0-foliaCreeperConfettiPro 2.2.0-foliaJul 28, 2026 This release adds support for custom language files and enables command help display through the help command.2.2.0-bukkitCreeperConfettiPro 2.2.0-bukkitJul 28, 2026 This release adds support for custom language files and enables command help display through the help command.2.1.2-folia-fix1CreeperConfettiPro 2.1.2-folia-fix1Jul 11, 2026 This version fixes scheduler‑related bugs in Folia, allowing the plugin to run stably under Folia.2.1.2-foliaCreeperConfettiPro 2.1.2-foliaJul 2, 2026 This version has made some minor adjustments to improve compatibility.2.1.2-bukkitCreeperConfettiPro 2.1.2-bukkitJul 2, 2026 This version has made some minor adjustments to improve compatibility.2.1.1-foliaCreeperConfettiPro 2.1.1-foliaMay 17, 2026 This is a minor iterative update, mainly adapted to the new version of Minecraft server, and optimizes the compatibility performance of plugins in the new version environment.2.1.1-bukkitCreeperConfettiPro 2.1.1-bukkitMay 17, 2026 This is a minor iterative update, mainly adapted to the new version of Minecraft server, and optimizes the compatibility performance of plugins in the new version environment.2.1-bukkitCreeperConfettiPro 2.1-bukkitFeb 26, 2026 This version adds support for automatic language detection for more countries and regions, as well as language configuration via configuration files.2.1-foliaCreeperConfettiPro 2.1-foliaFeb 24, 2026 This version adds support for automatic language detection for more countries and regions, as well as language configuration via configuration files.2.0-foliaCreeperConfettiPro 2.0-foliaFeb 23, 2026 This version adds a regional language system. When loading the plugin, it will automatically detect the server's region and switch to the corresponding language. Plugin code has been optimized to improve compatibility. Java version check has been adjusted and downgraded to Java 14.2.0-bukkitCreeperConfettiPro 2.0-bukkitFeb 23, 2026 This version adds a regional language system. When loading the plugin, it will automatically detect the server's region and switch to the corresponding language. Plugin code has been optimized to improve compatibility. Java version check has been adjusted and downgraded to Java 14.1.9-foliaCreeperConfettiPro 1.9-foliaFeb 21, 2026 This version adds cloud data statistics and Java version detection, allowing developers to maintain plugins more effectively and providing users with a better experience. Since the plugin is developed based on Java 21, it will check the server’s Java version. The plugin will be automatically disabled on servers running Java versions lower than 17.1.9-bukkitCreeperConfettiPro 1.9-bukkitFeb 21, 2026 This version adds cloud data statistics and Java version detection, allowing developers to maintain plugins more effectively and providing users with a better experience. Since the plugin is developed based on Java 21, it will check the server’s Java version. The plugin will be automatically disabled on servers running Java versions lower than 17.1.8-foliaCreeperConfettiPro 1.8-foliaFeb 20, 2026 In this version, we have optimized the code execution logic, which has greatly improved the plugin's compatibility. This time... we support all versions above 1.8!!! We have also added exciting Folia support. As for the Folia version... please download it from our official Modrinth page or the official GitHub repository.1.8-bukkitCreeperConfettiPro 1.8-bukkitFeb 20, 2026 In this version, we have optimized the code execution logic, which has greatly improved the plugin's compatibility. This time... we support all versions above 1.8!!! We have also added exciting Folia support. As for the Folia version... please download it from our official Modrinth page or the official GitHub repository.1.7Jan 30, 2026 This branch further optimizes the original code of CreeperConfetti, making the plugin more lightweight.1.6Jan 29, 2026 This is the first official release of CreeperConfettiPro, which continues from version 1.4, the final release of the original CreeperConfetti. As for why there is no CreeperConfettiPro 1.5: we did develop CreeperConfettiPro 1.5, but critical bugs emerged, so we discarded it and directly launched the stable CreeperConfettiPro 1.6.
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta