Documentation	GOTHIC
The INI-file for GothicMODs
Author: Bert Speckels	Version: July 26th 2001

Content:

back to index

Every Gothic mod is represented through a INI file "modname.ini". This INI file too is to be found in the System directory of Gothic! Thereby it is possible that multiple Gothic mods are parallel installed. The GothicStarter uses this file, to display a selection of all Gothic mods.

INFO Section

[INFO]
title=FunnyMod
description=Some funny additions to Gothic
authors=M.Musterman
version=0.31
webpage=http://www.musterpage.de

The INFO-Section stores general informations to the specific Game(mod). Title, description, authors, version number and a website can be inserted here.

FILES Section

[FILES]
; Dont attach file-extensions to these files.
game=content\gothic
fightai=content\fight
menu=system\menu
camera=system\camera
music=system\music
soundeffects=system\sfx
particleseffects=system\particlefx
visualeffects=system\visualfx
outputunits=content\outputunits\ou
; List of vdf-files which have been added to the original Gothic
; [separate them by spaces, include their extension ".mod"]
vdf=FunnyMod.mod

The FILES-Section includes the most important data. Here all the script files in the directory [GOTHIC]/_work/data/scripts are listed, which will be potentially modified. All file paths are specified relative to the script directory. It is very important, that a file extension is not allowed. It will be added by the programme automatically.

Candidate Nr 1 for an adjustment is the value for "game". This file contains more or less all scripts from the content folder. Gothic recognises automatically, whether the file system/gothic.src has to be used (and thus has to be compiled anew), or if an up-to-date (compiled) gothic.dat is available in the "_compiled" folder already.

The next candidate is the entry "outputunits". In our case these are the two files "ou.bin" and "ou.csl".

All the other files are not as interesting.

Especially important:
The entry for "vdf" must specify VDF files that are to be used additionally to the ones from GOTHIC. When there are multiple ones, they are separately specified by spaces (FunnyMod1.mod FunnyMod2.mod ...). But we recommend to just use one vdf file.
For this see also "How do I create a Gothic mod?".

SETTINGS Section

[SETTINGS]
world=test.zen
player=PC_HERO

The world-parameter specifies the level (relative to the directory _work/data/worlds/) that is to be loaded when executing "NEW GAME". The variable "player" points to a NPC Instance, which is used as player character (PC). In our case our well-known "PC_HERO". Diego for instance would be PC_THIEF, the Ricelord would be BAU_900_RICELORD. This way one can specifiy self-made player characters or maybe even Mud?! :-)

OPTIONS Section

[OPTIONS]
force_parameters=
force_subtitles=0
show_info=0

The last section contains diverse additional options:

"force_parameters" contains command line parameters, which are automatically used when Gothic is started; without the need to specify them. Maybe someone wants that no music is played (then. e.g.: "force_parameters=-znomusic").

"force_subtitles" should be clear in its meaning. If the value is set to 1, it will overwrite the menu options, so that subtitles are shown in every case. This makes sense when no acoustic voice output is available.

"show_info" shows title and version number in the game menu, when the value is set to 1.