🤖 How to Start Ers Discord

Ers Discord is a companion plugin for EpicReports. Due to the size of the Discord compatibility API, it was necessary to split the plugin into two parts. Despite its size, the plugin is well-optimized and will not negatively affect your server performance.

Spigot page: https://www.spigotmc.org/resources/126087/

---

🧩 Installation

• Local Mode: Add the ErsDiscord plugin alongside EpicReports on every server.

• BungeeCord Mode: Only add ErsDiscord to your BungeeCord server. No need to install it on every Spigot/Paper server.

---

🔐 Creating Your Discord Bot

To send notifications to Discord, you need to create your own bot:

1. Go to discord.com/developers/applications

2. Click "New Application" and give it a name.

3. In the left menu, go to "Bot" and click "Add Bot".

4. Under "Bot", find the Token, click "Copy", and save it safely. You will use it in the configuration later.

---

📥 Adding the Bot to Your Server

1. On the bot's application page, go to "OAuth2 > URL Generator".

2. Under Scopes, check bot.

3. Under Bot Permissions, check Send Messages and any other necessary permissions.

4. Copy the generated URL and paste it into your browser.

5. Select your server and authorize the bot.

---

🧑‍💻 Enabling Developer Mode

To get the server ID and channel ID, you need to enable Developer Mode in Discord:

1. Open Discord (app or web).

2. Click the gear icon at the bottom left (User Settings).

3. Scroll down and go to the "Advanced" tab.

4. Enable "Developer Mode".

Now:

• Right-click your server's icon → Copy Server ID

• Right-click your desired text channel → Copy Channel ID

---

⚙️ Configuration Example

Discord_Settings:
  Discord:
    botToken: "<your-token-here>"
    serverID: "<your-server-id>"
    channelID: "<your-channel-id>"

botToken Paste here the bot token you copied earlier

serverID Right-click your server icon > Copy Server ID, then paste here

chanelID Right-click the Discord channel > Copy Channel ID, then paste here

Discord_Msg:
  Title: "New Report #%reportID%"
  reported_data:
    Title: "**Reported**"
    Description: "**Name:** `%reportedName%` \n
                  **UUID:** `%reportedUUID%` \n
                  **Gamemode:** %reportedGamemode% \n
                  **Health:** %reportedHealth% \n
                  **Server:** %reportedServer% \n
                  **Location:** `%reportedLocation%` \n
                  **IP:** `%reportedIP%` "
  reporter_data:
    Title: "**Reported by**"
    Description: "**Name:** `%reporterName%` \n
                  **UUID:** `%reporterUUID%` \n
                  **Gamemode:** %reporterGamemode% \n
                  **Health:** %reporterHealth% \n
                  **Server:** %reporterServer% \n
                  **Location:** `%reporterLocation%` \n
                  **IP:** `%reporterIP%` "
  reason: "**Report Reason**"
  date: "**Date**"
  status: "**Status**"

Discord_img:
  active: true
  image: "https://imgur.com/oWG8rwW.png"

---

📝 Notes

• The ** is used to bold text in Discord.

• Variables like %reporterName% will be replaced dynamically with real values.

• is used to add line breaks in the message.

• You can modify the texts freely, but avoid altering the variable names inside %...%.

The Discord_img section lets you display an image in the message footer.

You can upload your own image to Imgur and replace the URL.

---

With this setup, you’ll have Discord integration for EpicReports fully working!