Deluxe Announce - Real-time Donation v36.0.26

- Automatic Text Adjustment: Added an optional feature to trim excessively long messages, preventing the Avatar's drawing from being distorted.

Flawless Chat: Fixed a visual glitch where avatars would mix with other chat messages under heavy load. They now display perfectly every time.
Ultra-Fast Performance: Massive optimizations to image processing to eliminate any potential lag spikes.
Lightweight: Reduced overall file size and simplified installation (Toast API is now bundled internally).

Changelog:

• New Feature (Price Flags): Added support to capture package prices directly from Tebex and CraftingStore.
  • Tebex usage:
    Code:

    acs donate {username} {packageName} --tid:{transaction} --price:{price}

  • CraftingStore usage:
    Code:

    acs donate {player} {package_name} --tid:{transaction_id} --price:{cost}

• New Placeholders: Use {Price}, %Price%, or %price% to display transaction values.
• Fix: The Bossbar in "Permanent Auto-Announcement" mode now correctly disappears when a player switches worlds.
• Optimization: Major internal code refactoring for better performance and stability.

MANDATORY READING FOR ALL USERS

We want to clarify the timeline of the recent major changes to avoid further misunderstandings:

1. Announcement & Notice: On November 2nd, 2025, we officially notified the community that a massive recode was coming and it would require config adjustments.
2. Official Release: Version 33.9.21-ANIMATIONS-RECODE was launched on January 8th, 2026, after more than two months of prior notice.

The plugin is currently in a BETA phase regarding the new animation engine. It is very disappointing to receive 1-star reviews from users who do not read the Changelog history or ignore notifications sent months in advance.

Before leaving a negative review:

• Open a Discord Ticket: We are here to help you fix any config issues.
• Check your history: If you missed the January 8th release notes, your configuration might need a refresh.

Support is provided daily via Discord. Please use the proper channels instead of the review section to report issues.

️ Donation Anti-Spam & Deduplication
To prevent duplicate announcements (spam) caused by store connection lag, we have implemented a strict packet deduplication system using Caffeine Cache.
You must update your store commands to include the Transaction ID!

Please add the --tid: flag to your commands in your store configuration:

Tebex Example:

Code:

acs donate {username} {packageName} --tid:{transaction}

CraftingStore Example:

Code:

acs donate {player} {package_name} --tid:{transaction_id}

Changelog

• Security & Performance
  • Implemented Caffeine Cache on the /donate command to instantly reject duplicate packets from payment gateways.
  • Added logic to validate unique Transaction IDs (--tid) to ensure every announcement is legitimate.
• Leaderboards (Signs & Heads)
  • Fixed a critical bug where Signs and Heads would not open the Statistics GUI when clicked.
  • Improved interaction: Now supports both Left-Click and Right-Click.
  • Fixed "Ghost Text" visual glitch on signs caused by block protection updates.
• Store & Config
  • Added Blacklist System: You can now exclude specific players (e.g., Admins, manual payments) from the Top Donator stats by adding their Name or UUID to the config.
  • Added DATA_LIMIT option to control how much historical data is processed, optimizing RAM usage.

Please update your store configuration to ensure the new security features work correctly!

Leaderboards

We’ve released a massive update focused on player engagement and server stability. Now you can recognize your supporters in-game like never before!

New Visual Statistics System
It is now possible to create physical Top Donator displays in your world.

• Leaderboards: Full support for Recent, Weekly, Monthly, and Global (All-Time) rankings.
• Visual Support: Place Signs and Heads (Skulls) that automatically update with the player's skin.
• PlaceholderAPI: New placeholders to display goals and stats in holograms, tab lists, or scoreboards.

Updated Documentation
Learn how to set up signs, heads, and view the list of new placeholders on our official Wiki:
https://announce.artzstudio.dev/en/donations

Hello everyone! We are releasing a massive update featuring critical internal changes and new visual features. Please read the following points carefully:

BETA Version & Feedback

Please note that this is a BETA version.

• Report Issues: If you encounter any bugs or performance issues, please notify us immediately.
• Support: We kindly ask you to open a ticket on our Discord before leaving a negative review. We are here to help and fix any issues as quickly as possible!

Critical File System Changes

The file system has been completely modified. Due to this transition, some existing configurations for Actionbars, Bossbars, Titles, and Subtitles may break.

• Automatic File Updater: We have implemented a new system that will automatically modify or delete obsolete paths.
• No More Manual Resets: This replaces the old method of deleting the entire file and re-configuring it manually with every update (we apologize for that!).
• Final Transition: This is the last time such a disruptive change to the configuration files will occur.

New Independent Animations!

You can now take your server's aesthetics to the next level. We have added independent animation support for:

• Actionbars
• Bossbars
• Titles & Subtitles

Animation Wiki: https://announce.artzstudio.dev/en/animations

Rebranding & Recoding (Artz Studios)

We have officially rebranded from STN Studios to Artz Studios. Much of the plugin has been recoded to ensure maximum optimization.

Important for Developers: Internal packages have been updated. If you use these dependencies, you must delete the old JAR files and download the new ones:

• Artz Bot: https://artzstudio.dev/artz-bot
• Toast API: https://artzstudio.dev/toast-api

New Features & Navigation

• Infinite Pagination: Check out the new system at the bottom of the plugin's main page.
• New Manager Access: Jump directly to the manager inventory with
  Code:

  /acs manager

  .
• New Wiki: https://announce.artzstudio.dev/

- A new avatar service has been integrated and is currently in BETA. Please report any bugs.

Hello everyone!
The powerful avatar cache system has received a crucial upgrade. We've introduced the new avatarCache.yml file to give you, the user, full control over the existing caching and network functionalities.

Key Improvements & New Features
We've externalized the behavior of the internal caching (Caffeine) and network (OkHttpClient) libraries into a configurable system:
Full Configurability: You now have complete control over cache and network behavior via the new avatarCache.yml file. Customize settings such as:
Expiration Time: How long an avatar stays in the cache (EXPIRATION-MINUTES).
Maximum Size: The total number of avatars stored in memory (MAXIMUM-SIZE).
Network Timeouts: Define precise timeouts for HTTP calls, connections, and reads (CALL-TIMEOUT, CONNECT-TIMEOUT, READ-TIMEOUT).
Hot Reloading: Changes made to avatarCache.yml can now be applied without restarting your server using a simple console command.
Asynchronous Preloading: The system can now pre-load existing local avatar images (.png files) into the cache in the background upon startup, preventing initial lag spikes.

Applying Changes (No Restart Needed!)
After modifying the settings in your avatarCache.yml file, you can apply them instantly by running the following command in your server console: /acs clearcache
This command will clear the old cache and reload all the new configuration values.

Documentation
For a full explanation of how these options work, recommended settings, and more technical details, please visit our updated wiki page:
https://announce.stn-studios.dev/en/avatarCache
Enjoy the control! If you have any questions, feel free to ask.