Red Pockets

RedPockets Changelog

v1.3.0-Release

Cross-server red packets

- Send on A → visible and claimable on B/C: Shared MySQL for active packets (active / active_amounts / active_claims) with atomic claims; BungeeCord/Velocity plugin-message sync; poll fallback when messages are missed. - Config: cross-server.enabled, server-id, poll-seconds, broadcast-claims; requires storage.type: mysql on the same database for all backends. - Single-server mode (cross-server.enabled: false) unchanged.

Fixes

- MySQL writes failing: After the vault/points split, keys like vault#UUID / points|UUID exceeded VARCHAR(36) and failed under strict SQL mode. Columns widened to VARCHAR(64) with automatic startup ALTER migration.

Others

- Version 26.2 supported. ---

RedPockets Changelog

v1.2.9-Release

Features

- 1.20.x Support - 26.1.x Support ---

RedPockets Changelog

v1.2.84-Release

Features

- Fixed custom command not supported in gui. - Allow fully customlized gui. ---

RedPockets Changelog

v1.2.83-Release

Features

- Custom command supported in gui. - Seperated PlayerPoints and Vault gui. ---

RedPockets Changelog

v1.2.82-Release

Features

- MySQL support. Use /redpockets convert to convert data between SQLite and MySQL ---

RedPockets Changelog

v1.2.81-Release

Fixes

- Fix config not getting new features ---

RedPockets Changelog

v1.2.8-Release

Features

- Fixed update link. - Fix incorrect bStats. - Improved plugin performance. - Fixed knowed bugs. ---

RedPockets Changelog

v1.2.7-Release

Startup improvements

- Plugin now loads after world load (POSTWORLD), so Vault/economy is ready and currency is detected reliably. - If currency is not found at first, the plugin retries once after ~5 seconds before disabling. - When configured for PlayerPoints but it is not installed, falls back to Vault and logs a warning.

Resend red packets on join

- When a player joins, they can be shown current active red packets (not expired, not empty) so they can see and claim after reconnecting. - Config: resend-on-join to turn this on/off, resend-min-amount to only show packets with total amount ≥ that value (0 = show all). ---

RedPockets Changelog

v1.2.62-Release

Custom currency

- Supports Vault economy and PlayerPoints; switch in config.yml via currency.type (vault or playerpoints). - When using PlayerPoints, amounts are rounded to whole numbers.

Send / claim whitelist & blacklist

- You can configure send list (send-list) and claim list (claim-list) in config.yml. - Each list supports mode: none (no restriction), whitelist (only listed players can do the action), or blacklist (listed players cannot). - List entries can be player names or UUIDs.

Shutdown refund

- On server shutdown, any unclaimed red packet balance is refunded to the sender so no money is lost. ---

RedPockets Changelog

v1.2.61-Release

Features:

- Fixed some bugs. ---

RedPockets Changelog

v1.2.6-Release

Features:

- Fix: Fixed some issues. Optimized some codes. ---

RedPockets Changelog

v1.2.54-Beta

Password red packet claiming

- Click [Type password to claim]: The password red packet broadcast shows a clickable “Type password to claim”; on click, the plugin sends the correct password to public chat as that player and completes the claim (one click per player per packet). - Type password in chat: Players can also type the correct password in public chat to claim; when typed manually, that chat line is cancelled so the password is not shown. - Password matching: Still uses password-redpacket.case-sensitive and password-redpacket.allow-spaces in config.yml. - Files: RedPockets.java (click-triggered send flag), MessageManager.java (clickable password hint), ChatListener.java (chat match and cancel behaviour), RedPacketCommand.java (clickclaim sends password), and message keys broadcast-password-hint / claim-password-use-click in all languages. ---

RedPockets Changelog

v1.2.53-Beta

#### Lucky red packet amount boundary (RedPacket.generateLuckAmounts) - Issue: When total amount per share was too small (e.g. total 0.05 for 10 shares), max could be less than min, causing invalid or negative amounts. - Fix: If totalAmount < count * 0.01 use equal split; in the loop add if (max < min) max = min to prevent invalid amounts. - Files changed: RedPacket.java ---

RedPockets Changelog

v1.2.52-Alpha

