IW4MAdmin supports plugins to extend functionality. Plugins are automatically loaded from the Plugins directory.

Track player performance, statistics, and rankings.

Features:

• Kill/death ratio tracking
• Score per minute calculations
• Skill rating (based on KDR and SPM)
• Elo rating (based on encounter wins)
• Performance rating (average of Skill + Elo)
• Global and per-server leaderboards
• Performance buckets for isolated ranking pools

Qualification Requirements:

• Minimum 3 hours playtime (configurable per bucket)
• Connected within past 15 days (configurable per bucket)

Performance buckets let you group servers into isolated ranking pools. Players are ranked independently within each bucket, so leaderboards and Z-scores are computed separately. This is useful when you want to separate different play styles or game modes (e.g. competitive vs casual, or zombie servers vs multiplayer).

How it works:

1. Set PerformanceBucketCode on each server in IW4MAdminSettings.json (see Configuration)
2. Servers with the same code share a ranking pool
3. Servers without a code use the global (default) pool
4. If a code doesn't exist in the database yet, it is auto-created on server startup

Per-bucket configuration is set in StatsPluginSettings.json under PerformanceBuckets:

{
  "PerformanceBuckets": [
    {
      "Code": "competitive",
      "ClientMinPlayTime": "03:00:00",
      "RankingExpiration": "15.00:00:00"
    }
  ]
}

If a server's bucket code has no matching entry in PerformanceBuckets, the defaults above are used.

Commands:

Silence players in chat.

Commands:

Password-based authentication for privileged users. Deters GUID spoofing by requiring login before commands work.

Setup:

1. Set password using !setpassword <password>
2. Login using !login <password>

Commands:

Geo-location based welcome messages.

Features:

• Welcome players based on country of origin
• Special messages for privileged users (Trusted+)
• Customizable messages

Configuration: WelcomePluginSettings.json

Automated profanity filtering.

Features:

• Warn and kick players for profanity
• Immediate kick for profane names
• Customizable word list

Configuration: ProfanityDetermentSettings.json

JavaScript-based plugins for extended functionality.

Detect and kick VPN users.

Configuration Examples:

// Single user
vpnExceptionIds: [123456]

// Multiple users
vpnExceptionIds: [1, 2, 345678]

Disable: Delete Plugins\VPNDetection.js

Commands:

Automated action when report threshold is reached.

Configuration: ActionOnReport.js

Kicks users using known shared GUIDs.

Purpose: Block players using torrented game copies with shared GUID F4D2C30B712AC6E3.

Ban entire IP ranges.

Commands:

Additional IW4x integration.

Setup: Copy userraw folder to IW4x server directory.

Commands (IW4/IW5/T5/T6):

Create custom plugins using C# or JavaScript.

• Plugin Development Guide
• Plugin Examples
• Building Locally

Browse community plugins at store.raidmax.org