sDiscord — Advanced Discord Link System ⭑ 26.3 ✅

★ About
sDiscord connects your Minecraft server with your Discord community in one plugin. Chat flows both ways — delivered under each player's real name and skin head, with formatting, mentions, replies and emojis translating cleanly between both sides. The server console streams live into a staff channel where trusted roles can even run commands. Players link their accounts with codes, roles stay in sync automatically, and every report, note and audit entry lands where your staff needs it. Everything is configured in plain YAML, hot-reloadable with a single command, shipped in five languages, and runs from Minecraft 1.13 all the way to 26.x.


★ Features
Chat bridge

• ✔ Two-way chat — Minecraft <-> Discord with join/leave and server start/stop announcements
• ✔ Webhook delivery under the player's exact name and skin head (any avatar service, configurable)
• ✔ Markdown translation, both directions — **bold**, *italic*, __underline__, ~~strike~~, ||spoiler||, quotes and `code` become Minecraft formatting; Minecraft format codes become Discord markdown
• ✔ Mention translation, both directions — user, role and channel tags read as names in game; @everyone/@here are neutralized; @Player typed in game becomes a real ping on the linked account
• ✔ Reply support — Discord replies shown in Minecraft with the quoted text
• ✔ Emoji support — unicode or shortcode modes for Discord custom emojis
• ✔ Vanish-aware — players hidden by any vanish plugin are never announced in public channels and can't be exposed through /report

Live console

• ✔ Live console channel — [HH:mm:ss LEVEL] timestamps, min-level and regex filters, batching
• ✔ Console overflow protection — big backlogs are uploaded as a console-*.log attachment instead of flooding
• ✔ Run commands from Discord — role-gated console execution with ✅/❌ reactions, whitelist/blacklist and rate limit

Linking & roles

• ✔ Account linking — /connect codes (with optional staff verification), one link per account, stored forever
• ✔ Auto role sync — map LuckPerms groups or permissions to Discord roles (added/removed automatically)

Reports, staff & audit

• ✔ Reports & bug reports — in-game GUI, /report, /reportbug and Discord slash commands, staff notifications
• ✔ Staff channel — join/quit/server start/server stop notices with colored embeds per event
• ✔ Audit log — links, unlinks, verifications, remote commands, lockouts, broadcasts and reloads

Platform

• ✔ Storage: SQLite (default), MySQL & MariaDB with connection pooling, all async
• ✔ BungeeCord networks — shared storage, cross-server chat relay, one config per server
• ✔ 5 languages — English (default), Español, Português, Polski, Deutsch; switch live with /sdiscord reload
• ✔ PlaceholderAPI expansion (%sdiscord_linked% and more) + presence placeholders: %players%, %online%, %max%, %server%
• ✔ Developer API — events (DiscordChatEvent, ConsoleCommandEvent, PlayerLinkedEvent...) + placeholders
• ✔ Hot reload — configs re-apply without a restart; a broken YAML keeps the last known values and is never overwritten
• ✔ Update checker — one console line and an in-game notice for admins when a new version is published
• ✔ Small & self-sufficient — a ~232 KB jar; the connecting libraries download themselves once on first boot (integrity-checked) and are cached locally; Java 8+

★ Commands & Permissions
Players

• /discord (alias /sd) — Shows your link status and how to get started
• /connect <code> — Links your Discord account — sdiscord.connect (default: all)
• /disconnect — Unlinks your Discord account — sdiscord.disconnect (default: all)
• /report <player> [reason] — Reports a player — sdiscord.report (default: all)
• /reportbug <description> — Sends a bug report — sdiscord.reportbug (default: all)

Staff & admins

• /verify <player> — Approves a pending link (when staff verification is enabled) — sdiscord.verify (default: OP)
• /sdiscord (alias /sdadmin) — Admin panel: status, reload, broadcast, reports, unlink, verify, audit, admin, codes, debug, selftest — sdiscord.admin (default: OP)
• /sdiscord reload — Re-applies every config, lang file and module without a restart — sdiscord.admin
• /sdiscord broadcast <message> — Network-wide announcement — sdiscord.broadcast (default: OP)
• /sdiscord selftest — Live checks: token, chat channel, storage, console capture, drivers and integrations — sdiscord.admin

On the Discord side: /vincular, /desvincular and /report slash commands with localized descriptions.

★ Setup (60 seconds)

1. Create an application in the Discord Developer Portal, add a Bot, enable the SERVER MEMBERS and MESSAGE CONTENT intents and invite it to your server.
2. Drop sDiscord.jar into /plugins and start the server once — the connecting libraries download themselves on this first boot and stay cached from then on.
3. Open plugins/sDiscord/config.yml and paste your bot token.
4. Open channels.yml and paste your chat, console, reports, bugs and staff channel IDs.
5. Run /sdiscord reload — no restart needed.
6. Done! Chat flows instantly; players link with /discord and /connect.

★ Webhooks (recommended)
Create a webhook in your chat channel, copy its URL and set it in features.yml: every player message is delivered with the player's exact name and skin avatar instead of the bot identity — exactly how players expect a chat bridge to look. With SkinsRestorer installed, the avatar is built from the skin the player actually wears, so offline-mode servers get real skins too.

★ Console from Discord
Your console channel mirrors the server with [HH:mm:ss LEVEL] timestamps. Members holding any role from consoleRoles can type commands directly — each one runs on the server console, gets a ✅/❌ reaction, is rate-limited and recorded in the audit log. When the console gets busy (crash dumps, spam), sDiscord stops flooding and uploads the remaining lines as a .log attachment.

★ config.yml example

★ Networks (BungeeCord)
Set storage.type to MYSQL (or MARIADB) on every backend server pointing to the same database, enable network and give each server its own serverId with one PRIMARY. Links are shared network-wide and chat relays between servers automatically.

★ Compatibility

• Spigot, Paper and Purpur — tested on Paper 26.3 and Paper 1.21.4
• Minecraft 1.13 → 26.x (api-version 1.13, modern API only)
• Java 8+ — one small jar; the connecting libraries self-download once (integrity-checked) and are cached
• BungeeCord networks with shared MySQL/MariaDB storage
• Optional integrations: LuckPerms, PlaceholderAPI, SkinsRestorer
• Vanish plugins respected: SuperVanish, PremiumVanish, Essentials, CMI, VanishNoPacket — plus generic detection for most others