explain autobuilds
[xonotic/xonotic.wiki.git] / Blender-to-IQM.md
1 Blender to IQM
2 ==============
3
4 Blender when exporting to IQM
5 -----------------------------
6
7 ### Needed/Example files
8
9 * Bounding Box for Stand and Crouch: [bbox_crouch.blend](assets/files/bbox_crouch_stand/bbox_crouch.blend), [bbox_standing.blend](assets/files/bbox_crouch_stand/bbox_standing.blend)
10 * Erebus example blend: [erebus.blend](https://gitlab.com/xonotic/mediasource/raw/master/models/player/erebus.blend)
11 * Erebus example framegroups: [erebus.iqm.framegroups](https://gitlab.com/xonotic/xonotic-data.pk3dir/raw/master/models/player/erebus.iqm.framegroups)
12 * Link to exporter: http://sauerbraten.org/iqm/
13
14 ### Before You Start
15
16 * use the bbox.blend in order to see the size that your model should be. Iqm exporter scale function untested.
17 * use the duck_bbox.blend in order to see the size that your model should be when crouching.
18 * for more information on bbox size refer to div0’s model specs [Player_Model_Spec](Player-Model-Spec)
19 * naming conventions for textures and model go as follow assuming the example is the umbra model: modelname: umbra.iqm, framegroups: umbra.iqm.framegroups, textures: umbra.tga or (jpg), umbra_norm.tga, umbra_gloss.tga, (need to add more)
20
21 ### Exporting
22
23 1. Select both mesh and armature in object mode.
24 2. Go to scripts \> export \> inter-quake-model.
25 3. Now make sure bounding boxes and meshes are both highlighted in the script window.
26 4. Export to a file path of your choosing, /path/to/umbra.iqm. Put the names of all the animations in the animations box, using commas for multiple anims. Then hit the export button and hopefully it will work without any errors.
27 5. Your model will need a .framegroups file to be used in Xonotic, look at the example file at the beginning of this article or check the [Framegroups](Framegroups) section of this wiki.
28
29 ### Notes
30
31 As of 01/06/2012, Xonotic uses these animations:
32
33     dieone,dietwo,draw,duck,duckwalk,duckjump,duckidle,idle,jump,painone,paintwo,shoot,taunt,run,runbackwards,strafeleft,straferight,deadone,deadtwo,forwardright,forwardleft,backright,backleft,melee,duckwalkbackwards,duckstrafeleft,duckstraferight,duckforwardright,duckwalkforwardleft,duckbackwardright,duckbackwardleft