KisakBlack

About the project

An open source fully-buildable reimplementation of Call of Duty Black ops's Multi-Player .exe

Aimed towards mod developers and BLOPS enthusiasts.

Development Blog

Learn about the Development of KisakBlack here: https://lwss.github.io/Kisak-Black/

Current Requirements

• Windows OS
• Visual Studio 2022
• CMake >= 3.16
• DirectX SDK 2010
• Steam with a copy of Call of Duty: Black Ops

How to build

1. Install the above requirements and Clone repo
2. create a /build folder
3. CMAKE .. -G"Visual Studio 17 2022" -DCMAKE_GENERATOR_PLATFORM=WIN32
4. Open the generated .sln file
5. Build Debug or Release (Visual Studio dropdown)
6. Copy BLOPS Game files to build/(BUILD_TYPE)/* (Don't try to cherry-pick them, small files like localization.txt are needed)
7. Copy binkw32.dll, steam.dll, steam_api.dll, steamclient.dll, tier0_s.dll, vpx.dll, vstdlib_s.dll into the folder as well (You can find these in-tree in the respective folders)
8. Run the game via Visual Studio play button or just the .exe

Keep in Mind: This is a ~20 year old game with some known exploits. We will try to fix these as we become aware of them.
However, there is a non-zero chance of some type of binary exploitation when playing online. Use a sandbox (Sandboxie?) for peace of mind. 

Known Issues

(Use the issues section)

Troubleshooting

• Can't Connect to Dedicated Server :
  • Check net_ip and net_port, the server will increment the port if the preferred one isn't available but the client won't sweep upwards.
• DLL Error upon launch :
  • You didn't copy over the necessary runtime DLL's

Credits and Special Thanks

• All Original BLOPS Developers (for creating one of the best games of all time)
• https://github.com/SwagSoftware/KisakCOD (Some code re-used)
• https://github.com/PJayB/jk3src (Jedi Academy fork with .sln)
• https://github.com/voron00/CoD2rev_Server - Useful yacc code for the gsc scripting here
• https://github.com/shiversoftdev/BO3Enhanced - Viewed as reference code for some of the Steam API Auth
• RAD Game Tools for their Bink library.

Discord

Join the KisakCOD Discord