DytchsLinking v1.9.0

Support: Message "dytch" on discord for free lifetime support!

---

✦ Features

• Simple, secure linking. Run /discord link, DM the code to your bot, done. Works for offline and Bedrock players (the name is captured at link time).
• First-link rewards. Run any console commands the first time a player ever links — exactly once, ever, even across a whole network. Never fires twice.
• Two-way role sync. Minecraft → Discord (in-game rank grants a Discord role) and Discord → Minecraft (a booster role grants in-game perks). Fully bidirectional.
• Discord Booster perks. Server Boosters get ongoing perks that are added and removed automatically with the role, plus a one-time reward they claim themselves in a fully editable GUI.
• NameMC likes reward. Reward players who like your server on NameMC with a one-time crate (or anything), a clickable join reminder, and an optional Discord webhook shout-out.
• Built for networks. Share one bot token across every server — the plugin elects a single host (with automatic failover) so DMs and lookups are answered exactly once. Rewards and links are network-wide via MySQL. Or run a single server on flat-file with zero setup.
• Alt detection. Get a staff ping in Discord when a player links from an IP that already has other linked accounts — LiteBans /alts style, no LiteBans required.
• Link announcements. Post a clean review embed (player head, name + UUID, and the linked Discord user) to a channel on every new link.
• Staff lookups in Discord. /linked discord <@user> and /linked player <name> slash commands, restricted to admins / your staff role.
• Link reminders. Nudge unlinked players on join with a clickable message that runs /discord link for them.
• Fully configurable. Every message, reward command, role mapping, and GUI item is editable. Legacy &a and hex &#RRGGBB colours everywhere.
• Lightweight. JDA is fetched automatically at startup (tiny jar, no shading), and nothing is a hard dependency.

---

✦ Requirements

• Server: Spigot / Paper / Folia (and forks) 1.21+, Java 21.
• A Discord bot (free — made in the Developer Portal) with the Server Members + Message Content intents.
• Optional: MySQL (for a multi-server network), LuckPerms or Vault (for rank/booster perk sync), PlaceholderAPI.
• No forced dependencies — a single server works out of the box on flat-file.

---

✦ Installation

1. Drop DytchsLinking.jar into /plugins and start the server once to generate the config.
2. Create a bot at discord.com/developers/applications → Bot → Reset Token, and enable the Server Members + Message Content intents.
3. Invite it (OAuth2 → URL Generator) with the bot + applications.commands scopes and the Manage Roles permission, with its role above any role it should assign.
4. Put your bot-token and guild-id in config.yml.
5. (Multi-server) Set storage.type: mysql with the same database on every server, and use LuckPerms so rank/booster perks apply network-wide.
6. Restart. In game: /discord link → DM the code to the bot → linked.

---

✦ Discord Booster → Minecraft perks
Reward the people who boost your Discord, automatically.

• Ongoing perks. When a linked member has your Server Booster role, configured commands run to grant a rank/permission — and the reverse commands run the moment they stop boosting. Perks come and go with the role, with no babysitting.
• A one-time reward they claim. Players open /nitro and claim a one-time reward (a crate key, items, anything). It runs on the server they claim from, so the reward lands where they want it — not stuck on your hub.
• Editable claim GUI. DeluxeMenus-style item config (material, display_name, lore, item_flags, enchantments/glow, custom-model-data) — or disable the built-in menu and use your own.
• Works on every server. Only one server hosts the bot, so the others relay through the database — boosters are detected and rewarded no matter which server they're on.
• Per-server control. Choose exactly which servers allow claiming (e.g. block it on the hub, allow it on game servers).

✦ Run one bot across your whole network
Put the same token on every server. The plugin uses a database lease to elect one host for the bot, so a DM'd link code is answered exactly once (no duplicate "invalid or expired" spam) and slash lookups are reliable. If the host goes down, another server takes over within a couple of minutes — fully automatic.

✦ NameMC likes → rewards
A player who likes your server on NameMC is rewarded once, ever (atomic, even across servers). Until they like, a clickable reminder shows on join; once they like it stops; if they remove the like it returns — but the reward is never granted twice. Optional Discord webhook announces each claim. Players use /namemc to claim instantly.

---

✦ Commands
Aliases: /discord → /dlink, /dytchslinking • /namemc → /like, /likes • /nitro → /boosterreward

✦ Permissions

---

✦ Support
Questions or setup help? Message "dytch" on Discord for free lifetime support.