Stefanos Kornilios Mitsis Poiitidis cca7b3c6fa Merge branch 'falco/gainz_phase_2' into 'main'
Phase 2 of Liberty/Mmiami engine+RW SH4 math

See merge request skmp/dca3-game!96
2025-04-04 17:26:28 +00:00
2025-03-09 12:17:42 +02:00
2025-03-31 15:05:06 +02:00
2025-03-31 15:05:06 +02:00
2024-12-26 11:36:13 +02:00
2020-12-08 18:38:49 +01:00
2025-03-09 23:22:22 +02:00
2024-12-26 11:36:13 +02:00
2025-04-01 05:58:55 +00:00

Intro

dca3 is a port of GTA III/VC for the Dreamcast made by The Gang, using re3 as a base.

re3 a fully reversed source code for GTA III/VC.

This project was started by Stefanos Kornilios Mitsis Poiitidis and uses KallistiOS.

Baking the CDI

Prerequisites

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.

Make sure you have a LEGIT copy with no corrupted files, as this process wont work otherwise.

You will also need the following tools installed

Cloning the dca3-game repo (this is required once)

  • Open dreamsdk shell
  • 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)
  • 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.
  • 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/liberty (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 liberty beta prebuilt elf from https://gitlab.com/skmp/dca3-game/-/releases/beta
  • Open artifacts.zip and extract dca-liberty.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/liberty (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 dca-liberty.cdi for you (~ 900 megs)

Repacking and making a prebuilt cdi FOR burning CD-ROM

  • Open dreamsdk shell
  • type cd dca3-game/liberty (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 "*** CDI Baked Successfully ***"
  • type explorer . (and press enter)
  • 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.
    • You can type rm -rf repack-data (and press enter)
    • 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

License

The code should only be used for educational, documentation and modding purposes.
We do not encourage piracy or commercial use.
Please keep derivate work open source and give proper credit.

Description
A port of librw and re3 to the Dreamcast https://dca3.net
Readme 53 MiB
Languages
C++ 86.7%
C 5.9%
Scheme 3.7%
Makefile 3%
Assembly 0.4%
Other 0.1%