Configuration
Complete reference for configuring IW4MAdmin.
When IW4MAdmin launches for the first time, you'll be prompted to configure basic settings.
| Prompt | Description | Default |
|---|---|---|
| Enable webfront | Web-based monitoring and control interface | http://0.0.0.0:1624 |
| 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 |
| 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 |
| Prompt | Description | Default |
|---|---|---|
| Use custom encoding parser | Alternative encoding for game events | false |
Note: Russian users should enable this and use
windows-1251as the encoding.
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 |
Edit IW4MAdminSettings.json directly for advanced options.
Important: Validate JSON syntax before running IW4MAdmin.
| 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 |
| Name | Description | Default |
|---|---|---|
CommandPrefix |
Chat command prefix | ! |
BroadcastCommandPrefix |
Broadcast command prefix | @ |
| Name | Description | Default |
|---|---|---|
EnableCustomSayName |
Enable message prefix | false |
CustomSayName |
Prefix text | — |
| 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) | — |
| Name | Description | Default |
|---|---|---|
EnableCustomParserEncoding |
Use custom character encoding | false |
CustomParserEncoding |
Windows CodePage name | — |
| Name | Description | Default |
|---|---|---|
EnableCustomLocale |
Override system locale | false |
CustomLocale |
ISO 639-1 language code | — |
| Name | Description | Default |
|---|---|---|
DatabaseProvider |
Database type: sqlite, mysql, postgresql
|
sqlite |
ConnectionString |
Connection string for MySQL/PostgreSQL | — |
| 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 |
| Name | Description | Default |
|---|---|---|
ServerConnectionAttempts |
RCon attempts before unreachable | 6 |
IgnoreServerConnectionLost |
Suppress connection lost alerts | false |
| 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 |
| Name | Description | Default |
|---|---|---|
EnableColorCodes |
Show color codes on webfront | false |
IngameAccentColorKey |
Accent color for Color::Accent
|
Cyan |
EnablePrivilegedUserPrivacy |
Hide privileged users from guests | false |
| 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 | — |
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 |
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 | — |
| 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 |
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
| Name | Description |
|---|---|
Title |
Link title |
Url |
Link URL |
IconUrl |
Icon image URL |
IconId |
Phosphor Icons icon name |
Use either
IconUrlorIconId, not both.
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 |
