Installation

Prerequisites

Minecraft server running Paper or Spigot 1.21.4+
Java 21 installed
Access to Discord Developer Portal
Server restart capability

1 Create Discord Bot

1.1 Create Application

Go to discord.com/developers/applications
Click New Application
Enter name: "BoosterRewards Bot"
Click Create

1.2 Create Bot User

Click Bot in left sidebar
Click Reset Token
Click Yes, do it!
Click Copy to copy your bot token

⚠️ Warning: Never share your bot token. Treat it like a password.

1.3 Enable Server Members Intent

Scroll down to Privileged Gateway Intents:

Enable SERVER MEMBERS INTENT (required)
Click Save Changes

1.4 Invite Bot to Server

Click OAuth2 → URL Generator
Under Scopes, select:
- bot
- applications.commands
Under Bot Permissions, select:
- Send Messages
- Embed Links
- Manage Roles (optional)
Copy generated URL
Open URL in browser
Select your Discord server
Click Authorize

2 Install Plugin

Download latest BoosterRewards-X.X.X-Fat.jar from Releases
Place JAR in plugins/ folder
Start your server
Wait for server to fully load
Stop your server

The plugin creates:

File Structure

plugins/BoosterRewards/
├── config.yml
├── discord.yml
├── messages.yml
└── database/
    └── boosterrewards.db

3 Configure Discord Bot

Edit plugins/BoosterRewards/discord.yml:

3.1 Add Bot Token

discord.yml

bot:
  token: "YOUR_BOT_TOKEN_HERE"
  guild-id: "000000000000000000"

Replace YOUR_BOT_TOKEN_HERE with token from Step 1.2

3.2 Get Guild ID

Open Discord
Go to User Settings → Advanced
Enable Developer Mode
Right-click your server icon
Click Copy Server ID
Paste into guild-id

4 Configure Rewards

Edit plugins/BoosterRewards/config.yml:

config.yml

rewards:
  booster:
    enabled: true
    on-boost:
      - "lp user %player% parent add booster"
      - "give %player% diamond 5"
    on-stop:
      - "lp user %player% parent remove booster"

This example:

Adds "booster" LuckPerms group when player boosts
Gives 5 diamonds
Removes group when boost expires

See config.yml for all configuration options.

5 Start Server

Start your Minecraft server
Check console for:

Console Output

[BoosterRewards] Enabling BoosterRewards v0.0.1
[BoosterRewards] Connected to Discord guild: YourServerName
[BoosterRewards] Database initialized successfully
[BoosterRewards] Registered 3 Discord commands

✅ Success! If you see these messages, installation is complete.

6 Verify Installation

Test Discord Bot

In your Discord server, type / and verify these commands appear:

/link
/unlink
/status

Test In-Game

Join your server and run:

Minecraft Command

/boosterrewards

You should see the plugin help menu.

Troubleshooting

If you encounter issues:

BoosterRewards Wiki