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

Main Configuration File

The main configuration file is located at config/cfg_main.lua. It controls the core behavior of Madonn'Admin, including the server token, notification system, active modules, and general settings.


๐Ÿ”‘ Authentication

Server_Token = "",
Option
Type
Description

Server_Token

string

Your unique server token, found in your community settings on madonnadmin.com. Required.


๐Ÿ› Debug & Display

Option
Type
Description

Debug

boolean

Enable or disable debug messages in the server console

Discord_Invite_Link

string

Your Discord invite link, shown to players in the ban screen


๐Ÿ• Date & Time

Option
Type
Description

DateFormatSQL

string

Date format used for log timestamps. Default: "%d/%m/%Y %T"

Timezone

string

Timezone offset for logs (e.g. "+1" = UTC+1, "0" = UTC, "-5" = UTC-5)


๐Ÿ”Œ Connection Handling

Option
Type
Description

Failure_Override

boolean

If true, players can still connect even when Madonn'Admin is temporarily unreachable. If false, they are blocked.

AprilFoolBan

boolean

Enables the April Fool's fake ban joke on April 1st

CantConnectText

string

Message shown to players when Madonn'Admin is down and Failure_Override is false

CantConnectToMadonnAdmin

string

Message shown briefly when the platform is unreachable but Failure_Override is true

CheckingProfile

string

Message shown in the loading screen while a player's profile is being verified


๐ŸŽฎ In-Game Interface

Option
Type
Description

OpenAdminMenu

string

Key binding to open the admin menu. Default: "F10"

StaffActiveNoticeSize

string

Font size of the active staff notice displayed on screen. Default: "20px"

MinPlayersForHighDensityArea

number

Minimum number of players in a zone for it to be flagged as a high density zone


๐Ÿ”” Notification System

Option
Values
Description

NotificationSystem

"default" | "chat" | "okokNotify" | "MadonneNotify" | "custom"

Controls how notifications are displayed to staff members

NotificationChatColorMessage

{r, g, b}

Text color for chat-based notifications. Only used when NotificationSystem = "chat"

NotifyAllPlayersForSanctions

boolean

If true, all players receive a server-wide chat message when a sanction is applied

๐Ÿ’ก If using "custom", implement your notification handler in client/custom/cl_functions.lua inside the CustomNotify(text) function.


๐Ÿ’ฌ Staff Chat & Broadcasts

Option
Type
Description

StaffMessagePrefix

string

Prefix shown in chat for staff messages. Default: "STAFF CHAT"

ShowStaffMessageAsSplashMessage

boolean

If true, private staff messages sent to a player appear as a full-screen GTA V splash message

ShowAuthorName

boolean

If true, the author's name is shown in the splash message when a staff sends a message to a player

StaffMessageColor

{r, g, b}

Text color of staff chat messages

BroadcastMessageColor

{r, g, b}

Text color of broadcast messages


๐Ÿงฉ Modules

Option
Type
Description

ModuleAnticheat

boolean

Enable the anti-cheat module. Requires Silver or Gold subscription.

ModuleLogs

boolean

Enable the activity log module (shots, deaths, chat, connectionsโ€ฆ)

ModuleScreenshots

boolean

Enable the automatic screenshot system. Requires screenshot-basic.


โฑ๏ธ Ban Durations

The BanDurations table defines the letter codes used when applying bans via command or the in-game panel:

Examples of valid durations:

  • "30m" โ†’ 30 minutes

  • "2h" โ†’ 2 hours

  • "7d" โ†’ 7 days

  • "2w" โ†’ 2 weeks

  • "1mo" โ†’ 1 month

  • "p" โ†’ permanent

  • "c" โ†’ community ban


๐Ÿ”„ Restart Announcement

Automatically send countdown messages in chat before scheduled server restarts:

Option
Type
Description

Enabled

boolean

Enable or disable the restart announcement system

Hours

table

List of scheduled restart times in "HH:MM" format

XMinutesBefore

table

List of how many minutes before each restart to send a warning

Last updated