Skip to content

๐Ÿ“š Reference

This is a complete reference for all parameters, structures, functions, and enums used in Smart Cone Trace.


๐Ÿงฑ Component Parameters

Name Type Default
Interval float 0.25
Length float 200.0
AngleDegrees float 40.0
TraceChannel ETraceTypeQuery TraceTypeQuery1
ActorsToIgnore Array<Actor> []
RequiredClass Class<Actor> None
RequiredTags Array<Name> []
RequiredInterface Class<Interface> None
bMultiHit bool false
bIgnoreSelf bool true
DebugMode EConeDebugMode None
DebugDuration float 1.0
StepSize float 40.0
BoxDepth float 60.0
ToleranceDegrees float 2.0
bUseComponentTransform bool true
bCheckVisibility bool false
VisibilityChannel ETraceTypeQuery TraceTypeQuery1
VisibilityOriginMode EVisibilityOriginMode ScreenPoints
VisibilityBoundsScale float 0.95

โ„น๏ธ Note: ActorsToIgnore only accepts actors that are already placed in the level.
Learn more about this limitation โ†’


๐Ÿ“ฆ Struct: FSmartConeTraceResult

Field Type Description
bDidHit bool true if anything was hit
Hits Array<HitResult> All valid hits (filtered)
HitActors Array<Actor> All valid hit actors
ClosestHit HitResult Closest valid hit
VisibleActors Array Actors that passed the visibility (line-of-sight) check. Empty if bCheckVisibility is false.

๐Ÿงฐ Blueprint Function: ConeTraceByChannel()

Returns: FSmartConeTraceResult
Defined in: SmartConeTraceLib

Parameter Type Required Description
WorldContextObject Object โœ… Usually self
Start Vector โœ… Origin point of the cone
Direction Vector โœ… Direction the cone faces
Length float โœ… How far the cone extends
AngleDegrees float โœ… Half-angle of the cone in degrees
TraceChannel ETraceTypeQuery โœ… Object types to trace
ActorsToIgnore Array<Actor> โŒ Skip these actors during trace
RequiredClass Class<Actor> โŒ Only include actors of this class
RequiredTags Array<Name> โŒ Only include actors with these tags
RequiredInterface Class<Interface> โŒ Only include actors implementing it
bMultiHit bool โŒ Whether to collect all hits
bIgnoreSelf bool โŒ Whether to skip tracing the owner
DebugMode EConeDebugMode โŒ Visualize trace shapes
DebugDuration float โŒ Time to display debug shapes
StepSize float โŒ Distance between trace steps
BoxDepth float โŒ Depth of each trace box
ToleranceDegrees float โŒ Extra angular tolerance
bCheckVisibility bool โŒ Enable line-of-sight checks
VisibilityOriginMode EVisibilityOriginMode โŒ Start point of visibility traces
VisibilityBoundsScale float โŒ Scale of target bounds to trace against

๐Ÿ” Timer Functions

Also in SmartConeTraceLib:

Function Description
StartConeTraceTimer(WorldContext, TargetActor, CallbackFunctionName, Interval, bLoop) Binds a Blueprint function to be called repeatedly on a timer.
StopConeTraceTimer(WorldContext, TargetActor) Stops the timer for the given actor.

๐Ÿ” Helper Functions

All helper functions work with the FSmartConeTraceResult struct.

Function Return Type Description
GetClosestHitActor(Result) Actor Returns the closest hit actor
GetFirstValidHitActor(Result) Actor Returns the first hit actor
WasActorHit(Result, Actor) bool true if that actor was hit
IsValidHit(Result) bool true if any valid hit exists
GetHitActorsByClass(Result, Class) Array<Actor> Filters hit actors by class
GetVisibleActors(Result) Array<Actor> Returns only actors that passed the visibility check
IsActorVisible(Result, Actor) bool Returns true if the actor is in the VisibleActors list

๐Ÿงพ Enum: EConeDebugMode

Used to control debug visualization.

Value Description
None No visual debug
Basic Hit lines and impact points
Full Full cone shape: lines, boxes, points

๐Ÿงพ Enum: EVisibilityOriginMode

Determines the starting point for visibility raycasts.

Value Description
ScreenPoints Traces from the camera (Center + 4 corners). Best for "Player Vision"
ScreenCenter Traces from the exact center of the screen (Crosshair)
ConeStart Traces from the cone's origin. Best for "AI Vision" or sensors

Looking for real examples? Check out Examples ยป