https://github.com/plowteam/donut
Open source reimplementation of The Simpsons: Hit & Run
https://github.com/plowteam/donut
and c-plus-plus donut foss hit open-source run simpsons
Last synced: 17 days ago
JSON representation
Open source reimplementation of The Simpsons: Hit & Run
- Host: GitHub
- URL: https://github.com/plowteam/donut
- Owner: plowteam
- License: gpl-3.0
- Created: 2019-07-06T00:51:35.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-27T15:44:58.000Z (about 1 year ago)
- Last Synced: 2025-03-27T17:55:57.499Z (22 days ago)
- Topics: and, c-plus-plus, donut, foss, hit, open-source, run, simpsons
- Language: C++
- Homepage:
- Size: 6.42 MB
- Stars: 430
- Watchers: 21
- Forks: 28
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Authors: AUTHORS.md
Awesome Lists containing this project
- awesome-game-remakes - donut - Reimplementation of The Simpsons: Hit & Run in modern C++ and modern OpenGL. (Action)
README
# donut
[](https://github.com/plowteam/donut/stargazers)
[](https://discord.gg/U7jFGJKuW4)
[](LICENSE.md)
donut is an open source reimplementation of [The Simpsons: Hit & Run](https://en.wikipedia.org/wiki/The_Simpsons:_Hit_&_Run)
written in modern C++ and modern OpenGL.
You still need to have the original game assets in order to use this.
---
# Building
Clone the code using: `git clone --recursive https://github.com/plowteam/donut.git`
The simplest way to obtain all the required dependencies is through [vcpkg](https://github.com/Microsoft/vcpkg).
```bash
PS> .\vcpkg install sdl2 bullet3 openal-soft fmt
Linux:~/$ ./vcpkg install sdl2 bullet3 openal-soft fmt
```
If you don't want to use vcpkg; CMake will fallback on installed system dependencies, or manually specified
package directories.
## Windows
* Install [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/)
* Install [CMake](https://cmake.org/download/)
You can either:
1. [Open the `donut` folder directly in Visual Studio](https://docs.microsoft.com/en-us/cpp/build/cmake-projects-in-visual-studio?view=vs-2019).
2. Or generate project files with the following:
```bash
cd donut
cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows
```
## Linux
*Note: These instructions are for Ubuntu, but can be easily applied to other distros.*
Ensure you have dependencies first
```bash
sudo apt install cmake
cd donut
cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux
cmake --build build -j 5
```
**Mesa drivers on Linux:** if you are trying to run with Mesa drivers and are getting issues with OpenGL context try messing with `MESA_GL_VERSION_OVERRIDE` when running like so: `MESA_GL_VERSION_OVERRIDE=4.3FC MESA_GLSL_VERSION_OVERRIDE=430 bin/donut`
## Docs
* [Chunks](dev/Chunks.md)
* [Commands](dev/Commands.md)
## Contributing
Contributions are always welcome, whether it's modifying source code to add new
features or bug fixes, documenting new file formats or simply editing some
grammar.
You can also join the [Discord for development discussion]((https://discord.gg/xpdbWzG))
if you are unsure of anything.
## License
donut is released as open source software under the [GPL v3](https://opensource.org/licenses/gpl-3.0.html)
license, see the [LICENSE.md](./LICENSE.md) file in the project root for the full license text.