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.
- Main-Thread Decoupling: Database I/O (H2/MySQL) and Discord API interactions are strictly offloaded to dedicated worker threads.
- Hot-Reload Integration: Perform atomic bot re-initialization and configuration updates via
/br reloadwithout 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.
- Granular Tracking: 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.
Bi-Directional Linking Seamlessly connect identities through intuitive protocols. Supports both Discord-to-Minecraft (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 <p> |
/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.
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
