Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Format:Wwise SoundBank (BNK)

From ReverseEngineering.wiki
Format
Developer Audiokinetic
Magic BKHD
Extensions .bnk
Endianness little (PC), big on Xbox 360/PS3/Wii U
License proprietary; readers: vgmstream (ISC), wwiser
On this wiki Facts · Code · Notes · Topics

Audiokinetic Wwise's SoundBank (.bnk): a sequence of 4-character chunks (BKHD header, DIDX index, DATA wem payloads, HIRC object hierarchy, STID, STMG, INIT, ENVS ...) holding events, sounds, music and optionally the audio itself.

Identification

  • The file starts with the chunk BKHD (some Xbox 360 games prefix it with a 12-byte AKBK wrapper). Chunks are 4-char id, u32 size, payload, sizes in the platform's byte order, no padding, sequentially packed; unlike RIFF the first chunk follows the same rule.
  • BKHD payload starts with the bank version (u32; Wwise 2007 era files have version 0 or 1 and the real version 0x10 further on), then the bank id and the language id; the version is the best date indicator: see the table under Versions. Sound-engine code branches on this version.
  • Typical chunks: DIDX (index of embedded .wem: 12-byte entries of file id, offset into DATA, size), DATA (the .wem files back to back, see Format:WEM (Wwise RIFF audio)), HIRC (hierarchy of all objects, see HIRC object types; the largest chunk and the one that defines playback), STID (bank id to name table), STMG (global settings), INIT (plugin list), ENVS, FXPR. Banks of a game's own Init.bnk define buses and plugins.
  • In bank versions up to 26 the DATA chunk has its own embedded header in place of DIDX (entries of 0x18 bytes).
  • Streamed audio is not in the bank: HIRC refers to external .wem files by id; .pck is the package file that gathers banks and wems.

Practical

To hear or extract audio: vgmstream opens a .bnk and lists the embedded wems as subsongs; for the event logic (which sound plays on which event, loops, music) use wwiser (parses HIRC into a dump or .txtp playlists for vgmstream). Names in HIRC are 32-bit FNV-1 hashes of lower-case names; wwnames lists known names.

Related

Library:Wwise, Format:WEM (Wwise RIFF audio), Technique:Game audio and video middleware.

Versions

Bank version (u32 in BKHD) against the SDK release, from the bank_versions table of wwiser (wwiser/parser/wdefs.py, commit 08e937b649bc7007c234bbd59e34a41d5eef3b38). The version is AK_SOUNDBANK_VERSION; it grows by about 1 per breaking field change and does not track the calendar year exactly. A marker "?" means wwiser's author is unsure of the release.

Bank version Wwise release Example platforms/games listed by wwiser
14 2007.1/2? Xbox 360
26 2007.3? Xbox 360, PC
34, 35, 36 2008.1?, 2008.2?, 2008.3? 35 seen on Wii
38 2008.4 PS3, Wii
44, 45, 46 2009.1?, 2009.2?, 2009.3 Xbox 360, Wii
48 2010.1 Xbox 360, PS3
52, 53 2010.2, 2010.3 Xbox 360, PS3
56 2011.1 PS3, Vita
62 2011.2 Xbox 360
65, 70 2011.3?, 2012.1?
72 2012.2 PC, Xbox 360
88 2013.1/2 Wii U, PC
112 2014.1 PS3, Wii U, Android, PC
113 2015.1 PC
118, 120 2016.1, 2016.2 PS4, Switch, PC
125 2017.1 PC
128 2017.2 PC, PS4, Switch
132 2018.1 Switch, PC
134 2019.1 PC
135 2019.2 PC, Switch
140, 141 2021.1 PC
145 2022.1 PC
150 2023.1 PC
154 2024.1 PC
168-172 2025.1.x (beta builds in the table) none known

Intermediate numbers (89, 122, 126, 129, 136, 144, 152, 160) are beta or update builds. Versions 14 and 26 are parsed only partially by wwiser. Hence the earlier statement on this page that 34-36 is 2009 and 134 is 2019 was partly wrong: 34-36 is 2008, 44-48 is 2009-2010.

HIRC object types

HIRC payload: u32 count of objects, then each object is u8 type, u32 size, body (the type was a u32 in bank versions up to 48). Type numbers, from wwiser (wwiser/parser/wdefs.py AkBank__AKBKHircType_* and the dispatch in wparser.py get_hirc_dispatch, commit 08e937b649bc7007c234bbd59e34a41d5eef3b38):

Type Object Notes
0x01 State
0x02 Sound (SFX/voice) refers to a .wem by source id
0x03 Action
0x04 Event
0x05 Random/Sequence container
0x06 Switch container
0x07 Actor-Mixer
0x08 Bus
0x09 Layer container
0x0A Music segment
0x0B Music track
0x0C Music switch container
0x0D Music random/sequence container
0x0E Attenuation
0x0F Dialogue event

Numbers above 0x0F shifted over time:

Type Bank versions up to 72 Versions 73-126 Version 128 and later
0x10 FeedbackBus FeedbackBus FxShareSet
0x11 FeedbackNode FeedbackNode FxCustom
0x12 FxShareSet FxShareSet Auxiliary bus
0x13 FxCustom FxCustom LFO modulator
0x14 Auxiliary bus Auxiliary bus Envelope modulator
0x15 - LFO modulator (112+) Audio device
0x16 - Envelope modulator (112+) Time modulator (132+)
0x17 - Audio device (118+) Sidechain mix (168+)

wwiser's dispatcher switches at version 126/127 (the 128-and-later layout); the exact version of the switch is from its code. In 2025.1 the editor renamed Actor-Mixer to Containers, but the bank still uses type 0x07.

Facts for readers: Fact:Wwise SoundBank (BNK)/enum/HIRC object types (bank version 126 and earlier) and Fact:Wwise SoundBank (BNK)/enum/HIRC object types (bank version 127 and later) (complete value lists), Fact:Wwise SoundBank (BNK)/enum/Action types (common values) (the 16-bit Action type), Fact:Wwise SoundBank (BNK)/enum/Chunk ids, Fact:Wwise SoundBank (BNK)/enum/Language ids. Pitfall: the Sound source type values 1 and 2 swap meaning between old and new banks (1 streaming, 2 prefetch up to version 89; 1 prefetch, 2 streaming after): Fact:Wwise SoundBank (BNK)/enum/Source type (bank version 89 and earlier), Fact:Wwise SoundBank (BNK)/enum/Source type (bank version 90 and later). Media index: Fact:Wwise SoundBank (BNK)/struct/DIDX media index entry (12 bytes) and, for bank version 26 and lower, Fact:Wwise SoundBank (BNK)/struct/Old DATA chunk index (bank version 26 and earlier).

Code & repositories

  • https://github.com/bnnm/wwiser @ 08e937b649bc7007c234bbd59e34a41d5eef3b38 · license: none
    Wwise bank parser/dumper whose wdefs.py lists bank versions, chunk ids and HIRC object types
    Tested on: source read, not run: source read, not run · checked 2026-10-18; last activity 2026-09-30; no license: not reusable

Evidence & references

  • vgmstream commit db77f98f405a45ad08df98aa444cae3848f95e6c (ISC): src/meta/bkhd.c lines 8-140 (AKBK prefix, version handling, DIDX/DATA, old DATA layout, wmid/RIFF subfile detection). The HIRC object types and the version-to-release table were verified against wwiser (bnnm/wwiser commit 08e937b649bc7007c234bbd59e34a41d5eef3b38, wwiser/parser/wdefs.py bank_versions and AkBank__AKBKHircType_*, wparser.py get_hirc_dispatch; the repository has no license file, so only facts are recorded). The FNV-1 name hash is settled from wwiser/wfnv.py (names lower-cased, 32-bit FNV-1: multiply by 16777619 then xor, offset basis 2166136261): see Fact:Wwise SoundBank (BNK)/behavior/Name hash is FNV-1 of the lower-cased name.