GameBase
Documentation
© 1999-2004 James Burrows
Main
Contents
GEMUS.DAT File Specification v1.0
The GEMUS.DAT file is used by GEMUS's Emulator Setup Wizard. This file contains emulator definitions that the wizard uses to automatically setup a GEMUS environment. When the Wizard starts, it first checks if there is a GEMUS.DAT file in the root folder of the database that is loaded into GameBase. If it finds one it will use it instead of the default GEMUS.DAT file located in the root of the GameBase program folder. This is so that people can write their own GEMUS.DAT files for their own database (and thus specify exactly how they want the emulators to be setup for it)! Throughout this document, the DAT file located in the GameBase program folder is referred to as the Global DAT File, and the DAT file located in a database folder is referred to as the Local DAT File.
The GEMUS.DAT file is useless by itself. Accompanying any GEMUS.DAT file there should be a \Scripts sub-folder (in the same folder as the DAT file). This folder contains all the GEMUS scripts pointed to by the DAT file. Without these scripts the Emulator Setup Wizard will not run. If using the Global DAT File, the wizard will copy the relevant scripts from the \Scripts folder into the appropriate database's \Scripts folder when setting up the emulators. If using the Local DAT File, the DAT file's \Scripts folder IS the database's \Scripts folder, so no copying is necessary as the scripts are already in the right place!
A Sample GEMUS.DAT File
[DAT] Version=1.0 [CREDITS] Author=Fred Bloggs Contact=http://www.bu22.com/ LastUpdated=2002-04-22 [Commodore 64] ¬CCS64 v2.0b DOS¬http://www.ccs64.com/¬¬ccs64.exe¬3EFF020E¬D64;T64;G64;G41;TAP;PRG;P00;P01;CRT¬Y¬CCS64_v20b_DOS.txt¬c64.cfg¬ ¬CCS64 v2.0b Win32¬http://www.ccs64.com/¬¬ccs.exe¬A719C6EB¬D64;T64;G64;G41;TAP;PRG;P00;P01;CRT¬Y¬CCS64_v20b_Win32.txt¬c64.cfg¬ ¬CCS64 v1.09¬http://www.ccs64.com/¬Please consider registering this emulator!¬ccsdpmi.exe¬332644B8¬D64;T64;PRG;P00¬Y¬CCS64_v109.txt¬c64.cfg¬ ¬WinVICE v1.6¬http://viceteam.bei.t-online.de/¬Oooh... with RESID!¬x64.exe¬AB43B34F¬T64;PRG;P00;D64;G64;G41;CRT;TAP¬Y¬WinVICE_v16.txt¬ [Atari ST] ... [ZX Spectrum] ... [Arcade] ... [Super Nintendo] ... [Apple] ... [BBC Micro] ...
The [DAT] Section
Version=1.0
This is the version of the DAT file. It Should be 1.0.
The [CREDITS] Section
Author=Fred Bloggs
This is where the authors of the DAT file are specified. In the above example, the author is Fred Bloggs. You can specify multiple authors by separating them with a comma.
Contact=http://www.bu22.com/
This is the URL or email address where updates or newer versions of the DAT file are available. This link appears in the first and last screens of the emulator setup wizard.
LastUpdated=2002-04-22
This is the date that the DAT file was last updated, in the format YYYY-MM-DD. In the above example, the DAT file was last updated on the 22nd April 2002
The SYSTEM Sections
[Commodore 64] ¬CCS64 v2.0b DOS¬http://www.ccs64.com/¬¬ccs64.exe¬3EFF020E¬D64;T64;G64;G41;TAP;PRG;P00;P01;CRT¬Y¬CCS64_v20b_DOS.txt¬c64.cfg¬ ¬CCS64 v2.0b Win32¬http://www.ccs64.com/¬¬ccs.exe¬A719C6EB¬D64;T64;G64;G41;TAP;PRG;P00;P01;CRT¬Y¬CCS64_v20b_Win32.txt¬c64.cfg¬ ¬CCS64 v1.09¬http://www.ccs64.com/¬Please consider registering this emulator!¬ccsdpmi.exe¬332644B8¬D64;T64;PRG;P00¬Y¬CCS64_v109.txt¬c64.cfg¬ ¬WinVICE v1.6¬http://viceteam.bei.t-online.de/¬Oooh... with RESID!¬x64.exe¬AB43B34F¬T64;PRG;P00;D64;G64;G41;CRT;TAP¬Y¬WinVICE_v16.txt¬
There can be multiple SYSTEM sections in a DAT file. Each one contains the emulator definitions for that system. The name of the section (between the [] characters) is the name of the system. Each emulator definition is split into fields by the ¬ character. An emulator definition line must begin and end with the ¬ character. The wizard, when it starts, lets the user pick which system that they would like to setup emulators for.
The format of an emulator definition line is as follows: -
¬NAME¬URL¬[COMMENT]¬FILENAME¬CRC32¬FILETYPES¬USESHORT¬SCRIPTFILE¬[ASSOCIATED-FILE¬*]
NAME
Required. This is the name of the emulator. It is the unique name that GEMUS
uses to identify the emulator. When the wizard scans through the emulator definitions,
it will not allow you to add emulators to your GEMUS setup if you have an emulator
already setup with the same name.
URL
Required. This is the URL of the Emulator's web site (or an email address).
This is used in the wizard to allow users to obtain the emulator if they do
not already have it.
[COMMENT]
Optional. This field can contain any information you want about the emulator.
This should be used for such info as specific instructions to running games
with this emulator. Good examples of use are: "The
script for this emulator only works with the registered version of the emulator",
or "Specifically setup for the
GB64 database!".
FILENAME
Required. This is the actual filename (without a path) of the file used to run
the emulator. The wizard uses this (along with the CRC32 field) when scanning
for the emulator on your computer.
CRC32
Required. This is the CRC32 checksum of the file used to run the emulator. The
wizard uses this (along with the FILENAME field) when scanning for the emulator
on your computer. You can specify multiple CRC32 values in one definition by
separating them with the pipe ( | ) character (for example ¬A719C6EB|B729DEEB|24E5F221¬).
If you specify multiple CRC32 values, you should put them in preference order
since the wizard's emulator search will scan for these in the order they are
specified and stop search once one is found. If you do not wish to specify any
CRC32 values, you must specify a single *
value (¬*¬). This will
cause the wizard to only search for files matching the FILENAME field, and stop
when the first matching file is found.
FILETYPES
Required. This is a list of filetypes that the emulator supports, delimited
with the semi-colon character. For example ¬D64;T64;PRG¬.
USESHORT
Required. This field specifies whether the emulator uses short filenames when
running games via command line. This must be one of two values... ¬Y¬
(uses short filenames) or ¬N¬
(doesn't use short filenames).
SCRIPTFILE
Required. This is the filename (without a path) of the emulator's GEMUS script
file, which should be present in the DAT file's \Scripts folder.
[ASSOCIATED-FILE¬*]
Optional. There can be as many associated files as you wish in an emulator definition.
They correspond to the associated files that the emulator's GEMUS script may
use. Associated files that you specify in a GEMUS.DAT emulator definition line
are assumed to be already on the users system in the folder of the emulator's
executable file (or one of it's sub-folders). To specify that the associated
file is directly in the emulator's folder, just use the asssociated file's filename.
If you wish to specify that the associated file is located in a sub-folder of
the emulator's folder, include the subfolder name before the filename. The wizard
will attempt to create the associated file if it doesn't already exist in the
specified location.
The following example specifies 2 associated files, one which is assumed to be in the emulator's root folder, and one which is assumed to be in the emulator's config folder: -
...¬settings.ini¬config\controls.ini¬