> 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-or-mantic-dev.md).

# Setup Guide | Mantic-Dev

{% stepper %}
{% step %}

### 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.
{% endstep %}

{% step %}

### 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

{% hint style="info" %}
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.
{% endhint %}
{% endstep %}

{% step %}

### 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.

{% hint style="warning" %}
Notes: Avoid performing this step on a live server, as the security system may flag and ban players who are not yet listed.
{% endhint %}
{% endstep %}

{% step %}

### Discord Integration

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

{% stepper %}
{% step %}

#### 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.
  {% endstep %}

{% step %}

#### Open the Integrations Menu

* Inside the channel settings, click **Integrations**.
* Then click **Webhooks**.
  {% endstep %}

{% step %}

#### 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**.
  {% endstep %}

{% step %}

#### Copy the Webhook URL

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

{% step %}

#### Save and Apply

* Press **Save** in Discord.
* Restart/reload your server so **ManticProtector** can use the new webhook.
  {% endstep %}
  {% endstepper %}
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mantic.dev/manticprotector/setup-guide-or-mantic-dev.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.