GothicVDFS
Gothic VDFS is the most popular VDFS tool. It was created by NicoDE and allows viewing, extracting and building .vdf
and .mod
archives.
Download
You can download the tool from NicoDE's website - direct link.
Working areas
GothicVDFS has two working areas one for viewing volumes and one for building volumes.
Viewer
This is a blank VDFS viewer:
There are two paths to choose at the top:
- Filename - Path of the currently opened
.vdf
or.mod
archive - Root Path - Path to the place where the files will be extracted
When you specify the Filename
the VDFS will load the volume and display some information.
Comment is an information about loaded volume left by the author.
Timestamp is a date and time set by the author. Usually the date coincides with the actual date of the volume's build, but it cannot be taken for granted as it can be easily changed.
Tip
The timestamp defines order of loading volumes into the game. Volumes with the latest timestamp are loaded first.
At the bottom there are three different options for extracting files from archive:
- Extract Volume - extract the whole volume to the Root Path
- Extract Directory - extract only selected folder
- Extract Selected - extract currently selected files
In addition, you can choose if files should keep their structure after extraction or get extracted directly to the Root Path.
Builder
The second working area is the Builder. It allows you to create new VDF archives.
That's how initial builder looks like:
There are two paths to choose at the top:
- Filename - Path of the new
.vdf
or.mod
archive - Root Path - Path to the Gothic directory
In the middle there are three areas in which you can specify archive files.
- File(mask)(s) to search for - list of file masks to load in VDF archive e.g.
_WORK/Data/Anims/_compiled/*
- File(mask)(s) to exclude - list of file masks to exclude
- File(mask)(s) to include - list of file masks to include
At the bottom there are three buttons:
- Open Script - open a
.vm
script file with VDF configuration - Save Script - save current VDF configuration to a
.vm
script file - Build Volume - build the VDF archive with current configuration
Example build configuration could look like this:
CLI Interface
CLI interface is very simple and allows building and extracting VDF archives without GUI. That's good for automation and scripting.
Build VDF from script
Extract VDF to directory
Script Reference
GothicVDFS uses simple script language to define VDF archives. The script is a simple text file with .vm
extension. The script is divided into sections, each section is marked by a header in square brackets. The script must contain at least [BEGINVDF]
and [ENDVDF]
sections.
[BEGINVDF]
Marks the start of script and contains VDF properties.
Comment
Comment of VDF archive. Equivalent of "Comment" from GUI.
BaseDir
Root path of local files (relative to working directory). Equivalent of "Root Path" from GUI.
VDFName
Name of final VDF file (relative to working directory). Equivalent of "Filename" from GUI.
[FILES]
List of file masks to load in VDF archive (relative to BaseDir). Equivalent of "File(mask)(s) to search for" from GUI.
[EXCLUDE]
List of file masks to exclude. Equivalent of "File(mask)(s) to exclude" from GUI.
[INCLUDE]
List of file masks to include. Equivalent of "File(mask)(s) to include" from GUI.
[ENDVDF]
Marks end of file.