README.md

Call of Duty asset importer

Blender add-on for importing various Call of Duty assets via the game files.

Supported assets & features

• Call of Duty & Call of Duty United Offensive
  • BSP - Compiled map files
  • XModel - Compiled models
• Call of Duty 2
  • D3DBSP - Compiled map files
  • XModel - Compiled models
• Call of Duty 4 Modern Warfare
  • XModel - Compiled models
• Call of Duty 5 World at War
  • XModel - Compiled models
• Call of Duty Black Ops
  • XModel - Compiled models

Installation & setup

First of all, extract all the necessary game specific contents. Make sure to have the exact same folder structure as they have originally.

Call of Duty & Call of Duty United Offensive

Files can be found inside the .pk3 files.

  .
  ├── maps/
  ├── skins/
  ├── textures/
  ├── xanim/
  ├── xmodel/
  ├── xmodelalias/
  ├── xmodelparts/
  └── xmodelsurfs/

Call of Duty 2

Files can be found inside the .iwd files.

  .
  ├── images/
  ├── maps/
  ├── materials/
  ├── xanim/
  ├── xmodel/
  ├── xmodelalias/
  ├── xmodelparts/
  └── xmodelsurfs/

Call of Duty 4 Modern Warfare

Images can be found inside the .iwd files. The rest of the assets can be acquired by installing modtools.

  .
  ├── images/
  ├── materials/
  ├── xanim/
  ├── xmodel/
  ├── xmodelalias/
  ├── xmodelparts/
  └── xmodelsurfs/

Call of Duty 5 World at War

Images can be found inside the .iwd files. The rest of the assets can be acquired by installing modtools.

  .
  ├── images/
  ├── materials/
  ├── xanim/
  ├── xmodel/
  ├── xmodelalias/
  ├── xmodelparts/
  └── xmodelsurfs/

Call of Duty Black Ops

Images can be found inside the .iwd files. The rest of the assets can be acquired by installing modtools. There are still some missing assets though (mostly materials and images).

  .
  ├── images/
  ├── materials/
  ├── xanim/
  ├── xmodel/
  ├── xmodelalias/
  ├── xmodelparts/
  └── xmodelsurfs/

• Download the latest release
• Launch Blender
• Edit > Preferences > Add-ons > Install
• Browse to the downloaded .zip file
• Enable the addon by ticking the checkbox in front of its name

Usage

• Launch Blender
• To see import progress, information and errors
  • Window > Toggle System Console
• To import a map
  • File > Import > CoD Asset Importer > Import map
  • Browse to the map inside the maps folder
• To import a model
  • File > Import > CoD Asset Importer > Import model
  • Select the version of the model
  • Browse to the model inside the xmodel folder

Installation from source

Requirements

• Git
• Python
• Rust

Installation

• Clone the repository

$ git clone [email protected]:mauserzjeh/cod-asset-importer.git

• Install dependencies

$ pip install -r requirements.txt

• Run the build script which will create a .zip file in the release folder. Alternatively the Build & Package task can be run from Visual Studio Code

$ python setup.py build_rust --inplace --release --create-release-package

• Launch Blender
• Edit > Preferences > Add-ons > Install
• Browse to the generated .zip file in the release folder
• Enable the addon by ticking the checkbox in front of its name