mirror of
https://github.com/rwengine/openrw.git
synced 2024-10-06 09:07:19 +02:00
81 lines
2.0 KiB
Markdown
81 lines
2.0 KiB
Markdown
# OpenRW
|
||
|
||
OpenRW is a re-implementation of Rockstar Games' Grand Theft Auto III, a classic 3D action
|
||
game first published in 2001.
|
||
|
||
This project requires a legitimate copy of the original PC game data in order to run. Without
|
||
this data it will not be possible to use openrw.
|
||
|
||
## Building
|
||
|
||
Dependencies:
|
||
|
||
* Bullet
|
||
* GLM (0.9.5+)
|
||
* SFML (2.0+)
|
||
* Boost Test
|
||
|
||
Global Options:
|
||
|
||
* BUILD_TESTS — Builds the test suite
|
||
* BUILD_TOOLS — Builds the rwviewer application
|
||
* BUILD\_OLD\_TOOLS – Builds old, unmaintained tools (datadump & analyzer)
|
||
|
||
### Recomended build
|
||
|
||
```
|
||
$ mkdir build
|
||
$ cd build
|
||
$ cmake ../
|
||
```
|
||
|
||
## Running
|
||
|
||
Once compiled, set the environment variable `OPENRW_GAME_PATH` to the directory containing "gta3.exe" and run the rwgame executable.
|
||
|
||
### rwgame
|
||
|
||
This is the game binary
|
||
|
||
* Options:
|
||
* env: OPENRW\_GAME\_PATH, must be set to the folder containing "gta3.exe"
|
||
* -w **n**, -h **n** sets initial window size
|
||
* --newgame starts a new game automatically
|
||
|
||
### rwviewer
|
||
|
||
This Qt application enables viewing of the game data files and models.
|
||
|
||
## Documentation
|
||
|
||
Run Doxygen on the included Doxyfile to generate documentation.
|
||
|
||
## License
|
||
|
||
This program is free software: you can redistribute it and/or modify
|
||
it under the terms of the GNU General Public License as published by
|
||
the Free Software Foundation, either version 3 of the License, or
|
||
(at your option) any later version.
|
||
|
||
This program is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
GNU General Public License for more details.
|
||
|
||
You should have received a copy of the GNU General Public License
|
||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
### Third Party Licenses
|
||
|
||
MAD is licensed under the GNU General Public License
|
||
|
||
* http://www.underbit.com/products/mad/
|
||
|
||
SFML is licensed under the zlib license
|
||
|
||
* http://www.sfml-dev.org/license.php
|
||
|
||
Bullet Physics is licensed under the zlib license
|
||
|
||
* http://bulletphysics.org/mediawiki-1.5.8/index.php/LICENSE
|