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 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.

• 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