Minecraft plugin EssentialsDiscord

🔌 Over EssentialsX Discord

EssentialsX Discord (verstrekt als de EssentialsDiscord-module) is een officiële EssentialsX-module die een Minecraft-server integreert met een Discord-server. Hij draait als een plugin jar naast de kernmodule van EssentialsX en maakt via een geconfigureerde bot token verbinding met Discord om chat, gebeurtenissen en Discord-side interacties door te geven, ondersteund door een kleine API.

🎯 Doel

Het hoofddoel van de module is tweeledig: geselecteerde Minecraft-chat/gebeurtenissen doorsturen naar Discord-kanalen en geselecteerde Discord-berichten/commando’s doorsturen naar de Minecraft-server. De module is bedoeld voor serverbeheerders die directe, configureerbare communicatie en beperkte bediening op afstand willen tussen Discord en een op EssentialsX gebaseerde Minecraft-server.

⚙️ Functies

• Configureerbare kanaaltoewijzing voor verschillende berichttypen (chat, join/leave, staff, enz.).
• Doorsturen van Minecraft-chat naar Discord en optioneel doorsturen van Discord-berichten naar Minecraft-chat.
• Slash commands aan de Discord-kant die consolecommando’s kunnen uitvoeren, spelers berichten kunnen sturen en spelerslijsten kunnen tonen (configureerbaar en beperkt via rollen).
• Fijnmazig berichttypesysteem en per type opmaak, gedefinieerd in de pluginconfiguratie.
• Developer API voor het registreren van aangepaste berichttypen en Discord-interactiecommando’s via een meegeleverde DiscordService API.

🧩 Voor wie is dit

• Servereigenaren die EssentialsX gebruiken en Discord ↔ Minecraft chat-synchronisatie willen.
• Staffteams die privé staffkanalen willen koppelen aan staffleden in de game.
• Pluginontwikkelaars die eenvoudige Discord-interacties of aangepaste message hooks naar Discord willen ontsluiten.

🏗️ Voorbeeldtoepassingen

• Globale chat doorsturen naar een speciaal Discord-kanaal, terwijl staff-only Discord-berichten naar in-game staff worden gestuurd.
• Geverifieerde Discord-rollen toestaan om geconfigureerde serverquery’s of commando’s via slash commands uit te voeren zonder ze openbaar te maken.
• Een andere plugin gestructureerde meldingen naar Discord laten sturen door een aangepast berichttype te registreren met de EssentialsX Discord API.

⌨️ Commando’s

EssentialsX Discord biedt configureerbare slash commands aan de Discord-kant (geregistreerd bij Discord) in plaats van de gebruikelijke Minecraft-chatcommando’s. Die commando’s (voorbeelden staan in de officiële docs) worden uitgevoerd vanuit Discord en kunnen consolecommando’s uitvoeren, spelers berichten sturen of spelerslijsten tonen. De beschikbaarheid van commando’s en geavanceerde functies wordt geregeld via rol/ID-instellingen in de pluginconfiguratie.

🔐 Permissies

⚙️ Installatie

📥 Setup

• Download de EssentialsX Discord-module jar en plaats deze in de plugins/-map van je server naast de kern EssentialsX jar.
• Start de server om de configuratie van de module te genereren en stop daarna de server.
• Configureer de bot token, kanaal-ID's, message-types en commando-rolinstellingen in plugins/EssentialsDiscord/config.yml zoals gedocumenteerd, en start daarna opnieuw op.

📦 Afhankelijkheden

• EssentialsX (kern) — de module draait als add-on op de EssentialsX-plug-inreeks.

🧠 Technische notities

• De module biedt een service-API (DiscordService) waarmee andere plugins aangepaste berichttypen kunnen registreren en berichten naar geconfigureerde Discord-kanalen kunnen sturen.
• Discord-side commando’s worden geregeld via rollen/ID's die in de pluginconfiguratie zijn ingesteld, in plaats van via standaard Minecraft permission nodes.
• Admin-achtige configuratie (bot token, kanaal-ID's, berichtopmaak, commando-rol-ID's) gebeurt in het configuratiebestand van de module dat bij de eerste start wordt aangemaakt.

🤝 Wanneer deze plugin nuttig is

Wanneer je beheerde, configureerbare tweerichtingscommunicatie nodig hebt tussen een Discord-community en een op EssentialsX gebaseerde Minecraft-server (inclusief op rollen beperkte Discord-commando’s en developer hooks), biedt EssentialsX Discord een gerichte module die berichttoewijzing en een kleine API voor integraties afhandelt.