README.md

Blender-CoD

Blender Add-On for Call of Duty® modding

Import / export addon for Call of Duty's intermediate model and animation plaintext file formats - no Maya required.

Download: Several download options are available. Choose one of the following:

• Official releases
• Experimental (active development)
• Checkout with Git

Model, animation and notetrack export to any CoD title:

• XMODEL_EXPORT v5 (vCoD, CoD:UO)
• XMODEL_EXPORT v6 (CoD2-CoD7)
• XANIM_EXPORT v3 (all)
• NT_EXPORT (CoD5, CoD7)

Use in combination with Lemon / Lime or Wraith.

Note: Feature description not up-to-date!

Experimental import is available for XMODEL_EXPORT v6, but lacks materials, UV mapping etc. Armatures may be imported wrong, weights aren't handled yet.

Original export scripts for Blender 2.4x by Flybynyt
Rewritten scripts for Blender 2.5x and above by CoDEmanX
Contributions by SE2Dev

2015-05-05: Migrated project from Google Code Project Hosting to GitHub. Addon releases were downloaded 4232x at that time.

Introduction

Getting new 3D content into Call of Duty games can be expensive, because the official mod tools only include plugins for the commercial 3d modelling software Maya by Autodesk (former Alias). With this addon, you can do it for free!

Blender-CoD is a free, open-source project and provides a plugin for the as well free and open-source 3D modelling software Blender.

It adds support for XMODEL_EXPORT v5/v6 and XANIM_EXPORT v3 formats, which can be compiled to xmodels and xanims using the mod tools. All CoD titles are supported for export (Blender -> Asset Manager -> Call of Duty).

You can basically import any supported 3d model into Blender (e.g. Blender files, Wavefront OBJ, Collada DAE, 3ds Max 3DS and more), edit it and finally export it for CoD using the Blender-CoD Add-On.

Features

Supported CoD-titles (export only):

• CoD1 (vCoD)
• CoD:UO (United Offensive)
• CoD2
• CoD4 (Modern Warfare)
• CoD5 (World at War)
• CoD7 (Black Ops)

XMODEL_EXPORT v5/v6

• Supports mesh export with automatic triangulation
• Armature export (bones)
• Vertex colors (v6 only, optionally: use color as alpha)
• Mesh modifiers except Armature (optional)
• Armature animation (poses) to xmodel sequences ("Pose animation")
• Adjustable minimum bone weight (optional)
• Vertex clean-up (optional)
• User Interface: File > Export > CoD Xmodel (.XMODEL_EXPORT)

XANIM_EXPORT v3

• Supports armature animation export
• Frame range and framerate can be specified
• Notetrack export for all CoD titles (minds frame range settings)
• User Interface: File > Export > CoD Xanim (.XANIM_EXPORT)

Requirements

• Blender 2.78 or later - blender.org

Installation

1. Download the archive, but don't unzip it!
   • Release
   • Experimental
2. Start Blender
3. Click menu File > User Preferences...
4. Activate the Addons section
5. Ignore an already installed version, it will be overwritten by default
6. Click Install Add-On... button at the bottom
7. Open the downloaded archive
8. The following entry should be shown: Import-Export: Blender-CoD - Add-On for Call of Duty modding (version)
   If it's not listed, make sure that Testing is selected under "Support Level" in the left sidebar!
   

1. Tick the checkbox on the right to enable it
   
2. Click Save As Default button at the bottom to enable it permanently
   
3. You can use the new menu entries now: File > Export and File > Import

Watch video on YouTube

Releases

Date	Version	Remarks
15-Apr-12	CoD4 Fastfile WAV Scanner	Extraction tool written in Python released (misc)
12-Apr-12	Blender-CoD Addon v0.3.5 (alpha 3)	Added export option: Vertex colors as alpha
01-Apr-12	Blender-CoD Addon v0.3.4 (alpha 3)	Mesh import, Bmesh support (requires Blender 2.62.3+)
16-Feb-12	Blender-CoD Addon v0.3.3 (alpha 3)	Fixed issue #5
25-Jan-12	Blender-CoD Addon v0.3.2 (alpha 3)	Fixed issue #2 and issue #4
29-Nov-11	Blender-CoD Addon v0.3.1 (alpha 3)	Fixed issue #3
22-Nov-11	Blender-CoD Addon v0.3.0 (alpha 3)	vCoD/UO & NT_EXPORT support
09-Oct-11	Blender-CoD Addon v0.2.3 (alpha 2)	Fixed issue #1
29-Sep-11	Blender-CoD Addon v0.2.2 (alpha 2)	CoD2-CoD7 model & anim export
13-Jul-11	Start of project	Code testing and rewriting from scratch for Blender 2.5+

Links

• Official Blender.org tutorial page (many good text and video tutorials)
• BlenderGuru.com tutorials (high quality video tutorials and blog)
• BlenderArtists.org Forum tutorials
• Wikibooks Blender tutorial list (some may be outdated, look for Blender 2.5x tutorials)
• BlenderNation.com tutorials
• Pixel2Life.com Blender tutorials
• Tutorialized.com Blender tutorials

Contact

If you have questions, problems or want to contribute to the project as a coder or tester,

• create an issue or
• send a pull request.