Installation Steps for Gothic 1

Check the installation requirements first.

Usage (Important!)

By using these scripts, you agree to the terms of the MIT License and need to include the license as well as visible mentions of the original author when redistributing your source code.

Please respect my efforts and accredit my work in your project accordingly by visibly mentioning the name of the project, the original author and a link to this repository, i.e:

Gothic Free Aim by mud-freak (@szapp) https://github.com/szapp/GothicFreeAim

Installation Steps for Gothic 1

1. Make sure Ikarus and LeGo are installed and parsed in _work\data\Scripts\Content\Gothic.src.

2. Copy all files from this repository into your Gothic installation. Mind the relative paths. Do not forget the binary files (GFA_Textures.zip) that come with the release.

3. Have the files parsed:

   • In _work\data\Scripts\Content\Gothic.src, somewhere after Ikarus, LeGo and ANIMS\FOCUS.D, add

     GFA\GFA_G1.src
     

   • In _work\data\Scripts\System\Camera.src, at the end, add

     Camera\CamInstGFA.d
     

   • In _work\data\Scripts\System\ParticleFX.src, at the end, add

     PFX\PfxInstGFA_G1.d
     

   • In _work\data\Scripts\System\SFX.src, at the end, add

     SFX\SfxInstGFA.d
     

   • In _work\data\Scripts\System\VisualFX.src, at the end, add

     VisualFX\VisualFxInstGFA.d
     

   • In _work\data\Scripts\System\Menu.src, between _intern\menu.d and menu\menu_main.d, add

     Menu\Menu_Opt_Game_GFA.d
     

4. Add a new menu entry to the options game menu. With this users can enable and disable free aiming from the options menu. Keep in mind, that there are still players preferring keyboard controls over mouse. Free aiming will always be possible to disable in the Gothic.ini file.

   • In _work\data\Scripts\System\Menu\Menu_Opt_Game.d find items[XX] = "MENUITEM_GAME_BACK"; in the instance MENU_OPT_GAME and change it to

     items[XX]       = "MENUITEM_OPT_GFA";
     items[XX+1]     = "MENUITEM_OPT_GFA_CHOICE";
     
     items[XX+2]     = "MENUITEM_GAME_BACK";

     By default, XX is 13 and it should look like this afterwards:

     items[13]       = "MENUITEM_OPT_GFA";
     items[14]       = "MENUITEM_OPT_GFA_CHOICE";
     
     items[15]       = "MENUITEM_GAME_BACK";

   • In the same file find posy = MENU_BACK_Y; in the instance MENUITEM_GAME_BACK and change it to

     posy = MENU_BACK_Y+300;

   • In _work\data\Scripts\System\Menu\Menu_Opt_Game_GFA.d set the constant MENU_ID_GFA to the next available slot in the menu, typically (XX-1)/2+1 which is 7 by default. For example:

     const int  MENU_ID_GFA      = 7; // Next available Y-spot in the menu

   • In the same file you might have to adjust the menu labels. By default they are in German.

5. In _work\data\Scripts\Content\Story\Startup.d find the function INIT_Global(). If you do not have that function yet, create it and call it from all INIT_*() functions in that file (not the INIT_SUB_*() functions!). Inside, either somewhere after Ikarus and LeGo or instead of them, initialize Gothic Free Aim with

   GFA_Init(GFA_ALL);

   GFA_ALL will enable all features that come with this script package. You can disable features like so

   GFA_Init(GFA_ALL & ~GFA_REUSE_PROJECTILES);

   Read on here to find out more about the different features.
    
   If you initialize LeGo before GFA, make sure to do so with the necessary LeGo packages for GFA (LeGo_All is not enough!): Required Lego Packages.

6. Make sure you have the following three files.
   _work\data\Anims\Humans.mds
_work\data\Anims\MDS_Overlay\Humans_BowT2.mds
_work\data\Anims\MDS_Overlay\Humans_CBowT2.mds
   If not, extract them from Data\anims.VDF with the GothicVDFS-tool of the mod development kit.

7. In _work\data\Anims\Humans.mds add the lines as indicated in _work\data\Anims\Humans.mds.additions. Make sure you add the lines before the two closing brackets "} }" at the end of the file.
   Do the same analogous for _work\data\Anims\MDS_Overlay\Humans_BowT2.mds.additions and _work\data\Anims\MDS_Overlay\Humans_CBowT2.mds.additions.

   For Gothic to detect the changes to the animation files, tick VDFS physical first in the GothicStarter_mod.exe. (This won't be necessary once you pack everything into a mod-file in your final mod.)

After parsing the scripts, GFA should be fully implemented. Read on here to find out how to adjust GFA to your preferences.