Exporting

Once you have created a stage and saved it as a Blender file, you need to export it as a Smash Hit stage XML file.

Opening the Export Dialogue

Go to File -> Export and then chose either Segment (.xml.mp3) or Compressed Segment (.xml.gz.mp3). Compressed segments will take less space in the APK, but they will be harder to edit by hand later.

Tweaking Export Options

There are many export options exposed through the export dialogue that you can tweak to your preference. The defaults try to produce a segment that looks as much like Smash Hit's exporter as possible, but this does not always work. Many of the options are only used in Mesh box baking mode.

• Segment strech: This will attempt to stretch the segment length without also streching any of the smaller boxes. This is meant for supporting Smash Hit VR without putting in additional effort to redesign the stages to be comfortable there; however, it can be useful for making stages easier or harder in general, too.
• Box bake mode: This controls how boxes will be made visible in the segment since Smash Hit does pre-computation of geometry that needs to be replicated or worked around.
  • Mesh: This will use Blender Tools Mesh Bake to create a .mesh file alongside the segment XML. As of Smash Hit Blender Tools 1.99.17, this looks almost like Smash Hit during normal gameplay, with some differences.
  • Stone hack: This will use a custom stone obstacle to create the visible boxes. The boxes will not be able to have tiles and only colour can be replicated. A stone obstacle must be present in the Smash Hit APK.^{[Note 1]}
  • None: Does not try to make boxes visible. This is useful when you just want to export the segment and .
• Template: The full path to the templates.xml.mp3 file in your Smash Hit APK, required to properly bake mesh files when the segment uses templates. If you aren't using templates with boxes or are using the stone hack, then this can be left blank. If you are using APK Editor Studio on Windows or Linux, this feild will automatically fill with the path to the templates.xml.mp3 file in the Smash Hit APK that you currently have open in APK Editor Studio.
• Tile count: The number of columns and rows for tiles in the tiles.png.mtx.mp3 file. This can be used to add extra tiles to Smash Hit without removing any existing tiles.
• Tile crop: The amount that each tile will be cropped on the left/right and top/bottom to avoid blending with other textures. This is kept for older segments and shouldn't be changed unless you know what you are doing.
• Bake unseen faces: Bakes unseen triangles into the mesh file. This causes the mesh file to be larger, but is useful when making segments for display on the main menu where culling prevents some faces from being seen.
• Per-vertex lighting: This will enable the fast implementation of per-vertex lighting. This will look somewhat different from an official segment (due to using a different method to find light at a point) and is subject to change to make it look closer; however, it should be alright to use.

Tips

• If you are using the latest release version, export options will not be saved when you close Blender. This will change in 2.1.

Notes

1. This setting is retained for segments that used older versions of Blender Tools which either did not have mesh baking (pre-0.107.x) or did not have accurate mesh baking (pre-1.99.x) and where the stone hack was available. It might still be wanted in some cases; for example, using this it would be possible to make boxes glass.