https://github.com/aeonitis/reverse-engineer-azel
My adventure in Reverse Engineering from Bytecode, on a forgotten digital relic.
https://github.com/aeonitis/reverse-engineer-azel
assembly azel azel-rpg decompilation decompiler disassembler dragoon game ghidra ida-pro panzer panzer-dragoon-saga ram reverse-engineering rpg saga saturn sega sega-saturn superh
Last synced: about 1 month ago
JSON representation
My adventure in Reverse Engineering from Bytecode, on a forgotten digital relic.
- Host: GitHub
- URL: https://github.com/aeonitis/reverse-engineer-azel
- Owner: Aeonitis
- License: gpl-3.0
- Created: 2022-07-10T15:01:57.000Z (almost 3 years ago)
- Default Branch: base
- Last Pushed: 2023-05-04T16:14:14.000Z (about 2 years ago)
- Last Synced: 2025-03-27T07:03:15.169Z (about 2 months ago)
- Topics: assembly, azel, azel-rpg, decompilation, decompiler, disassembler, dragoon, game, ghidra, ida-pro, panzer, panzer-dragoon-saga, ram, reverse-engineering, rpg, saga, saturn, sega, sega-saturn, superh
- Language: Assembly
- Homepage:
- Size: 1.86 MB
- Stars: 16
- Watchers: 5
- Forks: 1
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Reverse-Engineering Azel RPG
Why?
Well, the article [Sega's Missing Masterpiece](https://www.theringer.com/2018/1/29/16940902/1998-video-games-panzer-dragoon-saga-missing-masterpiece) probably makes a great case.
The NSA's Ghidra (Generic Hexadecimal Integrated Decompiling Reverse-Engineering Architecture) added [support](https://github.com/NationalSecurityAgency/ghidra/pull/715) from v9.1 onwards for the SH-2 processor, and I was interested in becoming a digital archeologist!
## Project Overview
[Wiki/Discord](https://github.com/Aeonitis/Reverse-Engineer-Azel/wiki)
[Discussions](https://github.com/Aeonitis/Reverse-Engineer-Azel/discussions)
- Day one of progress?
- Disassembled [MENUEN.PRG](https://github.com/Aeonitis/Reverse-Engineer-Azel/blob/main/AZEL_1/PRG/MENUEN.PRG.md)
- Interesting finds/easter eggs in progress? Go to [Anomalies](https://github.com/Aeonitis/Reverse-Engineer-Azel/blob/main/Docs/ANOMALIES.MD)
- Disc Analysis: File info [@AZEL#I.MD](https://github.com/Aeonitis/Reverse-Engineer-Azel/blob/main/AZEL_1/AZEL%23I.md)
- Assembly Code: [01000011](https://github.com/Aeonitis/Reverse-Engineer-Azel/blob/main/AZEL_1/0x00/_ASSEMBLY.md)
- Strange words & terms found [@Glossary](https://github.com/Aeonitis/Reverse-Engineer-Azel/blob/main/Docs/_Glossary.md)
- My Journey in Reverse Engineering [@Solo Logs](https://github.com/Aeonitis/Reverse-Engineer-Azel/wiki/Logs-%5BSolo%5D)
## Directory structure
```
├── AZEL_1 // Disc 1 specific info.
│ ├── 01000011 // C code for Disc 1
│ ├── 0x00 // Assembly code for Disc 1
│ ├── AZEL#I.md // Disc 1 analysis
│ ├── BIN // Data under BIN file-types
│ └── PRG // Data under PRG file-types
│
├── Abstract // Unconfirmed but potentially useful data for future cross-checking
│
├── Docs // Documentation.
│ ├── ANOMALIES.md // Unusual discoveries found and expected in future
│ ├── AUDIO.md // Audio documentation here
│ ├── GLOSSARY.md // Domain-specific documentation here
│ ├── MEMORY.md // Memory documentation here
│ ├── VIDEO.md // Video documentation here
│ └── _SEGASATURN.md // Sega Saturn specific documentation
└── アゼル―パンツァードラグーン-RPG.MD // Panzer Dragoon Swagger (PDS) general information
```
## Progress
### PRGs
Filename | Percentage | Decompiled (bytes) | Total (bytes)
---|------------|--------------------|---
1ST_READ.PRG | 74.70% | 1,908 | 2,554
BTL_A3.PRG | 8.65% | 3,256 | 37,660
BTL_A3_2.PRG | 8.39% | 3,240 | 38,606
MENUEN.PRG | 54.39% | 26,624 | 48,944
TWN_CAMP.PRG | 62.39% | 18,655 | 29,899
WORLD.PRG | 21.66% | 829 |3827
## Wanna contribute?
You're welcome! Here's our [Contributing.md](https://github.com/Aeonitis/Reverse-Engineer-Azel/blob/main/Docs/Rubric/Contributing.md)
I have a per-file discussion issue under the [focus on file](https://github.com/Aeonitis/Reverse-Engineer-Azel/labels/focus%20on%20file) label & you can get started on any file you like!
Any assembly genius info you have? Feel free to share on the [Issues](https://github.com/Aeonitis/Reverse-Engineer-Azel/issues) section as a comment :)
# Panzer Dragoon Saga
Panzer Dragoon Saga (PDS) a.k.a. Azel: Panzer Dragoon RPG (アゼル ―パンツァードラグーンRPG―) is an awesome game!
- [The Appeal of Panzer](https://venturebeat.com/2012/01/11/the-appeal-of-panzer-dragoon-saga/)
- [Fan-Wiki](https://panzerdragoon.fandom.com/wiki/Panzer_Dragoon_Saga)
## Goals
- Understand the Sega Saturn hardware: In order to reverse engineer a game for the Sega Saturn, it's important to have a solid understanding of the hardware architecture of the console. This includes knowledge of the CPU, graphics hardware, sound hardware, and other system components. Having a good understanding of the hardware can help us identify how the game code is interacting with the system and how it is implementing certain features.
- Understanding the common Saturn file formats, gathering Saturn documentation.
- Look for documentation on the Saturn boot process
- Know which file in the ISO is the main binary that it's going to run
- Figure out how the CD-ROM's SH-1 gets its instructions (find when it's trying to read a specific file).
- Use a debugger: A debugger is a software tool that allows us to step through the game code and analyze how it is executing. This can be an incredibly useful tool for reverse engineering a game, as it allows us to see how the code is working in real-time and identify key functions and data structures.
- Patterns & Structures: When reverse engineering a game, it's important to look for patterns and structures in the code and data. This includes identifying repeating code blocks, data tables, and other patterns that can provide insight into how the game is working. Once you identify these patterns, we can start to map out the game logic and data structures.
- Disassemble: Disassembling the game code involves converting the compiled machine code into assembly language. This can be a time-consuming process, but it can provide a deeper understanding of how the game code is working and how it is interacting with the Sega Saturn hardware.
- Patience & Persistence = Learning whilst discovering more of a great game!
## Documentation:
### SH-2 (and other Saturn subsystems)
- [SH-2 GCC C COMPILER](https://github.com/SaturnSDK/Saturn-SDK-GCC-SH2)
- [Renesas SH Instruction Set Summary](http://shared-ptr.com/sh_insns.html)
- [Renesas SH Instruction Set Project](https://github.com/shared-ptr/sh_insns)
- [Renesas SuperH disassembler](https://github.com/logic/sh2dis)
- [SuperH RISC Engine SH-2 Programming Manual [1996]](https://antime.kapsi.fi/sega/files/h12p0.pdf)
- [Sega Saturn Emulated Hardware](https://github.com/FCare/Kronos)
- [Game Modification Utilities](https://www.zophar.net/utilities/mod.html)
- [SH-2 CPU (Memory Map)](https://wiki.yabause.org/index.php5?title=SH-2CPU)
### Panzer Dragoon Saga
- [Panzer Dragoon Saga - The Cutting Room Floor](https://tcrf.net/Panzer_Dragoon_Saga)
- [RetroAchievements](https://retroachievements.org/game/14506)
### Emulation
- [uoYabause Blogs](http://www.uoyabause.org/blogs)
- [uoYabause Tutorial](https://fantasyanime.com/emuhelp/uoyabause)
- [YSS Loader](https://github.com/cyberwarriorx/yssloader)
- [Yabause Wiki](https://wiki.yabause.org)
### Saturn tools
- [Ghidra Releases](https://github.com/NationalSecurityAgency/ghidra/releases)
- [Ghidra Sega Saturn Loader](https://github.com/VGKintsugi/Ghidra-SegaSaturn-Loader)
- [Sega Master System/Game Gear Loader](https://github.com/VGKintsugi/Ghidra-SegaMasterSystem-Loader)
- [Jo-Engine (2D and 3D game engine)](https://github.com/johannes-fetz/joengine)
- [Save-Game Copier](https://github.com/slinga-homebrew/Save-Game-Copier)
- [Blender-to-Saturn-Model-Exporter](https://github.com/polygon-studio/Blender-to-Saturn-Model-Exporter)
### Reverse Engineering
- [Beginner Learning Materials on Reverse Engineering Video Games](https://github.com/kovidomi/game-reversing)
- [Decompilation Projects](https://www.resetera.com/threads/decompilation-projects-ot-free-next-gen-update-for-your-favorite-classics-a-link-to-the-past-pc-port-out-now.682687/#post-100662691)
### Game Archiving
- [Mysterious origins of an uncrackable video game](https://www.bbc.com/future/article/20190919-the-maze-puzzle-hidden-within-an-early-video-game)
- [Game archiving faces challenges...](https://www.polygon.com/2013/3/30/4157594/game-archiving-faces-challenges-for-the-future-say-experts)
- [Archiving video games for humanities research](https://www.cambridge.org/core/journals/art-libraries-journal/article/abs/art-and-technology-archiving-video-games-for-humanities-research-in-university-libraries/5F8C480FC76784C83C3A80940ACE4EB0)
### SuperH Family (not SH-2 processor)
- [SH2A [SH7211] Group Hardware Manual](https://www.renesas.com/us/en/document/mah/sh7211-group-hardware-manual)
- [SH3 [SH7706] Group Hardware Manual](https://www.renesas.com/us/en/document/mah/sh7706-group-hardware-manual)