Getting Started

Installation

This page offers step by steps instructions on how to build the MediEvil Decompilation Project using your MediEvil 1 US PSX copy of the game.

Getting started

Linux (Native or under WSL / VM)

1. Install build dependencies

The build process has the following package requirements:

• git
• make
• gcc-mipsel-linux-gnu
• binutils-mipsel-linux-gnu
• clang
• clang-format
• python3
• python3-pip

Under Debian / Ubuntu (which we recommend using), you can install them with the following commands:

sudo apt-get update
sudo apt-get install -y git make gcc-mipsel-linux-gnu binutils-mipsel-linux-gnu clang clang-format python3 python3-pip

Clone the repository

Create your own fork of the repository at https://github.com/MediEvilDecompilation/medievil-decomp. Then clone your fork where you wish to have the project, with the command:

git clone https://github.com/<YOUR_USERNAME>/medievil-decomp.git

This will copy the GitHub repository contents into a new folder in the current directory called medievil-decomp. Change into this directory before doing anything else:

cd medievil-decomp

Install python dependencies

The build process has a few python packages required that are located in /tools/requirements-python.txt.

To install them simply run in a terminal:

python3 -m pip install -r ./tools/requirements-python.txt

Update submodules

git submodule update --init --recursive

Disk extraction

Use any software with cue/bin support such as PowerISO to extract the game binaries from your own copy of Medievil US PSX, and put the files inside /disk/medievil/

Building steps

Assembly extraction

Use the following command to disassemble the game binaries:

make extract

Build

make all