Format:XDBF (Xbox 360 database)
| Platforms | Platform:Xbox 360 |
|---|---|
| Magic | XDBF |
| Endianness | big |
| On this wiki | Facts · Code · Notes · Topics |
Big-endian table-of-entries container used for Xbox 360 title resources (SPA: icon, localized strings, achievements) and profile data (GPD): magic XDBF, entry table, free-space table, then entries addressed by (namespace, id).
Overview
An XDBF file starts with XDBF (0x58444246), a version, and four counts: entry table capacity, entries used, free space table capacity and used. The 24-byte header is followed by the entry table (18 bytes each: u16 section/namespace, u64 id, u32 offset, u32 size), then the free-space table (8 bytes each), and the data area; entry offsets are relative to the end of the tables (xenia xdbf_utils.cc: content starts after entry_count entries and free_count free-space records, capacities rather than used counts).
Namespaces
1 metadata (e.g. id 0x58414348 XACH achievement table, id 0x58535443 XSTC string table settings with default language), 2 image (id 0x8000 is the title icon; other ids are achievement images), 3 string table (XSTR, one per language, entries of u16 id, u16 length, then that many bytes of text (xenia returns the bytes unconverted in a std::string, so the encoding is not stated by that source; Unverified: UTF-8); string table entry ids are looked up per language with the language number (1 English ... 12 Russian, see Fact:STFS (Xbox 360 package)/enum/Language ids) as the id of the section 3 entry, which starts with an XSTR header (magic, version, size as u32, count as u16); id 0x8000 is the title name (kXdbfIdTitle in xenia)).
Achievement table
XACH block: header (magic, version, size, count) then 0x24-byte records: id, label string id, description id, unachieved description id, image id, gamerscore, flags. Strings are looked up in the string table of the wanted language.
Where it is found
- Embedded in a Format:XEX2 (Xbox 360 executable) as a resource listed in the resource info header 0x000002FF whose 8-character name is the title id as upper-case hex digits (xenia kernel_state.cc module_xdbf formats the name with {:08X}); Fact:XEX2 (Xbox 360 executable)/identification/Title XDBF resource. Unverified: the name SPA for this file comes from Free60/tool vocabulary and is not used as a resource name by the xenia code read.
- Unverified: as
.gpdfiles (profile, title and game data) inside profile packages of type Format:STFS (Xbox 360 package) (from Free60 knowledge, not in the xenia files read).
See Fact:XDBF (Xbox 360 database)/struct/Header and entry. Format description originally from the Free60 project.
Related
Code & repositories
- https://github.com/xenia-project/xenia @
95a5c3ee250f80c3b9d139658649d9ffb6db3eec· license: BSD-3-Clause (declared by the contributor for the files used; GitHub reports BSD-3-Clause (read from LICENSE; GitHub's detector did not classify it) for the repository)
Xbox 360 emulator; src/xenia/kernel/util/xex2_info.h, vfs/devices/stfs_xbox.h and kernel/util/xdbf_utils.h hold the public header structures
Tested on: source read, not run: source reading only · checked 2026-10-18; last activity 2026-02-18