NitroLink | Discord Verification v1.0

Discord account verification
Minecraft /verify command with generated codes
Discord /verify code:<code> slash command
Automatic verified Discord role assignment
Verification rewards using configurable console commands
Optional 2FA-style lock until players verify
Staff alerts sent to Discord channels
Alert types for join, leave, first join, verify, 2FA lock/unlock, and blocked commands
Discord role sync to LuckPerms groups
Booster perks using Discord booster role detection
Giveaway reward queue for Discord giveaway winners
Persistent local player data
Hosted bot/API — no bot hosting required from the buyer
Optional DeluxeMenus community GUI included
Lightweight and simple configuration

1. A player joins your Minecraft server.
2. The player runs /verify.
3. NitroLink generates a verification code.
4. The player uses /verify code:<code> in Discord.
5. NitroLink links their Minecraft and Discord account.
6. The bot gives the configured verified Discord role.
7. The Minecraft plugin syncs the completed link and runs any configured rewards.





Player Commands

/verify
Generates a Discord verification code for the player.

/community
Opens the optional DeluxeMenus community menu if installed/configured.

Admin Commands

/nitrolink
Shows the NitroLink command help.

/nitrolink status
Shows current setup status, API status, configured Discord IDs, booster settings, giveaway settings, and detected optional plugins.

/nitrolink reload
Reloads NitroLink config/data and re-registers the server settings with the API.

/nitrolink setup <guildId> <verifiedRoleId>
Sets the Discord server ID and verified role ID.

/nitrolink info <player>
Shows stored NitroLink data for a player.

/nitrolink reset <player>
Removes local NitroLink data for a player.

/nitrolink link <player> <discordId>
Locally links a player to a Discord ID. This is mainly for admin/manual use.

/nitrolink unlink <player>
Unlinks a player from the API and local plugin data.

/nitrolink rewards <enable|disable|add|clear>
Manages verification reward commands.

/nitrolink rewards add <command>
Adds a command to run when a player verifies.

/nitrolink 2fa <enable|disable>
Enables or disables the 2FA-style verification lock.

/nitrolink alerts <enable|disable|set>
Manages Discord staff alerts.

/nitrolink alerts set <type> <channelId>
Sets the Discord channel for a staff alert type.

/nitrolink rolesync <add|remove|list>
Manages Discord role to LuckPerms group sync rules.

/nitrolink rolesync add <discordRoleId> <lpGroup>
Adds a role sync rule.

/nitrolink rolesync remove <discordRoleId>
Removes a role sync rule.

/nitrolink booster <enable|disable|role|reward|status>
Manages Discord booster perks.

/nitrolink booster role <discordRoleId>
Sets the Discord booster role.

/nitrolink booster reward add <command>
Adds a command to run when a player gains booster perks.

/nitrolink booster reward remove <command>
Adds a command to run when a player loses booster perks.

/nitrolink giveaway <enable|disable|channel|reward|status>
Manages giveaway rewards.

/nitrolink giveaway channel <channelId>
Sets the Discord giveaway channel.

/nitrolink giveaway reward add <command>
Adds a reward command for giveaway winners.



nitrolink.admin Allows access to all /nitrolink admin commands.

Players do not need a permission to use /verify unless you choose to add one through your own permission setup.



NitroLink can send clean Discord embed alerts for:

verify
Player linked their Discord account.

join
Player joined the server.

leave
Player left the server.

first-join
Player joined for the first time.

2fa-lock
Player is locked until verification.

2fa-unlock
Player completed verification and was unlocked.

command-blocked
Player tried to run a blocked command while locked by 2FA.





NitroLink can sync Discord roles to LuckPerms groups.

Example:

/nitrolink rolesync add 123456789012345678 vip

When a linked Discord user receives that Discord role, NitroLink queues the matching LuckPerms group to be added in Minecraft.

When the Discord role is removed, NitroLink queues the matching LuckPerms group to be removed.



NitroLink can detect a configured Discord booster role and run Minecraft commands when linked players gain or lose booster status.

Example add command:

lp user %player% parent add booster

Example remove command:

lp user %player% parent remove booster

You can also use any other server command, such as crate keys, cosmetics, permissions, economy rewards, or custom plugin commands.





NitroLink can detect giveaway winner messages in a configured Discord channel and queue rewards for linked Minecraft accounts. It works with any Discord bot that mentions winner in a normal message(not embed)

Example reward command:

give %player% diamond 10

This is useful for Discord events, community giveaways, booster events, and server reward campaigns.



NitroLink includes an optional community.yml DeluxeMenus menu.

The menu can show:

Verification status
Current verification code
Linked Discord ID
Verification rewards information
Booster perks information
Discord invite link
Community profile information

DeluxeMenus is not required for NitroLink to work. It is only needed if you want to use the included /community GUI menu.



Server Software:
Paper

Minecraft Version:
Built and tested for Paper 1.21.x

Java:
Java 21 recommended



1. Download NitroLink-1.0.0.jar.
2. Place it inside your server’s plugins folder.
3. Start your server once.
4. NitroLink will generate its config files.
5. Invite the official NitroLink Discord bot to your Discord server.
6. Run /nitrolink setup <guildId> <verifiedRoleId>.
7. Run /nitrolink status to confirm everything is configured.
8. Players can now use /verify in Minecraft and /verify code:<code> in Discord.



1. Set your Discord server and verified role

/nitrolink setup 123456789012345678 987654321098765432

2. Enable verification rewards

/nitrolink rewards enable

3. Add a reward command

/nitrolink rewards add lp user %player% permission set nitrolink.verified true

4. Enable staff alerts

/nitrolink alerts enable

5. Set a staff alert channel

/nitrolink alerts set verify 123456789012345678

6. Test verification

Player runs:

/verify

Then in Discord:

/verify code:<code>






Your download includes:

NitroLink-1.0.0.jar
The compiled NitroLink plugin.

NitroLink_README.md
General plugin overview.

NitroLink_SETUP.md
Step-by-step setup guide.

DeluxeMenus_README.md
Optional DeluxeMenus GUI setup instructions.

community.yml
Optional DeluxeMenus community menu config.

The source code, hosted API, and hosted Discord bot are not included.



The official NitroLink bot/API is hosted by us.

Buyers do not need to host their own Discord bot.

The NitroLink bot role must be above the configured verified role and booster role in your Discord server.

Giveaway rewards require the bot to have access to the configured giveaway channel.

Booster perks and role sync require players to have linked their Minecraft and Discord accounts.

LuckPerms is only required if you use role sync or LuckPerms commands.



If you need help setting up NitroLink, please read the included setup guide first.

For support, provide:

• Your Paper version
• NitroLink version
• Any console errors
• Your /nitrolink status output
• A screenshot of your Discord bot role position
• The feature you are trying to configure