NorrionProject Discord Plugin - Changelog v1.0.0

🚀 Initial Release — Minecraft ↔ Discord Integration

NPDiscord v1.0.0 is the official Discord integration plugin for the NorrionProject server. It bridges your Minecraft server with a Discord bot, automating rank synchronization, account linking, and server monitoring.

Designed for server administrators and community managers who want a seamless Discord↔Minecraft experience without manual role management.

---

✨ Key Features for Server Admins

1. Automatic Rank Synchronization (Discord ↔ LuckPerms)

Never manually assign Discord roles again. The plugin watches both directions in real time:

Direction	Trigger	Action
Minecraft → Discord	Player gets a LuckPerms group (rank)	Bot adds the matching Discord role
Minecraft → Discord	Player loses a LuckPerms group	Bot removes the matching Discord role
Discord → Minecraft	Admin adds/removes role on Discord	Bot updates the player's LuckPerms group

How it works:

• Configure rank↔role mappings in plugins/NorrionProject/discord-config.yml (grouping + priority system)
• Supports mutually exclusive groups — e.g., only one "Staff" role at a time (Mod / Admin / Owner)
• Default fallback role — players without a mapped rank get a default role (e.g., "Player")
• Powered by LuckPerms API events — instant, no polling, no lag

2. Secure Player Account Linking

Players link their Minecraft account to Discord themselves — no admin intervention needed.

Flow:

1. Player clicks "Link Account" button in a Discord channel (created via /ndiscord create-link <channel-id>)
2. Bot sends them a unique 10-digit code (ephemeral, only they see it)
3. Player runs /ndiscord link <code> in-game
4. Accounts are paired — Discord ID stored in player data
5. (Optional) Bot removes an "Unlinked" role on success

Security:

• Codes expire after use (single-use)
• Ephemeral Discord replies — codes never visible to others
• Prevents duplicate linking (one Minecraft account = one Discord account)

3. Server Monitoring → Discord Channel

Stream critical server logs directly to a Discord channel as rich embeds.

Configure what you see:

• Log levels: ERROR, WARN, INFO, DEBUG, etc. (pick any combination)
• Smart startup filter: Optionally suppress boot-time spam (enable monitoringAfterServerDone: true)
• Color-coded embeds: 🔴 ERROR / 🟡 WARN / 🔵 INFO / ⚫ FATAL
• Stack traces included for exceptions (truncated to Discord limits)
• Runs asynchronously — zero impact on main server thread

4. Multilingual Support (FR / EN)

All player-facing messages are translatable via JSON files in plugins/NorrionProject/language/NPDiscord:

• messages_en.json
• messages_fr.json

---

🎮 Player Commands

Command	Permission	Description
/ndiscord link <code>	ndiscord.link	Link Minecraft account to Discord using code from button

---

🔧 Admin Commands

Command	Permission	Description
/ndiscord create-link <channel-id>	ndiscord.admin	Posts the "Link Account" button embed in the current Discord channel (bot must have perms)

Usage:

1. Go to your Discord #verification channel
2. Run /ndiscord create-link <channel-id> in-game (or via console)
3. Bot posts an embed with a "Link Account" button
4. Players click → get code → run /ndiscord link <code> in-game

---

Made with ❤️ for the NorrionProject community.
Questions? Open an issue on our Discord.