warkingous/cod-asset-importer

Blender addon for importing Call of Duty assets and maps

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

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

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/

• 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 > Call of Duty map
  • Browse to the map inside the maps folder
• To import a model
  • File > Import > Call of Duty xmodel
  • Browse to the xmodel inside the xmodel folder

Installation from source

Requirements

• Git
• Python 3.8 <=
• Go 1.18 <=

Installation

• Open Git Bash in the folder where you would like to clone the repository
• Clone the repository

$ git clone --recurse-submodules git@github.com:mauserzjeh/cod-asset-importer.git

• Go to the release folder

$ cd cod-asset-importer/release

• Run the release script which will compile iwi2dds.exe and pack all the necessary files into a .zip

$ ./release.sh

• 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