FrostyRetain 1.0.0 – Initial Release 🎉

The first public release of FrostyRetain: daily rewards, streaks, weekly challenges and playtime rewards in one plugin.

Requires: Paper 26.3+ and Java 25. Vault and PlaceholderAPI are optional.

✨ Features

Menus & Commands

• /retain main menu with an overview of daily status, weekly challenges, personal stats and leaderboards
• Leaderboard GUI with player heads and tabs for streak, best streak and playtime
• /frostyretain shows plugin info and a clickable command list (admin commands only for admins)

Daily Rewards & Streaks

• Calendar GUI (/daily) with previews of upcoming rewards
• Reward cycle of 1–45 days, streak milestones
• Streak freezes (earned and used automatically) and an optional soft reset
• Optional minimum playtime per day, auto-claim, join notifications and reminders
• Configurable timezone

Weekly Challenges

• Rotating weekly selection from a configurable pool, with category variety
• Same challenges on every server of a network
• 13 types: break/place blocks, kill mobs/players, breed, fish, craft, smelt, consume, enchant, walk, playtime, daily claims
• Block, item and entity tags as targets (#logs, #crops, #fishes)
• Weekly bonus for completing all challenges
• Exploit protection: placed blocks, unripe crops, spawner mobs, repeat player kills, creative mode and blocked worlds

Playtime

• Active playtime only, so AFK players earn nothing and AFK pools don't work
• One-time milestones and repeating rewards

Retention Extras

• Comeback rewards for returning players
• First-join rewards
• Alt protection (IP limit per day, stored hashed)
• Discord webhook for milestones, comebacks and completed weeks

Rewards

• Actions: item, money, xp, console, player, message, broadcast, title, actionbar, sound, firework
• Chance per action, weighted random pools, rank bonuses and rank multipliers

Technical

• SQLite (default) or MySQL with table prefix
• Async database thread, batched saves, automatic schema migrations
• MiniMessage and & color codes
• PlaceholderAPI expansion with 30+ placeholders
• English and German language files (language: en / language: de)
• /frostyretain reload without a restart

📝 Notes

• Database settings are only applied after a server restart, not via /frostyretain reload.
• The day changes at midnight in the configured timezone (default: UTC).
• Reward and challenge names live in rewards.yml / challenges.yml, not in the language files. Translate them there if your server isn't English.