Settings

Where SuperPlacer keeps its settings, what is in the SuperPlacer Settings window and in the popups, and how to get the defaults back.

Where settings are stored

All SuperPlacer settings are kept in one file of the project:

<project folder>/Saved/Config/WindowsEditor/SuperPlacer.ini

Every project and every user has their own file: it sits in the Saved folder and usually stays out of version control. Values are saved automatically; there is no Save button.

Hotkeys are kept separately, in the editor's standard shortcut file EditorKeyBindings.ini. See Hotkeys.

The SuperPlacer Settings window

The general SuperPlacer settings are in the SuperPlacer Settings window. It doesn't open by itself — open it in one of these ways:

• from the editor's main menu: SuperPlacer → Settings;
• with the SuperPlacer Settings button in the mode panel (the SuperPlacer tab of the editor's Modes panel — there is nothing else in it).

The first time, the window opens as a tab next to the Details panel. You can drag it anywhere in the layout or pull it out into a separate window: the editor remembers the place and opens the window there next time. If you leave the tab open, it opens together with the editor. While the window is on screen, the editor spends time drawing it, so close the tab or switch to a neighbouring one when you don't need the settings.

If SuperPlacer is turned off, the window shows a single SP button: it turns SuperPlacer on, and the settings appear.

Groups and defaults:

Editor Modes Coexistence — which editor modes SuperPlacer works on top of:

Settings — the size and position of the buttons in the viewport. Changes show right away.

The Stripe UI and the Column UI never leave the viewport: an offset that is too large is clamped.

Coordinates

Touch&Type — how the number input window opens:

Aim Targets — what the aims (the teleport cones, Look At, Scale to Target) and the drop to the floor hit:

A hidden object is never a target.

Distribute

Settings popups in the Stripe UI

The rest of the settings are in the popups of the Stripe UI and the Column UI. How to open them is described in Interface.

• Snapping (right-click the Snapping group) — the snapping steps for moving, rotating and scaling, the Abs switch (snap to the world grid instead of stepping from where the gesture began), the mouse wheel step and the Target Snapping (vertices / bounds) section: Saved pivots (Ctrl: snap with rotation), Snap radius (px), Dots radius (px). See Snapping, Vertex and Bounds Snapping and Saved pivots as sockets.
• Constraints & RayHit (right-click the Constraints group) — all the settings of the group, each section under its own header: RayHit, N-Pivot — Surface Normal Tilt, Directional Drop, N-Point — Align To Surface Normal and Raycast Targets. Four buttons of the group also have popups of their own, each with just that button's sections. These open only on a right click on the button too:
  • RayHit (the Ray Hit Mode button) — Hit: what the Quick ray hits. It is the same switch as Hit in the Aim Targets group of the SuperPlacer Settings window.
  • N-Pivot (the Surface Normal Tilt button) — Respect Original Virtual Pivot Rotation, the Hit of the drop rays and the Raycast Targets lists.
  • N-Point (the Align Points To Surface Normal button) — the alignment to the normal: Align Power and Axis.
  • Directional Drop — the ray's axis, length and lift (Drop Axis, Ray Length, Ray Lift), Hit, Show Drop Rays and the Raycast Targets lists.
• Quick Controls (right-click the Quick Control Mode button in the Column UI) — the steps of the Quick cycle, its own for Place and Transform (on / off, the order, the stitches), Mouse Wheel Rotation Step (the wheel turn step, the same value as Mouse Wheel Step: in the Snapping popup) and the Reset Yaw Every Cycle and Reset Pitch Every Cycle checkboxes. See Quick Mode.
• DPI Settings (gizmo menu → Gizmo Settings or Visual Guides Settings) — the Gizmo and Guides tabs: gizmo size, axis colours, line thickness, the look of the rotation ring, the visibility of the guide lines. What the guide lines show is described in Guide lines.

A setting shown in several popups of the Constraints group is one and the same setting: change it in one popup, and the other shows the new value right away. For example, Hit in the N-Pivot and Directional Drop popups is shared: it decides what the Directional Drop rays (with N-Point) and the Quick ray with N-Pivot on hit. It is separate from Hit in the RayHit popup. The Raycast Targets lists (Exclude / Include) — the actors these rays skip, or the only actors they hit — are also the same in every popup. See Axis Constraints and Directional Drop.

Resetting to defaults

• One value in the gizmo settings. When a value differs from the default, a reset button appears next to the field.
• Hotkeys. The SuperPlacer Hotkeys tab has a reset for each row and a Reset All to Defaults button.
• Everything at once.
  1. Close the editor.
  2. Delete the Saved/Config/WindowsEditor/SuperPlacer.ini file in the project folder.
  3. Start the editor: all SuperPlacer settings are back to their defaults, and so are the positions of torn-off popups.