Minecraft plugin EssentialsDiscordLink

🔌 O EssentialsX Discord Link

EssentialsX Discord Link je doplňkový modul pro EssentialsX Discord, který zajišťuje propojení účtů a synchronizaci mezi účty Minecraftu a rolemi Discordu. Je navržen tak, aby rozšířil integraci Discordu v EssentialsX o funkce zaměřené na propojení identit uživatelů a mapování skupin Vault na role Discordu (a naopak).

🎯 Účel

Poskytnout jednoduchý a snadno udržovatelný způsob, jak mohou hráči propojit své účty Minecraft a Discord a jak udržet členství ve skupinách serveru a role Discordu synchronizované. Podporuje také omezení nepropojených hráčů, aby se nemohli připojit ani interagovat, dokud propojení nedokončí.

⚙️ Funkce

• Synchronizace skupin Vault -> rolí Discordu (mapování názvů skupin Vault na ID rolí Discordu).
• Synchronizace rolí Discordu -> skupin Vault (přiřazování skupin Vault na základě ID rolí Discordu).
• Zabránění nepropojeným hráčům v připojení na server.
• Zabránění nepropojeným hráčům v pohybu nebo posílání zpráv v chatu, dokud se nepropojí.
• Herní proces propojení účtu, který vydá krátký kód pro použití v Discordu.
• Malé API pro vývojáře pro kontrolu stavu propojení, propojení/odpojení hráčů a získání propojených dat.

🧩 Pro koho je to určeno

• Servery používající EssentialsX a modul EssentialsX Discord, které potřebují propojení účtu Discord.
• Servery používající skupiny Vault a chtějí, aby se tyto skupiny odrážely jako role Discordu (nebo naopak).
• Servery Survival, SMP a komunitní servery, které vyžadují ověřené členství v Discordu nebo synchronizaci rolí.

🏗️ Příklady použití

• Automaticky přidělit donátorskou skupinu založenou na Vault, když má hráč odpovídající roli Discordu.
• Blokovat nepropojené hráče v chatu nebo pohybu, dokud nepotvrdí svůj účet Discord pomocí kódu propojení ve hře.
• Použít backendový plugin nebo skript k ověření přes poskytnuté API, zda je hráč propojený.

⌨️ Příkazy

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální jar EssentialsX Discord Link a vložte jej do adresáře plugins/ vašeho serveru.
• Spusťte server, aby se vytvořila složka pluginu a výchozí konfigurace.
• Upravte konfiguraci pluginu v plugins/EssentialsDiscordLink/config.yml a definujte groups (skupina Vault -> ID role Discordu) a roles (ID role Discordu -> skupina Vault).
• Po uložení konfigurace spusťte reload příkaz v konzoli EssentialsX (například ess reload) nebo restartujte server, aby se nastavení synchronizace rolí projevilo.

📦 Závislosti

• EssentialsX (core) — vyžadováno (tento modul je doplněk pro EssentialsX Discord).
• EssentialsX Discord — vyžadováno (tento doplněk rozšiřuje daný modul).
• Vault — používá se pro mapování skupin Vault ↔ rolí Discordu (zmíněno ve funkcích synchronizace rolí).

🧠 Technické poznámky

• Plugin vystavuje malé API pro vývojáře (service), které umožňuje ostatním pluginům zjistit, zda je hráč propojený, programově hráče propojit/odpojit a získat propojená data.
• Pro mapování mezi skupinami Vault a ID rolí Discordu se používá konfigurace plugins/EssentialsDiscordLink/config.yml.

🤝 Kdy je tento plugin užitečný

Pokud už váš server používá EssentialsX a potřebujete, aby hráči ověřovali nebo propojovali své účty Discordu (a/nebo aby zůstaly skupiny Vault a role Discordu synchronizované), EssentialsX Discord Link poskytuje přímou, zdokumentovanou integraci, která funguje v ekosystému modulů EssentialsX.