BlockyDonations | Tebex, Minestore, etc v2.0.3

v2.0.3 - Multi-Provider & Multi-Currency Support

[+] Added support for multiple donation providers
[+] Added KantoPay provider with payments, goals, coupons, and gift cards
[+] Added manual payment provider
[+] Added /bd record command for manually recording donations
[+] Added per-provider leaderboards, revenue tracking, and latest purchases
[+] Added per-provider goal configuration
[+] Added multi-currency tracking and automatic exchange rate conversion
[+] Added combined leaderboards with currency conversion
[+] Added provider-specific filtering to /bd top
[+] Added provider-scoped PlaceholderAPI support
[+] Added goal completion rewards with configurable commands and chance-based execution
[+] Added SkinRestorer integration for skin URL resolution
[+] Added /bd ggwave [start|stop|status] command for managing GG Waves independently
[+] Added optional FancyHolograms and FancyNpcs integrations

[~] Improved multi-provider status output with pagination
[~] Improved provider and currency validation
[~] Improved provider key normalization and legacy configuration migration
[~] Improved exchange rate caching and fallback handling
[~] Improved provider query performance with database indexing and caching
[~] Improved provider error handling and logging
[~] Improved player name sanitization in rewards and broadcasts
[~] Improved configuration migration while preserving existing formatting
[~] Refactored HTTP and JSON handling into shared utilities

[!] Fixes:

• Resolved provider and currency filtering inconsistencies
• Improved migration from the legacy store.provider configuration
• Improved handling of unavailable or stale exchange rates

[!] Notes:

• Multiple providers can now be configured through store.providers
• Provider-specific goals, leaderboards, revenue, and currencies are supported
• Currency conversion uses configurable exchange-rate caching
• /bd record requires the manual provider to be configured
• GG Waves can now be controlled independently from donation broadcasts

v2.0.2 Async Skin Resolution & Milestone Improvements

[+] Added asynchronous skin and player head resolution
[+] Added background cache warming for skin/head lookups
[+] Added milestone test support
[+] Added milestone ID tab-completion
[+] Added flexible milestone metric parsing with alias support
[+] Added hover event support for cross-server broadcasts
[+] Added improved pre-release version comparison

[~] Improved skin and head placeholder performance
[~] Improved Mojang/Geyser lookups to avoid blocking the main thread
[~] Improved network broadcast rendering and placeholder handling
[~] Improved milestone testing and completion handling
[~] Improved Discord goal completion deduplication
[~] Improved Discord rate-limit handling
[~] Improved console donation broadcasts
[~] Improved fallback player head visibility

[!] Fixes:

• Resolved blocking skin lookups causing main-thread stalls
• Resolved duplicate milestone and goal completion broadcasts
• Resolved Discord fractional rate-limit retry handling

TL;DR:

• Skin/head placeholders now use cached or fallback values immediately while refreshing in the background
• Milestones can now be tested directly through the test command
• Cross-server donation broadcasts now support hover events
  
  

v2.0.1 Milestone & Cross-Server Improvements

[+] Added OfflinePlayer support for PlaceholderAPI placeholders, allowing milestone placeholders to resolve correctly for offline players
[+] Added UUID-based player identification for milestone completion handling
[+] Added player UUID information to milestone network synchronization payloads for reliable cross-server player resolution
[+] Added improved cross-server milestone completion handling with UUID-first player lookup and name fallback

[~] Improved milestone network synchronization to respect each node's announceComplete configuration
[~] Improved milestone completion broadcasts to prevent the player who triggered a milestone from receiving duplicate announcements
[~] Improved PlaceholderAPI placeholder handlers by removing unused variable declarations
[~] Improved Discord rate-limit handling to correctly parse fractional retry-after values
[~] Improved reliability of cross-server milestone events when players are offline or cannot be resolved by name

