Logo
BoosterRewards
PluginMIT

BoosterRewards

Synchronize Discord server booster perks with Minecraft. Automate reward distribution and revocation with a high-performance, async architecture.

13
Downloads
0
Followers
2 months ago
Updated
📦
3
Versions
managementsocialutilityfoliapaperpurpur
Download Latestv0.0.2View on Modrinth

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

banner

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.

admingui
rewardseditor

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