Project settings for runtime input, focus scoring, network request policy, activation snapshot tolerance, session limits, diagnostics, spatial queries, and preload behavior.
UCLASS(config = Game, defaultconfig, meta = (DisplayName = "Runtime"))
class INTERACTIONFRAMEWORKRUNTIME_API UInteractionFrameworkRuntimeDeveloperSettings : public UDeveloperSettingsProperties
Interaction Input Mapping Context
Input mapping context that contains interaction runtime actions used by the UI manager.
Focus Distance Weight
Weight applied to distance when scoring the best focused interaction point.
Focus View Weight
Weight applied to view alignment when scoring the best focused interaction point.
Focus Min Hold Sec
Minimum time in seconds before focus can switch away from the current point.
Focus Switch Score Margin
Score margin a new candidate must beat before replacing current focus.
Route Mismatch Policy
Server behavior when a client requests a route that no longer matches server state.
Server Min Request Interval Sec
Minimum accepted interval between server interaction requests from the same source.
Max Session Duration Sec
Maximum duration in seconds a Hold or MultiTap session may remain active on the server. Orphaned sessions (e.g., client disconnect mid-hold) are force-terminated with a Failed/TimedOut outcome after this time, releasing any held lock reservation. Non-positive or invalid values are clamped to a small runtime safety floor instead of disabling the safeguard. Should exceed the longest legitimate hold duration defined in your interaction definitions.
Activation Snapshot Max Distance Origin Delta Cm
Maximum tolerated delta between a client press-time snapshot distance origin and the server-owned interactor distance origin. Snapshots outside this tolerance are ignored and server-side origins are used for activation validation.
Activation Snapshot Max View Origin Delta Cm
Maximum tolerated delta between a client press-time snapshot view origin and the server-owned interactor view origin. Snapshots outside this tolerance are ignored and server-side origins are used for activation validation.
Enable Runtime Debug Diagnostics
Enables lightweight non-shipping runtime diagnostics for focus, activation, authority outcomes, and candidate filtering. Off by default.
Load Example Tags
Loads Interaction Framework's optional example gameplay tags from the plugin Config/Tags folder. Requires an editor restart after changing.
World Grid Max Candidates
Maximum number of candidate points returned from a spatial query before detailed per-target filtering.
World Grid Dirty Update Budget Per Tick
Maximum number of dirty spatial-grid updates processed per tick.
Log World Budget Pressure
Logs when the world-query dirty update budget is under pressure.
World Grid Max Query Range Cm
Optional hard cap for the global spatial query radius. Values <= 0 leave the authored maximum interaction range uncapped.
Preload Target Definition Soft Assets
Preloads soft assets referenced by target definitions to reduce first-use hitches.
Use Cases
- Use UInteractionFrameworkRuntimeDeveloperSettings in the core-concepts workflow.