Configuration - RaidMax/IW4M-Admin GitHub Wiki

Configuration

Complete reference for configuring IW4MAdmin.

Initial Setup

When IW4MAdmin launches for the first time, you'll be prompted to configure basic settings.

Webfront

Prompt	Description	Default
Enable webfront	Web-based monitoring and control interface	`http://0.0.0.0:1624`

Permissions

Prompt	Description	Default
Enable multiple owners	Allow more than one client to be Owner	`false`
Enable stepped hierarchy	Privileged clients can promote others to level below theirs	`false`

Display

Prompt	Description	Default
Enable custom say name	Prefix for IW4MAdmin messages (e.g., `[Admin] message`)	`false`
Enable social link	Show community link on webfront	`false`

Encoding

Prompt	Description	Default
Use custom encoding parser	Alternative encoding for game events	`false`

Note: Russian users should enable this and use windows-1251 as the encoding.

Server Configuration

After initial setup, configure each server:

Prompt	Description	Default
Server IP Address	Usually `127.0.0.1`	—
Server port	Port from `net_port` dvar	—
RCon password	From `rcon_password` dvar	—
Reserved slots	Slots reserved for privileged players	`0`

Advanced Configuration

Edit IW4MAdminSettings.json directly for advanced options.

Important: Validate JSON syntax before running IW4MAdmin.

Application Settings

Core Settings

Name	Description	Default
`EnableMultipleOwners`	Allow multiple Owner-level clients	`false`
`EnableSteppedHierarchy`	Stepped promotion hierarchy	`false`
`IgnoreBots`	Don't track bot players	`false`
`UseLocalTranslations`	Use local translation files	`false`

Commands

Name	Description	Default
`CommandPrefix`	Chat command prefix	`!`
`BroadcastCommandPrefix`	Broadcast command prefix	`@`

Custom Say Name

Name	Description	Default
`EnableCustomSayName`	Enable message prefix	`false`
`CustomSayName`	Prefix text	—

Social Link

Name	Description	Default
`EnableSocialLink`	Show social link on webfront	`false`
`SocialLinkAddress`	URL to social page	—
`SocialLinkTitle`	Link title text	—
`ContactUri`	Admin contact (shown on bans)	—

Encoding

Name	Description	Default
`EnableCustomParserEncoding`	Use custom character encoding	`false`
`CustomParserEncoding`	Windows CodePage name	—

Locale

Name	Description	Default
`EnableCustomLocale`	Override system locale	`false`
`CustomLocale`	ISO 639-1 language code	—

Database

Name	Description	Default
`DatabaseProvider`	Database type: `sqlite`, `mysql`, `postgresql`	`sqlite`
`ConnectionString`	Connection string for MySQL/PostgreSQL	—

Timing

Name	Description	Default
`RConPollRate`	Server poll interval (ms)	`5000`
`AutoMessagePeriod`	Auto-message interval (seconds)	`60`
`MapChangeDelaySeconds`	Delay before map change	`5`
`MaximumTempBanTime`	Maximum temp ban duration	`30.00:00`
`MaxClientHistoryTime`	Client history graph duration	`0.12:00:00`
`ServerDataCollectionInterval`	Data collection interval	`0.0:05:00`
`RecentAliasIpLinkTimeLimit`	Evading account link duration	`7.0:00:00`

Server Connection

Name	Description	Default
`ServerConnectionAttempts`	RCon attempts before unreachable	`6`
`IgnoreServerConnectionLost`	Suppress connection lost alerts	`false`

Content

Name	Description	Default
`AutoMessages`	Global broadcast messages	`[]`
`GlobalRules`	Rules for all servers	`[]`
`DisallowedClientNames`	Auto-kick names (exact match)	`[]`
`BanDurations`	Webfront ban duration options	`1h, 6h, 1d, 2d, 1w, 4w`
`PresetPenaltyReasons`	Webfront penalty reason presets	`afk, ci`

Display

Name	Description	Default
`EnableColorCodes`	Show color codes on webfront	`false`
`IngameAccentColorKey`	Accent color for `Color::Accent`	`Cyan`
`EnablePrivilegedUserPrivacy`	Hide privileged users from guests	`false`

Advanced

