DiscordVerificator

DiscordVerificator is a Spigot plugin that allows you to do player authentication using Discord bot.

[WARNING] This plugin is intended to be used on private servers with the manual player addition because it involves you to manually link each player to their Discord profile.

It was developed as an alternative for password-based authorization like /login <password> on servers with online-mode set to false (in server.properties).

If you have any issues/bugs, you may leave them here.

🤔 How it works?

This plugin enables players to link their usernames to their Discord profiles.

The linking process is controlled by the administrator of the server.
In order to link the account, the admin should run /link <Player> <Discord ID>. (how to get discord id?)

Then, when a player joins the server, the verification code appears.
To join the server, the player should run the seen command to the Discord bot you've configured:

[NOTE] Verification is required once per IP change

[CAUTION] The plugin will prevent a player from joining if it wasn't linked to Discord profile yet:

💻 Commands

• /link <player> <discordId> — links the player to its Discord profile. (how to get discord id?)
• /unlink <player> — unlinks the player from its Discord profile.
• /dvreload — reloads the plugin (including Discord bot).

🔞 Permissions

• discordVerificator.link (for operators by default) — Allows to use /link <player> <discordId>
• discordVerificator.unlink (for operators by default) — Allows to use /unlink <player>
• discordVerificator.reload (for operators by default) — Allows to use /dvreload

📄 Default config

[IMPORTANT] You should replace DISCORD_BOT_TOKEN with your Discord bot token.
Otherwise, nothing will work!

# 1. Create a Discord bot on the Discord Developer Portal: https://discord.com/developers/applications
# 2. Get the token from the "Bot" tab
# 3. Insert the token below
# 4. Run the "/dvreload" command or reload the server
# 5. Give your players access to send a command to the bot (e.g., invite it to your Discord server)
token: "DISCORD_BOT_TOKEN"

messages: "not-enough-permissions": "&cNot enough permissions!" "invalid-link-format": "&cInvalid format! Please use: /link " "invalid-unlink-format": "&cInvalid format! Please use: /unlink " "invalid-user-id-format": "&cInvalid Discord ID format!" "successfully-linked": "&aSuccessfully linked!" "successfully-unlinked": "&aSuccessfully unlinked!" "player-already-linked": "&cThis player is already linked!" "player-was-not-linked": "&cThis player was never linked!" "account-not-linked": "&cYour account is not linked to a Discord profile yet." "bot-not-working": "&cThe Discord bot is not currently working!\nAsk the administrator to resolve this issue." "confirm-with-command": "&6Confirm your IP via our Discord bot\nUsage: &f&n/confirm %s" "wait-until-verification": "&cPlease wait until you can request a new code!\n&f&n%s seconds left." "error-occurred": "An error occurred!" "its-not-your-account": "The account you're trying to confirm is not linked to your Discord profile!" "allowed": "Allowed!" "allowed-to-join-from-ip": "Successfully allowed to join from %s!" "confirm-command": "Command to verify you on the Minecraft server" "verification-code-you-got": "Verification code you've received from the server" "invalid-code": "Invalid Code!" "invalid-code-description": "This verification code is not valid!" "invalid-usage": "Invalid usage!" "provide-code-please": "Please provide the verification code!" "user-not-found": "User not found!" "user-not-found-description": "It seems like your account hasn't been linked to any Minecraft username yet." "reloaded": "&#14C60D[DiscordVerificator] Reloaded!"

## ☂ Getting started

**[IMPORTANT]** Before getting started, make sure that the plugin's version is **compatible** with your server version.

1. Create a **new discord application** on Discord Developer Portal<br>
!image<br>
!image
1. Go to the **"Bot"** tab and click on the **"Reset token"** button<br>
!image<br>
!image
1. Copy the token<br>
!image
1. Download the plugin from Releases tab or from Spigot page.
1. Put the downloaded `.jar` into the `./plugins` folder of your server.
1. Restart your server or enter the `/reload` command.
1. Go to `./plugins/DiscordVerificator` folder and open `config.yml`
1. Replace `DISCORD_BOT_TOKEN` with the token you've copied previously
1. Save the config and run the `/dvreload` command<br><br>
1. **Everything is done!** Now you can link players with the `link` command and<br> **invite** this bot **to your Discord server** (_to make them able to run `confirm <code>` command to the **Discord bot**_)