<a id="readme-top"></a> <div align="center"> <h1>BoostSync</h1> <p><strong>Reward your Discord Nitro boosters in Minecraft — automatically, and only when they're actually boosting.</strong></p> <p> Secure Discord account linking, automatic booster verification, temporary rank synchronization, seasonal rewards, and configurable renewals for Spigot and Paper servers. </p> <!-- Modrinth --> <p> <a href="https://modrinth.com/plugin/boostsync#download"> <img src="https://img.shields.io/modrinth/dt/boostsync?style=for-the-badge&logo=modrinth&label=Downloads&color=1bd96a" alt="Modrinth Downloads"> </a> <a href="https://modrinth.com/plugin/boostsync/versions"> <img src="https://img.shields.io/modrinth/v/boostsync?style=for-the-badge&logo=modrinth&label=Version&color=1565c0" alt="Latest Version"> </a> <a href="https://modrinth.com/plugin/boostsync"> <img src="https://img.shields.io/badge/Modrinth-BoostSync-1bd96a?style=for-the-badge&logo=modrinth" alt="View on Modrinth"> </a> </p> <!-- GitHub --> <p> <a href="https://github.com/OkaySleepy/BoostSync/releases"> <img src="https://img.shields.io/github/downloads/OkaySleepy/BoostSync/total?style=for-the-badge&logo=github&label=Downloads" alt="GitHub Downloads"> </a> <a href="https://github.com/OkaySleepy/BoostSync/releases/latest"> <img src="https://img.shields.io/github/v/release/OkaySleepy/BoostSync?style=for-the-badge&logo=github&label=Version" alt="Latest Version"> </a> <a href="https://github.com/OkaySleepy/BoostSync"> <img src="https://img.shields.io/badge/GitHub-BoostSync-181717?style=for-the-badge&logo=github" alt="View on GitHub"> </a> </p> </div> --- --- # BoostSync **Reward your Discord Nitro boosters in Minecraft — automatically, and only when they're actually boosting.** BoostSync links a player's Minecraft account to their Discord account with a quick one-time code, checks whether they hold your server's Booster role, and hands out rewards plus a temporary in-game rank. From then on it keeps that rank in sync with Discord on its own: keep boosting and the rank keeps renewing, stop boosting and it quietly expires. **Reward your Discord Nitro boosters in Minecraft --- automatically, and only when they're actually boosting.** BoostSync links a player's Minecraft account to their Discord account with a quick one-time code, checks whether they hold your server's Booster role, and hands out rewards plus a temporary in-game rank. From then on it keeps that rank in sync with Discord on its own: keep boosting and the rank keeps renewing, stop boosting and it quietly expires. ------------------------------------------------------------------------ ## Features - **Secure account linking** --- a short one-time code the player pastes into a Discord channel, tied to their real Discord account. - **Automatic role verification** --- checks your configured Booster role directly through the Discord bot. - **Temporary booster rank** --- granted on boost and renewed every cycle while the player keeps boosting. - **Auto-renewal & expiry** --- a background check renews active boosters and removes the rank from anyone who stopped. - **Once-per-season rewards** --- the one-time bonus can only be claimed once per season, even if a player unboosts and reboosts. - **Instant manual re-check** --- linked players just run `/booster` again to refresh on the spot instead of waiting. - **Fully configurable** --- every reward, rank command, cooldown, interval, and message lives in `config.yml`. ------------------------------------------------------------------------ ## How it works **1. A player boosts your Discord and runs `/booster`.** The first time, BoostSync gives them a six-character code and asks them to paste it in your verification channel. **2. The bot verifies the boost.** If the player has your configured Booster role, their account is linked, seasonal rewards are granted, and a temporary Booster rank is applied. **3. Automatic synchronization.** Every configured interval (30 minutes by default), BoostSync checks linked players: - Still boosting? The temporary rank is renewed. - No longer boosting? The rank expires automatically after its configured duration. **4. Manual refresh.** Already-linked players can run `/booster` anytime to instantly refresh their status. **5. Seasonal rewards.** Rewards are only granted once per season. Changing the configured season resets eligibility. ------------------------------------------------------------------------ ## Commands ----------------------------------------------------------------------- Command Description Permission ----------------------- ----------------------- ----------------------- `/booster` Verify your boost, `boostsync.use` claim rewards, and