Setup

Setup

1. Requirements

• Java 21 installed on your server
• Paper 1.21.11 (this plugin has only been tested on this exact version)

2. Create a Discord bot

1. Go to the Discord Developer Portal
2. Click "New Application," give it a name
3. Go to the "Bot" tab
4. Click "Reset Token," copy it somewhere safe — you'll need it in step 4
5. On the same page, enable Message Content Intent (this is required, chat sync won't work without it)

3. Invite the bot to your server

1. Go to "OAuth2" → "URL Generator"
2. Under "Scopes," check bot
3. Under "Bot Permissions," check at minimum:
   • Send Messages
   • Read Message History
   • Manage Messages (needed for the player list command to clean up after itself)
4. Copy the generated URL, open it in your browser, pick your server

4. Install the plugin

1. Download the .jar file from Modrinth or the Releases page
2. Drop it in your server's plugins/ folder
3. Start the server once (this generates the config file)
4. Stop the server (or leave it running if you're on a live server and don't want to restart)

5. Fill in your config

Open plugins/DiscordPulse/config.yml and set:

• bot-token — the token you copied in step 2
• channel-id — right-click your target Discord channel (Developer Mode must be on in Discord settings), Copy Channel ID

Leave debug and debug-logging as false unless something's broken and you're trying to figure out why.

6. Restart

Restart the server. Check your Discord channel — you should see a green "Server is online" message. If you don't, check the Troubleshooting page before opening an issue.