From e8c248b73cc34550d3e923803b1ecf1e64cff345 Mon Sep 17 00:00:00 2001 From: Luke Street Date: Mon, 18 Jul 2022 19:52:28 -0400 Subject: [PATCH] Add README.md Former-commit-id: ba2ae540fd51330e4814ce8b8999d7f11b0bee53 --- .gitignore | 40 ++++-------------------- README.md | 60 ++++++++++++++++++++++++++++++++++++ tools/mwcc_compiler/.gitkeep | 0 3 files changed, 66 insertions(+), 34 deletions(-) create mode 100644 README.md create mode 100644 tools/mwcc_compiler/.gitkeep diff --git a/.gitignore b/.gitignore index a1905ba1..938d8add 100644 --- a/.gitignore +++ b/.gitignore @@ -1,39 +1,11 @@ -.vscode -*.dat -*.exe -*.dll -*.idb -*.id0 -*.id1 -*.id2 -*.nam -*.til -*.o -*.out -*.elf +__pycache__/ *.dol -*.a -*.d -*.map -*.exe *.dump -*.7z -*.bat -*.sln -*.filters -*.vcxproj -*.user -include/*.s - +*.exe +*.map build/ -tools/mwcc_compiler/ +ctx.c tools/elf2dol tools/elf2rel -decomp/ -errors.txt -output.asm -Debug/ -.vs/ -__pycache__/ - -ctx.c +tools/mwcc_compiler/* +!tools/mwcc_compiler/.gitkeep diff --git a/README.md b/README.md new file mode 100644 index 00000000..cb627c94 --- /dev/null +++ b/README.md @@ -0,0 +1,60 @@ +Metroid Prime +============= + +A decompilation of Metroid Prime (USA v0-00). + +This repository builds the following DOL: + +``` +949c5ed7368aef547e0b0db1c3678f466e2afbff build/mp1.0/main.dol +``` + +Dependencies +============ + +Windows: +-------- +- Install [devkitPro](https://github.com/devkitPro/installer/releases/latest) with GameCube development package. +- Open `C:\devkitPro\msys2\msys2.exe` +- Run the following: + ``` + pacman -Sy --noconfirm --needed msys2-keyring + pacman -Su --noconfirm --needed gcc git gamecube-dev + ```` + +macOS: +------ +- Install wine: + ``` + brew tap gcenx/wine + brew install wine-crossover + sudo xattr -r -d com.apple.quarantine "/Applications/Wine Crossover.app" + ``` +- Install [devkitPro](https://github.com/devkitPro/pacman/releases/latest). +- Run the following: + ``` + sudo dkp-pacman -Syu --noconfirm --needed gamecube-dev + ``` + +Linux: +------ +- Install wine from your package manager. +- Install [devkitPro](https://devkitpro.org/wiki/devkitPro_pacman). +- Run the following: + ``` + sudo dkp-pacman -Syu --noconfirm --needed gamecube-dev + ``` + +Building +======== + +- Checkout the repository: + ``` + git clone https://github.com/PrimeDecomp/prime.git + ``` +- Download [GC_WII_COMPILERS.zip](https://cdn.discordapp.com/attachments/727918646525165659/917185027656286218/GC_WII_COMPILERS.zip) +- Extract the contents of the `GC` directory to `tools/mwcc_compiler` +- Build: + ``` + make -j + ``` \ No newline at end of file diff --git a/tools/mwcc_compiler/.gitkeep b/tools/mwcc_compiler/.gitkeep new file mode 100644 index 00000000..e69de29b