| name | ghidra-struct |
| description | Check struct/class layout against Ghidra's Data Type Manager. Compares DC3 header definitions with Ghidra's analysis to find offset mismatches. Use when debugging struct alignment issues or verifying class layouts. |
| argument-hint | [class-name ...] |
| allowed-tools | Bash(python3 tools/ghidra/struct_check.py *) |
Ghidra Struct Check
Compare DC3 header struct definitions against Ghidra's Data Type Manager.
Arguments
$ARGUMENTS - One or more class names to check
Usage
python3 tools/ghidra/struct_check.py ClassName [ClassName2 ...]
Steps
-
Run the check:
python3 tools/ghidra/struct_check.py HamDirector RndWind
-
Review output showing:
- Offset comparison table
- Field names from both sources
- Status: OK or MISMATCH
-
Investigate mismatches by:
- Checking header file for the class
- Looking for missing padding or inheritance issues
- Comparing with RB3 DWARF dump if available
Output Format
======================================================================
HamDirector
======================================================================
Offset Our Field Ghidra Field Status
---------- ------------------------- ------------------------- ----------
0x0048 unk48 unk48 OK
0x005c mSongAnims mSongAnims OK
0x0150 mWorldPostProc mWorldPostProc OK
Tips
- Check multiple classes at once for efficiency
- Use with
/rb2-class for DWARF comparison
- Mismatches often indicate:
- Missing base class members
- Wrong member order
- Incorrect padding
- Wrong type sizes
When to Use
- Before fixing offset mismatches in objdiff
- When adding new class members
- After making struct layout changes
- To verify inheritance chain is correct
