Ninja

This repository contains the source code of the Ninja extension for Gothic 1 and Gothic 2 NotR.

If you are interested in developing patches with Ninja, please follow the instructions in the relevant chapters of the documentation.

About

For information on Ninja, please visit the documentation.

Usage

To use Ninja, download and install the latest release. If you run into issues or need further instructions, please consult the documentation.

Building from Source

There is absolutely no need to assemble Ninja yourself as the latest build is always available for download.

Nevertheless, if you wish to do so anyway, not all resources necessary for building are supplied in this repository and you'll not be able to successfully build it. The purpose of this repository is merely to provide insight into the source code. The additional resources may be provided upon request.

Requirements

Because of linking a Windows DLL, assembling this project is no longer possible under *nix but is exclusive to Windows. (All *nix shell scripts have been stripped from this project, but may still be found in the git history.) For linking the final DLL the following libraries are required on your system.

• User32.dll
• Kernel32.dll
• NtDll.dll

For assembling and building, the following software is required.

• NASM (The Netwide Assembler)
• GoLink (Go Tools for Windows)
• GoRC (Go Tools for Windows)
• NSIS (Nullsoft Scriptable Install System)

Additionally, you'll need various GNU Win32 packages:

• Make
• Grep
• BinUtils for objdump

All binaries of the listed software must be added to your PATH environment variable.

Assembling

Building Ninja consists of a cascade of assembling the core and assembling the DLL wrapper.
First, the core is assembled into binary files. These are then included when assembling the wrapper which is then finally linked into a DLL.

The reason for this compartmentalization is to separate core and wrapper and to avoid slow absolute (eax) jumps within the executed code by injecting it into the executable at fixed addresses to make use of relative jumps to addresses known at time of assembling.

All the steps above are performed simply with

make

Legal

Ninja is free software and released under the MIT License (MIT).