Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aki-club/vpw2
Virtual Pro-Wrestling 2 decompilation project.
https://github.com/aki-club/vpw2
Last synced: 15 days ago
JSON representation
Virtual Pro-Wrestling 2 decompilation project.
- Host: GitHub
- URL: https://github.com/aki-club/vpw2
- Owner: AKI-Club
- Created: 2022-04-01T04:57:28.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-03-06T21:22:14.000Z (10 months ago)
- Last Synced: 2024-03-06T22:33:41.968Z (10 months ago)
- Language: Assembly
- Homepage:
- Size: 19.7 MB
- Stars: 14
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Roadmap: docs/roadmap.txt
Awesome Lists containing this project
- awesome-n64-development - Virtual Pro Wrestling 2: Ōdō Keishō - An in-progress decompilation of _Virtual Pro Wrestling 2: Ōdō Keishō_ (Reverse Engineering / Projects)
README
# Virtual Pro-Wrestling 2
This is a decompilation project for AKI Corporation's *Virtual Pro-Wrestling 2*
(バーチャル・プロレス2 〜王道継承〜), a Nintendo 64 wrestling game.
Like most other N64 decomp projects, this is very much a work in progress.
Also like other N64 decomp projects, you will need a ROM of the game to extract
the necessary assets, as they are not included in this repository.
## Table of Contents
1. [Introduction](#introduction)
2. [Requirements](#requirements)
3. [Setup](#setup)
4. [Building](#building)
5. [Further Steps](#further-steps)
## Introduction
Some crazy person spends over a decade or two of his life trying to hack a video game.
This repository has two main purposes:
1. Document game information for any interested hackers.
2. Serve as a base for future hacks requiring non-trivial changes.
## Requirements
- a Linux environment (native, virtual machine, WSL2 on Windows 10)
- GNU `make` (and probably the other stuff from `build-essential` if your distro has that)
- `binutils-mips-linux-gnu`
- `gcc-mips-linux-gnu`
- `gcc-multilib`
- Python 3.x
- an **unmodified** Virtual Pro-Wrestling 2 ROM in **Z64 format**, legally obtained
While [`qemu-irix`](https://github.com/n64decomp/qemu-irix/releases) was previously
listed here, it is currently not used. It may or may not be used in the future.
This has only been tested on Linux using a VM, and WSL2 on Windows 10.
An unmodified VPW2 ROM in Z64 format should have the SHA-1 hash `82dd25a044689eab57ab362fe10c0da6388c217a`.
If you need help verifying your ROM, use the [VPW2 ROM ID](https://github.com/AKI-Club/vpw2romid)
program.
## Setup
### Step 1: Set up prerequisites
For Debian (and Debian-based systems), this should handle most of it:
```bash
sudo apt-get update
sudo apt-get install binutils-mips-linux-gnu gcc-mips-linux-gnu gcc-multilib make git
```
If you don't already have host/native development tools set up, you'll also
need 'build-essential':
```bash
sudo apt-get install build-essential
```
### Step 2: Clone and set up the git repository
```bash
git clone --recurse-submodules https://github.com/AKI-Club/vpw2
```
If you are manually cloning the repository (i.e. without `--recurse-submodules`),
you *need* to initialize the submodules as well.
### Step 3: Perform setup
Place an unmodified copy of your existing ROM inside the root of this repository
with the name `baserom.z64`, then run the following command:
```bash
make setup
```
This will build the necessary tools, extract the binary files from the ROM,
and extract the data from the file table (this will take a while).
Further tasks (such as converting the file table data to human-editable assets)
are still to-do.
## Building
Run `make` in the main directory.
## Further Steps
todo: the next steps (a.k.a. ~~draw~~ disassemble the rest of the fucking ~~owl~~ game)
## Notice
None of the contributors are affiliated with AKI Corporation (now known as syn sophia)
or Nintendo.