For the complete documentation index, see llms.txt. This page is also available as Markdown.

First Launch

Before installing the resource on your server, you need to create and configure your Madonn'Admin community on the web platform. This step is required โ€” the resource cannot load without a valid server token linked to an active subscription.


๐Ÿ’ณ Payment

When subscribing, it is imperative to provide a valid email address. All information relating to your Madonn'Admin account will be sent to this address.

After validating your payment, a confirmation email will be automatically sent by our service from noreply@madonnadmin.com. This email contains crucial information such as your credentials, your community token, and direct links to the documentation.

๐Ÿ’ก If you do not receive the email within a few minutes, check your spam or junk mail folder. If you still cannot find it, contact our support on Discord immediately.

Keep this email somewhere safe โ€” you will need it to set up your community.


๐Ÿ‘ค Step 1 โ€” Create your account

Once you have received your email, create your Madonn'Admin account at madonnadmin.com. This account is the main entry point to manage your server, your staff, and your community settings.

Once logged in, your account will be automatically associated with your community.


๐Ÿ”‘ Step 2 โ€” Retrieve your Community Token

Your Community Token is a unique identifier required for various administrative actions. It was included in the email sent by our services and looks like this:

It can also be found at any time in your community settings on the Madonn'Admin dashboard. Keep it safe and never share it publicly.


โš™๏ธ Step 3 โ€” Initial setup

Once registered, follow the initial setup steps on the dashboard:

  • Configure your community name โ€” this is displayed in-game as the prefix in notifications and staff chat messages

  • Set your language (English, French, or Spanish)

  • Set your timezone โ€” used for accurate log timestamps


๐Ÿ–ฅ๏ธ Step 4 โ€” Add your server

In the dashboard, navigate to Servers and add a new server. Fill in:

  • The server name

  • The public IP address of your FiveM server

โš ๏ธ The IP address must match exactly the one your FiveM server is running on. An incorrect IP will prevent the resource from authenticating.

Once created, your Server Token will be generated. Copy it โ€” you will need it in config/cfg_main.lua (see ๐Ÿ“ฅ Installation).


๐ŸŽญ Step 5 โ€” Create your staff roles

In Roles, create the ranks for your moderation team. For each role you can configure:

  • The role name and display color (shown on nametags and in the staff list)

  • The rank order

  • Per-permission toggles โ€” teleportations, spectate, god mode, submarine mode, delete radius, broadcast, and more

๐Ÿ’ก Rank -1 is the super admin rank and bypasses all permission checks. Rank 0 means the player has no staff access.


๐Ÿ‘ฎ Step 6 โ€” Add staff members

Adding a player as a staff member requires a few steps to ensure a secure and correct association.

Requirements before adding a staff member:

  • The player must have connected at least once to your server. This initial connection allows Madonn'Admin to recognize the player and automatically generate their profile on the platform.

  • You must send the player your Community Token (see Step 2). The player must enter this token in the settings of their own Madonn'Admin account to link themselves to your community.

How to finalize the association:

Once the player has connected and entered the token, go to their Madonn'Admin profile. A box will appear under their username, showing the name linked to their account. Click on this box to officially add the player to your community as a staff member.

This creates a permanent link between the player and your community. If you later wish to remove this link, click the trash icon to delete the association.


๐Ÿท๏ธ Step 7 โ€” Assign a role to a staff member

At this point, the staff member is linked to your community but does not yet have a specific role. To assign one:

  • Go to Team Staffs โ†’ Manage Staffs in the dashboard

  • Select the server on which you want to assign the permissions

  • Enter the username of the staff member

  • Choose the role to assign

This ensures each staff member has the appropriate permissions to fulfill their functions while maintaining a clear and structured organization within your team.


๐Ÿ“ฃ Step 8 โ€” Configure broadcasts & announcements (optional)

In Broadcasts, pre-save server-wide message templates that staff can send with a single click from the in-game dashboard.

In Announcements, post staff-facing messages that appear on the admin panel homepage โ€” useful for shift instructions, event reminders, or moderation guidelines.


โœ… You're ready

Your community, server, roles, and staff are now configured. Proceed to the ๐Ÿ“ฅ Installation page to set up the resource on your FiveM server.

Last updated