Skip to content

Developer Setup

JaXt0r edited this page Jan 4, 2026 · 4 revisions

Setup

Troubleshooting

Q: When I start UnityEditor for the first time, I receive the following error: The type or namespace name 'HurricaneVR' could not be found (are you missing a using directive or an assembly reference?)
A: By default, our project is configured to work with Hurricane VR. To use this paid asset, you need to import your own installation inside /Assets/HurricaneVR. Alternatively, deactivate VR module and switch to Flat module to test the game in certain areas. For this, you need to do the following changes:

  1. You need to deactive UnZENity-VR module compilation via:
    image
    (It will alter /ProjectSettings/ProjectSettings.asset and remove GUZ_HVR_INSTALLED from key Standalone)

  2. Open up the Bootstrap scene and double click on GameManager.DeveloperConfig.
    image

  3. The configured DeveloperConfig.asset will open, where you can change Controls.GameControls from HVR to Flat
    image

  4. Hit start end enjoy Gothic-UnZENity


Q: My Hurricane VR hands are purple
A: The materials need to be converted to Universal Render Pipeline (URP) ones. UnZENity provides a menu for it: UnZENity->VR-> HVR - Convert Materials to URP image

Unity setup hints

  • For local Gothic installation directory, please create file GameSettings.dev.json next inside Assets/StreamingAssets. This file is ignored by git and you need to set its values to make the game run in Unity.
  • Load scene "Bootstrap" in your Editor. Hit play and you're good to go.
  • You can configure the runtime through a GameConfiguration scriptable object (see below).

GameConfiguration

  • One for Production is set by default
  • You can create your own by:
    • Navigating to the Gothic-UnZENity-Core/Resources/GameConfigurations directory in Unity
    • creating a new GameConfiguration object via Right Click > Create > ScriptableObjects > GameConfiguration
    • dragging it into the "Config" inspector-slot of the GameManager scene object
  • Can be edited in the inspector by either selecting it in the file view, or double-clicking its field in the Inspector

Modding Tutorials

Links about common Gothic modding information like how Daedalus works or meshes are set up.

Visuals/Mesh:

Clone this wiki locally