?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
BoosterRewards

BoosterRewards

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

37
0
37
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Report issues View source Visit wiki Join Discord server
Donate on Ko-fi

Tags

Creators

Details

Licensed MIT
Published 3 months ago

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