Exporting-a-weapon-for-Xonotic.md

   1 ## WARNING: This tutorial is under construction!
   2
   3 Blender version recommended: 2.79b or later *(if you want to contribute, it's strongly important use 2.79b for compatibility cases, they need to open from this version).*
   4
   5 Requires these following tools (addons) for Blender:
   6 - [IQM exporter](https://gitlab.com/xonotic/iqm) to export IQM files.
   7 - [MD3 importer/exporter](https://github.com/neumond/blender-md3) to import/export MD3 files.
   8
   9 # Introduction to export a weapon
  10 **Keep in mind about weapon systems:**
  11
  12 - `g_*.md3`: model mesh for item pickup spawn and third person.
  13 - `h_*.iqm`: for first person animations; the skeleton and the bones (the rigging and animation part). Keep in mind, you would need `*.iqm.framegroups` (more info: [Framegroups](https://gitlab.com/xonotic/xonotic/-/wikis/framegroups), you can look `*.iqm.framegroups` opening a notepad to see what animations contain and the keyframes where these are set)
  14 - `v_*.md3`: model mesh for first person and a glue of `h_*`; if `h_*.iqm` doesn't match with the animations needed of `v_*.md3`, it will generate spamming errors and bad pivot position.
  15
  16 More info: [Weapon modeling system](Weaponsystem)
  17
  18
  19 # Textures and UV map
  20
  21 Keep in mind, when you've done your UV map in your model, you need to set this:
  22 <br />
  23 <br />
  24 <img src="uploads/efee46a2a80a232ebe5fa63e30f4e2d9/Md3exp.png" alt="Md3exp" width="300" />
  25 <br />
  26 Texture must:
  27
  28 - be of **Image** type
  29 - mapping type **UV**
  30 - have UV map assigned
  31
  32 otherwise resulting data block will be filled with zeroes.
  33 <br />
  34 <br />
  35 <img src="uploads/c48fb7565453eab24faca2d6ffec4347/Md3_textures.png" alt="Md3_textures" width="360" />
  36 <br />
  37 <br />
  38 If you didn't this, the model will be invisible and it won't be able to interact shaders.
  39 <br />
  40 <br />
  41 [Blender reference about UV in MD3](https://archive.blender.org/wiki/index.php/Extensions:2.6/Py/Scripts/Import-Export/MD3/)
  42
  43 # Starting to export
  44
  45 Before to export, you need to select all objects in the scene.