IW4x is a community-driven project that aims to revitalize and enhance the Call of Duty: Modern Warfare 2 (2009) multiplayer experience by providing a stable platform with support for dedicated servers and modding.
A Steam installation of Modern Warfare 2 is required to run IW4x, copies from the Microsoft Store are not compatible.
IW4x is distributed through the IW4x Launcher.
Important
Clone the git repository instead of downloading the ZIP, as the latter will not work.
- Clone the repository -
git clone https://github.com/iw4x/iw4x-client.git - Run
generate.batto initialize and update submodules and generate the Visual Studio solution - Open/build the generated solution file
build\iw4x.slnwith Visual Studio
To use the iw4x.dll, you must have a valid Modern Warfare 2 installation with the IW4x Rawfiles installed.
On Linux, we can cross-compile IW4x using MinGW-w64. This requires a native Premake 5.0.0-beta8 or later, GNU Make 4.3 or later, UASM, and a 32-bit MinGW-w64 GCC toolchain with POSIX threads and C++20 <format> support. The latter should provide i686-w64-mingw32-g++ and i686-w64-mingw32-windres.
We can then build IW4x as follows:
git submodule update --init
premake5 --mingw gmake
make -C build/mingw -j"$(nproc)" config=release_win32For a Debug build, use config=debug_win32. The resulting DLL and Sentry helpers can be found under build/mingw/bin/Win32/Release/ (or Debug/).
Note that we need a native protoc 3.20.3 to match the bundled Protobuf runtime. If this version is not available on the host, we can build it from the bundled sources:
cmake -S deps/protobuf/cmake -B build/host-protobuf -Dprotobuf_BUILD_TESTS=OFF
cmake --build build/host-protobuf --target protoc --parallel
make -C build/mingw -j"$(nproc)" config=release_win32 PROTOC="$PWD/build/host-protobuf/protoc"Development Setup
- Right-click the IW4x solution in Visual Studio
- Select Properties
- Set the output directory to your MW2 install path
- Right-click the IW4x solution in Visual Studio
- Select Properties
- Select Debugging
- Set the Command value to the path of your
iw4x.exeinside your MW2 game files
Tip:
- Switch to Windowed mode in-game, as breakpoints will lock the window.
- Pressing
F5will launch the game and attach the debugger.- The default hotkey for stopping the debugger is
Shift+F5.
| Argument | Description |
|---|---|
--copy-to=PATH |
Copy the binaries into PATH after each build. |
--copy-pdb |
Copy the debug information along with the binaries (requires --copy-to). |
--disable-binary-check |
Don't verify that the game executable is the supported one. |
--sentry-dsn=URL |
Submit crash reports to this Sentry DSN. Crash reporting is compiled out when it is not given. |
--profile |
Build with Tracy (see Profiling). |
--no-buildinfo |
Don't regenerate the build information (version.h) before each build. generate-linux.sh passes it since the build can't run git under Wine. |
| Argument | Description |
|---|---|
-entries |
Print to the console a list of every asset as they are loaded from zonefiles. |
-stdout |
Redirect all logging output to the terminal iw4x is started from, or if there is none, creates a new terminal window to write log information in. |
-console |
Allow the game to display its own separate interactive console window. |
-dedicated |
Starts the game as a headless dedicated server. |
-dump |
Write info of loaded assets to the raw folder as they are being loaded. |
-nointro |
Skip game's cinematic intro. |
-version |
Print IW4x build info on startup. |
-steam |
Enable friends feature and other Steam integrations. |
-unprotect-dvars |
Allow the server to modify saved/archive dvars. |
-zonebuilder |
Start the interactive zonebuilder tool console instead of starting the game. |
-original-str-parsing |
(ZoneBuilder mode only) Parse .str files in the same manner as the CoD4 Mod Tools. |
-disable-notifies |
Disable "Anti-CFG" checks |
-disable-mongoose |
Disable Mongoose HTTP server |
-disable-rate-limit-check |
Disable RCon rate limit checks |
-disable-mod-unloading |
Disable automatic mod (fs_game) unloading when disconnecting |
-sentryfull |
Capture full process memory in crash reports rather than the stack and its surroundings. |
-sentrystack |
Capture only stack memory in crash reports. |
-sentrydebug |
Print the crash reporter's own diagnostics to the console. |
Crash reports are submitted to Sentry through the
Sentry Native SDK, using its
out-of-process native backend. Three binaries make up the client side of it:
| Binary | Role |
|---|---|
iw4x.dll |
Holds the SDK, the scope and the in-process crash handler. |
sentry-crash.exe |
Started at launch and parked until a crash. Writes the minidump against the crashed game from the outside and uploads it, so a corrupted heap or an exhausted stack cannot take the report down with it. |
sentry-wer.dll |
Registered with Windows Error Reporting. Catches fail-fast exceptions, stack buffer overruns and heap corruption, none of which reach a top level exception filter. |
All three are published with each release and must be installed side by side.
Crash reporting is compiled out unless a DSN is passed to premake, so it is off by default and release builds take the DSN from a repository secret. To point a local build at Sentry, copy the example configuration and fill in the DSN:
cp sentry.bash.example sentry.bash
sh generate-linux.sh releaseNote that sentry.bash is ignored by git and is picked up automatically
by generate-linux.sh, which passes the DSN on to premake and exports
the rest of the file so sentry-cli can upload debug symbols from the
same shell.
On Windows the same is done with a user script, which git ignores as well.
Create user.bat next to generate.bat containing:
@echo off
call generate.bat --sentry-dsn=https://...Profiling builds embed Tracy, which streams timing data to its viewer over the network.
Profiling is compiled out unless --profile is passed to premake.
generate-linux.sh takes the same option:
sh generate-linux.sh --profile releaseWith the MinGW-w64 build from above, the option goes to premake:
premake5 --mingw --profile gmake
make -C build/mingw -j"$(nproc)" config=release_win32Note that make doesn't notice changed compiler flags, so remove
build/mingw before adding --profile to an existing build directory
and again before dropping it.
On Windows, pass the option to generate.bat, for example from the
user.bat described in Crash reporting:
@echo off
call generate.bat --profileStart the game, then connect the viewer (tracy-profiler) to 127.0.0.1.
To record a profile without the viewer, use tracy-capture. For example,
to save 30 seconds into iw4x.tracy:
tracy-capture -o iw4x.tracy -a 127.0.0.1 -s 30This software has been created purely for the purposes of academic research. It is not intended to be used to attack other systems. Project maintainers are not responsible or liable for misuse of the software. Use responsibly.

