graph TB
    subgraph "Modder Layer"
        CFG[Config Files<br/>creatures/*.cfg<br/>magic.cfg<br/>sounds.cfg]
        LUA[Lua Scripts<br/>level.lua<br/>campaign.lua]
        DKS[DKScript<br/>map00001.txt]
    end
    
    subgraph "API Layer"
        SM[SoundManager<br/>C++ Singleton]
        REG[Sound Registry<br/>name → ID mapping]
        CAPI[C API Bridge<br/>sound_manager_* functions]
    end
    
    subgraph "Bank Layer"
        B0[Bank 0: sound.dat<br/>Built-in sounds]
        B1[Bank 1: speech.dat<br/>Mentor speech]
        B2[Bank 2: Custom<br/>Runtime WAV/OGG]
        B3[Bank 3: Campaign<br/>Per-campaign sounds]
    end
    
    subgraph "Playback Layer"
        OAL[OpenAL<br/>3D positioned audio]
        SDL[SDL2_Mixer<br/>Music streaming]
        EMT[Sound Emitters<br/>Per-Thing audio sources]
    end
    
    CFG --> REG
    LUA --> CAPI
    DKS --> CAPI
    
    REG --> SM
    CAPI --> SM
    
    SM --> B0
    SM --> B1
    SM --> B2
    SM --> B3
    
    B0 --> OAL
    B1 --> OAL
    B2 --> OAL
    B3 --> OAL
    SM --> SDL
    
    OAL --> EMT

sequenceDiagram
    participant Modder as Modder Config
    participant Registry as Sound Registry
    participant Manager as SoundManager
    participant Bank as Sound Banks
    participant OpenAL as OpenAL
    
    Note over Modder: sounds.cfg defines<br/>FIREBALL = 58
    Modder->>Registry: Load sound definitions
    Registry->>Registry: Build name→ID map
    
    Note over Modder: magic.cfg uses<br/>SoundPlayed = FIREBALL
    Modder->>Registry: get_sound_id("FIREBALL")
    Registry-->>Manager: Returns 58
    
    Note over Manager: Runtime playback
    Manager->>Bank: Get sample from bank
    Bank-->>OpenAL: Audio buffer
    OpenAL->>OpenAL: 3D positioned playback