Minecraft-Plugin EssentialsDiscordLink

🔌 Über EssentialsX Discord Link

EssentialsX Discord Link ist ein Add-on-Modul für EssentialsX Discord, das die Verknüpfung und Synchronisierung von Minecraft-Konten und Discord-Rollen ermöglicht. Es wurde entwickelt, um die Discord-Integration von EssentialsX mit Funktionen zu erweitern, die sich auf das Verknüpfen von Benutzeridentitäten und das Zuordnen von Vault-Gruppen zu Discord-Rollen (und umgekehrt) konzentrieren.

🎯 Zweck

Eine einfache, wartbare Möglichkeit bieten, damit Spieler ihre Minecraft- und Discord-Konten verknüpfen können und die Mitgliedschaft in Servergruppen sowie Discord-Rollen synchron bleiben. Außerdem können nicht verknüpfte Spieler daran gehindert werden, dem Server beizutreten oder zu interagieren, bis sie die Verknüpfung abgeschlossen haben.

⚙️ Funktionen

• Synchronisierung von Vault-Gruppe -> Discord-Rolle (Vault-Gruppennamen den Discord-Rollen-IDs zuordnen).
• Synchronisierung von Discord-Rolle -> Vault-Gruppe (Vault-Gruppen anhand von Discord-Rollen-IDs zuweisen).
• Verhindert, dass nicht verknüpfte Spieler dem Server beitreten.
• Verhindert, dass nicht verknüpfte Spieler sich bewegen oder Chat-Nachrichten senden, bis sie verknüpft sind.
• In-Game-Verknüpfungsablauf mit einem kurzen Code für die Verwendung in Discord.
• Eine kleine Entwickler-API zum Prüfen des Verknüpfungsstatus, zum Verknüpfen/Trennen von Spielern und zum Abrufen verknüpfter Daten.

🧩 Für wen es ist

• Server mit EssentialsX und dem EssentialsX-Discord-Modul, die eine Discord-Kontenverknüpfung benötigen.
• Server, die Vault-Gruppen verwenden und möchten, dass diese Gruppen als Discord-Rollen abgebildet werden (oder umgekehrt).
• Survival-, SMP- und Community-Server, die eine verifizierte Discord-Mitgliedschaft oder Rollen-Synchronisierung erfordern.

🏗️ Beispiel-Anwendungsfälle

• Einer Vault-basierten Spendergruppe automatisch zuweisen, wenn ein Spieler eine passende Discord-Rolle hat.
• Nicht verknüpfte Spieler vom Chatten oder Bewegen ausschließen, bis sie ihr Discord-Konto über den Verknüpfungscode im Spiel bestätigen.
• Ein Backend-Plugin oder Skript verwenden, um über die bereitgestellte API abzufragen, ob ein Spieler verknüpft ist.

⌨️ Befehle

⚙️ Installation

📥 Einrichtung

• Laden Sie das offizielle EssentialsX Discord Link-JAR herunter und legen Sie es in Ihrem Serververzeichnis plugins/ ab.
• Starten Sie den Server, um den Plugin-Ordner und die Standardkonfiguration zu erzeugen.
• Bearbeiten Sie die Plugin-Konfiguration unter plugins/EssentialsDiscordLink/config.yml, um groups (Vault-Gruppe -> Discord-Rollen-ID) und roles (Discord-Rollen-ID -> Vault-Gruppe) zu definieren.
• Nachdem Sie die Konfiguration gespeichert haben, führen Sie den Reload-Befehl der EssentialsX-Konsole aus (zum Beispiel ess reload) oder starten Sie den Server neu, um die Rollen-Synchronisierung zu übernehmen.

📦 Abhängigkeiten

• EssentialsX (core) — erforderlich (das Modul ist ein Add-on für EssentialsX Discord).
• EssentialsX Discord — erforderlich (dieses Add-on erweitert dieses Modul).
• Vault — wird für Zuordnungen zwischen Vault-Gruppe ↔ Discord-Rolle verwendet (in den Rollen-Synchronisierungsfunktionen erwähnt).

🧠 Technische Hinweise

• Das Plugin stellt eine kleine Entwickler-API (Service) bereit, mit der andere Plugins prüfen können, ob ein Spieler verknüpft ist, Spieler programmgesteuert verknüpfen/trennen und verknüpfte Daten abrufen können.
• Die Konfiguration verwendet plugins/EssentialsDiscordLink/config.yml für Zuordnungen zwischen Vault-Gruppen und Discord-Rollen-IDs.

🤝 Wann dieses Plugin nützlich ist

Wenn dein Server bereits EssentialsX verwendet und Spieler ihre Discord-Konten verifizieren oder verknüpfen müssen (und/oder Vault-Gruppen und Discord-Rollen synchron halten sollen), bietet EssentialsX Discord Link eine direkte, dokumentierte Integration, die innerhalb des EssentialsX-Modul-Ökosystems funktioniert.