Page MenuHome

m3addon: Exporter and importer for the m3 file format (m3 is the model format of Starcraft 2)
Closed, ArchivedPublic


Blender: 2.69
Category: Import Export
Python: 3.2

The addon allows to import and export m3 model files. M3 is the file format used by Starcraft 2.

The m3 file format does not only contain mesh and materail data, but also meta data like, Lights, Particle Systems, Projections, Forces, Rigid Bodies and many more. Since for example materials do not match Blender materials perfectly, the addon used a lot of custom collections to represent them, which can be edited via new panels in the Scene Properties Tab.

In order to simplify the editing of the meta data which has something like an "impact area", the addon uses bones with custom shapes in order to outline for example the spawn area of m3 particle systems.

Files of the m3addon:
- Defines all the UI and custom properties
- Blender independent library for loading and saving m3 files.
- structure.xml: An XML file which describes the m3 file format. Used by
- Provides a method for importing m3 files into Blender
- Provides a method for expriting m3 friles from Blender
- Place for code shared by, and
- Contains logic for calculating the tangents.
- Description of the m3addon with a feature list

Utility scripts contained in the m3addon:
- Script to convert m3 to xml.
- Script to convert xml files (in the format of to the m3 file format
- Merges the animations of one m3/m3a file into another m3 file.
- Makes a m3a (contains animations for m3 files) compatible with an m3 file based on bone names.
- Lists the calcualted offsets of an m3 data structure defined in structures.xml



Event Timeline

Florian Köberle (florian) attached 1 file(s): Unknown Object (File).

Uploaded the current version to this tracker.

The major improvements compared to the previous version are:
* Import and export of m3 lights, forces, rigid bodies and model boundings
* Rough shape visualization of lights, physic systems, hit tests, rigid bodies and forces
* Import and export of animations that animate only a part of the model while another animation runs.

Florian Köberle (florian) attached 1 file(s): Unknown Object (File).Nov 2 2012, 3:07 PM

I would like to upload a version which is compatible with 2.69 and has a ton of new features and bug fixes but I can't find a upload button.

Also the description is outdated. The newest version of the m3addon no longer generate the file. Instead the new file parses the structure.xml file in order to figure out how to import and export m3 files.

As mentioned on IRC, you can just change the "Action" drop down box here to "Upload File" to attach another file to the report.

As for editing the tasks, I don't know why you are not allowed to edit your own descriptions, but @Brecht Van Lommel (brecht) or @Sergey Sharybin (sergey) may know?

Uploaded the current version of the m3addon which is compatible with Blender 2.69.

We should automatically allow authors to edit their descriptions but we need to do some coding for that, for now I've given you some extra permissions so you can edit the description.

Also, upload can be done using drag & drop into the text field (there's a little upload button in the header that tells you this but it's not so obvious).

Thanks for the permissions brecht, I updated the description.

Brendon Murphy (meta-androcto) closed this task as Archived.

Archiving, op over 3 years old, no activity 2 years.
@Florian Köberle (florian), I noticed your git page does well, better to keep distributing & maintaining in your page.
Thanks for submission.