\ud83c\uddec\ud83c\udde7 English<\/p>\n
Synccord is an all-in-one integration plugin that connects your Paper\/Spigot server with a Discord guild:<\/p>\n
\u2705 Account linking via codes (MC \u2194 Discord) with SQLite storage<\/p>\n
\ud83d\udd01 Role sync between Discord roles and LuckPerms groups<\/p>\n
\ud83d\udcac Full chat bridge (Minecraft \u2194 Discord) + join\/leave\/death embeds<\/p>\n
\ud83e\uddfe Ticket system with buttons, modals, LiteBans hook & transcripts<\/p>\n
\ud83d\udcca Live server status embed (TPS, MSPT, players, IPs) with offline detection<\/p>\n
\ud83d\udc65 Online player list embed that updates automatically<\/p>\n
\ud83d\udcdc Rule acceptance flow with code word & auto-role<\/p>\n
\ud83e\udde9 PlaceholderAPI expansion (synccord_\u2026) for stats, link state & Discord info<\/p>\n
\u2699\ufe0f Everything configurable via config.yml, lang\/de.yml, rules.yml<\/p>\n
\ud83e\udeb2 Debug mode with detailed log messages<\/p>\n
\ud83d\udcc8 bStats support<\/p>\n
Features in detail
\n\ud83d\udd17 Account linking (MC \u2194 Discord)<\/p>\n
Code-based linking:<\/p>\n
On the Minecraft side a code is generated.<\/p>\n
On Discord you confirm the code via Slash-\/Button flow.<\/p>\n
Links are stored in SQLite (linked_users table) \u2013 no YAML spam.<\/p>\n
Commands:<\/p>\n
\/dcfind \/unlinkdiscord \/linkmc \u2026 & \/unlinkmc \u2026 \u2013 Discord slash commands to link\/unlink from Discord<\/p>\n Placeholders & Lang-keys show link status, last link time, remaining code time, etc.<\/p>\n \ud83c\udfad RoleSync (Discord \u2194 LuckPerms)<\/p>\n Discord \u2192 Minecraft:<\/p>\n role-link: in config.yml maps Discord role IDs \u2192 LuckPerms groups.<\/p>\n On player join, Synccord looks up the linked Discord member and syncs groups.<\/p>\n Groups are added\/removed so that Discord role setup and in-game groups always match.<\/p>\n Extensive debug logs: which role\/group combination is checked, added, removed, or unchanged.<\/p>\n Errors (missing guild id \/ role \/ member) are localized via lang\/de.yml.<\/p>\n (LuckPerms is a hard dependency.)<\/p>\n \ud83d\udcac Chat bridge & Join\/Leave\/Death embeds<\/p>\n Minecraft \u2192 Discord:<\/p>\n All chat messages go into the configured discord.chat-channel-id.<\/p>\n Uses PlaceholderAPI to format player name, prefix, status, etc.<\/p>\n Configurable format in config.yml (chat.format-to-discord).<\/p>\n Discord \u2192 Minecraft:<\/p>\n Messages from the configured channel are sent into the Minecraft chat.<\/p>\n Supports placeholder replacement and color codes.<\/p>\n Can block mentions and ignore bot messages.<\/p>\n Join\/Leave\/Death forwarding:<\/p>\n Randomizable messages for join\/leave\/death (discord.join-messages, discord.leave-messages, discord.death-messages).<\/p>\n Embedded messages with color and player name.<\/p>\n Features toggleable via features.send-join, features.send-leave, features.send-death.<\/p>\n \ud83e\uddfe Ticket system (Discord-only, but Minecraft-aware)<\/p>\n Multiple ticket types in config.yml under tickets: Each type has:<\/p>\n Name, description, button label<\/p>\n Support roles (supporter_roles)<\/p>\n Ticket category (Discord category ID)<\/p>\n Optional LiteBans hook to attach ban info to unban tickets<\/p>\n A list of questions with max input length (modal form)<\/p>\n Slash command \/ticket setup \u2026 (Discord) to post ticket panels.<\/p>\n When a ticket is created:<\/p>\n A private ticket channel is created in the configured category.<\/p>\n Supporters get permissions, the user sees only their own ticket.<\/p>\n Transcripts:<\/p>\n On closing a ticket, all messages are collected and uploaded as transcript.txt in the log channel, with an informative embed.<\/p>\n Minecraft integration:<\/p>\n When a staff member joins the server and there are open tickets, they receive an in-game reminder (configurable Lang key).<\/p>\n \ud83d\udcca Live server status embed<\/p>\n Slash command \/setup info sends a server info panel to a Discord channel:<\/p>\n TPS, MSPT, uptime<\/p>\n Online player count<\/p>\n Java & Bedrock IP from config<\/p>\n tps-monitor automatically updates the embed every X seconds.<\/p>\n Synccord remembers channel + message ID in a small YAML file and restores them after restart.<\/p>\n If the server is offline, InfoUpdaterOffline replaces the panel with an \u201coffline\u201d embed and a button, so users always see a valid status.<\/p>\n \ud83d\udc65 Online player list embed<\/p>\n Separate player list embed:<\/p>\n Shows current online players with rank & aliases (playerlist.rank-aliases).<\/p>\n Config options: show rank, alias, name; line format per player.<\/p>\n Updates automatically on player join \/ quit.<\/p>\n Stores channel + message ID and reuses them after restart.<\/p>\n \ud83d\udcdc Rules & code-word acceptance<\/p>\n File rules.yml holds your server rules in multiple sections.<\/p>\n Discord slash command \/setup regel:<\/p>\n Sends the rules into a channel (split into multiple embeds if needed).<\/p>\n Adds a \u201cAccept rules\u201d button that opens a modal with a code word.<\/p>\n If the user enters the correct codeword from config.yml (rules.keyword):<\/p>\n They receive the configured accept role (rules.accept-role-id).<\/p>\n Errors, success, and debug messages are fully localized via Lang.<\/p>\n \ud83e\udde9 PlaceholderAPI: %synccord_*%<\/p>\n Synccord registers a PlaceholderAPI expansion synccord with many placeholders, for example:<\/p>\n Global:<\/p>\n %synccord_tps%, %synccord_mspt%<\/p>\n %synccord_online_count%, %synccord_max_players%<\/p>\n %synccord_uptime%<\/p>\n %synccord_ip_java%, %synccord_ip_bedrock%<\/p>\n %synccord_synccord_version%<\/p>\n %synccord_status_embed_active%, %synccord_playerlist_embed_active%<\/p>\n %synccord_discord_online%, %synccord_linked_online%<\/p>\n %synccord_tickets_open%<\/p>\n Per-player (needs player context & link):<\/p>\n Basic: %synccord_player%, %synccord_uuid%, %synccord_x%, %synccord_y%, %synccord_z%<\/p>\n Link state: %synccord_discord_id%, %synccord_discord_linked%, %synccord_discord_status%<\/p>\n Discord info: %synccord_discord_tag%, %synccord_discord_username%, %synccord_discord_avatar%<\/p>\n Roles: %synccord_discord_roles%, %synccord_role_count%, %synccord_highest_role%<\/p>\n Linking info: %synccord_last_linked%, %synccord_code_expire%, %synccord_sync_fail_reason%<\/p>\n Tickets: %synccord_tickets_user%, %synccord_ticket_support_role%, %synccord_last_ticket_time%<\/p>\n Perfect for Scoreboards, MOTDs, TAB, or other chat plugins.<\/p>\n \ud83d\udee0 Language, debug & metrics<\/p>\n All user-visible text is in lang\/de.yml:<\/p>\n Normal messages, error messages, debug logs, ticket texts, rule messages, etc.<\/p>\n Missing keys get a clear \u201cmissing key\u201d message so you can fix them.<\/p>\n debug: true in config.yml enables very detailed debug logging:<\/p>\n Linking, Slash commands, role sync, tickets, embeds, Playerlist, InfoUpdater, etc.<\/p>\n bStats is integrated (ID is configured in the plugin) to provide anonymous statistics.<\/p>\n \ud83d\udce6 Requirements<\/p>\n Server: Paper \/ Purpur \/ Spigot (tested with 1.21)<\/p>\n Java: modern LTS (e.g. Java 17+; plugin is built for Java 21)<\/p>\n Dependencies:<\/p>\n Required: LuckPerms<\/p>\n Optional but supported:<\/p>\n LiteBans \u2013 for unban ticket integration<\/p>\n PlaceholderAPI \u2013 for placeholders & chat formatting<\/p>\n \ud83c\udde9\ud83c\uddea Deutsch<\/p>\n Synccord ist ein umfangreiches Discord-\u2194-Minecraft-Plugin:<\/p>\n \u2705 Account-Verkn\u00fcpfung (MC \u2194 Discord) mit Codes & SQLite<\/p>\n \ud83d\udd01 Rollen-Sync zwischen Discord-Rollen und LuckPerms-Gruppen<\/p>\n \ud83d\udcac Chat-Bridge (Minecraft \u2194 Discord) inkl. Join\/Leave\/Tod-Embeds<\/p>\n \ud83e\uddfe Ticketsystem mit Buttons, Modals, LiteBans-Anbindung & Transkript<\/p>\n \ud83d\udcca Serverstatus-Embed (TPS, MSPT, Spieler, IPs) mit Offline-Erkennung<\/p>\n \ud83d\udc65 Spielerliste-Embed, das sich automatisch aktualisiert<\/p>\n \ud83d\udcdc Regel-System mit Codewort-Abfrage & Auto-Rolle<\/p>\n \ud83e\udde9 PlaceholderAPI-Expansion (synccord_\u2026) f\u00fcr Stats, Linkstatus & Discord-Infos<\/p>\n \u2699\ufe0f Voll konfigurierbar \u00fcber config.yml, lang\/de.yml, rules.yml<\/p>\n \ud83e\udeb2 Debug-Modus mit ausf\u00fchrlichen Logs<\/p>\n \ud83d\udcc8 bStats-Unterst\u00fctzung<\/p>\n Funktions\u00fcbersicht Spieler erhalten im Minecraft einen Code, den sie auf Discord best\u00e4tigen.<\/p>\n Die Verkn\u00fcpfung wird in einer SQLite-Datenbank gespeichert \u2013 dauerhaft und sauber.<\/p>\n Befehle:<\/p>\n \/dcfind \/unlinkdiscord \/linkmc \u2026 \/ \/unlinkmc \u2026 \u2013 Slash-Commands auf Discord<\/p>\n Placeholders & Langtexte liefern Infos zu Linkstatus, letztem Link, Restlaufzeit des Codes usw.<\/p>\n \ud83c\udfad Rollen-Synchronisation<\/p>\n Discord \u2192 Minecraft (LuckPerms):<\/p>\n In config.yml unter role-link: werden Discord-Rollen-IDs \u2192 LuckPerms-Gruppen gemappt.<\/p>\n Beim Join eines verkn\u00fcpften Spielers werden die Gruppen in LuckPerms angepasst.<\/p>\n Gruppen werden hinzugef\u00fcgt\/entfernt, bis sie zu den vorhandenen Discord-Rollen passen.<\/p>\n Umfangreiche Debug-Ausgaben: welche Rolle\/Gruppe gepr\u00fcft, hinzugef\u00fcgt, entfernt oder ignoriert wurde.<\/p>\n Fehler (fehlende Guild-ID, Rolle, Member) laufen komplett \u00fcber die Sprachdatei.<\/p>\n \ud83d\udcac Chat-Bridge & Join\/Leave\/Tod<\/p>\n Minecraft \u2192 Discord:<\/p>\n Chat aus Minecraft geht in den konfigurierten Discord-Channel (discord.chat-channel-id).<\/p>\n PlaceholderAPI kann benutzt werden, um Namen, Prefix, Status usw. einzubauen.<\/p>\n Format konfigurierbar in config.yml (chat.format-to-discord).<\/p>\n Discord \u2192 Minecraft:<\/p>\n Nachrichten aus dem Chat-Channel werden in Minecraft angezeigt.<\/p>\n Mentions k\u00f6nnen geblockt werden, Bots ignoriert werden.<\/p>\n Join\/Leave\/Tod-Weiterleitung:<\/p>\n Zuf\u00e4llige Join-\/Leave-\/Death-Texte (discord.join-messages, discord.leave-messages, discord.death-messages).<\/p>\n Darstellung als Embed mit Farbe & Spielernamen.<\/p>\n \u00dcber features.send-join, features.send-leave, features.send-death einzeln deaktivierbar.<\/p>\n \ud83e\uddfe Ticketsystem<\/p>\n Tickets werden komplett \u00fcber Discord erstellt, sind aber Minecraft-aware.<\/p>\n Mehrere Tickettypen unter tickets: in config.yml:<\/p>\n z. B. support, entbannung, bugreport, teamapply, vorschlag, kriegsanfrage \u2026<\/p>\n Pro Typ:<\/p>\n Name, Beschreibung, Button-Text<\/p>\n Supporter-Rollen (supporter_roles)<\/p>\n Ticket-Kategorie (Channel-Kategorie)<\/p>\n Optional LiteBans-Hook (z. B. f\u00fcr Entbannungs-Tickets)<\/p>\n Fragen mit maximaler Zeichenzahl (Modal-Formular)<\/p>\n Slash-Command \/ticket setup \u2026 zum Posten der Ticket-Embeds.<\/p>\n Beim Erstellen:<\/p>\n Private Ticket-Channel mit passenden Rechten f\u00fcr User & Supporter.<\/p>\n Transkript:<\/p>\n Beim Schlie\u00dfen werden alle Nachrichten gesammelt, als transcript.txt in den Logchannel geladen + Embed mit Metadaten.<\/p>\n Minecraft-Integration:<\/p>\n Join-Hinweis im Spiel, wenn offene Tickets existieren (f\u00fcr berechtigte Spieler).<\/p>\n \ud83d\udcca Live-Serverstatus<\/p>\n \/setup info postet einen Status-Embed:<\/p>\n TPS, MSPT, Uptime<\/p>\n Spieleranzahl<\/p>\n Java- & Bedrock-IP aus der Config<\/p>\n tps-monitor aktualisiert den Embed automatisch in einem Intervall.<\/p>\n Synccord speichert Channel + Message-ID und belebt alles nach einem Restart wieder.<\/p>\n Wenn der Server nicht erreichbar ist, wird ein Offline-Embed gesendet, sodass der Status nie \u201cveraltet\u201d wirkt.<\/p>\n \ud83d\udc65 Spielerliste-Embed<\/p>\n Eigenes Playerlist-Panel:<\/p>\n Zeigt alle online Spieler mit Gruppe und Alias (playerlist.rank-aliases).<\/p>\n Anzeige pro Spieler \u00fcber ein Format ({alias} {name} etc.) definierbar.<\/p>\n Wird bei Join\/Quit automatisch aktualisiert.<\/p>\n Channel + Nachricht werden persistent gespeichert und nach Neustart wiederverwendet.<\/p>\n \ud83d\udcdc Regeln & Codewort-System<\/p>\n rules.yml enth\u00e4lt deine Serverregeln in Kategorien.<\/p>\n \/setup regel auf Discord:<\/p>\n Postet die Regeln als mehrere Embeds.<\/p>\n F\u00fcgt einen Button hinzu, der ein Modal mit Codewort-Eingabe \u00f6ffnet.<\/p>\n Korrektes Codewort (rules.keyword):<\/p>\n Benutzer bekommt die definierte Rolle (rules.accept-role-id).<\/p>\n Alle Texte (Fehler, Erfolg, Debug) laufen \u00fcber lang\/de.yml.<\/p>\n \ud83e\udde9 PlaceholderAPI-Expansion synccord<\/p>\n Synccord bringt eine gro\u00dfe Anzahl an Placeholders mit:<\/p>\n Global:<\/p>\n %synccord_tps%, %synccord_mspt%<\/p>\n %synccord_online_count%, %synccord_max_players%<\/p>\n %synccord_uptime%<\/p>\n %synccord_ip_java%, %synccord_ip_bedrock%<\/p>\n %synccord_synccord_version%<\/p>\n %synccord_status_embed_active%, %synccord_playerlist_embed_active%<\/p>\n %synccord_discord_online%, %synccord_linked_online%<\/p>\n %synccord_tickets_open%<\/p>\n Spielerbezogen:<\/p>\n Basis: %synccord_player%, %synccord_uuid%, %synccord_x%, %synccord_y%, %synccord_z%<\/p>\n Link: %synccord_discord_id%, %synccord_discord_linked%, %synccord_discord_status%<\/p>\n Discord-Infos: %synccord_discord_tag%, %synccord_discord_username%, %synccord_discord_avatar%<\/p>\n Rollen: %synccord_discord_roles%, %synccord_role_count%, %synccord_highest_role%<\/p>\n Linking: %synccord_last_linked%, %synccord_code_expire%, %synccord_sync_fail_reason%<\/p>\n Tickets: %synccord_tickets_user%, %synccord_ticket_support_role%, %synccord_last_ticket_time%<\/p>\n Ideal f\u00fcr Scoreboards, TAB, Chat-Plugins, MOTD usw.<\/p>\n \ud83d\udee0 Sprache, Debug & Statistiken<\/p>\n Alle Texte im Plugin sind \u00fcber lang\/de.yml anpassbar.<\/p>\n Fehlende Keys werden klar gekennzeichnet, damit du sie schnell erg\u00e4nzen kannst.<\/p>\n debug: true in der Config aktiviert umfangreiche Debug-Ausgaben f\u00fcr:<\/p>\n Linking, RoleSync, Ticketsystem, Status-Panel, Playerlist, Chat-Bridge usw.<\/p>\n bStats ist integriert.<\/p>\n \ud83d\udce6 Voraussetzungen<\/p>\n Server: Paper \/ Purpur \/ Spigot (getestet mit 1.21)<\/p>\n Java: moderne Java-Version (empfohlen: Java 17+ \/ 21)<\/p>\n Abh\u00e4ngigkeiten:<\/p>\n Pflicht: LuckPerms<\/p>\n Optional: LiteBans, PlaceholderAPI<\/p>\n","protected":false},"excerpt":{"rendered":" A Discord Bot for your Minecraftserver.<\/p>\n","protected":false},"featured_media":151444,"template":"","meta":{"_minecraft_slug":"synccord","_minecraft_project_id":"7zQqDuLI","_minecraft_author":"gamingkaetzchen","_minecraft_license":"MIT","_minecraft_downloads":375,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"synccord.zip","_minecraft_size_bytes":106255892,"_minecraft_version_count":10,"_minecraft_updated_at":"2026-05-16T11:07:35.861213Z","_minecraft_date_created":"2025-07-23T21:53:45.124824Z","_minecraft_date_modified":"2025-11-21T01:26:51.073126Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/synccord","_minecraft_icon_attachment_id":151444,"_minecraft_imported_at":"2026-06-09T03:20:31+00:00","_minecraft_import_hash":"f7725ed9d17cac7fb94ec13137b0decd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,867,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-151443","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n(e.g. support, entbannung, bugreport, teamapply, vorschlag, kriegsanfrage \u2026)<\/p>\n
\n\ud83d\udd17 Account-Verkn\u00fcpfung (Minecraft \u2194 Discord)<\/p>\n