Controls and Placement

Placement controls, freecam flow, code generation, and callbacks

Controls

The live controls come from Config.Controls.

If your server bindings differ, trust the config over older screenshots.

Sphere and box zone placement

Step 1: set the center

• arrow keys move on the XY plane relative to camera

• PgUp and PgDn change height

• Shift moves faster

• Enter confirms the center

• X cancels

Step 2: size the zone

• scroll adjusts radius or the active box dimension

• E cycles box width, length, height, and rotation

• arrow keys and PgUp or PgDn still move the center

• Shift speeds up changes

• Enter finishes

• X cancels

Prop and ped placement

• scroll rotates heading

• Ctrl + scroll slows rotation

• Shift + scroll speeds rotation

• Ctrl + Shift + scroll fine-tunes prop height

• arrow keys nudge XY

• PgUp and PgDn change height

• Shift moves faster

• ped placement uses E to cycle face drawable

• Enter confirms

• X cancels

Polygon and point placement

Freecam controls:

• mouse looks around

• W A S D moves

• Q moves down

• E moves up

• Shift speeds up

• Alt slows down

• left click adds a point

• right click removes the last point

• Enter finishes if the minimum point count is met

• ESC cancels

Placement exports

Main placement exports:

• StartZonePlacement(options, callback)

• StartPolyZonePlacement(options, callback)

• StartPointPlacement(options, callback)

• StartPropPlacement(options, callback)

• StartPedPlacement(options, callback)

• IsPlacementActive()

• CancelPlacement()

Common useful options

Zone placement supports things like:

• title

• initialCoords

• initialRadius

• initialSize

• initialRotation

• showUI

• canPlace

• forceBoxZone

• showGridPoints

• gridSize

• maxSlots

Prop and ped placement supports:

• model

• groundOffset

• placeOnGround

• showUI

• canPlace

• coords

• heading

• skipFirstPerson

• hideEntityDuringPlacement

• optional ped appearance

Code generation

After placement, the UI can generate:

• lib.zones.sphere

• lib.zones.box

• lib.zones.poly

• ox_target sphere, box, or poly snippets

• CreateObject snippets

• CreatePed snippets

Box zones can also include gridPoints for slot layouts.

Grid and drawing helpers

Useful helpers include:

• DrawSphere

• DrawCenterMarker

• DrawBoxWireframe

• CalculateGridPoints

• DrawGridPoints

Freecam helpers

Freecam exports include:

• StartFreecam()

• StopFreecam()

• IsFreecamEnabled()

• GetFreecamCamera()

• GetFreecamRot()

• FreecamRaycast()

Smart placement wrappers

The tool also includes convenience wrappers like:

• SimplePlacePropsLoop(options)

• SmartPlaceProp(options)

• SmartPlacePoint(options)

• SmartPlacePoints(options)

• SmartPlacePropsLoop(options)

• SmartPlacePtfx(options)