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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc6-IRq0k9aTWVWX7UyQpY3B8Fz7V9mgqsvNDzsXHdPSdDjCuDo91ycC517TbIxCKD1hKFrAKjSdO980SmSlOiz9KmAmjLDYPwtnGvxo4oodGipgPVlcuTjxNynFRlhSD6uP2oj-g?key=fT9iLy8cgk4ZyBMLYLd8yr47" alt=""><figcaption></figcaption></figure>

***

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

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

***

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

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

**Direct Message** — send a private message directly to the player. The message appears in their in-game chat and is visible only to them.

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

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeZFrOUQYclG-TcBhNplzfnU2XlV87TzxG8wwEsq8CMt0F8qgLajKq417d6OniE25iwzvqlxq4-DUu8mc5cIgqDzPX8W-9KOuvY4rBLM0lWFfwoq7PX3esKcKLBt4mbk6r_SpFZ?key=fT9iLy8cgk4ZyBMLYLd8yr47" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeMaHjKKEMb9ufI3WEi3Azmclu2Mn0YPY6dXQeC5pg_o-8Ps-lVD3Zx1dbJn8oqPY1lRfgb_dBs69-IRm2EX3SIQnz04SqeXzALtyydaoWT0xa8zYMZwp9S016aPEaqquHXSPDX?key=fT9iLy8cgk4ZyBMLYLd8yr47" alt=""><figcaption></figcaption></figure>
