CoD2x is a modification of Call of Duty 2. It is build on top of 1.3 version. It focuses on fixing bugs and adding new features to the game.
- The CoD2x patch is a community-made, unofficial modification for Call of Duty 2.
- It is provided free of charge, “as is”, without any warranty of functionality or support.
- You use it entirely at your own risk. The authors are not affiliated with Activision or Infinity Ward and take no responsibility for any issues or damages resulting from its use.
- To use this patch, you must own a legitimate, original copy of Call of Duty 2 purchased from an official distributor.
- This software may be terminated or withdrawn at any time
- 2025-10-02 - 1.4.5.1-test.7 - current testing
- 2025-07-25 - 1.4.4.6 - current
- 2025-07-12 - 1.4.4.5
- 2025-07-04 - 1.4.4.4
- 2025-06-27 - 1.4.4.3
- 2025-06-23 - 1.4.4.2
- 2025-06-20 - 1.4.4.1
Older versions
- 2025-06-08 - 1.4.3.5
- 2025-06-06 - 1.4.3.4
- 2025-06-06 - 1.4.3.3
- 2025-06-02 - 1.4.3.2
- 2025-05-25 - 1.4.3.1
- 2025-03-06 - 1.4.2.3
- 2025-03-02 - 1.4.2.2
- 2025-01-23 - 1.4.2.1
- 2025-01-23 - 1.4.1.1
- Dialog "Run in safe mode?" is removed
- Dialog "Set Optimal Settings?" and "Recommended Settings Update" is removed
- New text in the console to indicate that CoD2x is loaded
- Changed auto-update server with ability to download the latest version of CoD2x
- Ability to connect both original 1.3 servers and new 1.4 servers
- New server errors descriptions when non-compatible clients tried to connect to the server
- Fixed black screen on startup - caused by missing microphone / sound device
- Added requirement to run the game as administrator to fix problems with VirtualStore folder and the need to have write access into Program Files folder (as it was possible in Windows XP)
- Fixed "+smoke" bug
- Animations - https://www.youtube.com/watch?v=oQkTuwQnI-8
- Reworked the player character animations
- Stance animation
- No leg swing
- Nade throwing animation is canceled imidiately when the player crouches / prones
- Head movement on ladder - head is rotated according to player's yaw angle
- Prone high body fixed
- Weapon stabilization
- Torso rotation now match the player's yaw angle
- It fixes weapon "waving"
- It fixes diagonal bug
- Reworked the player character animations
- Fixed "iwd/sum name mismatch" error caused by too many iwd files
- Fixed negative protocol number when formating IP and port
- Disabled console prints:
- localized string warning
- Bot warning prints
- "==== ShutdownGame ===="
- "gamename: Call of Duty 2"
- "gamedate: Jun 23 2006"
- Smaller font size of text
- When downloading IWD file
- Text "RECORDING" in the left bottom corner when recording demo
- Added windowed and borderless window mode:
- windowed mode:
r_fullscreen 0 - borderless mode:
r_fullscreen 0andr_mode [screen resolution] - fullscreen mode:
r_fullscreen 1(default)
- windowed mode:
- Added support for rinput (raw input for mouse movement)