Fixes

#### Blessing/Password red packets could not be sent - Issue: Blessing and password red packets could not be sent after entering blessing/password. - Cause: completeInput(player) was called before retrieving amount and count; after clearing input state, getAmount() and getCount() returned 0. - Fix: Retrieve amount and count before calling completeInput, then execute createAndSendRedPacket. - Files changed: ChatListener.java ---

RedPockets Changelog

v1.2.51-Alpha

Multi-core support (including Spigot)

- PlatformBridge: New platform abstraction layer; plugin auto-detects server core on startup and loads the corresponding implementation - PaperPlatformImpl: For Paper / Folia / Purpur; uses GlobalRegionScheduler, AsyncScheduler; native Component message support - SpigotPlatformImpl: For Spigot; uses BukkitScheduler; Components are converted to legacy strings for broadcast / sendMessage - PlatformFactory: Selects implementation based on presence of getGlobalRegionScheduler - Supported cores: Spigot, Paper, Folia, Purpur, and other mainstream Bukkit-based cores - Console outputs the loaded implementation on startup (PaperPlatformImpl or SpigotPlatformImpl) ---

RedPockets Changelog

v1.2.5-Release

Fixes

#### 1. Double refund (ChatListener & RainRedPacketManager) - Issue: The runDelayed expiry task and the 5-minute getAndRemoveExpired could both process the same red packet, causing duplicate refunds. - Fix: Added removeAndGet(UUID) to RedPacketManager; refund only when the packet is successfully removed atomically; if it returns null, the packet was already handled by the periodic task. - Files changed: RedPacketManager.java (new removeAndGet), ChatListener.java, RainRedPacketManager.java #### 2. RedPacket.claim() race condition - Issue: When multiple threads claimed simultaneously, another thread could insert between claims.size() and amounts.get(index), causing duplicate allocation or index errors. - Fix: Added synchronized to the claim() method to ensure atomic claiming. - Files changed: RedPacket.java #### 3. RedPacket.tryUseClickClaim() redundant logic - Issue: Race condition between clickClaimed.contains() and clickClaimed.add(); ConcurrentHashMap.newKeySet().add() returns false when the element already exists. - Fix: Simplified to return clickClaimed.add(playerId), using the return value of add to determine first-time use. - Files changed: RedPacket.java ---

RedPockets Changelog

v1.2.4-Beta

/hongbao help command

- HongbaoMainCommand: Added help subcommand, displays available commands based on player permissions - HongbaoTabCompleter: Added Tab completion for help - Message files: Added help messages (help-header, help-send, help-claim, help-history, help-rank, help-rain, help-update, help-reload) in all 10 languages - plugin.yml: Added help to usage

RedPacket thread safety

- claims: Changed from HashMap to ConcurrentHashMap - clickClaimed: Changed from HashSet to ConcurrentHashMap.newKeySet() - Safer red packet claiming and click-claim operations under Folia multithreading

Expired red packet memory cleanup

- RedPacketManager: Added getAndRemoveExpired() to fetch and remove all expired red packets - RedPockets: Added scheduled task that runs every 5 minutes to clean up expired red packets - Refunds remaining amount to sender - Broadcasts expiry notification - Removes red packets from memory - onDisable: Cancels the scheduled task when plugin is disabled ---

RedPockets Changelog

v1.2.3-Beta

Multi-language support

- Added 8 new languages: Japanese (ja_JP), Korean (ko_KR), Traditional Chinese (zh_TW), German (de_DE), French (fr_FR), Spanish (es_ES), Brazilian Portuguese (pt_BR), Russian (ru_RU) - Now supports 10 languages total: zh_CN, zh_TW, en_US, ja_JP, ko_KR, de_DE, fr_FR, es_ES, pt_BR, ru_RU

Config updates

- language: Supports zh_CN, zh_TW, en_US, ja_JP, ko_KR, de_DE, fr_FR, es_ES, pt_BR, ru_RU

Fixes

- Added missing claim-password-prompt and claim-password-wrong message keys in en_US ---

RedPockets Changelog

v1.2.2-Alpha

Performance

