Troubleshooting (EN)

Show this page in German

If a patch does not seem to work properly, this might be due to incompatibilities. If you can manage to get into the game, first try to confirm that Ninja is active (see Confirm That Ninja is Active) and if the patch is loaded (see Confirm That a Patch is Loaded).

If the game crashes or closes down before that, start the zSpy.exe application (usually in [GothicDirectory]\_work\Tools\zSpy\ or [GothicDirectory]\System\). In Options → Logging, add checkmarks for all categories (information, warnings, faults and critical errors).

Ninja will detect when the zSpy is running and enable logging automatically. Wait for the crash to happen, save the log (File → Save as...) and post it in this forum thread along with information about the used mod and any other active patches. Help is on the way!

Confirm That Ninja is Active

To confirm that Ninja is active, type Ninja into the default in-game console. If Ninja is correctly installed, the current version and build information should be displayed. To confirm the integrity of Ninja you can compare the CRC32 checksum with these valid ones listed in Checksums.

If the game is installed in the program files directory, Ninja requires administrative privileges to properly run.

Confirm That a Patch is Loaded

To confirm, that a patch is loaded, type Ninja into the default in-game console. Below the version information of Ninja, all loaded patches will be displayed. If the patch in question is not displayed, it may either be installed incorrectly or it is not compatible with the mod you are playing.

Entering Ninja PatchName into the console will give you a brief description about the patch named PatchName.

Error Messages

Click to expand and view the explanations.

One of your patches is outdated (Ninja <= 1.2)
or Outdated patch found (Ninja < 2)

One of the installed patches uses an old version of Ninja and is thus outdated. Update or remove that patch to proceed.

Ninja was attached too late (after VDFS)

Ninja is not being loaded correctly. Reinstalling Ninja may fix the problem.
If using Union, make sure Ninja.dll** is added to the PluginList in SystemPack.ini (or Union.ini before Union 1.0h) and Union is updated to version 1.0e or higher. Under normal circumstances, this entry is created automatically when installing Ninja. When using Spine, it is also done automatically and should not be done manually.

Version mismatch of [Ikarus/LeGo]. Ikarus/LeGo must not be contained in any patch.

There is a malformatted patch installed. Remove the patch to continue.

Version mismatch of [Ikarus/LeGo]. Game: [x], Ninja: [y]

Your Ninja version is outdated. Install the newest version found here.