# Madonn'Admin

Madonn'Admin is the ultimate moderation and administration solution created by MadonneStudio. Designed from the ground up for FiveM server owners who take their community seriously, it brings together everything you need to protect your players, manage your staff, and run your server with full control — in-game, on the web, and on mobile.

<figure><img src="/files/vu4JMpwMVZRXGxu9cqIG" alt=""><figcaption></figcaption></figure>

***

## 📖 About Madonn'Admin

Trollers, cheaters, and bad actors will no longer have any excuse for going unpunished. With Madonn'Admin, your moderation team has access to a complete toolset at all times. The resource connects to the **Madonn'Admin cloud platform** (`madonnadmin.com`) to handle player profiles, sanctions, staff permissions, and real-time data synchronization across all your servers.

### ✨ Main Features

* 🎮 **In-Game Dashboard** — A complete admin panel accessible via `F10` (configurable), featuring a player list, live logs, report management, and all moderation actions, without ever leaving the game
* 💻 **Web Dashboard** — A full administration interface accessible from any browser, on desktop or mobile, synchronized in real time with the in-game panel
* 👥 **Staff & Role Management** — Create up to 5, 10, or 15 custom roles per server with granular per-permission control, and assign up to 10, 15, or 50 staff members depending on your plan
* ⚖️ **Sanction System** — Apply notes, commends, warns, kicks, temporary bans, permanent bans, and community bans, all stored permanently on each player's profile
* 🚨 **Report System** — Players submit reports in-game via `/report`, with automatic screenshot capture, real-time staff notifications, built-in messaging, and full statistics on the web dashboard
* 🗺️ **Player Blips & Nametags** — Active staff see player blips and nametags on the map, with trust level color coding and driver indicators
* 🔍 **Spectate System** — Discretely spectate any player with a built-in scaleform interface and `F` key to exit
* 📋 **Activity Logs** — Track connections, chat messages, shots, injuries, deaths, explosions, and name changes, with automatic Discord webhook delivery and automatic screenshots on kills
* 🏘️ **High Density Zones** — Automatically detect and display map areas where players are clustering, color-coded by density level
* 📣 **Broadcast & Staff Chat** — Send server-wide messages or communicate privately with your staff team via a dedicated admin chat command
* 🔔 **Notification System** — Compatible with `default`, `chat`, `MS_Madonne_Notify`, `okokNotify`, or a fully custom handler
* 🛡️ **Anti-Cheat** *(Silver & Gold)* — Built-in detection for prop spam, explosion spam, vehicle spam, noclip, freecam, invisibility, sound exploits, event spoofing, and task clearing — all auto-banning with configurable durations
* 🤖 **Birgitte AI Assistant** *(Gold)* — AI-powered assistant integrated into the dashboard with username compliance checking at connection
* 🧩 **Developer Exports** — `GetStaffRank`, `IsPlayerTrusted` (client), `GetStaffLevelServerSide`, `GetStaffStatus` (server)
* 🌐 **Multi-Language** — English, French, and Spanish included out of the box
* 📦 **Multi-Server** — Manage up to 2, 5, or 10 servers from a single account and dashboard

***

## 🔗 Quick Links

* [🚀 First Launch](/paid-scripts/madonnadmin/first-launch.md)
* [📥 Installation](/paid-scripts/madonnadmin/script-installation.md)
* [⚙️ Configuration](/paid-scripts/madonnadmin/configuration.md)
* [🖱️ Utilisation](/paid-scripts/madonnadmin/how-to-use-it.md)
* [🧩 Exports & API](/paid-scripts/madonnadmin/api-exports.md)
* [❓ Common Errors](/paid-scripts/madonnadmin/common-errors.md)


---

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