> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/manticprotector/setup-guide.md).

# Setup Guide

## 📔Setup Guide

Protector setup guide

Step 1:

Upload our plugin to the plugins folder found on your server. Proceed to placing your license in the configuration file (instructions: <https://docs.mantic.dev/welcome#how-can-i-claim-my-license>). Then, start up your server.

Step 2:

Open the configuration file located at `plugins/manticprotector/config.yml` and scroll down to the `**users**` section. You will see two example entries (`KingpinJordan` and `TheDeejayV1`). Replace these with your own user entries, including:

* **Username**
* **UUID**
* **Whether the user is allowed operator status**
* **Any whitelisted groups the user is permitted to be in**

📓 **Notes:** You only need to define whitelisted groups if the groups you want to protect *also* appear in the `blacklistedGroups` section.

If a group is *not* listed in `blacklistedGroups`. The plugin will ignore it during group-related security checks.

Step 3:

Restart your server. This refreshes the configuration and securely registers the new user entry. Once added, the user will be recognised and protected by the anti-grief system.📓 **Notes:** Avoid performing this step on a live server, as the security system may flag and ban players who are not yet listed.

🤖 Step 4 (Discord **Integration**):

If you do not want this option enabled, you can ignore this section entirely.

1\. Go to Your Discord Channel Settings

* Open Discord.
* Navigate to the **text channel** where you want alerts to be sent.
* Click the **gear icon** next to the channel name.

**2. Open the Integrations Menu**

* Inside the channel settings, click **Integrations**.
* Then click **Webhooks**.

**3. Create a Webhook**

* Click **Create Webhook**.
* Set a **name** (e.g., `ManticProtector Alerts`).
* *(Optional) Upload an* ***avatar*** *for cleaner embeds.*
* Ensure the webhook is assigned to the correct **channel**

**4. Copy the Webhook URL**

* Click **Copy Webhook URL**.
* Paste this link into your `config.yml` under the corresponding webhook section of ManticProtector.

**5. Save and Apply**

* Press **Save** in Discord.
* Restart/reload your server so **ManticProtector** can use the new webhook.