m_rinput 0- turned off, uses Windows cursor possition to get movement (default)m_rinput 1- raw mouse movement, dedicated thread, as external Rinput applicationm_rinput 2- raw mouse movement, integrated directly into the game- The game is also measuring the refresh rate of the mouse:
- If the external Rinput application is used, the internal
m_rinputis automatically turned off
- Added possibility to restrict FPS via mod (like zPAM) into range 125 - 250 using new cvar
com_maxfps_limit(the cvar is cheat protected and can be set only by the server) - Ignoring custom IWD mods on game start to avoid runtime errors (only files starting with 'iw_' or 'localized_' are loaded)
- Set sv_cheats 1 on disconnect to allow to play demo without the need to do devmap
- Improved error message
recursive error after: Can´t create Dvar 'xxx': 1280 dvars already exist: - Added informative texts into console with changes that has been applied when connected to the server:
- Added crash reporter
- Added process freeze detection
- Tickrate
- HWID
- An unique hardware ID is generated for each computer
- The HWID is used to ban cheaters on the server via commands
/banClient <clientId>and/unbanAll(bans are saved in filemain\ban.txt) - The HWID is replacing GUID that was generated by PunkBuster, which is no longer supported
- The HWID is an non-zero unsigned 32-bit integer, like
560978975 - You can see your HWID in the game by checking cvar
/cl_hwid 
- Added possibility to change the master via cvars
- client:
cl_masterServer,cl_masterPort - server:
sv_master1,sv_master2,sv_master3sv_master1is forced to becod2master.activision.comsv_master2is forced to bemaster.cod2x.mesv_master3is customizable
- client:
- New cvar
sv_crackedto make the server accept players with invalid CDKEY - New cvar
showPacketStringsto show network communication data - New commands
/increaseand/decreaseto increase or decrease the value of a cvar - Reversed function for third person, added new cvar
cg_thirdPersonMode 1that rotates directly around player without collision with the world - Added possibility to set CPU affinity
com_affinity -1(default) - use maximum available CPU corescom_affinity 0- disable automatically setting CPU affinitycom_affinity <number>- set specified number of cores (e.g.com_affinity 3will use first 3 cores)
- Fixed sounds of invisible players caused by PVS
- Changeable LODs (Level of Detail) for models
r_lodScale <value>r_lodScale 1(default) - original LODsr_lodScale 0.5- better model detail in distancer_lodScale 0- best model detail in distance
- Disabled VirtualStore folder redirection by checking for privileges
- You need original Call of Duty 2 with version 1.3 installed.
- Download latest version of CoD2x - CoD2x_1.4.4.6_windows.zip
- Extract these files from the archive to the Call of Duty 2 folder, replacing any existing file:
- 📄 mss32.dll
- 📄 mss32_original.dll
- Final structure should look like this:
- 📁 Call of Duty 2
- 📁 Docs
- 📁 main
- 📁 miles
- 📁 pb
- 📄 CoD2MP_s.exe
- 📄 CoD2SP_s.exe
- 📄 gfx_d3d_mp_x86_s.dll
- 📄 gfx_d3d_x86_s.dll
- 📄 mss32.dll
- 📄 mss32_original.dll
- 📄 ... (other files)
- 📁 Call of Duty 2
- The archive also contains additional files that are not required to be installed:
- 📄 CoD2x Installation and uninstallation manual.txt
- Delete the following files:
- 📄 mss32.dll
- Rename following file:
- 📄 mss32_original.dll -> 📄 mss32.dll
- Download latest version of CoD2x - CoD2x_1.4.4.6_linux.zip
- Extract this file from the archive to the Call of Duty 2 folder:
- 📄 libCoD2x.so
- Final structure should look like this:
- 📁 Call of Duty 2
- 📁 main
- 📁 pb
- 📄 cod2_lnxded
- 📄 libCoD2x.so
- 📁 Call of Duty 2
- The archive also contains additional files that are not required to be installed:
- 📄 CoD2x Installation and uninstallation manual.txt
- 📄 cod2_lnxded (official 1.3 game version)
- Update chmod for the libCoD2x.so file to be executable:
chmod +x libCoD2x.so
- Run the game with LD_PRELOAD, for example:
LD_PRELOAD=libCoD2x.so ./cod2_lnxded +exec server.cfg- 🛈 Its not common that server providers support adding this, only server administrators can do that.
- Auto-update is enabled by default. Make sure to enable UDP port 20720. If you want to disable auto-update, set
sv_update "0"or disable UDP port 20720. On server start, the server will check for the latest version of CoD2x and download it if available. File libCoD2x.so will be replaced with the latest version. Process restart is needed to apply the update.
Since version 1.4.4.6, the game does not require administrator rights to run if the game is located in folder outside of Program Files.
If the game is located in Program Files, you need to run the game as administrator to avoid problems with VirtualStore folder.
The VirtualStore folder is a feature introduced in Windows Vista and later to provide compatibility for legacy applications that try to write files to protected system locations, such as C:\Program Files. When a program without administrator rights attempts to write to these folders, Windows silently redirects the write operations to a user-specific location.
This allows older applications to run without errors, but it can cause confusion because files may not be where the application or user expects them to be. For example, config files and IWD files might end up in the VirtualStore folder instead of the actual game directory.
Possible locations for the game:
C:\Program Files\Activision\Call of Duty 2C:\Program Files (x86)\Activision\Call of Duty 2C:\Users\<username>\AppData\Local\VirtualStore\Program Files\Activision\Call of Duty 2C:\Users\<username>\AppData\Local\VirtualStore\Program Files (x86)\Activision\Call of Duty 2
Possible locations for the game in registry:
HKEY_LOCAL_MACHINE\SOFTWARE\Activision\Call of Duty 2HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Activision\Call of Duty 2HKEY_CURRENT_USER\SOFTWARE\Classes\VirtualStore\MACHINE\SOFTWARE\Activision\Call of Duty 2HKEY_CURRENT_USER\SOFTWARE\Classes\VirtualStore\MACHINE\SOFTWARE\Wow6432Node\Activision\Call of Duty 2
In CoD2x, we check for write access to the game folder on startup. If the game is located in Program Files and the user does not have write access, we show a error message box:

Running the game as administrator will fix this problem, but it decreases the security of the system. Thats why we recommend to move the game to a different folder, such as C:\Games\Call of Duty 2 and uncheck the "Run as administrator" option and compatibility mode in the properties of the game executable, if possible.
Why its recommended to uncheck also compatibility mode? Compatibility mode also runs the game with administrator rights.
Try to run the game without administrator and compatibility mode first, and if it works without problems, you can leave it that way. If you encounter problems with the game, you can try to run the game with compatibility mode, but you decrease the security of your system.
In registry, when the game runs with administrator rights, we are moving old values from VirtualStore to the original location, so the game always uses the latest saved values.
-
Clone this repository.
-
Copy .iwd files from original Call of Duty 2 1.3 main folder to
./bin/windows/mainfolder in this repository (iw_01..iw_15 and localized_english_iw00..localized_english_iw11) -
Instal MinGW-w64 by Brecht Sanders winlibs-i686-posix-dwarf-gcc-14.2.0-mingw-w64msvcrt-12.0.0-r2 into
./tools/mingw -
Install WSL (Windows Subsystem for Linux)
wsl --install Ubuntu-18.04
- Run these commands in WSL:
wsl --install(should install 'Ubuntu' instance name)sudo apt updatesudo dpkg --add-architecture i386sudo apt updatesudo apt install -y make ninja-build gcc gdb gdbserver:i386 build-essentialsudo apt install -y libc6:i386 libstdc++5:i386 libgcc1:i386(runtime libraries to run original CoD2)sudo apt install -y libssl-dev:i386(development libraries for OpenSSL)sudo apt install -y gcc-multilib libc6-dev:i386(development libraries to compile new code)sudo apt-get install gcc-multilib g++-multilib(some dependencies for compiling)- Install cmake >=3.25.2 (on Ubuntu 18.04 cmake version is 3.10, we need that for new options):
sudo apt install -y software-properties-common lsb-release ca-certificates gnupg wgetwget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | sudo apt-key add -sudo apt-add-repository "deb https://apt.kitware.com/ubuntu/ $(lsb_release -cs) main"sudo apt updatesudo apt install -y cmakeexitwsl --set-default Ubuntu-18.04- |
- Setup tmux: (enable mouse scrolling)
nano ~/.tmux.conf- write
set -g mouse on - Ctrl+X, Y, Enter
- write
tmux source-file ~/.tmux.conf- |
- How to get IP of WSL virtual machine to connect from Windows to Linux CoD2x server:
ip addr show eth0 | grep inet | awk '{ print $2; }' | sed 's/\/.*$//'
- Run VSCode as administrator (:warning: needed to be able to run CoD2 also as administrator while debugging)
- Use VSCode to compile, run and debug
- 📁 bin
- 📁 linux - Linux server binaries
- 📁 windows - Windows game binaries from original CD with 1.3 patch applied
- 📁 src
- 📁 linux - code related only for Linux server
- 📁 mss32 - code related for Windows, mimicking mss32.dll
- 📁 shared - code shared for both Linux server and Windows version
- 📁 other - reversed / testing code
- 📁 tools - contains external tools for coding, compiling, etc..
- 📁 zip - zip files are generated here
To avoid source code duplication, the code that is used for both Linux and Windows is placed in 📁src / 📁shared folder. Its primarily a server side code.
The code that is related only for Windows version or Linux server is placed in particular folders 📁src / 📁mss32 or 📁src / 📁linux, both sharing the shared folder.
CoD2MP_s.exe has following dynamic libraries:
- WINMM.dll
- WSOCK32.dll
- mss32.dll <-- hooking this library
- d3d9.dll
- DSOUND.dll
- KERNEL32.dll
- USER32.dll
- GDI32.dll
- ADVAPI32.dll
- SHELL32.dll
These libraries are loaded at runtime when the CoD2MP_s.exe is started.
File mss32.dll is a Miles Sound System dynamic link library used for audio playback. This file is replaced with our custom mss32.dll, which exports the same functions as the original mss32.dll.
The CoD2MP_s.exe imports 364 functions from original mss32.dll:
- _AIL_set_sample_adpcm_block_size@8
- _AIL_enumerate_3D_providers@12
- _AIL_end_sample@4
- _AIL_set_3D_position@16
- ...
Our version of mss32.dll has the same exported functions as original. These functions act as a proxy to the original functions in the original mss32.dll.
[CoD2MP_s.exe]
↓
[mss32.dll] <- this file
↓
[mss32_original.dll] <- original mss32.dll
When our mss32.dll is loaded, it loads mss32_original.dll and redirect all exported functions. It also runs patching process that modifies the game memory to fix some bugs and add new features.













