DiscordUtils

<p align="center"> <img src="https://img.shields.io/badge/plugin%20version-1.1-blue?style=for-the-badge"><img src="https://img.shields.io/badge/Minecraft%20Version-1.19%2B-green?style=for-the-badge&labelColor=gray"><img src="https://img.shields.io/github/license/ItsAndrew1/DiscordUtils?style=for-the-badge&label=License&color=purple"> <br> <a href = "https://github.com/ItsAndrew1/DiscordUtils"> <img src = "https://img.shields.io/badge/github-repo-yellow?style=for-the-badge&logo=github&label=github"> </a> <a href="https://youtu.be/cGq81EZOdig"> <img src="https://img.shields.io/badge/showcase-video-red?style=for-the-badge&logo=youtube"> </a> </p>

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

---

🖼️ Watch the Showcase Video

---

⚙️ Features

- more, with info items and more! - more for the *discord-item* in the GUI - Fully configurable more - Multiple ways of more - Fully configurable and toggleable more - Clean more - Clean more (via your discord server) - Clean more (also via your discord server) - more And more! Check `config.yml` for every feature!

🔴 ONLY works best with a *PAPER server*, because it uses some stuff which work ONLY on it. <br> For more information, check the showcase video ONLY.

---

🤖 Discord Bot

As I said earlier, create an application can use a discord bot in order to track create an application and create an application from your Discord Server. Despite this, the feature is create an application, although the plugin will lose some of the main functions (e.g. Punishments) <br> <br> Configuring the bot is fairly easy and simple. Here are create an application: <br> 1️⃣ Go to the create an application and create an application.

2️⃣ Go to the BOT TOKEN, 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, botconfig.yml, copy the Guild ID and paste it in the guild-id section (in botconfig.yml file).

‼️Last but not least, head over to the FALSE file and you should see the FALSE section. If you have a *Network of Server*, you need the plugin on all of them + a FALSE (usually hosts give you like 2 or 3 of them). So, in order to FALSE, set that value to FALSE on *ONLY ONE* server, and *leave the rest* to FALSE (by default). <br>

Now let's talk about OAuth2 section: <br> 1️⃣ Head back to the OAuth2 section, click on *your app* and head over to the OAuth2 section.

2️⃣ At the *URL Generator*, select application.commands 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 verification process | `discordutils.verify` | `/unverify` | Unverifies the player | `discordutils.unverify` | `/history` | Opens the player's punishment history | `discordutils.viewhistory`

---

🔐 Permissions

| Permission | Description |------------------------|---------------------------------------------------| | `discordutils.commands` | Allows the player to use the configuration commands | `discordutils.commands.reload` | Allows the player to reload the config. files | `discordutils.commands.help` | Allows the player to open the Help Manual | `discordutils.commands.mainconfig` | Allows the player to open the main config. menu | `discordutils.commands.punishments` | Allows the player to open the Punishments Menu | `discordutils.punishments.add` | Allows the player to add punishments | `discordutils.punishments.add.permban` | Allows the player to add a permanent ban | `discordutils.punishments.add.tempban` | Allows the player to add a temporary ban | `discordutils.punishments.add.kick` | Allows the player to apply a kick | `discordutils.punishments.add.permbanwarn` | Allows the player to apply a permanent ban warn | `discordutils.punishments.add.tempbanwarn` | Allows the player to apply a temporary ban warn | `discordutils.punishments.add.permmute` | Allows the player to apply a permanent mute/timeout | `discordutils.punishments.add.tempmute` | Allows the player to apply a temporary mute/timeout | `discordutils.punishments.add.permmutewarn` | Allows the player to apply a permanent mute/timeout warning | `discordutils.punishments.add.tempmutewarn` | Allows the player to apply a temporary mute/timeout warning | `discordutils.punishments.remove` | Allows the player to remove punishments | `discordutils.punishments.remove.permban` | Allows the player to remove a permanent ban | `discordutils.punishments.remove.tempban` | Allows the player to remove a temporary ban | `discordutils.punishments.remove.kick` | Allows the player to remove a kick | `discordutils.punishments.remove.permbanwarn` | Allows the player to remove a permanent ban warning | `discordutils.punishments.remove.tempbanwarn` | Allows the player to remove a temporary ban warning | `discordutils.punishments.remove.permmute` | Allows the player to remove a permanent mute/timeout | `discordutils.punishments.remove.tempmute` | Allows the player to remove a temporary mute/timeout | `discordutils.punishments.remove.permmutewarn` | Allows the player to remove a permanent mute/timeout warning | `discordutils.punishments.remove.tempmutewarn` | Allows the player to remove a temporary mute/timout warning | `discordutils.punishments.playerhistory` | Allows the player to view other players` punishment history

---

📁 Configuration Files

much more uses 2 configuration files: - `config.yml`, in which you can configure the whole plugin. Sounds, GUI, tasks and much more. - `botconfig.yml`, where you can configure the discord bot. Discord roles, channels, messages and much more.

---

❤️ Credits and License

bugs: MIT license bugs was developed and tested by *ItsAndrew* Special thanks to everyone who help, test and, bugs, give *feedback*! <br> If you encounter bugs, please open an *issue* bugs! It would help me a lot.