Plugins - RaidMax/IW4M-Admin GitHub Wiki

Plugins

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


Built-in Plugins

Stats

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

Qualification Requirements:

  • Minimum 3 hours playtime
  • Connected within past 15 days

Commands:

Command Alias Description Level
stats xlrstats View player stats User
topstats ts View top 5 players on server User
mostplayed mp View top 5 by playtime User
mostkills mk View top players by kills User
resetstats rs Reset your stats User
resetanticheat rsa Reset anticheat metrics Owner

Mute

Silence players in chat.

Commands:

Command Alias Description Level
mute mu Mute a player Moderator
tempmute tm Temporarily mute Moderator
unmute um Unmute a player Moderator
muteinfo mi View mute information Moderator

Login

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:

Command Alias Description Level
login li Login with password Trusted

Welcome

Geo-location based welcome messages.

Features:

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

Configuration: WelcomePluginSettings.json


Profanity Determent

Automated profanity filtering.

Features:

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

Configuration: ProfanityDetermentSettings.json


Script Plugins

JavaScript-based plugins for extended functionality.

VPN Detection

Detect and kick VPN users.

Setting Description
vpnExceptionIds Client IDs exempt from VPN kicks

Configuration Examples:

// Single user
vpnExceptionIds: [123456]

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

Disable: Delete Plugins\VPNDetection.js

Commands:

Command Alias Description Level
whitelistvpn wv Whitelist from VPN detection Senior Admin
disallowvpn dv Disallow VPN for player Senior Admin

Action on Report

Automated action when report threshold is reached.

Setting Description Values
enabled Enable plugin true/false
reportAction Action to perform Ban/TempBan
maxReportCount Reports before action > 0
tempBanDurationMinutes Temp ban duration > 0

Configuration: ActionOnReport.js


Shared GUID Kicker

Kicks users using known shared GUIDs.

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


Subnet Ban

Ban entire IP ranges.

Commands:

Command Alias Description Level
bansubnet bs Ban IPv4 subnet (CIDR) Senior Admin
unbansubnet ubs Unban IPv4 subnet Senior Admin

Game-Specific Plugins

IW4 Script Commands

Additional IW4x integration.

Setup: Copy userraw folder to IW4x server directory.

Commands (IW4/IW5/T5/T6):

Command Alias Description Level
giveweapon gw Give weapon to player Senior Admin
takeweapons tw Remove all weapons Senior Admin
noclip nc Enable noclip Senior Admin
hide hi Hide yourself in-game Senior Admin
alert alr Alert a player Senior Admin
gotoplayer g2p Teleport to player Senior Admin
playertome p2m Teleport player to you Senior Admin
goto g2 Teleport to coordinates Senior Admin
kill kpl Kill a player Senior Admin
switchteam st Switch player's team Administrator
lockcontrols lc Lock player controls Administrator
setspectator spec Set as spectator Administrator

Plugin Development

Create custom plugins using C# or JavaScript.

Resources

Plugin Store

Browse community plugins at store.raidmax.org

⚠️ **GitHub.com Fallback** ⚠️