Wing Blender is an import/export script for Blender 2.65+ that allows you to export a VISION engine (Wing Commander: Prophecy, Wing Commander: Secret Ops) IFF 3D model, or import a VISION engine IFF 3D model into Blender.
This means you'll be able to do most of your work in Blender, and then simply export it to the game without having to pass the model through multiple conversion programs (3D Exploration,
This project is the successor to OBJ2WCP, a crappy old OBJ converter written noobishly in Java.
- Allows you to do most of the work on the model in Blender and then export it without the need to use external utilities to set the collision sphere, radius, or hardpoints.
- If a texture's filename is numeric, you will be able to convert it straight to a MAT file without renaming it. For example, if you have a texture named
424242.jpg, your model will reference
- Converts Blender "empty" objects to hardpoints and other VISION engine mesh metadata.
- Collision sphere position and radius is automatically calculated, but can be manually overridden.
- Child objects can now be exported along with the main object.
- LOD mesh support
- Download a release from the "releases" page.
- Create a custom folder on your hard drive for Blender scripts.
- Create an
addonsfolder within the folder you created in step 2.
- Create an
io_scene_wcpfolder within the
- Unzip, extract, or copy all of the
.pyfiles into the
io_scene_wcpfolder you created in the previous step.
- If you haven't set up a custom path for Blender scripts already, open Blender, go to File -> User Preferences, click on the File tab, and set the "Scripts" folder to the folder you created in step 2. Then, save your settings and quit Blender.
- In Blender, go to File -> User Preferences, click on the Addons tab, and select the Import-Export category.
- You should see "Import-Export: WCP/SO Mesh File" if you scroll down.
- Check off the checkbox at the far right to enable the exporter script.
- Save your settings if you want to permanently enable the exporter script.
For more information, see this guide on the Blender wiki.
IFF Import Tutorial
Obtain a VISION engine IFF 3D model from somewhere. You can extract an IFF 3D model from the game (or your favourite WC:SO mod, such as Standoff or Unknown Enemy) using HCl's treman. (You'll need to run it in DOSBox on modern systems, however.)
Extract the textures for this model. If you are using MAT files, place them in the
matfolder, and the 3D model in the
If you are using PNG, BMP, GIF, or another high-quality image format, place the images in the same folder as the 3D model, and give them the same name as the 3D model, except with numbers after them. For example, if the 3D model is named
GRIKATH.IFF, and you want to use high-quality images as textures, name the images
Run the importer script to import the mesh into Blender.
IFF Export Tutorial
The first LOD of main mesh, by default, should be named
detail-0, unless you are using the active object as the first LOD of the main mesh.
The converter will, by default, use an object in the scene named
detail-0as the LOD 0 mesh. You can make the converter use the active object as the LOD 0 mesh. If you turn this option off, or if the active object is not a mesh, the converter will try to use the object in the scene named
detail-0as the LOD 0 mesh if it exists. Otherwise, nothing is exported.
a. If you are using materials, you must assign a material to each face on the model, and you must have at least one UV-mapped image texture in one of the material's texture slots.
b. If you are using face textures, you must assign a texture to each face on the model.
If the image referenced by an image texture has a numeric filename (ex. 245292.png), the exporter script will force the faces to use the image's number as the texture number.
In the text file accompanying the mesh file, you will see the texture filenames of the materials that your model uses and their associated texture numbers. Use this as a guide to convert the textures for WCSO.
Duhiky.png --> 00022000.mat Basicmetal.tga --> 00022001.mat 424242.jpg --> 00424242.mat
This indicates that
Duhiky.pngshould be converted to
Basicmetal.tgashould be converted to
424242.jpgshould be converted to
Hardpoints must be empties named
xxxxis the name of the hardpoint. For example.
hp-gun1will be exported as a hardpoint named
gun1. The rotation matrix of the hardpoint is calculated automatically.
Hidden hardpoint empties (hardpoint empties that are not visible in Blender's viewport) will not be exported.
Optionally, you can override the calculated collision sphere and radius by using a spherical empty object named
Go to where you exported the .IFF file. There should be a text file in that folder that has the same name as your IFF file, but with a different extension.
Read the text file mentioned in step 5 to see which images should be converted, and what they should be named.
Convert the textures to WCP/SO .mat format, and place them in the
matfolder under your WC Secret Ops root directory.
To use the mesh, you will need to reference the mesh file in a ship file.
For modders who want to use this exporter script, example .blend files and accompanying textures are included in the subfolders in the
examples folder of this repository. An exported "game-ready" version of each corresponding example model is located in the folder suffixed with
Getting involved (Testing)
If you want to try out the latest version of this thing yourself:
- Follow the installation instructions above, but instead of downloading a release, clone this repository to get the latest development version of the code.
- Copy all the .py files to the
addonsfolder under your Blender scripts folder.
To clone the repository:
- Open the Linux terminal/Command prompt/Git Bash/whatever you use.
- Go to a directory outside of your Blender scripts folder.
- Type in
git clone https://github.com/Talon1024/WCPBlenderExporter, and press enter.
This will create a folder named "WCPBlenderExporter" containing the latest versions of the code files.
To update to the latest development version of the code:
- Go to the folder you cloned the repository into using the Linux terminal/Command prompt/Git Bash/whatever you use.
- Type in
git pull origin master, and press enter.
Note that the latest version may not be usable.
Getting involved (Development)
If you want to contribute to this project, get the latest development version of the code, and check out the issues page, or the TODO Document. Feel free to fork this repo and do pull requests.
Projects using Wing Blender
WCPSO Model Upgrade Pack
WC CIC Forums member DefianceIndustries is using Wing Blender to create the new models for his WCPSO Model Upgrade Pack.