File list

File LinkDescription
Blender 3D SoftwareThe Blender application that we will be using to create our assets.

Setting up Blender

Installing the Blender addon

See the above link for setting up the Blender addon for exporting Halo assets if you haven't installed the addon already. Beyond that there may be a few other settings you may want to adjust with before starting with any modeling.

Undo count

Consider increasing the number of edits you can undo in Blender by changing the setting in preferences. Be aware that increasing this setting will use up more of your system RAM, so keep the value reasonable.

Undo steps setting of 128.


There will probably be certain Blender functions you will be using repeatedly so it's probably a good idea to setup some quick hotkeys for important functions. You could do this later if you're not sure what you need now.

Unit measurement

All units given in this guide are given with the expectation that your Blender instance is set to use metric units. If you haven't changed this then it's likely already set to metric by default. All units will also be given with the expectation that you are using global transforms.

Use the default settings or I'm coming for those kneecaps.

Scene options

An option added by the exporter to keep settings you don't need to care about hidden. Be sure to set game version to Halo CE as seen below:

This should help you stay focused on what matters to you.


Since we are modeling lets be sure to pick the correct workspace for our work. Choose the Modeling workspace found in the top left by default. You don't need to see things like the timeline if you're just making a level so this should help simplify the experience.

The Modeling tab is at the top of the editor window.

Clip start and end

The scale at which Halo levels are modeled is quite large. For instances, outdoor spaces like Bloodgulch are upwards of 1000 Blender units (JMS) across. By default, Blender scenes have a viewport clipping range of 0.01 m to 1000 m. This means that parts of your model may be cut off when zooming out to large scales. Blender's clipping distances can be adjusted in the View settings pane (press N and select the View tab).

A x100 range of 1 m to 100 000 m works well for large outdoor maps:

Clipping distances are set in the view settings pane.

Do not try to avoid configuring clip distances by using world units export scale in the Halo Asset Blender Development Toolset. The multiplication of vertex coordinates during export can amplify floating point imprecisions and cause "nearly coplanar face" warnings from [Tool] and potentially phantom BSP which cannot be resolved despite attempts to flatten surfaces in Blender.

Key configuration

All hotkeys given in this guide are given with the expectation that you are using the default Blender 2.8 preset.

Ready to start modeling a level? Continue to the next guide.


Thanks to the following individuals for their research or contributions to this topic:

  • General_101 (Writing this guide)