BoosterRewards

BoosterRewards | Discord-to-Minecraft Synchronization

BoosterRewards is an architecturally optimized system designed to automate guild booster incentives with surgical precision. It eliminates the friction of manual reward distribution by synchronizing Discord booster telemetry directly with your Minecraft server's internal permission and economy layers.

Premium Features

Architectural Integrity Engineered for modern server environments, BoosterRewards avoids the structural pathologies of legacy systems by focusing on data persistence and thread safety.

- Predictive State Sync: Database I/O (H2/MySQL) and Discord API interactions are strictly offloaded to dedicated worker threads. - Predictive State Sync: Perform atomic bot re-initialization and configuration updates via `/br reload` without server restarts. - Predictive State Sync: Real-time listening architecture detects boost status changes instantaneously, ensuring revocation logic is prioritized.

Dynamic Reward Evolution Add new items to reward pools mid-season without friction.

- Adaptive Claiming: Every item is uniquely indexed via MD5 hashing. - Adaptive Claiming: Existing boosters will automatically receive *only* newly added items upon their next `/claim`, preventing duplicate distribution of previously obtained rewards.

Minecraft-to-Discord Seamlessly connect identities through intuitive protocols. Supports both Minecraft-to-Discord (token handshake) and Minecraft-to-Discord flows.

---

Administration

Command Registry

| Command | Alias | Description | Permission | | :--- | :--- | :--- | :--- | | `/boosterrewards` | `/br`, `/brp` | Main system management. | `boosterrewards.admin` | | `/setboosterreward` | `/rewardsadmin` | Configure item-based rewards via GUI. | `boosterrewards.admin` | | `/claim` | | Access the reward distribution interface. | None | | `/link [code]` | | Initiate identity mapping. | None | | `/unlink` | `/logout` | Terminate account link. | None | | `/forceunlink

` | `/forcelogout` | Administrative link termination. | `boosterrewards.admin` |

Visual Reward Definition Define rewards through a direct-manipulation interface. Supports arbitrary NBT, custom metadata, and complex enchantments.

---

Configuration Patterns

Multi-Tiered Hierarchies Define multiple reward paths based on Discord roles or tenure.

```yaml rewards: booster: enabled: true permission: "boosterrewards.booster" on-boost: - "lp user %player% parent add booster" - "eco give %player% 5000" on-stop: - "lp user %player% parent remove booster" cooldown: 0 one-time: false