Source 2 uses inches as the basic unit, so it is recommended to scale the model so that 1 blender unit = 1 inch. This is especially important when working with animations, since we can't export animations in a scaled format from Blender.

To work with metric units, set the scale to Inches in the Scene panel, and set the Length scale to metric.



The Source 2 Tools do not handle embedded textures. We need to reference what materials are used by the mesh, and this is done by assigning Blender materials with the same names as the material files we will create.



Now, to export the mesh, select it, and the armature if you plan on adding animations. Then open the export dialog from File -> Export -> FBX (.fbx)

Note: As a an alternative, it is possible to export directly to the native DMX format. See the Adding animations section below



Make sure Selected Objects is checked to only export the needed objects.

To keep the inch based scaling on the mesh, uncheck the button next to the scale setting. The Source 2 Tools do not support reading the scale setting in FBX files, and assume everything is in inches.

To simplify updating the mesh, export it directly to the content directory of your addon, for example \Destinations\content\steamtours_addons\<addon_name>\models\my_models



If you have made changes to the mesh in Blender, simply re-export it, and the model will be automatically updated with the new mesh.

Launch the model editor and select New VMDL from mesh file, and select the exported .fbx file. The editor should present you with a small dialog asking to confirm the name. Do this, or choose a different one.





Now the Model Editor should launch, showing the mesh in a red wireframe. Confim that the model scale is correct.




Next we will apply the materials to the model.

Export any neccessary textures, preferably in .png or .tga format. Place them under the materials directory of the addon content directory, for example: \Destinations\content\steamtours_addons\<addon_name>\materials\models\my_models



Launch the Material editor and create new materials using the textures. Save the materials in the same directory, and give them the same material names as chosen eariler in Blender.



In the Model Editor, select the mesh and add the path where the material files are to the Material Search Path in the right panel. The paths in the virtual file system are based on the root of the addon folder, so only include the relative path under it starting from the materials folder, for example: materials/models/my_models

Note: The Material Search Path does not work correctly if it starts with a slash (/).



Now the materials should display correctly on the mesh.

The Source 2 Tools include an advanced collision mesh generator, but if you want more control it is possible to import collision meshes manually as well. Note that this guide does not show how to use the advanced generator.

It is possible to use a custom collison mesh, or using the reference mesh as the collison mesh. Apart from very simple models, the reference mesh is too complex to be used directly, and will cause glithces. To get around this, the Model editor has a Convexify option that will generate a simple shrinkwrapped mesh based on the loaded mesh, altthough this may not always produce desirable results. The better option is usually to make a custom collison mesh in Blender. The mesh should be comprised of one or more separate convex closed hulls.

Export the collision mesh as an FBX or DMX the same way as the reference mesh eariler. Remember to include the armature for animated models. Like the reference mesh, the collison mesh will update automatically when re-exported.



To add a collison mesh use the menu command: Model -> Collision -> Add Simple Physics



The physics mesh can be viewed from the Display menu.



Select the collision mesh from the left panel and apply the Convexify option on the right panel if needed.

The Source 2 Tools can not import animations from Blender-exported FBX files. Fortunately the third party Blender Source Tools allow you to export to the native DMX format the tools use.

Install the Blender Source Tools, and find its panels in the Scene tab. Set the export path to the same model directory as ealier, and select DMX version Binary 9, Model 22.

Select the action to export, and give the subdirectory an appropriate name. Then click Export, and the animation file.



To add an animation in the Model editor, select Animation -> Add animation from the menu. The animation will update automatically if the DMX file is re-exported, but the Start and End frmae numbers do not, so they will need to be updated manually from the right panel.