G-Engine is a C++ game engine that is capable of reading and using the data files from the 3D adventure game Gabriel Knight 3: Blood of the Sacred, Blood of the Damned (GK3), developed and published by Sierra Studios in 1998.
The goal of this project is to create a cross-platform game engine that can be used to play GK3. The original game only supported Windows, and it is also a bit buggy on modern hardware. Since GK3 is a heavily data-driven game, the idea is to build a newer, more modern engine that can use the original's data files. Completely new features can also be implemented.
See my blog post introducing the project for more in-depth info!
Currently, the project only builds and runs in Xcode as a command line project. Simply download, open in Xcode, and build/run.
Supporting new platforms or build tools should be as easy as creating the necessary build tool files and making sure all required libraries are implemented on those platforms (see below).
GK3 Data Files
This repository does not contain the data files from the game, since those are copyrighted material. You will need to obtain a copy of GK3 (available on Steam or GOG) to get the data files.
The following data files are needed at the moment; copy them into the "Assets" folder before building/running:
The engine currently uses the following libraries:
All library files are included in the repo, so no software need be installed before running the game.
This project uses Catch for unit tests.
The Xcode project contains a build target called GEngine-Tests. Simply build and run this target to run all defined unit tests.
- SDL - My training wheels for cross-platform OS polling, rendering, and input
- fmod - Made SFX and music way easier than I thought possible
- zlib - For GK3 asset decompression
- minilzo - Also for GK3 asset decompression
G-Engine is kind of a pet project of mine, and I'm using it primarily as a learning tool. As such, I am not actively looking for contributions.
That being said, if you are interested in contributing, shoot me an email and we can discuss!
This project is licensed under the GNU GPLv3 License - see the LICENSE.md file for details.
- Sierra On-Line, who inspired me as a kid, and still do today
- GK3 Tools, which provided some guidance on BRN, BSP, and ACT file formats