Saltar al contenido principal

Kit trace

25 herramientas. Generado a partir del código fuente del plugin; no lo edites a mano.

Las descripciones de las herramientas y de los argumentos se muestran en inglés porque reflejan el schema de las herramientas (el mismo texto que el agente recibe en tools/list).

Guía​

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.

Herramientas​

Leyenda. riesgo 0 = solo lectura, 1 = operación inofensiva del editor, 2 = modifica un asset, 3 = elimina/reemplaza un asset, 4 = proyecto/configuración/build, 5 = potencialmente destructivo (las llamadas por encima de MaxAutoRisk requieren "_confirm": true). modifica = se ejecuta en una transacción (edit.undo la revierte). requiere PIE / requiere mundo = se rechaza sin una sesión PIE / sin un nivel abierto. requiere el plugin = no disponible cuando el plugin está desactivado. dryRun = acepta el argumento dryRun. smoke = cubierto por edit.self_test.

trace.box_multi_by_channel (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
halfExtent{x,y,z}Box half extent cm.
halfHeightnumberCapsule half height cm. Valor predeterminado 100.0.
rotation{x,y,z}Shape rotation pitch/yaw/roll.

trace.box_multi_by_object (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
halfExtent{x,y,z}Box half extent cm.
halfHeightnumberCapsule half height cm. Valor predeterminado 100.0.
rotation{x,y,z}Shape rotation pitch/yaw/roll.

trace.box_multi_by_profile (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
halfExtent{x,y,z}Box half extent cm.
halfHeightnumberCapsule half height cm. Valor predeterminado 100.0.
rotation{x,y,z}Shape rotation pitch/yaw/roll.

trace.capsule_multi_by_channel (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
halfExtent{x,y,z}Box half extent cm.
halfHeightnumberCapsule half height cm. Valor predeterminado 100.0.
rotation{x,y,z}Shape rotation pitch/yaw/roll.

trace.capsule_multi_by_object (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
halfExtent{x,y,z}Box half extent cm.
halfHeightnumberCapsule half height cm. Valor predeterminado 100.0.
rotation{x,y,z}Shape rotation pitch/yaw/roll.

trace.capsule_multi_by_profile (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
halfExtent{x,y,z}Box half extent cm.
halfHeightnumberCapsule half height cm. Valor predeterminado 100.0.
rotation{x,y,z}Shape rotation pitch/yaw/roll.

trace.component_line_trace_multi (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label/name/path.
componentstringobligatorio. Primitive component name.

trace.component_overlap_multi (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label/name/path.
componentstringobligatorio. Primitive component name.

trace.component_sweep_multi (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
actorstringobligatorio. Actor label/name/path.
componentstringobligatorio. Primitive component name.

trace.line_multi_by_channel (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
start{x,y,z}obligatorio. Query start cm.
end{x,y,z}obligatorio. Query end cm.
querystringobligatorio. Collision channel/object/profile selector.
objectsarray of stringObject channel names for object queries.
radiusnumberSphere radius cm; ignored by line tools. Valor predeterminado 50.0.
ignoreActorsarray of stringActor labels/names to ignore.

trace.line_multi_by_object (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
start{x,y,z}obligatorio. Query start cm.
end{x,y,z}obligatorio. Query end cm.
querystringobligatorio. Collision channel/object/profile selector.
objectsarray of stringObject channel names for object queries.
radiusnumberSphere radius cm; ignored by line tools. Valor predeterminado 50.0.
ignoreActorsarray of stringActor labels/names to ignore.

trace.line_multi_by_profile (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
start{x,y,z}obligatorio. Query start cm.
end{x,y,z}obligatorio. Query end cm.
querystringobligatorio. Collision channel/object/profile selector.
objectsarray of stringObject channel names for object queries.
radiusnumberSphere radius cm; ignored by line tools. Valor predeterminado 50.0.
ignoreActorsarray of stringActor labels/names to ignore.

trace.overlap_box_by_channel (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_box_by_object (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_box_by_profile (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_capsule_by_channel (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_capsule_by_object (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_capsule_by_profile (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_sphere_by_channel (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_sphere_by_object (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.overlap_sphere_by_profile (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
center{x,y,z}obligatorio. Overlap centre cm; Start is retained for shared schema compatibility.
deduplicatebooleanDeduplicate identical actor/component pairs. Valor predeterminado true.

trace.spawn_test_target (riesgo 2, modifica, requiere mundo, 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.

ArgumentoTipoDescripción
namestringobligatorio. Actor label.
location{x,y,z}World location in centimetres.
scalenumberUniform scale of the 100 cm engine cube. Valor predeterminado 1.0.
collisionProfilestringCollision profile name, e.g. BlockAll, BlockAllDynamic, OverlapAll. Valor predeterminado TEXT("BlockAll").

trace.sphere_multi_by_channel (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
start{x,y,z}obligatorio. Query start cm.
end{x,y,z}obligatorio. Query end cm.
querystringobligatorio. Collision channel/object/profile selector.
objectsarray of stringObject channel names for object queries.
radiusnumberSphere radius cm; ignored by line tools. Valor predeterminado 50.0.
ignoreActorsarray of stringActor labels/names to ignore.

trace.sphere_multi_by_object (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
start{x,y,z}obligatorio. Query start cm.
end{x,y,z}obligatorio. Query end cm.
querystringobligatorio. Collision channel/object/profile selector.
objectsarray of stringObject channel names for object queries.
radiusnumberSphere radius cm; ignored by line tools. Valor predeterminado 50.0.
ignoreActorsarray of stringActor labels/names to ignore.

trace.sphere_multi_by_profile (riesgo 0, requiere mundo, smoke)​

Sin descripción.

ArgumentoTipoDescripción
start{x,y,z}obligatorio. Query start cm.
end{x,y,z}obligatorio. Query end cm.
querystringobligatorio. Collision channel/object/profile selector.
objectsarray of stringObject channel names for object queries.
radiusnumberSphere radius cm; ignored by line tools. Valor predeterminado 50.0.
ignoreActorsarray of stringActor labels/names to ignore.