Minecraft-plugin EssentialsDiscordLink

🔌 Om EssentialsX Discord Link

EssentialsX Discord Link är en tilläggsmodul för EssentialsX Discord som erbjuder kontolänkning och synkronisering mellan Minecraft-konton och Discord-roller. Den är utformad för att utöka EssentialsX Discord-integrationen med funktioner som fokuserar på att länka användaridentiteter och mappa Vault-grupper till Discord-roller (och vice versa).

🎯 Syfte

Att erbjuda ett enkelt och lättunderhållet sätt för spelare att länka sina Minecraft- och Discord-konton och hålla servergruppsmedlemskap och Discord-roller synkroniserade. Den stöder också att hindra olänkade spelare från att gå med eller interagera tills de har slutfört länken.

⚙️ Funktioner

• Synkronisering av Vault-grupp -> Discord-roll (mappa Vault-gruppnamn till Discord-roll-ID:n).
• Synkronisering av Discord-roll -> Vault-grupp (tilldela Vault-grupper baserat på Discord-roll-ID:n).
• Förhindra att olänkade spelare ansluter till servern.
• Förhindra att olänkade spelare rör sig eller skickar chattmeddelanden tills de länkar.
• Ett flöde för kontolänkning i spelet som utfärdar en kort kod för användning i Discord.
• Ett litet utvecklar-API för att kontrollera länkstatus, länka/avlänka spelare och hämta länkad data.

🧩 Vem den är för

• Servrar som använder EssentialsX och EssentialsX Discord-modulen och behöver Discord-kontolänkning.
• Servrar som använder Vault-grupper och vill att de grupperna ska speglas som Discord-roller (eller tvärtom).
• Survival-, SMP- och communityservrar som kräver verifierat Discord-medlemskap eller rollsynk.

🏗️ Exempel på användning

• Tilldela automatiskt en Vault-baserad donatorgrupp när en spelare har en matchande Discord-roll.
• Blockera olänkade spelare från att chatta eller röra sig tills de bekräftar sitt Discord-konto via länkkoden i spelet.
• Använda ett backend-plugin eller ett skript för att fråga om en spelare är länkad via det tillhandahållna API:t.

⌨️ Kommandon

⚙️ Installation

📥 Konfiguration

• Ladda ner den officiella EssentialsX Discord Link-jar-filen och placera den i serverns plugins/-katalog.
• Starta servern för att skapa pluginmappen och standardkonfigurationen.
• Redigera plugin-konfigurationen i plugins/EssentialsDiscordLink/config.yml för att definiera groups (Vault-grupp -> Discord-roll-ID) och roles (Discord-roll-ID -> Vault-grupp).
• Efter att du sparat konfigurationen, kör EssentialsX-konsolens reload-kommando (till exempel ess reload) eller starta om servern för att tillämpa inställningarna för rollsynk.

📦 Beroenden

• EssentialsX (core) — krävs (den här modulen är ett tillägg till EssentialsX Discord).
• EssentialsX Discord — krävs (detta tillägg utökar den modulen).
• Vault — används för Vault-grupp ↔ Discord-rollmappningar (omnämns i funktionerna för rollsynk).

🧠 Tekniska anteckningar

• Pluginet exponerar ett litet utvecklar-API (service) som låter andra plugins kontrollera om en spelare är länkad, länka/avlänka spelare programmatiskt och hämta länkad data.
• Konfigurationen använder plugins/EssentialsDiscordLink/config.yml för mappningar mellan Vault-grupper och Discord-roll-ID:n.

🤝 När det här pluginet är användbart

Om din server redan använder EssentialsX och du behöver att spelare verifierar eller länkar sina Discord-konton (och/eller håller Vault-grupper och Discord-roller synkroniserade), erbjuder EssentialsX Discord Link en direkt, dokumenterad integration som fungerar inom EssentialsX modul-ekosystemet.