Exporting - Smashing-Tech/Smash-Hit-Blender-Tools GitHub Wiki
Once you have created a stage and saved it as a Blender file, you need to export it as a Smash Hit segment to play it.
Go to File → Export and then either:
- →
Segment (.xml.mp3) - →
Compressed Segment (.xml.gz.mp3).
Compressed segments will take less space in the APK, but they will be harder to edit by hand later.
There are a few export options exposed through the export dialogue that you can tweak to your preference.
This is 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.
Blender Tools will automatically fill the templates feild under one of the following conditions:
- You have a Smash Hit APK with a templates.xml open in APK Editor Studio.
- You have the file
templates.xmlin theSmash Hit Blender Toolsinside your user folder. - You have the file
smash-hit-templates.xmlin your user folder.
Since this option is not available during Quick Test export, you must either open an APK with the templates you want or create a templates.xml file in (user folder)/Smash Hit Blender Tools/templates.xml.
See also: Quick Test
By going to File → Export → Smash Hit Quick Test Server, you can export the files to a server for testing with a special mod of Smash Hit.
Show older options
Some options have been moved to the Properties panel in versions 2.0.3 and newer. Tile options have been removed because they were complex and probably not worth using most of the time.
- 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
.meshfile 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
stoneobstacle 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.
-
Mesh: This will use Blender Tools Mesh Bake to create a
-
Tile count: The number of columns and rows for tiles in the
tiles.png.mtx.mp3file. 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.
- If you are using the latest release version, export options will not be saved when you close Blender. This will change in 2.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.