Hoe koppel ik mijn Minecraft-server aan Discord met DiscordSRV?

DiscordSRV verbindt de chat van je Minecraft-server met een Discord-kanaal: berichten gaan twee kanten op, en joins, leaves en dood-meldingen verschijnen automatisch in Discord. Voor een SMP of hardcore-seizoen is dat de makkelijkste manier om de hele groep bij het spel te houden, ook als ze niet online zijn.

Stap 1: maak een Discord-bot

1. Ga naar het Discord Developer Portal en maak een nieuwe applicatie.
2. Open het tabblad Bot en kopieer het token. Deel dit token met niemand; wie het heeft, bestuurt je bot.
3. Zet op hetzelfde tabblad de Message Content Intent en de Server Members Intent aan. Zonder de eerste ziet de bot geen berichten.
4. Ga naar OAuth2, kies scope bot met de rechten om berichten te lezen en te sturen, en open de gegenereerde link om de bot in je Discord-server uit te nodigen.

Stap 2: installeer de plugin

Installeer DiscordSRV via de pluginbibliotheek van je paneel of upload het jar-bestand naar plugins. Zie een plugin installeren. Herstart de server; de map plugins/DiscordSRV verschijnt met de configuratiebestanden.

Stap 3: token en kanaal invullen

Zet in Discord de ontwikkelaarsmodus aan (Instellingen, Geavanceerd) en klik met de rechtermuisknop op het chatkanaal om het kanaal-ID te kopiëren. Open plugins/DiscordSRV/config.yml en vul in:

BotToken: "jouw-bot-token"
Channels: {"global": "123456789012345678"}

Herstart de server of typ /discordsrv reload. In de console zie je of de bot verbinding maakt. Test met een bericht in Minecraft: het hoort binnen een seconde in Discord te staan, en andersom.

Dood-meldingen en joins

Standaard staan dood-meldingen en join- en leave-berichten aan. Wil je ze aanpassen of uitzetten, open dan plugins/DiscordSRV/messages.yml. Voor een hardcore-seizoen is het leuk om dood-meldingen in een apart kanaal te zetten; voeg dan een extra kanaal toe aan Channels en verwijs daar in messages.yml naar.

Accounts koppelen (optioneel)

Met /discord link krijgt een speler een code die hij aan de bot stuurt. Daarna kan DiscordSRV bijvoorbeeld automatisch een Discord-rol geven aan spelers die op de whitelist staan. Voor een vriendengroep is dit niet nodig.

Veelvoorkomende problemen

• De bot komt online maar er gebeurt niets: controleer het kanaal-ID en of de bot rechten heeft in dat kanaal.
• Fout over intents in de console: de Message Content Intent staat uit in het Developer Portal.
• Berichten komen dubbel: er draait nog een andere chat-plugin die dezelfde koppeling maakt; zet er één uit.
• Token gelekt: genereer in het Developer Portal een nieuw token en vervang het in config.yml.