# Mobile Suit Gundam Version 2.0 Recomp

A native recompilation project for the Japanese PlayStation release of **Mobile Suit Gundam Version 2.0**, built using the PSXRecomp framework.

> **Important:** This repository does not contain the original game. You must provide your own legally obtained copy of **Mobile Suit Gundam Version 2.0 (Japan)**.

## Project Information

- **Game:** Mobile Suit Gundam Version 2.0
- **Platform:** Sony PlayStation
- **Region:** Japan
- **Publisher:** Bandai
- **Year:** 1997
- **Serial:** SLPS-00280
- **Boot executable:** SLPS_002.80
- **Tracks:** 12
- **Recompilation framework:** PSXRecomp
- **Launcher / setup interface:** recomp-ui

## About the Project

This project uses static recompilation to convert the original PlayStation program for execution through a modern native runtime. It is an unofficial preservation, research, and recompilation project. It is not a source port and does not contain the original game's source code.

## Original Game Required

You must own and supply your own legally obtained copy of **Mobile Suit Gundam Version 2.0 (Japan)**. Game data is processed locally and must not be committed to this repository.

## No Copyrighted Game Data

This repository intentionally does **not** contain BIN/CUE files, ISO/CHD/IMG/PBP images, ROM files, BIOS files, the extracted PlayStation executable, generated copyrighted game code, music, XA audio, voices, FMV/video, textures, sprites, models, artwork, or other original Gundam game assets. Build output and compiled executables are also excluded.

## Setup

Clone the repository with its submodules:

```bash
git clone --recursive https://github.com/omegakatana92/Mobile-Suit-Gundam---Version-2.0-Recomp.git
```

If already cloned without submodules:

```bash
git submodule update --init --recursive
```

Provide your own legally obtained game when prompted by the PSXRecomp/recomp-ui setup process.

## Building

```bash
cmake -S . -B build-release -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build-release --target psx-runtime
```

## Verified Disc Metadata

- Serial: `SLPS-00280`
- Boot executable: `SLPS_002.80`
- Load address: `0x80020000`
- Entry PC: `0x8002970C`
- Text size: `0x00056000`
- Stack base: `0x801FFFF0`
- Track count: `12`
- Data-track MD5: `b1b9932cbf2f1f798bc60ad2a8dc70bf`
- Data-track SHA-1: `35b81a2fdfbc54498569439bf863b7c9e83f6487`
- Data-track CRC32: `955432ea`
- Disc fingerprint: `5d95ebc100e10f8ab9db5bfeaa8fbb345df66ca7977b51a7819f217ebd18e2bc`
- Initial discovered seed functions: `452`

## Project Status

Compatibility should be tracked separately as **Buildable**, **UI Functional**, **Bootable**, **Playable**, and **Complete**. A successful build or title-screen boot does not automatically mean the entire game is complete.

## PSXRecomp Credit

Special thanks and full credit to **mstan** for creating and developing **PSXRecomp**, the PlayStation static recompilation tool and framework that makes this project possible.

Additional thanks to the PSXRecomp contributors, **RetroPortingToolKit**, and the **recomp-ui** developers and contributors.

## Legal

**Mobile Suit Gundam**, Mobile Suit Gundam Version 2.0, and all associated characters, mobile suits, designs, artwork, music, trademarks, and other intellectual property belong to their respective copyright holders.

This project is unofficial and is not affiliated with or endorsed by the original game's developers, publishers, rights holders, mstan, RetroPortingToolKit, or recomp-ui. No copyrighted Mobile Suit Gundam Version 2.0 game data is intentionally distributed through this repository.