SabreCSG Settings


SabreCSG Settings UI

SabreCSG Main Toolbar

Create and Rebuild

To create a new brush, click the Create button on the left side of the SabreCSG main toolbar. This will open a prompt for a cube, sphere, cylinder, or prism brush. Selecting any of these options will create a new brush at the last position under CSGModel in the Hierarchy. In most cases, you will probably want a cube or prism. You can also create a new brush by using the duplicate keyboard shortcut (Ctrl+D, or Cmd+D on OSX) one a selected brush; as with creating a brush from the SabreCSG main toolbar, duplicating a brush will place it at the last position under CSGModel.

The Rebuild button, which is next to the Create button, is what converts the CSG brushes into the level geometry. You can also rebuild from the SabreCSG button on the Unity Toolbar, (or press Ctrl+Shift+R on PC, Cmd+Shift+R on OSX). The exact effect of a rebuild will depend on the build settings, which you can access by inspecting the properties of CSGModel in the Hierarchy.


At the right side of the first row of the Sabre settings toolbar, there is a button marked “Grid SabreCSG” and  clicking it will prompt you with options for “Unity” and “none” as alternatives to SabreCSG’s grid. This selection determines what type of grid to draw in Unity. By default in a scene using SabreCSG, Unity will use Sabre’s grid system while SabreCSG’s interface is active. The advantage of SabreCSG’s grid is that the scale is updated to match position snapping. Selecting “none” will hide the grid. Regardless of the grid type you use, brushes will still snap unless you disable that feature separately by toggling positional snapping.

Position Snapping and Scale

In the second row of the SabreCSG main toolbar, there are toggles for “Pos Snapping” and “Ang Snapping” which toggle position snapping and angular snapping respectively. The fields beside these toggles indicate the unit by which Sabre will snap. The “” and “+” buttons next to the field will halve or double the value in the field. By using the keyboard shortcuts “,” and “.” you can quickly halve or double the current grid scale. You can also use the keyboard shortcut “/” to toggle position snapping altogether.

Brush and Mesh Visibility

The SabreCSG main toolbar also has buttons for Brushes Hidden and Meshes Hidden which, when active, hide brushes and meshes respectively. Both of these buttons are red when active. Usually it is best to leave brushes and meshes visible, but in larger or more complicated levels, these options may make work easier. For example, if you are attempting to select a large group of brushes, it may help to temporarily hide the built level geometry so you don’t accidentally select it instead.

Disable SabreCSG UI

The Disable button at the right side of the SabreCSG main toolbar lets you hide all of the SabreCSG UI. Once you have built and textured a level’s final geometry, you may want to disable SabreCSG’s while you focus on meshes, lighting, or other details. Note that you can also select a non-CSG object in the hierarchy to automatically disable the SabreCSG UI. Selecting a CSG object will automatically re-enable SabreCSG’s interface.

Next page: Keyboard Shortcuts