orion-project-acoustics

Diagnose Unreal Engine ProjectAcoustics listener crashes and audio integration failures.

16|3|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/OrionUE/Orion_FreeEdition --skill orion-project-acoustics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orion-project-acoustics
Source: https://github.com/OrionUE/Orion_FreeEdition/tree/main/.agents/skills/orion-project-acoustics
Command: npx skills add https://github.com/OrionUE/Orion_FreeEdition --skill orion-project-acoustics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps Unreal Engine developers diagnose and fix ProjectAcoustics runtime failures, especially audio thread listener crashes, unsafe actor updates, and plugin configuration issues.

Core Features & Use Cases

  • Listener Crash Triage: Guides investigation of OnListenerUpdated, audio thread callbacks, virtual speaker failures, and EXCEPTION_ACCESS_VIOLATION crashes.
  • Plugin Configuration Support: Helps validate ProjectAcoustics, SteamAudio, SourceDataOverride, spatialization, reverb, and Unreal audio plugin settings.
  • Safe Runtime Fixes: Provides patterns for moving actor operations to GameThread paths, managing weak references, and validating lifecycle state during world changes.
  • Use Case: When an Unreal Engine project crashes while updating ProjectAcoustics virtual speakers, use this Skill to identify thread-safety issues and implement a validated repair workflow.

Quick Start

Use the orion-project-acoustics skill to investigate my Unreal Engine ProjectAcoustics listener crash and recommend a safe fix.

Frequently Asked Questions about orion-project-acoustics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does Unreal Engine crash with EXCEPTION_ACCESS_VIOLATION during Project Acoustics listener updates?

Unreal Engine Project Acoustics listener crashes usually occur when the audio thread accesses actors unsafely. Diagnose these EXCEPTION_ACCESS_VIOLATION failures by validating audio thread safety and checking OnListenerUpdated callbacks.

How do I fix Project Acoustics virtual speaker failures in Unreal Engine?

To fix Project Acoustics virtual speaker failures, move actor operations to the GameThread path and manage weak references. This ensures safe lifecycle state validation during world changes and prevents audio thread crashes.

Does Steam Audio work with Project Acoustics plugin configuration in Unreal Engine?

Yes, this validates plugin settings for both Project Acoustics and Steam Audio in Unreal Engine. It checks spatialization, reverb, SourceDataOverride, and overall audio plugin configurations to resolve integration failures.

How do I validate audio thread safety when updating spatial reverb in Unreal Engine?

Validate audio thread safety by ensuring actor updates run on the GameThread and using weak references. This prevents unsafe access during spatial reverb updates and maintains stable virtual speaker lifecycle states.

What is the best way to troubleshoot SourceDataOverride integration issues in Unreal Engine?

The best way to troubleshoot SourceDataOverride issues is verifying Unreal Engine audio plugin configurations and build settings. Validate spatialization and reverb plugin settings to identify and resolve the root integration failures.

What are the limitations of moving Project Acoustics actor updates to the GameThread?

Moving Project Acoustics actor updates to the GameThread prevents audio thread crashes but requires careful weak reference management. You must validate lifecycle states during world changes to avoid stale object access and ensure build verification.