ue5-world-interaction

Quick Start

• Define interaction model: overlap-driven, trace-driven, or explicit use key.
• Define actor set: pickup actor, optional spawner, optional visual mapping data asset.
• Output runtime state transitions from spawn to interaction resolution.

UE5.7 API Anchors

• Detection anchors:
  • USphereComponent, UBoxComponent
  • UPrimitiveComponent::OnComponentBeginOverlap
  • UPrimitiveComponent::OnComponentEndOverlap
  • FHitResult
• Trace anchors:
  • UWorld::LineTraceSingleByChannel(...)
  • UWorld::SweepSingleByChannel(...)
  • UKismetSystemLibrary::SphereTraceSingle(...)
• Lifecycle anchors:
  • AActor::SetActorHiddenInGame(...)
  • AActor::SetActorEnableCollision(...)
  • AActor::Destroy(...)
  • AActor::SetActorTickEnabled(...)
• Networking anchors:
  • server authority validation for interaction success
  • replicated result state for client feedback

Interaction Stage Contract

• Every interaction feature must define:
  • Detection source (overlap/trace/use-key)
  • Eligibility checks (distance, tags, inventory/capacity, authority)
  • Success and failure result payloads
  • Feedback path (VFX/SFX/UI)
  • Post-interaction lifecycle policy (destroy/disable/cooldown/respawn)
• If any item is missing, interaction behavior is underspecified.

Workflow

1) Actor and Component Setup

• Build root + collision + visual components with explicit collision channels.
• Define default states (active, cooldown, consumed) and replication needs.
• Keep collision shape and bounds aligned with intended interaction distance.

2) Detection Path

• Overlap model: bind begin/end overlap delegates on collision component.
• Trace model: run line/sphere traces on input request and validate hit actor/component.
• Keep detection deterministic by explicit channels/profiles.

3) Eligibility and Authority

• Validate target state, range, actor validity, and gameplay conditions.
• In multiplayer, validate success on server before mutating shared state.
• Return structured failure reason on rejection.