diff --git a/README.md b/README.md index db13288a..278fe7e4 100644 --- a/README.md +++ b/README.md @@ -6,15 +6,70 @@ re3 a fully reversed source code for GTA III. This project was started by [Stefanos Kornilios Mitsis Poiitidis](https://x.com/poiitidis) and uses [KallistiOS](https://kos-docs.dreamcast.wiki/). -## Building +## Baking the CDI +### Prerequisites +You need GTA 3 installed. This version has been tested and works: https://store.rockstargames.com/game/buy-grand-theft-auto-the-trilogy. -dca3 requires PC game assets to work, so you **must** have GTA III. We have tested the 2cd version, others might work. +Please note that *SOME VERSIONS* of the game may not work. It has been reported that `d4_gta.mp3` is corrupted sometimes. -You need to have installed: +Make sure you have a LEGIT copy with no corrupted files, as this process wont work otherwise. -- GTA III PC -- [DreamSDK R3](https://github.com/dreamsdk/dreamsdk/releases/tag/r3-3.0.4.2311) -- more instructions to follow soon +You will also need the following tools installed +- git-scm http://git-scm.com/downloads/win +- dreamsdk r3 https://github.com/dreamsdk/dreamsdk/releases + +### Preparing the gta3 folder +- Open dreamsdk shell +- type `mkdir gta3` (and press enter) +- type `explorer .` (and press enter) +- This will open a folder named gta3. Copy your gta3 files in there. + - If you use the 2cdrom version of the game, make sure to also copy the contents of the play disc to this folder. +- close the folder and the dreamsdk shell and proceed to the next step. + +### Cloning the dca3-game repo and downloading the prebuilt elf +- Open dreamsdk shell +- type `git clone https://gitlab.com/skmp/dca3-game.git` (and press enter) +- It should take a moment and successfully clone the repo +- type `cd dca3-game/dreamcast` (and press enter) +- type `explorer .` (and press enter). +- A folder named dreamcast with some files should be open. Keep it on the side. +- Download the artifacts from https://gitlab.com/skmp/dca3-game/-/jobs/8725216645 +- Open artifacts.zip and extract dca3.elf to the folder that was kept open before. +- Close the folder and dreamsdk shell + +### Repacking and making a prebuilt cdi FOR GD-EMU +- Open dreamsdk shell +- type `cd dca3-game/dreamcast` (and press enter) +- type `make cdi-prebuilt` (and press enter) + - This should take a while (5-15 mins) + - Due to an issue with dreamsdk, this won't fully complete the first time +- type `make cdi-prebuilt` (and press enter) + - It will continue where it left off before + - It should run to completion now and show "*** Repack Completed Successfully ***" +- type `explorer .` (and press enter) +- The dreamcast folder should open up, and it should contain dca3.cdi for you (~ 900 megs) + +### Repacking and making a prebuilt cdi FOR burning CD-ROM +- Open dreamsdk shell +- type `cd dca3-game/dreamcast` (and press enter) +- type `make FOR_DISC=1 cdi-prebuilt` (and press enter) + - This should take a while (5-15 mins) + - Due to an issue with dreamsdk, this won't fully complete the first time +- type `make FOR_DISC=1 cdi-prebuilt` (and press enter) + - It will continue where it left off before + - It should run to completion now and show "*** Repack Completed Successfully ***" +- type `explorer .` (and press enter) +- The dreamcast folder should open up, and it should contain dca3.cdi for you (~ 700 megs) +- If the .cdi is not 700 megabytes, then you did something wrong. + - You can type `rm -rf repack-data` (and press enter) + - And then start this step from the beggining + + +## How to report issues +- Take a photo of your tv/monitor and vmu +- open a ticket via https://gitlab.com/skmp/dca3-game/-/issues/new +- state which elf you have used (eg, https://gitlab.com/skmp/dca3-game/-/jobs/8725216645) +- write something descriptive of what is/went wrong ## License