trace kit

25 tools. Generated from the plugin source; do not edit by hand.

Guide

Use trace.line_multi_by_* to inspect every blocking hit along a path. Use trace.sphere_multi_by_* to validate clearance for an actor-sized radius. Channel queries take a channel name, object queries take objects, and profile queries take a collision profile name. All six require a live editor or PIE world and should use project fixtures.

trace.box_multi_by_* takes halfExtent and rotation; trace.capsule_multi_by_* takes radius, halfHeight, and rotation. Both return every public UWorld sweep hit.

Use trace.overlap_sphere_by_* or trace.overlap_box_by_* for stationary occupancy checks. They return actor/component pairs and deduplicate those pairs by default.

Capsule overlaps add radius, halfHeight, and rotation. Component queries use the selected primitive component's actual collision shape for overlap or multi-sweep checks.

No collision in the level yet? trace.spawn_test_target {name, location, scale, collisionProfile} spawns a labelled 100 cm engine cube (StaticMeshComponent0) with the given profile (default BlockAll) in the editor level, a known target for every query above and for the component tools. Channel names accept Visibility, Camera, WorldStatic, ... or ECC_*; profiles are names such as BlockAll.

Tools

Legend. risk 0 = read-only, 1 = harmless editor op, 2 = modifies asset, 3 = deletes/replaces asset, 4 = project/config/build op, 5 = potentially destructive (calls above MaxAutoRisk need "_confirm": true). mutates = runs in a transaction (edit.undo reverts). requires PIE / requires world = refused without a PIE session / an open level. requires plugin = unavailable while the plugin is disabled. dryRun = honours the dryRun argument. smoke = covered by edit.self_test.

trace.box_multi_by_channel (risk 0, requires world, smoke)

No description.

Argument	Type	Description
halfExtent	{x,y,z}	Box half extent cm.
halfHeight	number	Capsule half height cm. Default 100.0.
rotation	{x,y,z}	Shape rotation pitch/yaw/roll.

trace.box_multi_by_object (risk 0, requires world, smoke)

No description.

Argument	Type	Description
halfExtent	{x,y,z}	Box half extent cm.
halfHeight	number	Capsule half height cm. Default 100.0.
rotation	{x,y,z}	Shape rotation pitch/yaw/roll.

trace.box_multi_by_profile (risk 0, requires world, smoke)

No description.

Argument	Type	Description
halfExtent	{x,y,z}	Box half extent cm.
halfHeight	number	Capsule half height cm. Default 100.0.
rotation	{x,y,z}	Shape rotation pitch/yaw/roll.

trace.capsule_multi_by_channel (risk 0, requires world, smoke)

No description.

Argument	Type	Description
halfExtent	{x,y,z}	Box half extent cm.
halfHeight	number	Capsule half height cm. Default 100.0.
rotation	{x,y,z}	Shape rotation pitch/yaw/roll.

trace.capsule_multi_by_object (risk 0, requires world, smoke)

No description.

Argument	Type	Description
halfExtent	{x,y,z}	Box half extent cm.
halfHeight	number	Capsule half height cm. Default 100.0.
rotation	{x,y,z}	Shape rotation pitch/yaw/roll.

trace.capsule_multi_by_profile (risk 0, requires world, smoke)

No description.

Argument	Type	Description
halfExtent	{x,y,z}	Box half extent cm.
halfHeight	number	Capsule half height cm. Default 100.0.
rotation	{x,y,z}	Shape rotation pitch/yaw/roll.

trace.component_line_trace_multi (risk 0, requires world, smoke)

No description.

Argument	Type	Description
actor	string	required. Actor label/name/path.
component	string	required. Primitive component name.

trace.component_overlap_multi (risk 0, requires world, smoke)

No description.

Argument	Type	Description
actor	string	required. Actor label/name/path.
component	string	required. Primitive component name.

trace.component_sweep_multi (risk 0, requires world, smoke)

No description.

Argument	Type	Description
actor	string	required. Actor label/name/path.
component	string	required. Primitive component name.

trace.line_multi_by_channel (risk 0, requires world, smoke)

No description.

Argument	Type	Description
start	{x,y,z}	required. Query start cm.
end	{x,y,z}	required. Query end cm.
query	string	required. Collision channel/object/profile selector.
objects	array of string	Object channel names for object queries.
radius	number	Sphere radius cm; ignored by line tools. Default 50.0.
ignoreActors	array of string	Actor labels/names to ignore.

trace.line_multi_by_object (risk 0, requires world, smoke)

No description.

Argument	Type	Description
start	{x,y,z}	required. Query start cm.
end	{x,y,z}	required. Query end cm.
query	string	required. Collision channel/object/profile selector.
objects	array of string	Object channel names for object queries.
radius	number	Sphere radius cm; ignored by line tools. Default 50.0.
ignoreActors	array of string	Actor labels/names to ignore.

trace.line_multi_by_profile (risk 0, requires world, smoke)

No description.

Argument	Type	Description
start	{x,y,z}	required. Query start cm.
end	{x,y,z}	required. Query end cm.
query	string	required. Collision channel/object/profile selector.
objects	array of string	Object channel names for object queries.
radius	number	Sphere radius cm; ignored by line tools. Default 50.0.
ignoreActors	array of string	Actor labels/names to ignore.

trace.overlap_box_by_channel (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_box_by_object (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_box_by_profile (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_capsule_by_channel (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_capsule_by_object (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_capsule_by_profile (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_sphere_by_channel (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_sphere_by_object (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.overlap_sphere_by_profile (risk 0, requires world, smoke)

No description.

Argument	Type	Description
center	{x,y,z}	required. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicate	boolean	Deduplicate identical actor/component pairs. Default true.

trace.spawn_test_target (risk 2, mutates, requires world, smoke)

Spawns a labelled engine cube (/Engine/BasicShapes/Cube, 100 cm) with a collision profile as a known target for queries; returns its actor and component names.

Argument	Type	Description
name	string	required. Actor label.
location	{x,y,z}	World location in centimetres.
scale	number	Uniform scale of the 100 cm engine cube. Default 1.0.
collisionProfile	string	Collision profile name, e.g. BlockAll, BlockAllDynamic, OverlapAll. Default TEXT("BlockAll").

trace.sphere_multi_by_channel (risk 0, requires world, smoke)

No description.

Argument	Type	Description
start	{x,y,z}	required. Query start cm.
end	{x,y,z}	required. Query end cm.
query	string	required. Collision channel/object/profile selector.
objects	array of string	Object channel names for object queries.
radius	number	Sphere radius cm; ignored by line tools. Default 50.0.
ignoreActors	array of string	Actor labels/names to ignore.

trace.sphere_multi_by_object (risk 0, requires world, smoke)

No description.

Argument	Type	Description
start	{x,y,z}	required. Query start cm.
end	{x,y,z}	required. Query end cm.
query	string	required. Collision channel/object/profile selector.
objects	array of string	Object channel names for object queries.
radius	number	Sphere radius cm; ignored by line tools. Default 50.0.
ignoreActors	array of string	Actor labels/names to ignore.

trace.sphere_multi_by_profile (risk 0, requires world, smoke)

No description.

Argument	Type	Description
start	{x,y,z}	required. Query start cm.
end	{x,y,z}	required. Query end cm.
query	string	required. Collision channel/object/profile selector.
objects	array of string	Object channel names for object queries.
radius	number	Sphere radius cm; ignored by line tools. Default 50.0.
ignoreActors	array of string	Actor labels/names to ignore.