From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:3DSX" |
|---|
| claim | "A 3DSX file starts with magic '3DSX', u16 header size, u16 relocation header size, u32 version, u32 flags, four u32 sizes (code, rodata, data, bss), and, if header size exceeds 0x20, u32 SMDH offset, u32 SMDH size and u32 RomFS offset." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "3DSX files written by 3dsxtool (format version 0)" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "THREEDSX_Header" |
|---|
| size_min | 32 |
|---|
| size_max | 44 |
|---|
| fields | | offset | "0x00" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "magic" |
|---|
| notes | "0x58534433, bytes 33 44 53 58" |
|---|
|
| offset | "0x04" |
|---|
| size | 2 |
|---|
| type | "u16" |
|---|
| name | "header_size" |
|---|
| notes | "0x20, or 0x2C with the extended header" |
|---|
|
| offset | "0x06" |
|---|
| size | 2 |
|---|
| type | "u16" |
|---|
| name | "reloc_hdr_size" |
|---|
| notes | "8 as written by 3dsxtool (two u32 counts)" |
|---|
|
| offset | "0x08" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "format_ver" |
|---|
| notes | "0" |
|---|
|
| offset | "0x0C" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "flags" |
|---|
|
| offset | "0x10" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "code_seg_size" |
|---|
|
| offset | "0x14" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "rodata_seg_size" |
|---|
|
| offset | "0x18" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "data_seg_size" |
|---|
| notes | "includes the BSS" |
|---|
|
| offset | "0x1C" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "bss_size" |
|---|
|
| offset | "0x20" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "smdh_offset" |
|---|
| condition | "header_size > 0x20" |
|---|
|
| offset | "0x24" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "smdh_size" |
|---|
| condition | "header_size > 0x20" |
|---|
|
| offset | "0x28" |
|---|
| size | 4 |
|---|
| type | "u32" |
|---|
| name | "fs_offset" |
|---|
| condition | "header_size > 0x20" |
|---|
| notes | "RomFS image offset; written only when a RomFS directory is given" |
|---|
|
|
|---|
| endianness | "little" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "Header writer: magic 0x58534433, header size 8*4 (+3*4), reloc header size, version, flags, segment sizes; extended header words filled by WriteExtHeader" |
|---|
| repo | "https://github.com/devkitPro/3dstools" |
|---|
| commit | "718d6f2330dbef9dd5726573392425dcbd451677" |
|---|
| path | "src/3dsxtool.cpp" |
|---|
| lines | "417-433" |
|---|
|
| type | "source" |
|---|
| detail | "Reader struct THREEDSX_Header with the same field order" |
|---|
| repo | "https://github.com/azahar-emu/azahar" |
|---|
| commit | "987f18405073960622e1043bb44005989135c6e1" |
|---|
| path | "src/core/loader/3dsx.cpp" |
|---|
| lines | "48-63" |
|---|
|
| type | "source" |
|---|
| detail | "FileClass constructors set LittleEndian(true); WriteWord/WriteHword byte-swap with le_word/le_hword" |
|---|
| repo | "https://github.com/devkitPro/3dstools" |
|---|
| commit | "718d6f2330dbef9dd5726573392425dcbd451677" |
|---|
| path | "src/FileClass.h" |
|---|
| lines | "26-30, 62-79" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Header" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T23:55:02.066Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T01:30:47.143Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read devkitPro 3dstools 3dsxtool.cpp at 718d6f2: writes 0x58534433, hdr size 8*4 (+3*4), sizeof(RelocHdr)=8 (two u32), version 0, flags 0, four segment sizes, then 3 ext words." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T12:35:37.420Z" |
|---|
| summary | "Set byte order: 3dsxtool FileClass defaults to LittleEndian and WriteWord/WriteHword use le_word/le_hword." |
|---|
| changed | |
|---|
|
|
|---|