> For the complete documentation index, see [llms.txt](https://documentation.madonnestudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.madonnestudio.com/paid-scripts/madonnadmin/how-to-use-it/web-dashboard/players.md).
# Players
The Players section offers two subsections for managing and looking up player profiles.
***
## Search for a Player
Search for a specific player's Madonn'Admin profile using:
* **Username** — as it appears on the server
* **GTA 5 License**
* **Discord ID**
* **Steam ID**
* **Xbox ID / Live ID**
By default the search uses the GTA 5 license as the identifier, but this can be changed from the dropdown in the search interface.
***
## Show All Players
A complete list of all players registered or active on the server, with the following columns:
| Column | Description |
| --------------------- | ------------------------------------------------ |
| **Player Name** | Nickname — click to open the full player profile |
| **Playing Time** | Total cumulative time spent on the server |
| **First Connection** | Date of the player's first connection |
| **Last Connection** | Date of the player's most recent connection |
| **Status** | Online or offline |
| **Warn / Kick / Ban** | Sanction summary |
All columns are sortable. A search bar in the top right allows filtering by nickname. Default display: 10 players, expandable to 100.
***
## Player Profile
A player's profile is divided into several sections.
**Identifiers** — all accounts linked to the player: Discord, Steam, FiveM license, Xbox ID, and any other associated platforms.
**Statistics** — displayed on the right side of the profile:
* Current status (online / offline)
* First and last connection dates
* Total playtime
* **Trust score** — calculated from playtime and sanction history. A higher score indicates reliable behavior; a lower score reflects a significant sanction history.
* **Flags** — reliability indicators based on behavior and history
**Direct Message** — send a private message directly to the player. The message appears in their in-game chat and is visible only to them.
**Sanction History** — complete list of sanctions applied to the player: notes, recommendations, warns, kicks, and bans.
**Appeals** — accessible to administrators and above. Includes a clipboard button to copy a direct link to the player's Madonn'Admin page, which can be sent to the player so they can submit an appeal themselves.
**Logs** — all actions performed by the player on the server, with date/time, action type, and additional context. Default display: 10 logs, expandable to 100.
**Apply a Sanction** — directly from the profile:
* **Note** — add a personal annotation to the player's profile
* **Recommendation** — adds a positive note that influences the player's trust score
* **Kick** — apply an expulsion with a reason
* **Warn** — apply a warning with a reason
* **Ban** — apply a ban with a configurable duration (from minutes to permanent/community ban) and a reason
---
# 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:
```
GET https://documentation.madonnestudio.com/paid-scripts/madonnadmin/how-to-use-it/web-dashboard/players.md?ask=
```
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.
