DiscordUtils

!(https://github.com/user-attachments/assets/e0ef9048-17ce-4383-b84c-ca5ef383d292)

DiscordUtils is a lightweight, discord utility minecraft plugin, designed to help every server owner connect the players with his discord server. Control the punishments of the players, track them using logs in specific channels, let players appeal their punishments and much more!

## 🖼️ Watch the Showcase Video

## ⚙️ Features - Fully configurable GUI, with info items and more! - Custom block for the discord-item in the GUI - Fully configurable sounds - Multiple ways of displaying the discord link to the player - Fully configurable and toggleable discord bot - Clean punishments system - Clean appealing system (_via your discord server_) - Clean logs system (_also via your discord server_) - Simple configuration And more! Check `config.yml` for every feature!

🔴 DiscordUtils works best with a PAPER server, because it uses some stuff which work ONLY on it.

For more information, check the showcase video (https://youtu.be/cGq81EZOdig).

## 🤖 Discord Bot As I said earlier, DiscordUtils can use a _discord bot_ in order to track the players and their punishments from your Discord Server. Despite this, the feature is toggleable, although the plugin _will lose_ some of the main functions (e.g. _Punishments_)

Configuring the bot is fairly _easy and simple_. Here are the main steps:

1️⃣ Go to the (https://discord.com/developers/home) and create an application. 2️⃣ Go to the bot section, fill in the _username, description, icon, banner_ and copy the BOT TOKEN. Also, enable all those 3 intents (Presence, Server Members and Message Content). 3️⃣ In the botconfig.yml file, fill in the _bot-token_ section with that bot token. 4️⃣ After this, _open Discord_, right click on your server, copy the _Guild ID_ and paste it in the _guild-id_ section (in botconfig.yml file).

‼️Last but not least, head over to the config.yml file and you should see the open-discord-bot section. If you have a Network of Server, you need the plugin on all of them + a MySQL Database (usually hosts give you like 2 or 3 of them). So, in order to not override the bot, set that value to TRUE on ONLY ONE server, and leave the rest to FALSE (by default).

Now let's talk about how you get the bot on your Discord Server:

1️⃣ Head back to the (https://discord.com/developers/home), click on your app and head over to the OAuth2 section.

2️⃣ At the URL Generator, select bot and application.commands.

3️⃣ Further down, select Administrator (_the bot needs to access the player's roles/permissions and more_).

4️⃣ At the bottom, copy the generated link, paste it in your browser and follow the instructions to invite it to your server.

I also told various instructions in both .yml files, so make sure to read them thoroughly.

## 🪄 Commands | Command | Description | Permission | |------------------------|---------------------------------------------------|----------------------| | `/dcutils mainconfig` | Opens up the main configuration. | `discordutils.commands.mainconfig` | | `/dcutils punishments` | Opens up the Punishments Menu | `discordutils.commands.punishments` | | `/dcutils reload` | Reloads the configuration files. | `discordutils.commands.reload` | | `/dcutils help` | Opens the help manual | `discordutils.commands.help` | | `/discord` | Opens the discord GUI | `discordutils.discord` | | `/verify` | Starts the v