mirror of
https://gitlab.com/skmp/dca3-game.git
synced 2025-04-28 13:07:59 +03:00
Edit README.md for beta instructions
Some checks failed
re3 conan+cmake / build-cmake (openal, glfw, macos-latest, gl3) (push) Has been cancelled
re3 conan+cmake / build-cmake (openal, glfw, ubuntu-18.04, gl3) (push) Has been cancelled
re3 conan+cmake / build-cmake (openal, glfw, windows-latest, gl3) (push) Has been cancelled
re3 conan+cmake / build-cmake (openal, windows-latest, d3d9) (push) Has been cancelled
re3 cmake devkitA64 (Nintendo Switch) / build-nintendo-switch (push) Has been cancelled
re3 premake amd64 / build (Debug, win-amd64-librw_d3d9-oal) (push) Has been cancelled
re3 premake amd64 / build (Debug, win-amd64-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake amd64 / build (Release, win-amd64-librw_d3d9-oal) (push) Has been cancelled
re3 premake amd64 / build (Release, win-amd64-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_d3d9-mss) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_d3d9-oal) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_gl3_glfw-mss) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_d3d9-mss) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_d3d9-oal) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_gl3_glfw-mss) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_d3d9-mss) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_d3d9-oal) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_gl3_glfw-mss) (push) Has been cancelled
Some checks failed
re3 conan+cmake / build-cmake (openal, glfw, macos-latest, gl3) (push) Has been cancelled
re3 conan+cmake / build-cmake (openal, glfw, ubuntu-18.04, gl3) (push) Has been cancelled
re3 conan+cmake / build-cmake (openal, glfw, windows-latest, gl3) (push) Has been cancelled
re3 conan+cmake / build-cmake (openal, windows-latest, d3d9) (push) Has been cancelled
re3 cmake devkitA64 (Nintendo Switch) / build-nintendo-switch (push) Has been cancelled
re3 premake amd64 / build (Debug, win-amd64-librw_d3d9-oal) (push) Has been cancelled
re3 premake amd64 / build (Debug, win-amd64-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake amd64 / build (Release, win-amd64-librw_d3d9-oal) (push) Has been cancelled
re3 premake amd64 / build (Release, win-amd64-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_d3d9-mss) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_d3d9-oal) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_gl3_glfw-mss) (push) Has been cancelled
re3 premake x86 / build (Debug, win-x86-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_d3d9-mss) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_d3d9-oal) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_gl3_glfw-mss) (push) Has been cancelled
re3 premake x86 / build (Release, win-x86-librw_gl3_glfw-oal) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_d3d9-mss) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_d3d9-oal) (push) Has been cancelled
re3 premake x86 / build (Vanilla, win-x86-librw_gl3_glfw-mss) (push) Has been cancelled
This commit is contained in:
Stefanos Kornilios Mitsis Poiitidis
parent
a31d73d2e4
commit
67cd1106ab
1 changed files with 77 additions and 20 deletions
97
README.md
97
README.md
|
|
@ -1,14 +1,14 @@
|
||||||
## Intro
|
## Intro
|
||||||
|
|
||||||
dca3 is a port of GTA III for the Dreamcast made by The Gang, using [re3](https://github.com/halpz/re3/tree/master/) as a base.
|
dca3 is a port of GTA III/VC for the Dreamcast made by The Gang, using [re3](https://github.com/halpz/re3/tree/master/) as a base.
|
||||||
|
|
||||||
re3 a fully reversed source code for GTA III.
|
re3 a fully reversed source code for GTA III/VC.
|
||||||
|
|
||||||
This project was started by [Stefanos Kornilios Mitsis Poiitidis](https://x.com/poiitidis) and uses [KallistiOS](https://kos-docs.dreamcast.wiki/).
|
This project was started by [Stefanos Kornilios Mitsis Poiitidis](https://x.com/poiitidis) and uses [KallistiOS](https://kos-docs.dreamcast.wiki/).
|
||||||
|
|
||||||
## Baking the CDI
|
## Baking the CDI
|
||||||
### Prerequisites
|
### Prerequisites
|
||||||
You need GTA 3 installed. This version has been tested and works: https://store.rockstargames.com/game/buy-grand-theft-auto-the-trilogy.
|
You need Grand Theft Auto III or Grand Theft Auto: Vice City installed. This version has been tested and works: https://store.rockstargames.com/game/buy-grand-theft-auto-the-trilogy.
|
||||||
|
|
||||||
Please note that *SOME VERSIONS* of the game may not work. It has been reported that `d4_gta.mp3` is corrupted sometimes.
|
Please note that *SOME VERSIONS* of the game may not work. It has been reported that `d4_gta.mp3` is corrupted sometimes.
|
||||||
|
|
||||||
|
|
@ -18,28 +18,33 @@ You will also need the following tools installed
|
||||||
- git-scm http://git-scm.com/downloads/win
|
- git-scm http://git-scm.com/downloads/win
|
||||||
- dreamsdk r3 https://github.com/dreamsdk/dreamsdk/releases
|
- dreamsdk r3 https://github.com/dreamsdk/dreamsdk/releases
|
||||||
|
|
||||||
### Preparing the gta3 folder
|
### Cloning the dca3-game repo (this is required once)
|
||||||
- Open dreamsdk shell
|
- Open dreamsdk shell
|
||||||
- type `mkdir gta3` (and press enter)
|
- type `git clone --branch beta https://gitlab.com/skmp/dca3-game.git` (and press enter).
|
||||||
|
- It should take a moment and successfully clone the repo
|
||||||
|
- close the dreamsdk shell and proceed to the next step.
|
||||||
|
|
||||||
|
### Grand Theft Auto III build (liberty)
|
||||||
|
#### Preparing the liberty folder
|
||||||
|
- Open dreamsdk shell
|
||||||
|
- type `mkdir liberty` (and press enter)
|
||||||
- type `explorer .` (and press enter)
|
- type `explorer .` (and press enter)
|
||||||
- This will open a folder named gta3. Copy your gta3 files in there.
|
- This will open a folder named liberty. 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.
|
- 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.
|
- close the folder and the dreamsdk shell and proceed to the next step.
|
||||||
|
|
||||||
### Cloning the dca3-game repo and downloading the prebuilt elf
|
#### Downloading and extracting the prebuilt elf
|
||||||
- Open dreamsdk shell
|
- Open dreamsdk shell
|
||||||
- type `git clone --branch alpha https://gitlab.com/skmp/dca3-game.git` (and press enter)
|
- type `cd dca3-game/liberty` (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).
|
- type `explorer .` (and press enter).
|
||||||
- A folder named dreamcast with some files should be open. Keep it on the side.
|
- A folder named dreamcast with some files should be open. Keep it on the side.
|
||||||
- Download the Alpha Prebuilt Elf from https://gitlab.com/skmp/dca3-game/-/jobs/8725216645
|
- Download the *liberty* beta prebuilt elf from https://gitlab.com/skmp/dca3-game/-/releases/beta
|
||||||
- Open artifacts.zip and extract dca3.elf to the folder that was kept open before.
|
- Open artifacts.zip and extract dca-liberty.elf to the folder that was kept open before.
|
||||||
- Close the folder and dreamsdk shell
|
- Close the folder and dreamsdk shell
|
||||||
|
|
||||||
### Repacking and making a prebuilt cdi FOR GD-EMU
|
#### Repacking and making a prebuilt cdi FOR GD-EMU
|
||||||
- Open dreamsdk shell
|
- Open dreamsdk shell
|
||||||
- type `cd dca3-game/dreamcast` (and press enter)
|
- type `cd dca3-game/liberty` (and press enter)
|
||||||
- type `make cdi-prebuilt` (and press enter)
|
- type `make cdi-prebuilt` (and press enter)
|
||||||
- This should take a while (5-15 mins)
|
- This should take a while (5-15 mins)
|
||||||
- Due to an issue with dreamsdk, this won't fully complete the first time
|
- Due to an issue with dreamsdk, this won't fully complete the first time
|
||||||
|
|
@ -47,28 +52,80 @@ You will also need the following tools installed
|
||||||
- It will continue where it left off before
|
- It will continue where it left off before
|
||||||
- It should run to completion now and show "*** Repack Completed Successfully ***"
|
- It should run to completion now and show "*** Repack Completed Successfully ***"
|
||||||
- type `explorer .` (and press enter)
|
- type `explorer .` (and press enter)
|
||||||
- The dreamcast folder should open up, and it should contain dca3.cdi for you (~ 900 megs)
|
- The dreamcast folder should open up, and it should contain dca-liberty.cdi for you (~ 900 megs)
|
||||||
|
|
||||||
### Repacking and making a prebuilt cdi FOR burning CD-ROM
|
#### Repacking and making a prebuilt cdi FOR burning CD-ROM
|
||||||
- Open dreamsdk shell
|
- Open dreamsdk shell
|
||||||
- type `cd dca3-game/dreamcast` (and press enter)
|
- type `cd dca3-game/liberty` (and press enter)
|
||||||
- type `make FOR_DISC=1 cdi-prebuilt` (and press enter)
|
- type `make FOR_DISC=1 cdi-prebuilt` (and press enter)
|
||||||
- This should take a while (5-15 mins)
|
- This should take a while (5-15 mins)
|
||||||
- Due to an issue with dreamsdk, this won't fully complete the first time
|
- Due to an issue with dreamsdk, this won't fully complete the first time
|
||||||
- type `make FOR_DISC=1 cdi-prebuilt` (and press enter)
|
- type `make FOR_DISC=1 cdi-prebuilt` (and press enter)
|
||||||
- It will continue where it left off before
|
- It will continue where it left off before
|
||||||
- It should run to completion now and show "*** Repack Completed Successfully ***"
|
- It should run to completion now and show "*** CDI Baked Successfully ***"
|
||||||
- type `explorer .` (and press enter)
|
- type `explorer .` (and press enter)
|
||||||
- The dreamcast folder should open up, and it should contain dca3.cdi for you (~ 700 megs or ~260 megs)
|
- The dreamcast folder should open up, and it should contain dca-liberty.cdi for you (~ 700 megs or ~260 megs)
|
||||||
- If the .cdi is not ~ 700 megs (linux/mkdcdisc) or ~260 megs (windows/cdi4dc), then you did something wrong.
|
- If the .cdi is not ~ 700 megs (linux/mkdcdisc) or ~260 megs (windows/cdi4dc), then you did something wrong.
|
||||||
- You can type `rm -rf repack-data` (and press enter)
|
- You can type `rm -rf repack-data` (and press enter)
|
||||||
- And then start this step from the beggining
|
- And then start this step from the beggining
|
||||||
|
|
||||||
|
### Grand Theft Auto Vice City build (miami)
|
||||||
|
#### Preparing the miami folder
|
||||||
|
- Open dreamsdk shell
|
||||||
|
- type `mkdir miami` (and press enter)
|
||||||
|
- type `explorer .` (and press enter)
|
||||||
|
- This will open a folder named liberty. Copy your gtavc files in there.
|
||||||
|
- close the folder and the dreamsdk shell and proceed to the next step.
|
||||||
|
|
||||||
|
#### Downloading and extracting the prebuilt elf
|
||||||
|
- Open dreamsdk shell
|
||||||
|
- type `cd dca3-game/miami` (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 *miami* beta prebuilt elf from https://gitlab.com/skmp/dca3-game/-/releases/beta
|
||||||
|
- Open artifacts.zip and extract dca-miami.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/miami` (and press enter)
|
||||||
|
- type `FOR_DISC=2 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 `FOR_DISC=2 make cdi-prebuilt` (and press enter)
|
||||||
|
- It will continue where it left off before
|
||||||
|
- You will have to close the dreamshell window a few times and restart this procesure a few times
|
||||||
|
- Eventually it should run to completion now and show "*** CDI Baked Successfully ***"
|
||||||
|
- type `explorer .` (and press enter)
|
||||||
|
- The dreamcast folder should open up, and it should contain dca-miami.cdi for you (~ 1.5 gigs)
|
||||||
|
|
||||||
|
#### Repacking and making a prebuilt cdi FOR burning CD-ROM
|
||||||
|
- Open dreamsdk shell
|
||||||
|
- type `cd dca3-game/miami` (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 dca-miami.cdi for you (~700 or ~550 megs)
|
||||||
|
|
||||||
|
## Running on emulators
|
||||||
|
You must have the 'trails' options turned off from the graphics settings, or a white overlay may appear over the 3d render
|
||||||
|
|
||||||
|
## Fine tuning settings
|
||||||
|
Two experimental modes, 24 bpp (640x480x24) and Anti Aliasing are provided in the Graphics settings.
|
||||||
|
|
||||||
|
- When using HDMI or VGA out, it is recommended to turn enable 24 bpp mode. Note that you also have to disable the 'trails' effect.
|
||||||
|
- Anti Aliasing will work with or without trails, however trails enabled will have a bigger performance hit in that mode.
|
||||||
|
|
||||||
|
Enabling any of those modes may result in some missing geometry under heavy scenes (more likely with AA mode).
|
||||||
|
They can also be combined.
|
||||||
|
|
||||||
## How to report issues
|
## How to report issues
|
||||||
- Take a photo of your tv/monitor and vmu
|
- Take a photo of your tv/monitor and vmu
|
||||||
- open a ticket via https://gitlab.com/skmp/dca3-game/-/issues/new
|
- 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
|
- write something descriptive of what is/went wrong
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue