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:AAMP

From ReverseEngineering.wiki
Format
Platforms Platform:Nintendo Wii U, Platform:Nintendo Switch
Magic 41 41 4D 50 ("AAMP")
Endianness little
On this wiki Facts · Code · Notes · Topics

Nintendo's binary parameter archive (magic AAMP, .bxml, .baiprog, .bgparamlist and many other extensions in Wii U and Switch Zelda games): a 0x30-byte little-endian header, then a tree of parameter lists, objects and typed parameters addressed by CRC-32 name hashes, with data and string sections.

Overview

AAMP files hold game parameters (actor, AI and physics settings) as a tree: a root ParameterIO list (key param_root) containing lists, each containing sub-lists and objects, each object containing typed parameters. Names are stored only as CRC-32 hashes, so tools carry a name table to show them. Layout read from zeldamods/oead (GPL-2.0-or-later) src/aamp.cpp and src/include/oead/aamp.h; oead reads and writes only version 2, little-endian, UTF-8 archives and rejects the others. Unverified: files are commonly stored inside Format:SARC archive archives, Format:Yaz0 compressed, with extensions such as .bxml, .baiprog or .bgparamlist (general knowledge, not read in oead). The sister format for structured data is Format:BYML.

Header

The 0x30-byte header is little endian: magic AAMP, version (2), flags (bit 0 little endian, bit 1 UTF-8), file size, ParameterIO version, offset to the ParameterIO (relative to 0x30), number of lists (including the root), number of objects, number of parameters, data section size, string section size and an unknown-section size (Fact:AAMP/struct/AAMP header). After the header comes a string holding the ParameterIO type (read at offset 0x30).

Nodes

  • Parameter list (0xC bytes): u32 name CRC-32, u16 offset of its sub-lists and u16 count, u16 offset of its objects and u16 count; offsets are counted in 4-byte units relative to the node.
  • Parameter object (8 bytes): u32 name CRC-32, u16 offset of its parameters (4-byte units) and u16 count.
  • Parameter (8 bytes): u32 name CRC-32, a 24-bit offset to the value in 4-byte units (relative to the parameter) and a u8 type (Fact:AAMP/enum/AAMP parameter types).

The root list's name must be the CRC-32 of param_root or oead refuses the file. Unverified: how the writer orders and deduplicates strings and data, and the meaning of the unknown section.

Tools

  • oead (C++ library and Python module) converts AAMP to and from a YAML text form.

Code & repositories

  • https://github.com/zeldamods/oead @ 5fb74e1128468380b47da23a5690891c8af4ab72 · license: GPL-2.0
    oead (GPL-2.0-or-later): src/aamp.cpp and include/oead/aamp.h define the AAMP layout
    Tested on: source read, not run: source read only, not built · checked 2026-10-18; last activity 2026-10-02