ZDLSharp Configuration File
From ZDLSharp
The ZDL configuration file format is the same format as the Microsoft® Windows® format for file based configuration (Although has been largely replaced by XML). This page currently describes the 3.0.5.3 configuration file.
Contents |
[edit] Backwards Compatibility
ZDLSharp supports the ZDL configuration file standard 100%.
[edit] Forward Compatibility
ZDLSharp saves all information in the same place where ZDL expects it, so ZDLSharp configuration files will work in ZDL. The only side effect is that ZDL (and ZDLSharp as of 3.0.4.1 and earlier) overwrites all information, losing any configuration specific to the later versions. This is undesirable, and future versions of ZDLSharp will be modified to fix this.
[edit] Parser Directives
Starting with ZDLSharp 3.0.5.3q, configuration files may have extra levels of parsing involved. Currently the only format supported is variable resolution. Given ${SECTION#VARIABLE}, the configuration file parser will expand and replace this with the variable found in section SECTION named VARIABLE. There is also a virtual section call "ENV". Variables in the "ENV" section map directly to the system environment variables. Check out the Configuration Parser page for more.
[edit] Syntax
The ZDLSharp configuration file is currently modeled after the INI file format. It is completely possible that it will be replaced with XML, or another configuration system. The following is a list of sections.
[edit] [zdl.general]
Description: Contains various configuration options relating to the operation of ZDL.
alwaysadd: Contains arguments from the "Always add these args" option (Currently not supported by ZDLSharp)
- To be added in 3.0.5.3q
zdllaunch: Sets the "Launch *.ZDL files transparently" option (Currently not supported by ZDLSharp)
- Support for this is available if the user manually sets it up in their OS, as well drag/drop ontop of the ZDLSharp executable
autoclose: Sets the "Close on Launch" option (Currently not supported by ZDLSharp). 1 signifies enabled, all other values disabled.
[edit] [zdl.ports]
Description: Contains a list of the source ports and their names.
p#n: The name of the source port, where # is the zero-based index.
p#f: The filename (and path) to the source port, where # is the zero-based index.
[edit] [zdl.iwads]
Description: Contains a list of the IWADs and their names.
i#n: The name of the IWAD, where # is the zero-based index.
i#f: The filename (and path) to the IWAD, where # is the zero-based index.
[edit] [zdl.save]
Description: Contains various configuration options, including skill, file list, DMFlags, etc.
iwad: The name of the IWAD from the list to use when launching. Must be in the i#n list.
port: The name of the source port from the list to use when launching. Must be in the p#n list.
extra: Added at the end of the command line on launching. Input is taken from the box directly below the file list.
dmflags: An interger value specifying the DMFLAGS command line option.
dmflags2: An interger value specifying the DMFLAGS2 command line option.
skill: The zero based skill level, where 0 is not specified, 1 is V. Easy, and 6 is V. Hard (Nightmare).
file#: The filename (and path) to a file to load after the -file option in the command line, where # is the zero-based index.
host: The hostname/ip of the server to join in net play.
gametype: The game type. 0: Single player, 1: Co-op, 2: Deathmatch
fraglimit: Number of frags per game.
players: If a host, how many players allowed to join. 0 if joining a game.
dlgmode: Dialog extended mode. If set to open, the multiplayer settings are shown, otherwise they are hidden.
warp: Used as the -warp parameter, added in 3.0.5.3q
[edit] [zdl.net]
Description: Contains various networking related settings, added in ZDLSharp.
updateManger: Either enabled or disabled. If not present, or other than disabled, it's assumed enabled.
advenabled: Either enabled or disabled. If not present, or other than enabled, it's assumed disabled. This controls ZDLSharps 'advanced multiplayer settings'.
netmode: Net mode. 0: Not included, 1: Classic, 2: Client/Server
port: Specify which port to use. Default is 5029.
dup: dup setting. 0: Not included, 1-9: passed to ZDoom
extratic: extratic setting. Either enabled or disabled. If not present, or other than enabled, it's assumed disabled.
