● ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬ ●
ʟ ᴏ ᴠ ᴇ ʟ ʏ ʟ ɪ ɴ ᴋ — ᴀ ᴄ ᴄ ᴏ ᴜ ɴ ᴛ ʟ ɪ ɴ ᴋ ɪ ɴ ɢ ᴍ ᴀ ɴ ᴀ ɢ ᴇ ʀ
Secure Discord-First Linking, Whitelist Approvals & DiscordSRV Sync
● ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬ ●
» ✦ ABOUT LOVELYLINK
LovelyLink connects Minecraft and Discord accounts using a secure, Discord-first
linking workflow. Players initiate linking on Discord with a slash command, receive
a private temporary code (expires in 30s), and complete the link in-game.
It features force-link mode to protect players during verification, custom rewards,
automatic nickname syncing, and an interactive admin DM whitelist approval system.
» ✦ KEY FEATURES
▪ Discord-First Flow: Secure code generation on Discord with a 30s timeout.
▪ Force-Link & Freeze: Fully lock movement, chat, building & commands until verified.
▪ Player Protection: Protects unlinked players from all damage and mob targeting.
▪ Whitelist System: Parsed request channel; administrators approve directly in DM.
▪ Reward Commands: Run custom console rewards upon successful first link.
▪ Nickname Syncing: Automatically sync Discord member nicknames to in-game names.
▪ Account Lookups: Check linked accounts through Discord or in-game command.
▪ DiscordSRV Sync: Seamlessly syncs account databases with DiscordSRV database.
» ✦ LINKING WORKFLOW
1. Player joins the Minecraft server.
2. If force-link is active and the player is not linked, they are frozen & protected.
3. Player goes to the designated Discord channel and runs: /link
4. The bot replies privately with a code and instructions.
5. Player runs: /link code <code> in-game within 30 seconds.
6. Accounts are linked, protection is removed, and rewards are executed!
» ✦ WHITELIST FLOW
▪ Players post: IGN: PlayerName in the whitelist request channel.
▪ The bot automatically deletes invalid messages to keep it clean.
│
├─► Admin receives DM with Approve/Deny buttons.
└─► Bot adds
/
reactions to both original request and Admin DM.
» ✦ COMMANDS & PERMISSIONS
Minecraft Commands:
• /link - Shows linking instructions
• /link code <code> - Complete the linking process
• /link force <player> <code> - Force-link a player (Admin only)
• /unlink - Request account unlinking
• /unlink force <player> - Forcefully remove player link (Admin only)
• /ilookup <player-or-discord-id> - Look up link information
• /ihelp - Shows the configured help menu
Discord Commands:
• /link - Request a private link code
• /unlink code:<code> - Complete the unlinking process
• /lookup user:<member> - Find a user's Minecraft name
• /lookup nickname:<minecraft_name> - Find a player's Discord account
Permissions:
• lovelylink.link (Default: true)
• lovelylink.unlink (Default: true)
• lovelylink.force-link (Default: op)
• lovelylink.force-unlink (Default: op)
• lovelylink.lookup (Default: op)
» ✦ SYSTEM REQUIREMENTS
• Java 21 or higher (Download: https://adoptium.net/)
• Paper / Purpur 1.21.x (Tested on 1.21.11) (Download: https://papermc.io/)
• Discord Bot with Server Members and Message Content Intents enabled.
ʟ ᴏ ᴠ ᴇ ʟ ʏ ʟ ɪ ɴ ᴋ — ᴀ ᴄ ᴄ ᴏ ᴜ ɴ ᴛ ʟ ɪ ɴ ᴋ ɪ ɴ ɢ ᴍ ᴀ ɴ ᴀ ɢ ᴇ ʀ
Secure Discord-First Linking, Whitelist Approvals & DiscordSRV Sync
● ▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬ ●
» ✦ ABOUT LOVELYLINK
LovelyLink connects Minecraft and Discord accounts using a secure, Discord-first
linking workflow. Players initiate linking on Discord with a slash command, receive
a private temporary code (expires in 30s), and complete the link in-game.
It features force-link mode to protect players during verification, custom rewards,
automatic nickname syncing, and an interactive admin DM whitelist approval system.
» ✦ KEY FEATURES
▪ Discord-First Flow: Secure code generation on Discord with a 30s timeout.
▪ Force-Link & Freeze: Fully lock movement, chat, building & commands until verified.
▪ Player Protection: Protects unlinked players from all damage and mob targeting.
▪ Whitelist System: Parsed request channel; administrators approve directly in DM.
▪ Reward Commands: Run custom console rewards upon successful first link.
▪ Nickname Syncing: Automatically sync Discord member nicknames to in-game names.
▪ Account Lookups: Check linked accounts through Discord or in-game command.
▪ DiscordSRV Sync: Seamlessly syncs account databases with DiscordSRV database.
» ✦ LINKING WORKFLOW
1. Player joins the Minecraft server.
2. If force-link is active and the player is not linked, they are frozen & protected.
3. Player goes to the designated Discord channel and runs: /link
4. The bot replies privately with a code and instructions.
5. Player runs: /link code <code> in-game within 30 seconds.
6. Accounts are linked, protection is removed, and rewards are executed!
» ✦ WHITELIST FLOW
▪ Players post: IGN: PlayerName in the whitelist request channel.
▪ The bot automatically deletes invalid messages to keep it clean.
│
├─► Admin receives DM with Approve/Deny buttons.
└─► Bot adds
/ reactions to both original request and Admin DM.» ✦ COMMANDS & PERMISSIONS
Minecraft Commands:
• /link - Shows linking instructions
• /link code <code> - Complete the linking process
• /link force <player> <code> - Force-link a player (Admin only)
• /unlink - Request account unlinking
• /unlink force <player> - Forcefully remove player link (Admin only)
• /ilookup <player-or-discord-id> - Look up link information
• /ihelp - Shows the configured help menu
Discord Commands:
• /link - Request a private link code
• /unlink code:<code> - Complete the unlinking process
• /lookup user:<member> - Find a user's Minecraft name
• /lookup nickname:<minecraft_name> - Find a player's Discord account
Permissions:
• lovelylink.link (Default: true)
• lovelylink.unlink (Default: true)
• lovelylink.force-link (Default: op)
• lovelylink.force-unlink (Default: op)
• lovelylink.lookup (Default: op)
» ✦ SYSTEM REQUIREMENTS
• Java 21 or higher (Download: https://adoptium.net/)
• Paper / Purpur 1.21.x (Tested on 1.21.11) (Download: https://papermc.io/)
• Discord Bot with Server Members and Message Content Intents enabled.
