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.
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.
Supported CoD-titles (export only):
- CoD1 (vCoD)
- CoD:UO (United Offensive)
- CoD2
- CoD4 (Modern Warfare)
- CoD5 (World at War)
- CoD7 (Black Ops)
- 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)
- 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)
- Blender 2.78 or later - blender.org
- Download the archive, but don't unzip it!
- Start Blender
- Click menu
File > User Preferences... - Activate the
Addonssection - Ignore an already installed version, it will be overwritten by default
- Click
Install Add-On...button at the bottom - Open the downloaded archive
- 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!
- Tick the checkbox on the right to enable it
- Click
Save As Defaultbutton at the bottom to enable it permanently
- You can use the new menu entries now:
File > ExportandFile > Import
| 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+ |
- 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
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.