# Common Errors

## 🔴 You lack the required entitlement to use MS\_MadonnAdmin

This message indicates that your server does not have the necessary entitlement to start the resource. This is related to FiveM's **Escrow** protection system.

Check the following points one by one:

* ✅ The **CFX Portal key** listed in your `server.cfg` does not contain any typing error
* ✅ The CFX Portal key belongs to the **FiveM account that was used to purchase or claim** the resource
* ✅ The resource has been **successfully claimed** on the [CFX Portal](https://portal.cfx.re/)
* ✅ The CFX Portal key linked to your server **belongs to you**, and not to your hosting provider

> ⚠️ Some hosting providers include a shared CFX Portal key as part of their offers. A key that does not belong to you will block the use of **any Escrow-protected resource**, without exception. Always use your own personal key.

***

## 🔴 Error 0xA01 — Failed to initialize Madonn'Admin

```
[ERROR - #0xA01] An error has occured during the loading of MadonnAdmin. Please check your Server Token in the config.lua
```

**Cause:** The Madonn'Admin platform could not be reached, or the Server Token is invalid.

**Fix:**

* Verify that `Server_Token` in `config/cfg_main.lua` matches exactly the token shown in your community settings on `madonnadmin.com`
* Make sure your FiveM server has outbound internet access to `madonnadmin.com`
* If the platform is temporarily unavailable, the resource will retry automatically every 5 seconds

***

## 🔴 Error 0xA02 — Community not found or subscription inactive

```
[ERROR - #0xA02] An error has occured during the loading of MadonnAdmin. Please check your Server Token in the config.lua
```

**Cause:** The Server Token is recognized but the associated community cannot be loaded. This usually means the subscription is inactive or the community has been deleted.

**Fix:**

* Check that your subscription is active on `madonnadmin.com`
* Verify that the server is correctly configured in your community dashboard with the right IP address
* If your IP has changed, update it in the Madonn'Admin dashboard

***

## 🔴 Error 0xC01 — Player blocked from connecting

```
[ERROR - #0xC01] Player X is not verified through Madonn'Admin and will not be connected
```

**Cause:** Madonn'Admin is offline or unreachable, and `Failure_Override` is set to `false` in `config/cfg_main.lua`, so players are blocked from joining.

**Fix:** Set `Failure_Override = true` to allow players to connect even when Madonn'Admin is temporarily unavailable:

```lua
Failure_Override = true,
```

> 💡 When `Failure_Override` is `true`, players will see a brief warning message but will still be able to connect. Bans and permission checks will be suspended until the connection is restored.

***

## 🔴 Error 0xC02 — No response from Madonn'Admin when loading permissions

```
[ERROR - #0xC02] No response received from Madonn'Admin
```

**Cause:** The platform did not respond when loading a player's permissions after they connected.

**Fix:** This is usually a temporary network issue. It resolves itself automatically on the next connection attempt. If it happens persistently, check that your server has stable outbound internet access.

***

## 🔴 The admin menu does not open

**Cause 1:** The player does not have a staff rank assigned in Madonn'Admin.

**Fix:** Go to **Team Staffs → Manage Staffs** in the dashboard, select the correct server, and assign a role to the player.

**Cause 2:** The player has a rank assigned but has not connected since the assignment.

**Fix:** Have the player disconnect and reconnect to the server so their permissions are reloaded.

**Cause 3:** The key binding is conflicting with another resource.

**Fix:** Check the FiveM key bindings in **Settings → Key Bindings → FiveM** and look for the **"Open Admin Menu"** entry. Reset it to the configured key (`F10` by default).

***

## 🔴 Staff member has no permissions after being added

**Cause:** The player was added to the community but has not yet been assigned a role, or the role has no permissions enabled.

**Fix:**

* Go to **Team Staffs → Manage Staffs**, select the server, and assign the correct role to the player
* In **Roles**, verify that the role has the necessary permission toggles enabled (teleportations, spectate, god mode, etc.)
* Have the player reconnect to reload their permissions

***

## 🔴 Screenshots are not working

**Cause 1:** `screenshot-basic` is not installed or not started before `MS_MadonnAdmin`.

**Fix:** Install `screenshot-basic` and make sure it is ensured before `MS_MadonnAdmin` in your `server.cfg`:

```cfg
ensure screenshot-basic
ensure MS_MadonnAdmin
```

**Cause 2:** The Discord webhook in `config/module/cfg_screenshots.lua` is invalid or missing.

**Fix:** Replace the webhook URL with a valid one from your Discord server:

```lua
SCREENSHOTS = {
    ScreenshotBasicName = "screenshot-basic",
    DiscordWebhookToSaveScreenshots = "https://discord.com/api/webhooks/...",
}
```

***

## 🔴 Logs are not appearing in Discord

**Cause:** The Discord webhook URLs in `config/module/cfg_logs.lua` are set to `false` or are invalid.

**Fix:** Set valid webhook URLs for the log types you want to receive:

```lua
LOGS = {
    DiscordWebhook = {
        Connections = "https://discord.com/api/webhooks/...",
        Chat        = "https://discord.com/api/webhooks/...",
        Shots       = "https://discord.com/api/webhooks/...",
        -- etc.
    }
}
```

Set any entry to `false` to disable that log type's webhook.

***

## 🔴 Anti-cheat is not running *(Silver & Gold only)*

**Cause 1:** `ModuleAnticheat` is set to `false` in `config/cfg_main.lua`.

**Fix:** Set it to `true`:

```lua
ModuleAnticheat = true,
```

**Cause 2:** Your subscription tier is **Bronze**. The anti-cheat module requires **Silver or Gold**.

**Fix:** Upgrade your subscription at `madonnadmin.com`.

***

## 🔴 Sanction returns "Error 0xS14" or "Error 0xS18"

```
[ERROR - #0xS14] An error occured while applying sanction to X
```

**Cause:** The Madonn'Admin API returned an error when applying the sanction. This can happen if the targeted player's profile is not yet fully synchronized.

**Fix:**

* Make sure the target player has connected at least once and their profile exists on `madonnadmin.com`
* If the error persists, contact support with the full error message

***

## 🔴 Ban screen not showing to a banned player

**Cause:** The `Failure_Override` option allowed the player through before the ban check completed, or the player's identifiers changed.

**Fix:**

* Check that the player's ban is correctly registered on `madonnadmin.com` under their profile
* Verify that the player is connecting with the same identifiers (Steam, FiveM, etc.) that were used when the ban was applied

***

## 💬 Still having issues?

If you are still experiencing problems after following the steps above, feel free to reach out to us:

* 💬 **Discord:** [discord.gg/madonne](https://discord.gg/madonne)
* 🌐 **Website:** [madonnestudio.com](https://madonnestudio.com/)
* 📧 **Email:** <contact@madonnestudio.com>


---

# Agent Instructions: 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:

```
GET https://documentation.madonnestudio.com/paid-scripts/madonnadmin/common-errors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.