Skip to main content

​
Economy Bridge

The economy-bridge module connects your Discord server to your in-game economy. Verified Discord users can check balances and, if you allow it, transfer funds to other players directly from Discord.

​
How It Works

  1. A player verifies their Discord account against their Minecraft account (via the verification module).
  2. economy-bridge reads that link and resolves the player’s balance through Vault.
  3. Discord commands operate on the linked in-game balance — queries are read-only, transfers move real funds through your economy provider.
Vault is required. This module depends on Vault and a registered economy provider. Players must also be verified through the verification module before their balance can be read or moved from Discord — unverified users are invisible to the bridge.

​
Configuration

features:
  economy-bridge:
    enabled: true
    # Symbol prepended to monetary values.
    currency-symbol: "$"
    # Human-readable name for the currency.
    currency-name: "coins"
    # How many players to show in top-balances listings.
    top-players: 10
    # Allow Discord-to-game transfers between players.
    allow-transfers: true
    # Minimum transfer amount.
    min-transfer: 1.0
    # Maximum transfer amount per transaction.
    max-transfer: 1000000.0
    # Fraction of each transfer taken as tax (0.0 = no tax).
    transfer-tax: 0.0

​
Security Notes

min-transfer and max-transfer cap every transaction. Transfers outside the range are rejected before any balance moves, preventing both dust spam and runaway transfers from a compromised account.
transfer-tax is a fraction between 0.0 and 1.0 skimmed from each transfer. At 0.0 no tax is applied. The taxed amount is removed from circulation — set it deliberately if you use the bridge as a currency sink.
Set allow-transfers: false to keep the bridge read-only. Players can still query balances and view top players, but no funds can move from Discord.

​
Next Steps

Community & Engagement

Browse the engagement modules: welcome DMs, voice channels, whitelisting, and more.

Configuration

See how every module is toggled and configured.