REGoth

OpenSource-Reimplementation of the zEngine, used by the game "Gothic" and "Gothic II".

Don't forget to check out the REGoth-Wiki for more information about the project!

A list showing the current state of the engine, can be found here.

Videos showing the current state

Release-Commentary to V0.4:
- https://www.youtube.com/watch?v=DX92f8CrjrE
Release-Commentary to V0.3:
- https://www.youtube.com/watch?v=EjEpN3I8Ovc
Release-Commentary to V0.2:
- https://www.youtube.com/watch?v=jB3pzxd6vIk
Release-Commentary to V0.1.1:
- https://www.youtube.com/watch?v=heg49o78Ii4
Dialogs, Audio, NPC script-states:
- https://www.youtube.com/watch?v=R3F4WY6A060
Day/Night-Cycle and Fighting-animations:
- https://www.youtube.com/watch?v=Z1mlI9qxkzc
First showcase:
- https://www.youtube.com/watch?v=8bLAGttYYpY

Download (Latest stable version)

Version 0.4 (Windows): https://github.com/REGoth-project/REGoth/releases/tag/0.4

Version 0.4 (Android): https://github.com/REGoth-project/REGoth/releases/tag/0.4-android

Automated nightly builds: https://github.com/degenerated1123/REGoth/releases

Source

Make sure to clone this repository with the --recursive flag:

ssh:

git clone --recursive git@github.com:degenerated1123/REGoth.git

https:

git clone --recursive https://github.com/degenerated1123/REGoth.git

To update the repo, you need to make sure to update the submodules as well. Instead of simply pulling the repository, you can do:

git pull --recurse-submodules

Building

Note: If you are missing packages or are having trouble building on your platform, you can check out this wiki-page, which may contain more detailed instructions. If you don't find your platform there, I'd kindly ask you to add some instructions for other people to that wiki-page!

You will need CMake (3.1 or newer) and a C++14-capable compiler. Currently supported/tested are:

GCC (6.x)
MinGW
Visual Studio 2015, 2017

Then:

cd path/to/REGoth
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..

If CMake complains about some folders missing a CMakeLists.txt, you most likely forgot to clone with the --recursive-flag! Simple do git submodule update --init --recursive and it should work.

Then, choose depending on your OS:

Linux, MacOS and other *nix

make -j4

Windows

Starting Visual Studio 2017 you can use the integrated cmake functionality to open the cloned folder.
Check out the how to build wiki page for details on this.

For previous versions of Visual Studio, open the generated REGoth.sln and build as usual.
Alternatively, you may run this command inside of the build folder:

cmake --build . --config release

Running

The compiled files are inside the build/bin directory.

Make sure to copy the content/shaders folder to the working directory of the compiled REGoth-Executable. Then, run the program with the following flags:

REGoth -g "path/to/gothic1or2" -w startworld.zen

Where path/to/gothic1or2 points to the root of a Gothic I or II installation and startworld.zen is one of the Zen-Files found in a .vdf-files in the games data/-directory. For example: newworld.zen or addonworld.zen for Gothic II.

It is recommended to run this from the commandline, to see the debug-output of the program.

Additionally, for a list of possible commands, run REGoth --help.

Controls

Movement: WASD/QE or arrow-keys (Space or Shift to run faster)
Actions: Left CTRL for everything
Menus: B for status-screen
Console: F10
- Available commands (square brackets mean optional argument):
  - tp [<teleporter:default=player>] <target>: Teleport NPC teleporter (= player if none is given) to NPC target
  - goto waypoint <waypoint>: Teleport player to waypoint
  - kill [<npc>]: Kill npc or a nearby NPC if none is given
  - knockout [<npc>]: Knockout npc or a nearby NPC if none is given
  - save <slotindex>: Save the game to the given slot
  - load <slotindex>: Load the game from the given slot
  - switchlevel <zenfile>: Switch to an other level in current session
  - usemana <amount>: Use mana
  - hurtself <amount>: Hurt yourself
  - set clock <hour> [<min:default=0>]: Set time of day to hour:min
  - control <npc>: Take control over npc

Development

If you want to help out and don't know where to start, I suggest reading the wiki-page, which contains information about the engine-layout and lists of which features are missing (Not yet, though!).

Examples

Gothic 1 - Overworld: REGoth -g "path/to/gothic1" -w world.zen

Gothic 1 - Oldmine: REGoth -g "path/to/gothic1" -w oldmine.zen

Gothic 1 - Freemine: REGoth -g "path/to/gothic1" -w freemine.zen

Gothic 1 - Orc graveyard: REGoth -g "path/to/gothic1" -w orcgraveyard.zen

Gothic 1 - Sleeper temple: REGoth -g "path/to/gothic1" -w orctempel.zen

Gothic 2 - Overworld: REGoth -g "path/to/gothic2" -w newworld.zen

Gothic 2 - Valley of mines: REGoth -g "path/to/gothic2" -w oldworld.zen

Gothic 2 - Addonworld: REGoth -g "path/to/gothic2" -w addonworld.zen

Gothic 2 - Dragonisland: REGoth -g "path/to/gothic2" -w dragonisland.zen

versable/REGoth