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 ` on servers with `online-mode` set to `false` (_in server.properties_). ## 🤔 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 `. ([how to get discord id?](https://youtu.be/RzTWH0g2xbo?si=oQT2rCSuf6B3Z5kY))

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 ` — links the player to its Discord profile. ([how to get discord id?](https://youtu.be/RzTWH0g2xbo?si=oQT2rCSuf6B3Z5kY)) - `/unlink ` — 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 ` - `discordVerificator.unlink` _(for **operators** by default)_ — Allows to use `/unlink ` - `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!** ```yml # 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": "C60D[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
![image](https://github.com/MrQuackDuck/DiscordVerificator/assets/61251075/3322da7c-95b3-4ee0-a22a-c868c5f43aae)
![image](https://github.com/MrQuackDuck/DiscordVerificator/assets/61251075/fa05b770-0ad0-42a6-833e-101ba06eee41) 1. Go to the **"Bot"** tab and click on the **"Reset token"** button
![image](https://github.com/MrQuackDuck/DiscordVerificator/assets/61251075/f75a5bca-a28a-42b2-aa04-479842688280)
![image](https://github.com/MrQuackDuck/DiscordVerificator/assets/61251075/be31fca3-2f50-4004-a9c9-fdf076bde60d) 1. Copy the token
![image](https://github.com/MrQuackDuck/DiscordVerificator/assets/61251075/f2b15ed9-5999-4093-8c78-3ee27c490c28) 1. Download the plugin from Releases tab or from Spigot page. 1. Put downloaded `.jar` into `./plugins` folder of your server. 1. Restart your server or enter `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 `dvreload` command

1. **Everything is done!** Now you can link players with the `link` command and
**invite** this bot **to your Discord server** (_to make them able to run `confirm

` command to the **Discord bot**_)

DiscordVerificator

Entering the server

Confirming by a code

Success message

External resources

Project members

Technical information