Daily Rewards | Streaks, Bonus, Pools v2.5.0

Added

• Added configurable Reward Pools.
• Create multiple named pools and reference them with pool:<name>.
• Each pool entry can execute one or several commands as a single logical reward.
• Added optional weighted probabilities for common and rare rewards.
• Repeat the same pool reference to perform multiple independent rolls.
• Reward Pool commands automatically support player placeholders and permission multipliers.
• Reward Pools can also be used in streak bonus commands.

Notes

• The weight option is optional and defaults to 1.
• Multiple rolls may select the same reward.
• Existing configurations remain fully compatible.

• Rewritten internal reward flow for safer timing & claim handling
• Improved cooldown handling and edge-case safety
• Fail-Safe Mode. If critical configuration errors are detected, plugin enters Fail-Safe Mode. Prevents corrupted data or broken reward logic. Clear console warnings explain what failed and why.
• Smart Config Validation. Deep config validation added: days configuration integrity, commands correctness, materials, multipliers and sounds and particles validation.
• New Admin Tool: /rewards verify
• NEW — /rewards info

Added reward description lore to the GUI (per day)
• Improved GUI clarity: players can now clearly see what each reward contains
• Display active multiplier directly in the GUI (including x1.0)
• Full multilingual support for new GUI elements (EN, ES, FR, DE, IT)
• Automatic migration for new message keys (no manual edits required)
• Minor internal cleanup and stability improvements

RewardsLite v1.3 introduces native integration with PlaceholderAPI (PAPI). Now you can display your players' reward data in Scoreboards, Tablists, Custom Menus, or any other compatible plugin.

What's New:

• Native Placeholder Support: No need to download expansions from the eCloud. The plugin automatically registers its own placeholders on startup.
  
  
• Performance Optimized: Fast data-reading system to ensure zero lag, even on high-population servers.
  
  
• New "Power" Placeholders: More than just numbers! We've added logical placeholders to help you create "Smart Alerts."

Available Placeholders:
Informative:

• %rewardslite_streak% — Shows the player's current daily streak.
• %rewardslite_next_day% — Shows the number of the next day to be claimed.

Timers:

• %rewardslite_timeleft% — Remaining time in a professional format (HH:mm:ss).
• %rewardslite_timeleft_seconds% — Total raw seconds remaining (perfect for progress bars or menu logic).

Logic & Status (For Admins):

• %rewardslite_available% — Returns a colored status: READY or WAIT. Ideal for Tablists!
• %rewardslite_can_claim_raw% — Returns true or false. Use this for advanced logic in plugins like ConditionalEvents.

Usage Ideas:

• In your Tablist: &7Streak: &e%rewardslite_streak% &8| &7Status: %rewardslite_available%
  
  
• Welcome Message: &aWelcome back! Your next reward is Day %rewardslite_next_day%.
  
  
• Holograms: &eNext reward in: &f%rewardslite_timeleft%

️ Quick Start Guide:

1. Ensure you have PlaceholderAPI installed.
2. Install RewardsLite v1.3.
3. Start using placeholders immediately! No extra commands required.
4. Pro Tip: Test your setup in-game with: /papi parse me %rewardslite_available%.
   

This update doesn’t add new visible features, but it completely upgrades the foundation of the plugin — making it cleaner, safer and ready for the next versions.

What’s New in v1.2

Extended Compatibility:
Now officially supporting all versions from 1.19.4 up to 1.21.1+. One single JAR for all your modern server needs!

Fully Refactored RewardManager
All reward, streak and cooldown logic has been centralized into a single, clean manager.

This makes the plugin more stable, easier to maintain and far easier to extend in future updates.

️ Cleaner InventoryHandler
The GUI system has been rewritten to separate interface from logic.

InventoryHandler now handles only the menu — no business logic mixed inside.

Improved Config.yml (with advanced examples)
The configuration file has been reorganized and expanded with ready‑to‑use examples for:

• Economy (Vault / Essentials / CMI)
• Crates (CrazyCrates)
• Ranks (LuckPerms)
• Effects
• Points / Tokens
• Broadcast messages
  Everything is clearly commented and beginner‑friendly.

️ More Robust Commands

• /rewards → opens the menu
• /rewards reload → reloads the configuration
• /rewards reset <player> → resets a player’s streak (online or offline)
  All admin commands now work properly from console as well.

Stability & Code Quality Improvements

• Removed duplicated logic
• Improved error handling
• Cleaner internal structure
• Prepared for PlaceholderAPI, bStats and future features
• Strong foundation for upcoming updates

This update sets the stage for the next major improvements.

Important Notice for Server Owners (v1.1 → v1.2)
RewardsLite v1.2 introduces several internal improvements and architectural changes to make the plugin more stable, cleaner and easier to maintain.

These changes do not affect your existing player data (data.yml) and do not require any manual action from server owners.

However, because the internal structure has been reorganized, we recommend that servers running heavily modified configurations review their config.yml after updating.

✔ Safe to update

• No data loss
• No streak resets
• No format changes in data.yml
• Fully compatible with v1.0 and v1.1

✔ What you should do
Nothing special — just update normally.
If you have a custom config, compare it with the new default to ensure you’re not missing new options or comments.