[+] Added Redis network synchronization for multi-server setups
[+] Added cross-server syncing for donation broadcasts, GG Wave, and goal announcements
[+] Added player-specific milestone system with progress tracking
[+] Added configurable milestones based on total spending, package spending, and package counts
[+] Added repeatable milestones with configurable active time periods and package filters
[+] Added milestone rewards with console, player, and message execution support
[+] Added PlaceholderAPI support for milestone progress and completion data
[+] Added Redis-based synchronization for milestone completions
[+] Added Redis leader election and distributed deduplication to prevent duplicate network events
[+] Added secure HMAC-SHA256 verification for Redis network messages
[+] Added support for pre-release version tags in the update checker
[+] Added enhanced broadcast message handling with input sanitization and click event support

[~] Improved Redis error handling and network payload validation
[~] Improved donation broadcast synchronization by rendering messages before sending them across the network
[~] Improved milestone placeholder performance with cached lookups
[~] Improved goal announcement handling across multiple servers
[~] Improved security and validation for database and Redis operations
[~] Improved handling of malformed network messages and invalid Redis signatures
[~] Improved Discord synchronization and deduplication when Redis is enabled
[~] General reliability, security, and performance improvements

[!] Fixes:
Resolved issues with malformed Redis network messages causing errors
Improved handling of invalid or unsigned network messages
Improved database schema modification safety
Improved consistency of donation and goal announcements across multiple servers

[!] Notes:
• Redis synchronization allows donation-related events to be shared across multiple servers
• Milestones can track individual player progress and can be configured to repeat
• Milestones support TOTAL_SPEND, PACKAGE_SPEND, and PACKAGE_COUNT tracking
• Milestone progress can be displayed using new %bd_milestone__* placeholders
• Redis synchronization requires a shared network configuration and network secret when security verification is enabled
• This release includes support for the 2.0.1-beta pre-release version format

[+] Added full PayNow provider support
[+] Added internal goal tracking for providers that do not support goals, such as PayNow
[+] Added configurable internal goal values and seed amounts
[+] Added support for configurable "almost filled" goal progress bars
[+] Added improved goal progress tracking and persistence

[~] Refactored SQLite and MySQL database connection handling with HikariCP
[~] Improved database connection pooling, reliability, and resource management
[~] Improved goal configuration handling to prevent unnecessary resets during reloads
[~] Improved thread safety for goal, sale, and synchronization handling
[~] Improved database error handling and initialization reliability
[~] General performance, stability, and internal code improvements

[!] Notes:
• Internal goals allow providers such as PayNow, which do not provide native goal tracking, to use donation goals
• Internal goal progress is stored in the plugin database and persists across restarts
• Goal progress bars now support filled, almost-filled, and empty states
• Database handling has been significantly improved for both SQLite and MySQL

[+] Added option to independently enable or disable donation embeds while keeping goal embeds active
[+] Added improved Bedrock skin resolution using Floodgate XUID detection
[+] Added automatic gamertag normalization for Floodgate players
[+] Added fallback Steve skin support when player skin resolution fails
[+] Added default skin and render URLs for empty leaderboard placeholder entries
[+] Added PixelEast support for the update checker and anti-piracy placeholder system
[~] Improved PlaceholderAPI skin placeholders for better Java and Bedrock compatibility
[~] Improved skin URL caching with optimized cache durations for successful and failed lookups
[~] Enhanced placeholder handling to return default skin URLs instead of N/A for missing leaderboard entries


[!] Fixes:
Resolved Bedrock skin lookup issues for Floodgate players
Resolved missing skin placeholder values when leaderboard positions were empty
Improved reliability of player skin resolution and fallback handling


[!] Config changes:
• Added discord.donation-embed.enabled to independently control donation embed sending while keeping goal embeds enabled if desired - config should get updated automaticly.