- Async file I/O: HistoryManager, RankManager, and DailyLimitManager now save asynchronously to avoid blocking the main thread - History retention: New history-retention-days config option (default 7) to automatically delete history older than the specified days; 0 disables deletion

Shutdown data safety

- onDisable sync save: Sync-save history, rankings, and daily limit data when the plugin is disabled to prevent data loss - Cancel scheduled tasks: Properly cancel the red packet rain scheduled task on disable

User experience

- Tab completion: /hongbao command supports Tab completion for subcommands (history, rank, rain, update, reload, claim, clickclaim) - OP update notification on join: OPs with redpockets.reload permission receive an update notification when joining if a new version is available; can be disabled via update-notify-on-join config

Code structure

- Command refactor: Split /hongbao main command logic into HongbaoMainCommand with separate methods per subcommand - Config caching: New ConfigCache manager to cache frequently used config values (amount/count limits, cancel word, expiry, cooldown, daily limit, VIP permissions, etc.), reducing repeated config reads; refreshes automatically on reload

Config updates

- history-retention-days: Number of days to retain history (0 = no deletion) - update-notify-on-join: Whether to notify OPs of updates on join (default true)

RedPockets Changelog

v1.2.1-Alpha

Features:

Added a update notice.

RedPockets Changelog

v1.2.0-Alpha

New Features

#### Blessing Red Packet - Added blessing red packet option in GUI - Prompts for blessing message after entering count (empty uses default "Congratulations on getting rich") - Custom blessing limited to 6 characters #### Password Red Packet - Added password red packet option in GUI - Sender sets claim password after entering count - Click [Click to Claim] on broadcast message to claim (one click per player) - Configurable in config: password-redpacket.case-sensitive, allow-spaces #### Red Packet Rain - Added /hongbao rain command to start red packet rain (requires redpockets.rain permission) - OP input flow: amount → count → spawn count (optional) → duration (optional) - Scheduled auto rain: configure schedule-times, schedule-amount, schedule-count, schedule-duration-seconds in config - Fund source configurable: SERVER or PLAYER (UUID or player name) #### History - Added /hongbao history [page] command to view history (requires redpockets.history permission) - Data saved in data/history.yml, paginated (10 entries per page) #### Rankings - Added /hongbao rank command to view rankings - Shows top 10 for best luck, total sent, total received - Data saved in data/best.yml #### Sounds & Particles - Play sound when sending red packet (default ENTITY_PLAYER_LEVELUP) - Play sound and show particles when claiming (default HAPPY_VILLAGER) - Can be toggled and customized in config #### Cooldown & Daily Limit - Added cooldown (cooldown-seconds, 0 to disable) - Added daily send limit (daily-limit, 0 to disable) - VIP permission redpockets.vip bypasses both; more permissions configurable in config

Config Updates

- sound.send / sound.claim: Sound types - particle.type: Particle type - history-path: History file path - best-path: Rankings data file path - password-redpacket.case-sensitive / allow-spaces: Password red packet rules - rain.*: Red packet rain settings - bstats-enabled: BStats anonymous stats toggle (bottom of config)

Commands & Permissions

| Command | Permission | Description | |---------|------------|-------------| | /hongbao | redpockets.send | Open red packet GUI | | /hongbao history [page] | redpockets.history | View history | | /hongbao rank | redpockets.rank | View rankings | | /hongbao rain | redpockets.rain | Start red packet rain | | /hongbao claim <id> | redpockets.claim | Claim red packet | | /hongbao clickclaim <id> | redpockets.claim | Password red packet claim | | /hongbao reload | redpockets.reload | Reload config |

Dependencies & Integration

- PlaceholderAPI (soft depend): Placeholders %redpockets_send_1%, %redpockets_receive_1%, %redpockets_best_1%, etc. - BStats: Anonymous usage stats, can be disabled in config

Fixes

- Fixed plugin.getConfig() reference in red packet rain command - Avoid load error when PlaceholderAPI is not installed - BStats supports shaded class name loading

RedPockets Changelog

v1.0.1-Release

New Features:

In addition to using /hongbao, you can now use /redpockets. PLEASE NOTE THAT THIS IS THE LAST VERSION OF v1.0 SERIES. NEW VERSIONS WILL BE COMMING SOON!

Hello world!