Skip to main content

smartbuild.shape

Overview

  • Spawn primitive shapes (cube/sphere/cylinder/cone/plane) at world coordinates and control their transform/color/lifetime via a handle. Uses /Engine/BasicShapes meshes and a per-instance MID on BasicShapeMaterial. Spawned shapes are no-collision, no-physics — pure debug markers that do not interfere with character movement. Tracked entries auto-purge when the level changes (WeakObjectPtr-based). action=spawn shape= x=.. y=.. z=.. [rx ry rz] [sx sy sz] [r g b] [label]: spawn at world coords (cm). Returns handle. sx-only sets uniform scale. action=spawn_at_screen shape= [x y]: spawn at the surface under a screen pixel via line trace (Visibility channel). x/y default to current mouse position. action=list (default): list all tracked shapes with their world transform. action=set_transform handle= [x y z] [rx ry rz] [sx sy sz]: overwrite only the specified axes; other axes are kept. action=set_color handle= r=.. g=.. b=..: change the MID Color (0~1 linear). action=destroy handle= | all=1: remove one or every spawned shape.

Metadata

FieldValue
DisplaySpawn Debug Primitive
Categorysmartbuild
AccessScriptCheat
ScopeB1Standalone
TagsExperimental
Aliases

Parameters

NameTypeRequiredDefaultDescription
actionstringnolistlist (default), spawn, spawn_at_screen, set_transform, set_color, destroy
shapestringnocube|sphere|cylinder|cone|plane
handleintnoSpawned shape handle (for set_transform/set_color/destroy)
xfloatnoWorld X (cm) for spawn / Pitch override for set_transform / screen X pixel for spawn_at_screen
yfloatnoWorld Y (cm) for spawn / screen Y pixel for spawn_at_screen
zfloatnoWorld Z (cm)
rxfloatnoPitch (degrees)
ryfloatnoYaw (degrees)
rzfloatnoRoll (degrees)
sxfloatnoScale X (uniform when sy/sz omitted)
syfloatnoScale Y
szfloatnoScale Z
rfloatnoColor R (0~1 linear)
gfloatnoColor G (0~1 linear)
bfloatnoColor B (0~1 linear)
labelstringnoOptional user label echoed back in list output
allboolnodestroy: remove every tracked shape

Returns

  • Return shape is not declared for this command.

Usage

await inzoi.cli.execute('smartbuild.shape', {
action: 'list', // optional
shape: '', // optional
handle: 0, // optional
x: 0.0, // optional
y: 0.0, // optional
z: 0.0, // optional
rx: 0.0, // optional
ry: 0.0, // optional
rz: 0.0, // optional
sx: 0.0, // optional
sy: 0.0, // optional
sz: 0.0, // optional
r: 0.0, // optional
g: 0.0, // optional
b: 0.0, // optional
label: '', // optional
all: false, // optional
});