[!] Placeholder changes:
• %bd_top_*__skin% now returns a unified skin PNG URL supporting both Java and Bedrock players
• %bd_top_*__skin_body% now provides an improved 3D body render supporting both Java and Bedrock players
• Removed legacy skin placeholder variants:
• %bd_top_*__skin_url%
• %bd_top_*__skin_helm%
• %bd_top_*__skin_avatar%
• %bd_top_*__skin_bust%
• Empty leaderboard entries now return default skin/render URLs instead of N/A, making them compatible with NPC plugins and menus


[!] Notes:
• Java and Bedrock player skin placeholders now use a unified system with improved compatibility
• Floodgate prefixes (., *, !, ~, _) are automatically removed during Bedrock player lookup
• Failed skin lookups now temporarily cache fallback results to reduce unnecessary external requests

[~] Fixed a bug where discord handlers ran on the main thread instead of async

v1.1.7:
[+] Added support for NoteBlockAPI .nbs songs for wave-music

chat-reactions:
  sounds:
    wave-music:
      enabled: false
      trigger: "always"

      type: "music_disc.cat"
      volume: 1.0
      pitch: 1.0
      # RECORD category = the proper jukebox sound channel
      category: "RECORD"

      # NoteBlockAPI playback. Requires the NoteBlockAPI plugin to be
      # installed. When nbs.enabled is true, this is used INSTEAD of the
      # vanilla type/volume/pitch/category settings above.
      # Drop your .nbs files into plugins/BlockyDonations/songs/ then
      # uncomment and fill in the fields below.
      nbs:
        enabled: false
        # Exact filename (case-sensitive) from the songs/ folder,
        # or "random" to pick a random .nbs file from that folder each time.
        #file: "Fireflies.nbs"
        # 0-100 (NOT 0.0-1.0 - this is a percentage, unlike vanilla volume)
        #volume: 100
        # Must be one of NoteBlockAPI's SoundCategory enum values:
        # MASTER | MUSIC | RECORDS | WEATHER | BLOCKS | HOSTILE | NEUTRAL | PLAYERS | AMBIENT | VOICE
        #category: "RECORDS"
        # random | in-order  (only relevant if you expand this to a playlist later)
        #queue-mode: "random"
        #loop-queue: true
        # Preload all .nbs files into memory on plugin start/reload
        #preload: false

v1.1.6:
[+] Added Discord Bot integration as an alternative to the existing webhook system
[+] Added automatic Discord thread creation support for donation and goal embeds (Discord Bot only)
[+] Added configurable thread names with placeholder support
[+] Added support for automatic thread archiving with configurable durations
[+] Added support for selecting which embed types create threads (donation, goal, or both)
[+] Added TownyChat support for GG Wave chat integration
[+] Added option to automatically suppress messages that do not match GG Wave filter requirements
[~] Complete Discord integration rework for improved flexibility and future expansion
[~] Improved Bedrock player compatibility across donation announcements and integrations
[~] Enhanced Tebex package handling by grouping duplicate purchases with quantity prefixes
[~] Improved leaderboard skin rendering using NMSR-compatible skin URLs
[~] Improved Discord webhook payload handling for thread creation support
[~] Renamed Discord goal embed configuration keys for improved consistency

[!] Fixes:
Resolved an issue where duplicate package purchases were displayed incorrectly in Discord embeds
Resolved an issue with Discord thread naming and webhook thread delivery handling
Resolved skin rendering inconsistencies in leaderboard embeds

[!] Config changes:
• goal-donation-embed settings have been renamed to goal-embed
• Discord Bot settings have been added to discord.yml
• Bot sender now takes priority over webhook delivery when enabled and configured

v1.1.5:
[+] Added support for Crafatar skin image providers
[+] Added support for NMSR skin renders and avatar images
[+] Added new skin placeholder URLs for Crafatar and NMSR image types
[+] Added configurable render types, sizes, and overlay support for Discord embeds
[~] Improved Discord image processing and fallback reliability

v1.1.4
[+] Added improved obfuscation and leak prevention handling
[+] Added enhanced integrity validation and verification logging
[~] Refactored internal protection handling for improved reliability