CreeperConfettiPro 4.2.0 Official Release

4.2.0 is the first official release focused on the “server operations experience”: it adds automatic update checks, GitHub token support, automatic config migration, and console message improvements, while removing the experimental explosion protection feature that did not meet expectations.

Download

• Repository: https://github.com/Hi-PolarBear/CreeperConfettiPro
• Issue tracker: https://github.com/Hi-PolarBear/CreeperConfettiPro/issues
• Discord: https://discord.gg/DajmZMmEbx
• Wiki: https://hi-polarbear.github.io/CreeperConfettiPro/

New in This Version

1. Automatic Update Checks

• 5 seconds after startup, asynchronously requests GitHub Releases in the background without blocking the main thread
• When a new version is found, the console outputs the latest version number and download URL
• When an OP joins the server, they receive a one-time notification with a clickable download link
• Update checks and notifications can be disabled separately:

update-checker:
  enabled: true
  notify-ops: true

2. GitHub Token Support (60 requests/hour → 5000 requests/hour)

Anonymous access to the GitHub API has a quota of only 60 requests per hour per IP. Shared egress IPs on hosting providers and cloud servers are often exhausted, resulting in HTTP 403 in the console. You can now enter a personal access token to increase the quota:

update-checker:
  github-token: "ghp_xxxxxxxx"

You can also use an environment variable (recommended; the token will not be written to the config file and will not be included in backups/ backups):

CREEPERCONFETTI_GITHUB_TOKEN

• The token only needs the public_repo scope: https://github.com/settings/tokens
• When the quota is exhausted, the plugin clearly reports the reason, current quota, and reset time instead of only throwing an exception
• A token is equivalent to a password. If leaked, revoke it immediately on GitHub

3. Automatic Config Migration (config-version 6)

• During upgrades, old configs are automatically backed up to plugins/CreeperConfettiPro/backups/
• Missing entries are filled in based on the bundled default config, and all values you have already filled in are preserved
• The new github-token entry automatically appears in your config

4. Configurable Command Aliases

/cc and /confetti are now dynamically registered at runtime and can be disabled as needed to avoid conflicts with other plugins over commands:

command-aliases:
  enabled: true
  cc: true
  confetti: true

5. Console Message Improvements

The startup banner includes the version, author, Discord, Java version, and current language; when debug: true, it additionally outputs the firework style list and probability distribution.

Recap of Existing 4.x Features

• Multiple firework styles: built-in classic, starburst, rainbow, and creeper, which can be freely added or removed
• Automatic probability weight normalization: firework_chances can use arbitrary weights, and the plugin automatically compensates them to total 100%
• In-game management: /cc effect list, /cc effect add <name> (execute while holding a firework), /cc effect chance
• Visual GUI: /cc gui to view and edit all styles
• 18 languages: Simplified Chinese, Traditional Chinese, English, Japanese, Korean, French, German, Spanish, Russian, etc., with automatic GeoIP matching
• Full Folia support: all scheduling goes through entity / region / global schedulers, with no remaining Bukkit.getScheduler() calls

Changes and Removals

• Removed explosion-protection (no-damage / no-destroy): this experimental feature did not work reliably, and 4.2.0 official release no longer includes it. Any leftover section in old configs will be ignored and can be manually deleted
• The console no longer prints the Website line

Compatibility

Upgrade Steps

1. Back up the old jar and the plugins/CreeperConfettiPro/ directory
2. Replace the old files with the 4.2.0 jar for the corresponding platform
3. Restart the server (the config will be automatically migrated to version 6)
4. Optional: fill in update-checker.github-token, or set the environment variable CREEPERCONFETTI_GITHUB_TOKEN