# Required Files to Play

First and foremost, **the re3 team does not condone piracy. You must provide the files contained in your legally bought copies of the game**. Any attempts to request help for pirated copies will be deleted and the authors will be banned.

## Base files from the original game
The re3 project is based around the PC version of the game. The easiest way to get the files is by buying [the Steam version for PC](https://store.steampowered.com/app/12100/Grand_Theft_Auto_III/). You can also use the assets from the CD releases if you have them, but you'll need to install the game first before being able to get the files.

Russian, Polish and Japanese language support is added via re3's package contents, which contains all the required language assets.

To be more precise, you need to get the following folders and their contents from the base PC game:

anim  
Audio  
data  
models  
txd  

At the moment, the re3 project does not play the introduction videos located in the `movies` folder. Also, if you have downloaded a release of the game that requires Miles Sound System for audio playback, you will also need the `mss` folder and its contents and place them in the same folder the re3.exe executable is located.

After that, once again, **make sure you paste and overwrite the contents of the release package onto the folder!** You will not be able to use non-European languages and other new featues without the package.

## Contents of the files included in the release packages

- The `data` folder contains a file required to enable the Free Roam mode, which lets you go around the map with no missions enabled (press and hold the R key on your keyboard while loading or starting a new game)
- The `models` folder contains assets required to display controller button icons on the UI, as well as other minor improvements, such as map support in GTA3.
- The `neo` folder contains assets required to enable post-processing effects, vehicle reflections and other elements (see the [Graphical Settings and New Features](link.html) for more information). These assets are designed to be used with XBOX assets, but some of their effects work on the base PC assets.
- The `text` folder contains updated versions of the game's texts, which are required to display the new menus properly. It also contains updated translations for non-English languages.
- Any additional `.dll`file included in the OpenGL release package is required to be able to boot that particular version of the binaries.

## Can I add the original files from PS2/XBOX to improve the compressed/lesser elements from the PC version?

At this time of writing, only some assets from the PS2 and XBOX releases can be used from the original discs.

### What can I take from the PS2 version of GTA3?

- `anim` folder: Works, but the `ped.ifp` file from PS2 lacks a couple of animations required for player strafing (which is a PC-exclusive action). Unless your build has PC_PLAYER_CONTROLS undefined (defined by default), you will need the PC equivalent. The rest of the PS2 files contain minor changes, such as different camera angles in certain cutscenes, like the intro bank robbery.
- `audio` folder: First and foremost, keep in mind that there might be differences between re3's subtitles and what's being said in the PS2 audio files. That said, re3 needs a number of files from the PC version that have been hardcoded into the game. If you want to use PS2's uncompressed audio files, you will need the following:
- Your EXE file should be compiled with PS2_AUDIO_PATHS (disabled by default).
- You should keep the original PC files, specially the PC versions of `sfx.raw` and `sfx.sdt`.
- If you are using an MSS-enabled version, you will also need to include [VBdec](https://github.com/CookiePLMonster/VBdec) on the root of the game.
- `data` folder: All the PS2's assets can be used, with the exception of files `default.dat` and `cullzone.dat`. If you are using the PS2 assets, make sure you replace `default.dat` and `cullzone.dat` with blank files.
- `models` folder: The only important difference between versions is that the PS2 `models` folder contains different textures than the ones on PC, and also that the weapon icons are gray, rather than yellow. If you want to use the contents of the PS2 `models` folder, make sure you keep files `menu.txd` and `fonts.txd` from the PC version, as well as the files included on re3's package. The PS2 version has multiple redundant copies of GTA3.IMG, so you only need to take the one called `GTA3.IMG`.
- **Make sure you delete `txd.img` and `txd.dir` from your `models` folder before starting the game.**

### What can I take from the PS2 version of Vice City?

- `anim` folder: Works, but the `ped.ifp` file from PS2 lacks a couple of animations required for player strafing (which is a PC-exclusive action). Unless your build has PC_PLAYER_CONTROLS undefined (defined by default), you will need the PC equivalent. The rest of the PS2 files contain minor changes, such as different camera angles in certain cutscenes.
- `audio` folder: First and foremost, keep in mind that there might be differences between reVC's subtitles and what's being said in the PS2 audio files. That said, reVC needs a number of files from the PC version that have been hardcoded into the game. If you want to use PS2's uncompressed audio files, you will need the following:
- Your EXE file should be compiled with PS2_AUDIO_PATHS (disabled by default).
- You should keep the original PC files, specially the PC versions of `sfx.raw` and `sfx.sdt`.
- If you are using an MSS-enabled version, you will also need to include [VBdec](https://github.com/CookiePLMonster/VBdec) on the root of the game.
- `data` folder: All the PS2's assets can be used.
- `models` folder: The only important difference between versions is that the PS2 `models` folder contains textures that are not as heavily compressed as in PC. If you want to use the contents of the PS2 `models` folder, you need to make sure of three things:
- Make sure you keep files `fonts.txd`, `fronten1.txd` and `fronten2.txd` from the PC version.
- Make sure you also keep the files included on reVC's package.
- The PS2 versions of `GTA3.IMG` and `GTA3.DIR` won't work properly out of the box, they need to be converted with the [convcdimage tool](convcdimage.exe). Simply copy the PS2 files to your PC and then drag and drop one of them to the executable and the tool will decompress them onto files `output.img` and `output.dir`. Change their names to GTA3 and you are done.
- **Make sure you delete `txd.img` and `txd.dir` from your `models` folder before starting the game.**

### What can I take from the XBOX version of GTA3?

- `data` folder: If you want to use XBOX's higher-quality models and textures, you need to copy the contents of the `maps` folder. Make sure you start a new game, any previous saved games will crash re3.
- `models` folder: If you want XBOX's higher-quality models and textures, you need to procure files `generic.txd` (overwrite the existing one from re3), as well as `GTA3.IMG` and `GTA3.DIR`. However, these last two files won't work out of the box, as they need to be decompressed with the [convcdimage tool](convcdimage.exe). Simply copy the XBOX files to your PC and then drag and drop one of them to the executable and the tool will decompress them onto files `output.img` and `output.dir`. Change their names to GTA3 and you are done.
- WARNING: Doing this will enable five-fingered hands, but at the time of writing, file `data\cutscenehands.xml`, which handles the finger movement, can not be read, so the fingers will remain at a certain pose. You will also need a copy of the XBOX player skin in your game's skins folder so the playable character's textures won't look wrong.
- **Make sure you delete `txd.img` and `txd.dir` from your `models` folder before starting the game.**

### What can I take from the XBOX version of Vice City?

- `data` folder: If you want to use XBOX's higher-quality models and textures, you need to copy the contents of the `maps` folder. Make sure you start a new game, any previous saved games will crash re3.
- `models` folder: If you want XBOX's higher-quality models and textures, you need to procure files `generic.txd` (overwrite the existing one from reVC), as well as `GTA3.IMG` and `GTA3.DIR`. However, these last two files won't work out of the box, as they need to be decompressed with the [convcdimage tool](convcdimage.exe). Simply copy the XBOX files to your PC and then drag and drop one of them to the executable and the tool will decompress them onto files `output.img` and `output.dir`. Change their names to GTA3 and you are done.
- **Make sure you delete `txd.img` and `txd.dir` from your `models` folder before starting the game.**