Minecraft-plugin EssentialsDiscord

🔌 Om EssentialsX Discord

EssentialsX Discord (distribueres som EssentialsDiscord-modulet) er et officielt EssentialsX-modul, der integrerer en Minecraft-server med en Discord-server. Det kører som en plugin jar sammen med kerne-modulet EssentialsX og forbinder til Discord via en konfigureret bot token for at videresende chat, events og give Discord-side interaktioner understøttet af et lille API.

🎯 Formål

Modulets kerneformål er todelt: at videresende udvalgte Minecraft chat/events til Discord-kanaler og at videresende udvalgte Discord-beskeder/kommandoer til Minecraft-serveren. Det er beregnet til serveradministratorer, der ønsker direkte, konfigurerbar kommunikation og begrænset fjernstyring mellem Discord og en EssentialsX-baseret Minecraft-server.

⚙️ Funktioner

• Konfigurerbar kanal-mapping for forskellige beskedtyper (chat, join/leave, staff osv.).
• Videresendelse af Minecraft-chat til Discord og valgfri videresendelse af Discord-beskeder til Minecraft-chat.
• slash commands på Discord-siden, der kan køre konsolkommandoer, sende beskeder til spillere og vise spillerlister (konfigurerbart og begrænset via roller).
• Finkornet system for beskedtyper og type-specifik formatering defineret i plugin-konfigurationen.
• Developer API til registrering af brugerdefinerede beskedtyper og Discord-interaktionskommandoer via den medfølgende DiscordService API.

🧩 Hvem er det til

• Serverejere, der kører EssentialsX og ønsker chat-synk mellem Discord ↔ Minecraft.
• Staff-teams, der vil have private staff-kanaler koblet til staff-medlemmer i spillet.
• Pluginudviklere, der vil eksponere simple Discord-interaktioner eller brugerdefinerede message hooks til Discord.

🏗️ Eksempel på brug

• Videresende global chat til en dedikeret Discord-kanal, mens staff-only Discord-beskeder sendes til staff i spillet.
• Lade verificerede Discord-roller køre konfigurerede serverforespørgsler eller kommandoer via slash commands uden at gøre dem offentlige.
• Lade et andet plugin sende strukturerede notifikationer til Discord ved at registrere en brugerdefineret beskedtype med EssentialsX Discord API.

⌨️ Kommandoer

EssentialsX Discord tilbyder konfigurerbare slash commands på Discord-siden (registreret med Discord) i stedet for typiske Minecraft chatkommandoer. De kommandoer (eksempler vises i den officielle dokumentation) køres fra Discord og kan udføre konsolkommandoer, sende beskeder til spillere eller vise spillerlister. Kommando-tilgængelighed og udvidede funktioner styres af rolle/ID-konfiguration i plugin-konfigurationen.

🔐 Tilladelser

⚙️ Installation

📥 Opsætning

• Download EssentialsX Discord-modulets jar, og læg den i serverens plugins/-mappe sammen med EssentialsX-kerne-jaren.
• Start serveren for at generere modulets konfiguration, og stop derefter serveren.
• Konfigurer bot token, kanal-ID'er, message-types og kommando-rolleindstillinger i plugins/EssentialsDiscord/config.yml som dokumenteret, og genstart derefter.

📦 Afhængigheder

• EssentialsX (core) — modulet kører som et add-on til EssentialsX plugin-pakken.

🧠 Tekniske noter

• Modulet stiller en service API (DiscordService) til rådighed, så andre plugins kan registrere brugerdefinerede beskedtyper og sende beskeder til konfigurerede Discord-kanaler.
• Discord-side kommandoer styres af roller/ID'er, der er konfigureret i plugin-konfigurationen, i stedet for standard Minecraft permission nodes.
• Administrationslignende konfiguration (bot token, kanal-ID'er, beskedformatering, rolle-ID'er til kommandoer) sker i modulets konfigurationsfil, der oprettes ved første start.

🤝 Hvornår er dette plugin nyttigt

Når du har brug for styret, konfigurerbar tovejs-kommunikation mellem et Discord-fællesskab og en EssentialsX-baseret Minecraft-server (inklusive rollebegrænsede Discord-kommandoer og developer hooks), leverer EssentialsX Discord et fokuseret modul, der håndterer beskedmapping og en lille API til integrationer.