This project aims to reimplement the GTA 3 on the Godot Engine.
Currently, this project is able to load the game's map, collision data, etc. at runtime and stream in models and textures as needed.
This repository doesn't contain GTA3 code or files
It's not a 1:1 reimplementation because GTA3 is complex and old, the RenderWare formats needs to be converted to Godot which already is a lot of work.
The story mode is also very complex and time consuming to implement.
The Godot engine loads the GTA3 files at execution by converting them from GTA3 file formats to Godot formats, this conversion is very fast and don't reduce performance.
Currently there's two open-source reimplementations of GTA3:
Both projects use the RenderWare version of GTA3, which is old and limited for improvements.
Our project is more safe to work because we don't use Rockstar Games code, just the GTA3 files that the user needs to add on the project folder.
Beyond legal safety, the RenderWare version used on the GTA3 is old and technically limited for improvements. While the Godot Engine is modern and much more advanced, also easier to make contributions.
If we successfully load most GTA3 formats, we could start a GTA San Andreas reimplementation on the Godot engine.
Why? because the GTA San Andreas formats are an evolution of the GTA3 formats, thus part of the GTA3 format converter code can be reused.
Similar to what the San Andreas Unity project did, but the Unity engine is closed-source and proprietary.
The Godot engine allows you to save a lot of time in development because of the node system, where the relationship between the game components is very easily and fast to implement things.
Also because of GDScript, the Godot scripting language allows you to write less code to implement things.
You can watch the demo video on this link.
- Download this repository
- Paste the GTA3 files inside the
gtafolder of the repository - Open the Godot Engine and run the default scene
- Download this repository
- Open the Godot Engine
- Export the executable
- Paste the GTA3 files on the same folder of the executable
- Arrow Keys/WASD - Move the player
- Z - Control the car headlights
- X - Control the internal car light
- Space - Play/Pause music
- = - Increase the music volume
-
-
- Decrease the music volume
-
- N - Enable the night
- F - Enable full-screen
- Properly verify if the GTA3 files are present before execution
- Configure the player model and texture on the map
- Load the vehicles
- Load the weapons
- Load the NPCs
- Load the animations
- Add controls on the player
- Add controls on vehicles
- Configure the weapons
- Add Day and Night cycle
- Add shadows
- Add rain
- Add the Sun on the sky
- Add the Moon on the sky
- Support modding
- Multiplayer (WIP, almost working)
The most advanced and complete website for GTA documentation is the GTAMods Wiki, you can read it on this link.
If you want to send a bug report, open an issue with "(Bug)" before the title.
If you have a feature request, open an issue with "(Feature request)" before the title.
If you have a suggestion, open an issue with "(Suggestion)" before the title.
- Download the repository and game assets
git clone https://github.com/FOSS-Supremacy/re3-gd- Download the Godot Engine 4.x version (normal variant, not C#)
- Export the executable to your operating system
- Give a star to this repository, it will increase our chances to receive contributions.
- Download the Godot Engine 4.x version (normal variant, not C#)
- Verify the open issues and select some item to work on
- Once ready, send a pull request (if you are adding commits on the PR branch, mark it as draft status)
- Send the link of your pull requests on the "Pull Requests" channel/room on Discord or Matrix.
- We don't accept C# code
- New assets needs to be licensed as Creative Commons
- Don't distribute or send GTA3 files here, all PRs containing this will be closed, if the contributor do it again he/she will be banned from the repository
If you want to support our work, consider a donation, every amount is important.
bc1qg9x5vzr4ppkm2ssw5k7ete4lu49wg7t02azkce
We thank atirut-w a lot for writting the GTA3 loader and configuring the project scenes, this project wouldn't be possible without his work.
