Configuration

Configuration

access-token

Default: access-token: ""

Required. Your OAuth2 token from DonationAlerts.
Get it here.

reconnect-delay

Default: reconnect-delay: 10

Delay in seconds before reconnecting after a disconnection.

log-donations

Default: log-donations: true

Log each donation to console.

log-info

Default: log-info: true

Log connection status, authentication, subscription events to console.

log-web-socket

Default: log-web-socket: false

Log raw WebSocket messages (incoming/outgoing) to console.

enable-builtin-commands

Default: enable-builtin-commands: true

If you don't want to handle donations via your own code, enable this option. When a donation arrives, the plugin will automatically execute a list of commands as the console (with full permissions).

commands

Default:

commands:
  - title @a title {"text":">> Donation! <<","color":"gold"}
  - title @a subtitle {"text":"$sender$ - $amount$ $currency$"}
  - tellraw @a {"text":"[DONATION] $sender$ - $message$"}
  - playsound minecraft:entity.experience_orb.pickup master @a
  - tellraw $sender$ {"text":"❤ Thanks for donation!","color":"green"}

Each command is a string exactly as you would type it in the console.

Available Placeholders

• $sender$ - Sender's username. Example: ProTerUga
• $amount$ - Donation amount (numeric). Example: 5.00
• $currency$ - Currency code. Example: USD, EUR, RUB
• $message$ - Donation message (can be empty): Hello! Great server!

Messages

Default:

messages:
  prefix: "<dark_gray>[<gradient:#F2A544:#FFDC80>DonationAlertsAPI</gradient>]</dark_gray> "
  reload:
    successfully-reloaded: "<green>Configuration reloaded!"
    successfully-connected: "<green>Successfully connected to DonationAlerts!"
    reconnect-trying: "<yellow>Reconnecting... Check result in a few seconds."
    missing-token: "<red>Cannot connect: access-token is missing."
    connection-failed: "<red>Connection failed. Check console for errors."
  status:
    connected: "<gray>Connection status: <green>Connected"
    not-connected: "<gray>Connection status: <red>Not connected"
  test:
    connection-warning: "<yellow>Warning! DonationAlerts is NOT connected!"
    donation: "<green>The donation was successfully triggered."

All messages sent to players and the console are defined here. The plugin uses MiniMessage (Adventure) natively — legacy color codes (&) are not supported.

Full Documentation

For complete MiniMessage documentation, visit: https://docs.papermc.io/adventure/minimessage/format/