GFS - Revision history

Printz at 07:33, 18 February 2021

2021-02-18T07:33:04Z

← Older revision		Revision as of 03:33, 18 February 2021
Line 1:		Line 1:
	'''GFS''', or '''Game File Script''', is a ~~new~~ method of adding multiple data files to [[Eternity]] at once with the use of only one command-line parameter. GFS syntax ~~is extremely simple, and~~ allows for more safety and semantic checking than do batch files or response files. GFS also doesn't exclude the use of any other command-line parameters in addition to itself, so you can override files added in a GFS with your own if needed. GFS is designed primarily for distribution along with modifications such as PCs, TCs, megawads, etc., to make it easier for users to play them without need for lots of command-line parameters.		'''GFS''', or '''Game File Script''', is a method of adding multiple data files to [[Eternity]] at once with the use of only one command-line parameter. GFS syntax allows for more safety and semantic checking than do batch files or response files. GFS also doesn't exclude the use of any other command-line parameters in addition to itself, so you can override files added in a GFS with your own if needed. GFS is designed primarily for distribution along with modifications such as PCs, TCs, megawads, etc., to make it easier for users to play them without need for lots of command-line parameters.

	~~Now that~~ Eternity supports drag-and-drop file loading in windowed operating systems, users can also start your project by simply dragging a GFS onto Eternity~~. This is the absolute best way to load a project, perhaps aside from using a frontend~~. This functionality cannot be duplicated with batch or response files.		Since Eternity supports drag-and-drop file loading in windowed operating systems, users can also start your project by simply dragging a GFS onto Eternity. This functionality cannot be duplicated with batch or response files.

	GFS uses the same ~~libConfuse~~ parser as [[EDF]] and [[ExtraData]]~~, written by Martin Hedenfalk~~, and therefore shares most of the same syntactic elements. GFS is free-form, meaning that whitespace is ignored and that other tokens' positions are irrelevant to their meanings. #, //, and /* */ comments are also supported~~, but are not very important for GFS files, so they will not be discussed in this document~~. To see thorough information on these elements of the syntax, see the General Syntax section of the Eternity Engine EDF Reference.		GFS uses the same parser as [[EDF]] and [[ExtraData]], and therefore shares most of the same syntactic elements. GFS is free-form, meaning that whitespace is ignored and that other tokens' positions are irrelevant to their meanings. <code>#</code>, <code>//</code>, and <code>/* */</code> comments are also supported. To see thorough information on these elements of the syntax, see the General Syntax section of the Eternity Engine EDF Reference.

	GFS supports long file names ~~under operating systems other than DOS~~, but they must be enclosed in quotation marks if they contain spaces.		GFS supports long file names, but they must be enclosed in quotation marks if they contain spaces.
	{{Backto\|Eternity Engine}}		{{Backto\|Eternity Engine}}
	{{editref}}		{{editref}}
	==Using GFS==		==Using GFS==

	To use a GFS file, use the -gfs command-line parameter, and give it an argument of one absolute file path to the desired GFS file. If the GFS file is in the executable's directory, it is not necessary for the path to be absolute, but otherwise GFS may not function properly if the path is only relative.		To use a GFS file, use the <code>-gfs</code> command-line parameter, and give it an argument of one absolute file path to the desired GFS file. If the GFS file is in the executable's directory, it is not necessary for the path to be absolute, but otherwise GFS may not function properly if the path is only relative.

	Example:		Example:
Line 16:		Line 16:
	eternity -gfs C:\Games\AliensTC\atc.gfs		eternity -gfs C:\Games\AliensTC\atc.gfs

	GFS files can also be loaded by drag-and-drop or typing the name(s) directly after the "eternity" executable (without the -gfs parameter).		GFS files can also be loaded by drag-and-drop or typing the name(s) directly after the "eternity" executable (without the <code>-gfs</code> parameter).

	A "default.gfs" file can be included in the game subfolder (Doom, Doom2, Heretic...) of the "base" folder, and it will be loaded automatically when the specified game is loaded, if not specified otherwise (-gfs or drag-drop).		A "default.gfs" file can be included in the game subfolder (Doom, Doom2, Heretic...) of the "base" folder, and it will be loaded automatically when the specified game is loaded, if not specified otherwise (-gfs or drag-drop).

Printz: /* Adding WAD Files */ added about lumps

2012-06-20T23:13:21Z

Adding WAD Files: added about lumps

← Older revision		Revision as of 19:13, 20 June 2012
Line 60:		Line 60:

	GFS WAD files will be added before any other WAD files added via the command-line or specified in the configuration file, so that any WADs specified there can override those in the GFS.		GFS WAD files will be added before any other WAD files added via the command-line or specified in the configuration file, so that any WADs specified there can override those in the GFS.

			You can also load isolated lumps, which have the .LMP extension, using wadfile.

	Example of Usage:		Example of Usage:

Printz at 08:38, 9 March 2012

2012-03-09T08:38:47Z

← Older revision		Revision as of 04:38, 9 March 2012
Line 7:		Line 7:
	GFS supports long file names under operating systems other than DOS, but they must be enclosed in quotation marks if they contain spaces.		GFS supports long file names under operating systems other than DOS, but they must be enclosed in quotation marks if they contain spaces.
	{{Backto\|Eternity Engine}}		{{Backto\|Eternity Engine}}
			{{editref}}
	==Using GFS==		==Using GFS==

Printz at 10:34, 4 March 2012

2012-03-04T10:34:17Z

← Older revision		Revision as of 06:34, 4 March 2012
Line 6:		Line 6:

	GFS supports long file names under operating systems other than DOS, but they must be enclosed in quotation marks if they contain spaces.		GFS supports long file names under operating systems other than DOS, but they must be enclosed in quotation marks if they contain spaces.
			{{Backto\|Eternity Engine}}
	==Using GFS==		==Using GFS==

Printz: /* Using GFS */ added extra ways to call GFSes

2012-02-15T18:26:12Z

Using GFS: added extra ways to call GFSes

← Older revision		Revision as of 14:26, 15 February 2012
Line 14:		Line 14:

	eternity -gfs C:\Games\AliensTC\atc.gfs		eternity -gfs C:\Games\AliensTC\atc.gfs

			GFS files can also be loaded by drag-and-drop or typing the name(s) directly after the "eternity" executable (without the -gfs parameter).

			A "default.gfs" file can be included in the game subfolder (Doom, Doom2, Heretic...) of the "base" folder, and it will be loaded automatically when the specified game is loaded, if not specified otherwise (-gfs or drag-drop).

	==How Files are Found==		==How Files are Found==

Bloodshedder: New page: '''GFS''', or '''Game File Script''', is a new method of adding multiple data files to Eternity at once with the use of only one command-line parameter. GFS syntax is extremely simple,...

2009-04-29T07:21:31Z

New page: '''GFS''', or '''Game File Script''', is a new method of adding multiple data files to Eternity at once with the use of only one command-line parameter. GFS syntax is extremely simple,...

New page

'''GFS''', or '''Game File Script''', is a new method of adding multiple data files to [[Eternity]] at once with the use of only one command-line parameter. GFS syntax is extremely simple, and allows for more safety and semantic checking than do batch files or response files. GFS also doesn't exclude the use of any other command-line parameters in addition to itself, so you can override files added in a GFS with your own if needed. GFS is designed primarily for distribution along with modifications such as PCs, TCs, megawads, etc., to make it easier for users to play them without need for lots of command-line parameters.

Now that Eternity supports drag-and-drop file loading in windowed operating systems, users can also start your project by simply dragging a GFS onto Eternity. This is the absolute best way to load a project, perhaps aside from using a frontend. This functionality cannot be duplicated with batch or response files.

GFS uses the same libConfuse parser as [[EDF]] and [[ExtraData]], written by Martin Hedenfalk, and therefore shares most of the same syntactic elements. GFS is free-form, meaning that whitespace is ignored and that other tokens' positions are irrelevant to their meanings. #, //, and /* */ comments are also supported, but are not very important for GFS files, so they will not be discussed in this document. To see thorough information on these elements of the syntax, see the General Syntax section of the Eternity Engine EDF Reference.

GFS supports long file names under operating systems other than DOS, but they must be enclosed in quotation marks if they contain spaces.

==Using GFS==

To use a GFS file, use the -gfs command-line parameter, and give it an argument of one absolute file path to the desired GFS file. If the GFS file is in the executable's directory, it is not necessary for the path to be absolute, but otherwise GFS may not function properly if the path is only relative.

Example:

eternity -gfs C:\Games\AliensTC\atc.gfs

==How Files are Found==

Normally, file names specified in a GFS are appended to the path of the GFS file. So if a GFS file is in C:\Games and specifies a file "superwar.wad", then "C:\Games\superwar.wad" will be added. This allows specification of subdirectories or the parent directory in a file name. It is recommended that GFS files provided with modifications allow the GFS to work in this manner.

Note that an IWAD file name will not have any path appended to it, so it should be an absolute path in all circumstances.

===Changing the Base Path===

It is possible to alter the path which will be appended to WAD, DEH/BEX, CSC, and EDF file names by using the '''basepath''' variable. When basepath is set to a path, that path will be appended to those file names instead of the path of the GFS file. This allows GFS to be placed by the user into a directory other than that in which the other files exist. There can only be one basepath specification per GFS file. The last one found during parsing will be the one which is used.

This option is not generally useful to GFS provided with modifications, since authors cannot know how the user's file system is set up. This facility is present to allow users to create their own GFS files and keep them wherever they wish.

'''basepath''', as mentioned above, does not affect the '''iwad''' specification, if one is present.

Example of Usage:

#
# Assume that Aliens TC 2.0 is in C:\Games\AliensTC, but this GFS is somewhere else
# (like in the port's directory, for example
#

# The files I want to load:

wadfile = alitcsf.wad
wadfile = alitcsnd.wad
wadfile = atclev.wad
dehfile = atcud19.bex

# The location where they're at, since the GFS file is not also there
# (note you could also use "C:\\Games\\AliensTC"):

basepath = "C:/Games/AliensTC"

==Adding WAD Files==

A GFS can specify any number of wad files to load using the '''wadfile''' variable. WAD files will be loaded in the order in which they are specified.

A WAD file name should be a path which is relative either to the path of the GFS file, or to the '''basepath''' if it is specified.

GFS WAD files will be added before any other WAD files added via the command-line or specified in the configuration file, so that any WADs specified there can override those in the GFS.

Example of Usage:

wadfile = chextc.wad

==Adding DeHackEd/BEX Files==

A GFS can specify any number of DeHackEd/BEX files to load using the '''dehfile''' variable. These files will be loaded in the order in which they are specified.

A DEH/BEX file name should be a path which is relative either to the path of the GFS file, or to the '''basepath''' if it is specified.

GFS DEH/BEX files will be added after any DeHackEd files added on the command-line. This allows command-line DeHackEd files to take effect before any changes made by GFS. However, DeHackEd lumps in WADs and any specified in the configuration file are still added last.

Example of Usage:

dehfile = chexq.bex

==Adding Console Scripts==

A GFS can specify any number of console scripts to run using the '''cscfile''' variable. These files will be executed in the order in which they are specified.

A CSC file name should be a path which is relative either to the path of the GFS file, or to the '''basepath''' if it is specified.

GFS CSC files will be executed immediately after any that are specified via the configuration file.

Example of Usage:

cscfile = setvars.csc

==Specifying a Root EDF File==

A GFS can specify the root EDF file to process by using the '''edffile''' variable. Only one root EDF file can be specified, so the last definition encountered will become the one that is used.

The EDF file name should be a path which is relative either to the path of the GFS file, or to the '''basepath''' if it is specified.

If the -edf command-line parameter is used, it will take precedence over this setting.

Example of Usage:

edffile = myroot.edf

==Specifying an IWAD==

A GFS can specify the IWAD file to use by using the '''iwad''' variable. Only one IWAD file can be specified, so the last definition encountered will become the one that is used.

The IWAD file name should be the absolute path, including file name, of the IWAD. The '''basepath''' variable does NOT affect this file name, and the path of the GFS file will not be appended to it.

If the -iwad command-line parameter is used, it will take precedence over this setting.

This option is not generally useful to GFS provided with modifications, since they cannot know how the user's file system is set up. This facility is to allow users to create their own GFS files, or to edit existing ones, so that they can automatically be loaded without need to additionally specify the IWAD.

Example of Usage:

iwad = "C:/Games/DOOM/DOOM.wad"