# 🚀 How to Start Bungee

This page explains everything related to configuring BungeeCord for use with EpicReports.

***

### 🔌 Plugin Installation

First, place the plugin JAR in your BungeeCord server and in all of your Spigot or Paper servers.

Depending on the names of your servers defined in the BungeeCord configuration, the plugin will store and use those names later to display server information in inventories.

***

### 🧠 How It Works

To understand the basic functionality:

* The plugin installed in **BungeeCord** is responsible for detecting when a player uses the `/report` command.
* Once triggered, the Bungee plugin collects the necessary data and uploads it to the **MySQL database**.
* This is why it's also essential to install the plugin in each **Spigot/Paper server**.
* The Spigot version handles inventory GUIs like `/ers menu`, fetching and displaying data from the shared MySQL database.

***

### ⚙️ Bungee Configuration (`bungee-config.yml`)

```
Reports_Settings:
  Max_reports_per_person: true
  max_reports: 5
```

#### 🔁 Reports\_Settings

* **Max\_reports\_per\_person**: When `true`, limits the number of times a player can report another player. Default is 5.
* **max\_reports**: Maximum number of reports allowed against the same player. Only works if `Max_reports_per_person` is enabled.

#### 🔔 Notify\_Settings

```
Notify_Settings:
  notify_reports: true
```

* **notify\_reports**: When set to `true`, enables report notifications across all servers.
  * You can control what kind of notifications (message or title) each server receives using their own local `config.yml`. For example:
    * BungeeCord can have global notification enabled.
    * One server can show **message** notifications only.
    * Another can show **title** notifications only.

This gives you full control over how and where notifications appear.

#### 🚫 Players\_Whitelist\_Tab

```
Players_Whitelist_Tab:
  - "PlayerName1"
  - "PlayerName2"
```

* This list hides specific player names from the tab-completion suggestions when typing `/report`.
* By default, the plugin is compatible with **Premium Vanish** on BungeeCord (not Essentials vanish or others).
* Players with `op` or the `EpicReports.Admin` permission are also hidden automatically.
* If you want to hide specific player names, add them here.

**Important Note**: BungeeCord support for vanish is limited to **Premium Vanish** only. If you're not using MySQL (standalone mode), the plugin supports a wide range of vanish plugins including Essentials.

#### 🔔 Discord\_Notifications

```
Discord_Notifications: true
```

If set to `true`, this enables Discord notifications. However, in order for it to work, you **must also install my plugin** [`Ers Discord`](https://www.spigotmc.org/resources/126087/).

* You can learn how to configure Ers Discord here.

{% hint style="warning" %}
If you're using the plugin in **BungeeCord mode**, you **only need to install** [**`Ers Discord`**](https://www.spigotmc.org/resources/126087/) **in the BungeeCord server**, not on every individual Spigot/Paper server.
{% endhint %}

#### 💾 Network\_Settings > MySQL

```
Network_Settings:
  MySQL:
    host: "localhost"
    port: 3306
    database: "epicreports"
    user: "root"
    password: "1234"
```

* **host**: IP address or hostname of your MySQL server.
* **port**: Port of the MySQL server (default: 3306).
* **database**: The name of your EpicReports database.
* **user**: MySQL username.
* **password**: MySQL password.

***

This setup is essential for using EpicReports in a BungeeCord network. Once correctly configured, the system allows seamless report data synchronization and inventory management across all your servers.
