pink-vertex / blender_addon_md5

Blender Addon - import and export *.md5mesh and *.md5anim files
13 stars 5 forks source link
blender-addon python3

==================================================================================== Blender Addon - Import and Export id tech 4_ *.md5mesh and *.md5anim files

Installation:

Download this repository as zip-archive_ and rename it to md5.zip. Go to Blender User Preferences -> Addons and click Install from File... and select the zip-archive in the file browser which pops up.

Afterwards activate the addon under the category Import-Export or User.

Import:

Choose from the Info Menu -> File Import -> *.md5mesh. In the file browser choose the file you want to import.

The *.md5mesh mesh does not store information about the length of bones. You may edit the length of leaf bones before you import an animation.

Then select the armature for which you want to import an animation. Again choose from the Info Menu -> File Import -> *.md5anim and in the file browser which pops up select the file you want to import.

Export:

Put all the bones you want to import on one bone layer. Using the default keymap you can do this by selecting a bone and press M.

If you plan to export all bones and did not change any layer yet, you don't have to do anything.

Select the armature of your model and choose Info Menu -> File Export -> *.md5mesh. The addon will gather and export all meshes which have an armature deform modifier with the selected armature as target applied to them and are on an active scene layer. In the file browser which pops up choose your bone layer. The default layer is 0.

To export an animation select the armature of your model and assign the action you want to export to the armature. Afterwards choose Info Menu -> File Menu -> File Export -> *.md5anim

If you plan to export an animation for an existing md5mesh, import the mesh and its armature and use the latter to create your animation. The addon will store the bone indices in a custom property named name_to_index of the armature.

Adding, or removing bones from the armature is not supported yet, unless you delete the custom property and export the new md5mesh and all of its animations.

Notes:

.. _zip-archive: https://github.com/pink-vertex/blender_addon_md5/archive/Release.zip .. _id tech 4: https://github.com/id-Software/DOOM-3 .. _md5 addon: https://sourceforge.net/p/blenderbitsbobs/wiki/MD5%20exporter/