LoginLoot

# LoginLoot – Daily Reward Calendar with Streaks Give your players a reason to come back every day. **LoginLoot** adds a clean daily reward calendar with streaks, VIP bonuses and full network support – fully configurable, safe against duplicate claims and easy to set up. ## ✨ Features - **Reward calendar GUI** – claimed, available and locked days at a glance, with every reward listed in the item description. Long cycles get pages automatically. - **Any cycle length** – 7 days by default, set as many days as you like. After the last day the cycle starts again. - **Streaks** – track how many days in a row each player claimed a reward. - **Missed day mode** – choose `reset` (back to day 1) or `continue` (no penalty). - **Daily reset at midnight** – in a time zone of your choice. - **Flexible rewards** – items (custom name, lore, glow, custom model data), console commands (economy, ranks, crates…), chat messages and sounds. - **Rank bonuses** – extra rewards for players with any permission you choose, e.g. one bonus for VIP and a bigger one for your top rank. Works with LuckPerms or any permissions plugin. - **Your own command names** – add aliases like `/nagrody` or `/belohnung` in `config.yml`. - **Full inventory handling** – drop extra items at the player's feet, or ask the player to free some space first. - **Join reminder** – a clickable chat message when today's reward is waiting. - **SQLite or MySQL / MariaDB** – SQLite works out of the box; MySQL shares streaks across all servers of a network. - **No duplicate claims** – every claim is a single atomic database operation, so spam clicks, lag or two servers at once can never give a reward twice. - **Claim history** – see when and on which server a reward was claimed. - **Admin tools** – check, change or reset a player's progress, even when they are offline. - **Multi-language** – English and Polish included, add your own language file. All texts use MiniMessage. - **Safe updates** – new config options are added automatically, your settings are never overwritten (a backup is made first). - **`/daily claim`** – claim without the GUI, handy for Bedrock players (Geyser). ## 📸 Screenshots     ## 📦 Requirements - **Paper 26.3** or newer - **Java 25** - No other plugins required ## 🚀 Installation 1. Put `LoginLoot-1.0.0.jar` into your `plugins/` folder. 2. Start the server. 3. Edit `plugins/LoginLoot/rewards.yml` (rewards) and `config.yml` (settings). 4. Run `/loginloot reload`. For a network, set `storage.type: mysql` in `config.yml` on every server, point them to the same database and give each server its own `server-name`, then restart. ## ⌨️ Commands Main command: `/loginloot` – default aliases: `/daily`, `/rewards` (add your own in `config.yml`) | Command | Description | Permission | |---|---|---| | `/daily` | Open the reward calendar | `loginloot.use` | | `/daily claim` | Claim today's reward without the GUI | `loginloot.use` | | `/daily help` | Show help | `loginloot.use` | | `/daily info ` | Show a player's progress | `loginloot.admin` | | `/daily setday ` | Set the next reward day | `loginloot.admin` | | `/daily reset ` | Reset a player's progress | `loginloot.admin` | | `/daily reload` | Reload configuration and language files | `loginloot.admin` | | `/daily version` | Show the plugin version | `loginloot.use` | ## 🔑 Permissions | Permission | Default | Description | |---|---|---| | `loginloot.use` | everyone | Use the calendar and claim rewards | | `loginloot.admin` | op | Admin commands and reload | | *any permission* (e.g. `loginloot.vip`) | – | Bonus rewards you define in `rewards.yml` | ## 🛠️ Example reward day ```yaml days: 7: icon: material: ENDER_CHEST glow: true rewards: diamonds: type: item material: DIAMOND amount: 8 money: type: command command: "eco give 500" display: "500 coins" finished: type: message text: "You finished the weekly cycle, !" bonuses: vip: permission: loginloot.vip rewards: scrap: type: item material: NETHERITE_SCRAP amount: 2 ``` ## 💬 Support Found a bug or have an idea? Join our **[Discord](https://discord.gg/kchw4zxpCc)** and let us know before leaving a review – we usually reply quickly. ## 📄 License Free to use on any number of servers, including commercial ones. All Rights Reserved – re-uploading, selling or modifying the plugin is not allowed. See `LICENSE.txt` in the plugin jar for details. *LoginLoot is made by Lumen Plugins. Developed with the help of AI tools and tested manually on Paper 26.3.*