How to Set Up Discord Integration for Your Server

What You'll Need

• A Lodgichost Minecraft server (any version)
• The DiscordSRV plugin
• A Discord server where you have "Manage Server" permissions
• A Discord Bot Application (created through the Discord Developer Portal)

Step 1: Create a Discord Bot

Before you can link DiscordSRV to your Discord server, you need a bot token. This is how Discord identifies and authenticates your bot.

1. Go to the Discord Developer Portal at discord.com/developers/applications and click "New Application". Give it a name (e.g., "My Server Bot").
2. Navigate to the Bot tab on the left sidebar. Click "Add Bot" and confirm.
3. Copy the bot token by clicking "Reset Token" and then "Copy". Save this token somewhere secure — you'll need it in Step 3.
4. Enable Privileged Gateway Intents: Under the Bot settings, toggle on "SERVER MEMBERS INTENT" and "MESSAGE CONTENT INTENT". DiscordSRV needs these to function properly.
5. Invite the bot to your server: Go to the OAuth2 > URL Generator page. Select the bot scope, then choose permissions: "Send Messages", "Read Message History", "Manage Webhooks", "Embed Links", and "Attach Files". Use the generated URL to invite the bot to your Discord server.

Step 2: Install DiscordSRV

1. Download DiscordSRV from the official SpigotMC page or from discordsrv.com. Make sure you download the latest build for your server version.
2. Upload the jar to your server's plugins folder via the Lodgichost file manager or FTP.
3. Restart your server. DiscordSRV will create a DiscordSRV folder with several configuration files.

Step 3: Configure DiscordSRV

The main configuration file is config.yml inside the plugins/DiscordSRV/ directory. Open it and make these changes:

• BotToken: Paste the bot token you copied from the Discord Developer Portal inside the quotes.
• ServerID: Set this to your Discord server's ID. To find it, enable Developer Mode in Discord (Settings > Advanced > Developer Mode), right-click your server name, and select "Copy ID".
• ChannelAlerts: Set the channel ID where you want join/leave messages to appear.
• ChannelChat: Set the channel ID where in-game chat will be relayed to and from Discord.
• ChannelConsole: Set a channel ID for the console channel (optional — lets you run server commands from Discord).

To get a channel ID, enable Developer Mode in Discord, right-click the channel name, and select "Copy ID".

Step 4: Restart and Verify

1. Restart your Minecraft server after saving the config.yml file.
2. Check the console for a message like: "[DiscordSRV] Connected to Discord!". If you see this, the bot is online and linked.
3. Send a message in the Discord channel you configured for chat. It should appear in your Minecraft server's in-game chat, and vice versa.

Useful Features

Beyond basic chat sync, DiscordSRV offers several powerful features:

• Player status tracking: Use the !players command in Discord to see who's currently online.
• Console channel: If you configured ChannelConsole, you can run server commands directly from Discord. Commands in that channel are executed on the server.
• Advancement announcements: Players' advancement messages can be broadcast to a Discord channel.
• Death messages: When a player dies, the death message can appear in a dedicated Discord channel.
• Custom formats: You can customise how messages appear in both Discord and in-game using the messages.yml file.

Troubleshooting Tips

• Bot doesn't come online: Double-check the bot token in config.yml. Make sure there are no extra spaces around the token.
• Messages not syncing: Verify the channel IDs are correct. They should be numeric strings.
• Missing intents error: Go back to the Discord Developer Portal and make sure SERVER MEMBERS INTENT and MESSAGE CONTENT INTENT are both enabled.
• "Invalid token" error: Regenerate the bot token in the Discord Developer Portal and update your config.yml with the new one.

Lodgichost Ready

DiscordSRV is compatible with all Lodgichost Minecraft plans. You can install it through the plugin manager in your Lodgichost portal, or upload it manually via FTP. If you need help with the configuration, our support team is available to assist. Log in to your portal to get started.