Name	Description	Default
`MinimumNameLength`	Minimum client name length	`3`
`EnableImplicitAccountLinking`	Link accounts by IP (legacy)	`false`
`OverridePermissionLevelNames`	Custom permission level names	—
`MasterUrl`	Master server URL	`https://master.iw4.zip`
`Id`	Instance identifier (don't share)	Auto-generated
`SubscriptionId`	Plugin store subscription email	—

Webfront Configuration

Located under Webfront in settings:

Name	Description	Default
`Enabled`	Enable webfront	`false`
`BindUrl`	Listen address and port	`http://0.0.0.0:1624`
`ManualUrl`	Public URL (for reverse proxy)	—
`CustomBranding`	Header branding text	`IW4MAdmin`
`PrimaryColor`	Primary accent color (hex)	`#117ac0`
`SecondaryColor`	Secondary accent color	`pink`
`ThemePreset`	Theme preset name	`minimal`
`PreventUserCustomization`	Lock user theme settings	`false`
`EnableConnectionWhitelist`	IP whitelist for access	`false`
`ConnectionWhitelist`	Allowed IP addresses	`[]`
`UseSsl`	Enable HTTPS	`false`
`SslCertificatePath`	Path to PFX certificate	—
`SslCertificatePassword`	Certificate password	—
`PermissionSets`	Fine-grained permissions	See Permission Sets

Server Configuration

Per-server settings under Servers:

Name	Description	Default
`IPAddress`	Server IP (usually `127.0.0.1`)	—
`Port`	Server port (1-65535)	—
`Password`	RCon password	—
`Rules`	Server-specific rules	`[]`
`AutoMessages`	Server-specific messages	`[]`
`ReservedSlotNumber`	Reserved privileged slots	`0`
`ManualLogPath`	Override game log path	—
`GameLogServerUrl`	Game Log Server URL	—
`CustomHostname`	Override server name	—
`RConParserVersion`	RCon parser name	—
`EventParserVersion`	Event parser name	—

Parser Names

Game	Parser Name
Call of Duty (Pre-CoD4)	`CoD`
IW4x	`IW4x Parser`
IW6x	`IW6x Parser`
S1x	`S1x Parser`
CoD4x	`CoD4x Parser`
Plutonium IW5	`Plutonium IW5 Parser`
Plutonium T6	`Plutonium T6 Parser`
Plutonium T5	`Plutonium T5 Parser`
Plutonium T4 (MP)	`Plutonium T4 MP Parser`
Plutonium T4 (CO-OP/Zombies)	`Plutonium T4 CO-OP/Zombies Parser`
Tekno MW3	`Tekno MW3 Parser`
RektT5m	`RektT5m Parser`
World at War (Retail)	`Call of Duty 5: World at War Parser`
Black Ops 3 (Retail)	`Black Ops 3 Parser`
BOIII (X Labs T7)	`BOIII Parser`
H1-Mod	`H1-Mod Parser`
H2M-Mod	`H2M-Mod Parser`
CS:GO	`CS:GO Parser`
CS:GO (SourceMod)	`CS:GO (SourceMod) Parser`
L4D2 (SourceMod)	`L4D2 (SourceMod) Parser`

Community Information

Configure your community's about page:

Name	Description	Default
`Name`	Community name	`IW4MAdmin`
`Description`	Community description	—
`IsEnabled`	Show about page	`true`
`EnableBanner`	Show banner on about page	`true`
`SocialAccounts`	Social media links	`[]`

Note: Banner image location: wwwroot/images/community/banner.png

Social Account Configuration

Name	Description
`Title`	Link title
`Url`	Link URL
`IconUrl`	Icon image URL
`IconId`	Phosphor Icons icon name

Use either IconUrl or IconId, not both.

AutoMessage Tokens

Dynamic tokens for broadcast messages:

Token	Description
`{{TOTALPLAYERS}}`	Total connected players
`{{TOPSTATS}}`	Top 5 players by performance
`{{MOSTPLAYED}}`	Top 5 players by kills
`{{TOTALPLAYTIME}}`	Cumulative playtime (hours)
`{{VERSION}}`	IW4MAdmin version
`{{ADMINS}}`	Online unmasked admins
`{{NEXTMAP}}`	Next map in rotation