ВЕРСИИ (26)

## 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 gui` for 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-version` identifier. On upgrade, old configs are automatically **backed up** to the `backups/` 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 as `reseteffect`/`seteffect`/`setlanguage` have been merged under `effect` / `language` - Config structure: `confetti_effect` → split into `firework_styles` (styles) + `firework_chances` (probabilities). Old configurations are automatically migrated without data loss - Language codes switched to `xx_yy` format (`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 to `4.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 details ### Compatibility | 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 existing `config.yml` will be automatically migrated and backed up. The old `confetti_effect` will be converted into a style named `default`.

## 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 gui` for 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-version` identifier. On upgrade, old configs are automatically **backed up** to the `backups/` 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 as `reseteffect`/`seteffect`/`setlanguage` have been merged under `effect` / `language` - Config structure: `confetti_effect` → split into `firework_styles` (styles) + `firework_chances` (probabilities). Old configurations are automatically migrated without data loss - Language codes switched to `xx_yy` format (`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 to `4.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 details ### Compatibility | 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 existing `config.yml` will be automatically migrated and backed up. The old `confetti_effect` will be converted into a style named `default`.

### 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_yy` code format, standardized to 99 keys) - `debug` logging toggle - **Folia thread model adaptation** (Folia has no main thread; `Bukkit.getScheduler()` does not exist and throws exceptions when invoked): - New `creeperconfetti.util.Schedulers` to 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 in `LanguageManager`: `runAsync` + `runGlobal` (switch back to global thread to modify Bukkit state after lookup completes) - Language reload callback in `LanguageCommand`: Changed to `runGlobal` - **Cross-region thread safety** (multiple region threads concurrently access shared plugin state under Folia): - All public methods in `FireworkStyleManager` wrapped with `synchronized` (prevents `ConcurrentModificationException` from concurrent `LinkedHashMap` read/write when region A edits styles while a creeper explodes in region B) - `LanguageManager.getMessage / getConsoleMessage / loadMessages` marked `synchronized`; `currentLanguage` changed to `volatile` - `confetti_chance` and `debug` converted to **volatile cached fields**, avoiding unsafe `FileConfiguration` reads during explosions on region threads - `plugin.yml` declares `folia-supported: true` (Folia rejects plugin loading without this field).

### Fixed - **Literal `&f` appearing before GUI item names**: `BaseGui.item()` directly called `setDisplayName()` / `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).

### Added - **GUI graphical management interface**: `/cc gui` (alias `/cc menu`). Reuses permission `creeperconfetti.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**: Default `false`. Controls verbose logging including firework style list, probabilities, GeoIP lookup details and more. ### Fixed - **Help page click not working**: Missing leading `/` in `ClickEvent.Action.RUN_COMMAND` value (written as `cc help 2`). Client sends values without `/` as chat messages instead of executing commands. Fixed to `/cc help <page>`. - **Region detection failure**: - JSON returned by `ipwho.is` failed to parse with `YamlConfiguration` (spammed SEVERE stacktraces). - `ip-api.com` connection timeouts and `ipapi.co` returning 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 only `en` and `zh` used 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; existing `language: zh` in config requires no manual edits. - Old language files on server (e.g. `zh.yml`) are automatically renamed to `zh_cn.yml`, preserving user translations.

### 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 only `ip-api.com` to 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**: - Added `config-version` version marker. - When old config version is detected, the old configuration is first **backed up** to `plugins/CreeperConfettiPro/backups/config-backup-<timestamp>.yml`. - Merge missing keys based on bundled default config (existing user values are preserved). - Legacy single-effect `confetti_effect` automatically converted to a style named `default`, while populating new default styles and probability entries.

### 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 via `children`). - **Multiple firework styles + random triggering**: Configuration changed from a single `confetti_effect` to `firework_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 only `confetti_effect` will be automatically migrated into a style named `default`. 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.

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.

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.

This release adds support for custom language files and enables command help display through the help command.

This release adds support for custom language files and enables command help display through the help command.

This version fixes scheduler‑related bugs in Folia, allowing the plugin to run stably under Folia.

This version has made some minor adjustments to improve compatibility.

This version has made some minor adjustments to improve compatibility.

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.

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.

This version adds support for automatic language detection for more countries and regions, as well as language configuration via configuration files.

This version adds support for automatic language detection for more countries and regions, as well as language configuration via configuration files.

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.

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.

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.

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.

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.

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.

This branch further optimizes the original code of CreeperConfetti, making the plugin more lightweight.

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.