DragonFly On-Line Manual Pages
GEMRB(6) DragonFly Games Manual GEMRB(6)
NAME
GemRB - emulator for Infinity Engine-based games
SYNOPSIS
gemrb [-c CONFIG-FILE]
torment
DESCRIPTION
GemRB is an emulator for Infinity Engine-based games, fine RPGs like
Baldur's Gate, Icewind Dale and Planescape: Torment.
GemRB reimplements only the game engine. To actually play anything, you
have to have the data from the original game(s), installed or
unpackaged where GemRB can find it. See the GamePath and CDn settings
in the engine configuration file below. A full install is recommended.
OPTIONS
-c FILE
Use the specified configuration file FILE instead of the default
gemrb.cfg.
Note: You can also use the program's name as a mean to select
the configuration file. For example, if the program's name is
torment instead of gemrb, the engine first seaches for
torment.cfg and only if it's not found it searches for
gemrb.cfg.
To use this feature, just create a symbolic link torment
pointing to the gemrb binary and then run torment instead.
CONFIGURATION
A configuration file consists of pairs PARAMETER=VALUE, each on its own
line. The case of PARAMETER is not significant, GameType is the same as
GAMETYPE. If the same PARAMETER is defined more than once, only the
last occurence is used.
Empty lines and lines starting with `#' (hash sign) are ignored.
At least the GameType and GamePath parameters need to be changed. That
is often enough, so do not fiddle with the other paths too much.
General Parameters:
GameType=(auto|bg1|bg2|iwd|iwd2|how|pst)
Type of the game. The value is a name of subdirectory in
override/ and GUIScripts/ directories with game type-specific
files and scripts. It is at present also used for various tweaks
hardcoded in the GemRB engine. To autodetect the game type, use
"auto".
GameName=STRING
Arbitrary name of the game. It will be displayed in the window's
title bar.
Encoding=(default|polish|czech)
Specify language used in the game data. Except of polish version
of BG1, it's safe to leave it commented out.
GUIEnhancements=INT
The value is a bitfield. Setit to 1 to enable a few GUI
enhancements, mostly in BG2. Set to 2 or 3 to try to
autoidentify items on transfer (if the character has enough
lore). Disabled by default.
EndianSwitch=(0|1)
Set this to 1 if you are running GemRB on a big-endian machine.
Disabled by default.
MultipleQuickSaves=(0|1)
EXPERIMENTAL. Set this to 1 if you want GemRB to keep multiple
quicksaves around. Disabled by default.
MaxPartySize=INT
EXPERIMENTAL: Set this to 1-10 if you want more party members or
enforce fewer. 6 by default. NOTE: You need to choose a big
enough resolution, so there will be enough room for all the
party portraits! Does nothing for PST and IWD2.
Video Parameters:
Width=INT
Game window width (in pixels).
WARNING: This is not arbitrary but depends on the game data. For
custom resolutions the widescreen mod needs to be used.
Height=INT
Game window height (in pixels).
WARNING: This is not arbitrary but depends on the game data. For
custom resolutions the widescreen mod needs to be used.
Bpp=INT
Color depth of the game window (in bits per pixel).
Fullscreen=(0|1)
Whether the game should run in fullscreen mode.
TooltipDelay=INT
Delay (in miliseconds) before tooltips are displayed when the
mouse is not moving. A reasonable number for this option is
e.g. 500. The default is 100.
SkipIntroVideos=(0|1)
If set to 1, the intro and logo videos are skipped to save
developer's nerves. The default is 0.
FogOfWar=(0|1)
If set to 1, the unexplored parts of an area are blacked out. It
is enabled by default.
Audio Parameters:
AudioDriver=(openal|sdlaudio|none)
Use the specified plugin as the audio driver. The default is
openal, while none will disable all audio.
VolumeAmbients=INT
Volume of ambient sounds in percents. The default is 100.
VolumeMovie=INT
Volume during movie playback in percents. The default is 100.
VolumeMusic=INT
Volume of background music in percents. The default is 100.
VolumeSFX=INT
Volume of sound effects in percents. The default is 100.
VolumeVoices=INT
Volume of PC or NPC voices in percents. The default is 100.
Path parameters:
CaseSensitive=(0|1)
When this parameter is set to 1, the engine will try to find
files regardless of their names' case at the cost of a slight
speed penalty. This is especially important when using game
files on CD-ROMs, where the files can't be renamed. Like many
Windows programs, the original games use inconsistent mix of
lower/upper case letters for naming and referencing their files.
Set this parameter to 1 on Unix-like systems.
GamePath=PATH
Path to the directory where the original game is installed. If
you can't install the game under MS Windows or with WINE, you
can try to unpack the data files with the unshield program found
at http://synce.sourceforge.net.
CD1=PATH
CD2=PATH
CDn=...
Path to the data files for the game's particular CDs or any
other data sources.
CachePath=PATH
User-writable directory where the engine caches uncompressed and
temporary files. Defaults to a subdirectory of the current
directory.
GemRBPath=PATH
Path to the GemRB installation. (To be obsoleted; preset at
build time).
GUIScriptsPath=PATH
Path to the directory with scripts controlling the game's GUI.
(To be obsoleted; preset at build time).
GemRBOverridePath=PATH
Path where GemRB looks for its game override directory. It
defaults to GemRBPath. GemRB reuses some of the unused files
from the original or replaces them and this is the where they
can be found. The path is preset at build time. This directory
has the highest priority when searching, so putting files in the
game override will not affect them. Use another directory and
add it as ModPath to the GemRB config.
GemRBUnhardcodedPath=PATH
Path where GemRB looks for its unhardcoded engine data. It
defaults to GemRBPath. The original games hardcoded this
information in the engine. The path is preset at build time.
The following variables do not need to be altered, unless you are doing
something really special!
SavePath=PATH
Path to the directory with save games. Note that this directory
has to contain save/ and/or eventually mpsave/ subdirectories
and that only these subdirectories contain the actual saved
games.
SavePath defaults to GamePath.
GameDataPath=PATH
Path to the original game's installed data files, relative to
GamePath. Usually it's data.
GameOverridePath=PATH
Path to the original game's override dir, relative to GamePath.
Usually it's override. Original games use this directory to
place last-minute patches.
GameCharactersPath=PATH
Path to the original game's installed data files, relative to
GamePath. Usually it's characters.
GamePortraitsPath=PATH
Path to the original game's installed data files, relative to
GamePath. Usually it's portraits.
GameScriptsPath=PATH
Path to the original game's installed data files, relative to
GamePath. Usually it's scripts.
GameSoundsPath=PATH
Path to the original game's installed data files, relative to
GamePath. Usually it's sounds.
ModPath=PATH
Path where GemRB looks for additional engine override files. It
is not set by default. This directory has precedence over
GemRBOverridePath.
CustomFontPath=PATH
Path where GemRB looks for additional font files. It is meant to
be used with the TTF font plugin and fonts.2da as a way to
specify where to look for system or other external fonts. Check
the online documentation for the details. It is not set by
default.
Input Parameters:
DoubleClickDelay=INT
Milisecond threshold for detecting a double click. The default
is 250.
RepeatKeyDelay=INT
Milisecond threshold for detecting a repeated key press. The
default is 250.
UseSoftKeyboard=(0|1)
Toggles use of software keyboard on devices that support one. It
pops up when text input is required. Disabled by default.
NumFingScroll=(2|3|4)
Number of fingers for multitouch to trigger scrolling. The
default is 2.
NumFingKboard=(2|3|4)
Number of fingers for multitouch to open up the software
keyboard. The default is 3. The value should not be equal to
NumFingScroll above.
NumFingInfo=(2|3|4)
Number of fingers for multitouch to emulate a special keypress
(alt, tab). The default is 2.
MouseFeedback=(0-3)
Bitfield with reserved bits for disabling the mouse.
Show mouse+tooltips = 0 (default)
Hide mouse = 1
Hide tooltips = 2
Hide mouse+tooltips = 3
Development parameters:
EnableCheatKeys=(0|1)
This parameter is meant for developers. If set to 1, certain
keys allow you to inspect the internal state of objects, do
forbidden things, etc. The keys are listed in the CheatKeys.txt
file. Do NOT use this option unless you want to make your hands
dirty :-). The default is 0.
DrawFPS=(0|1)
This parameter is meant for developers. If set to 1, the current
FPS (Frames per Second) value is drawn in the top left window
corner. The default is 0.
ScriptDebugMode=(n)
This parameter is meant for developers. It is a combination of
bit values
1 - count references,
2 - display cutscene warnings,
4 - display variable warnings,
8 - display action warnings,
16 - display trigger warnings.
The default is 0.
DelayPlugin=FILENAME
Named plugin will be loaded after other (nondelayed) plugins
were loaded. FILENAME is a name without path, but with
extension, for example libNullSound.so or libNullSound.dll. You
can use this parameter more than once.
SkipPlugin=FILENAME
Named plugin will not be loaded. FILENAME is a name without
path, but with extension, for example libNullSound.so or
libNullSound.dll. You can use this parameter more than once.
SaveAsOriginal=(0|1)
Set this parameter to 1, if you want to keep the save game
compatible with the original engine. It is enabled by default.
KeepCache=(0|1)
Set this parameter to 1, if you want to keep the cache after
exiting GemRB. It is disabled by default.
IgnoreOriginalINI=(0|1)
Set this parameter to 1, if you want to ignore the settings from
the original configuration files - baldur.ini / icewind.ini /
torment.ini. It is disabled by default.
FILES
/usr/local/etc/gemrb/gemrb.cfg
system-wide configuration file
/usr/local/share/gemrb/override/
directory with GemRB-distributed data files. These used to be
hardcoded in the original engine. The files are sorted into
directories for specific games.
/usr/local/share/gemrb/GUIScripts/
directory with Python scripts providing GUI setup and
interaction. The files are sorted into directories for specific
games.
~/.gemrb/gemrb.cfg
~/.gemrb/override/
~/.gemrb/GUIScripts/
user's own configuration and data files.
~/.gemrb/cache/
cache directory
BUGS
Many. GemRB is still in an early development stage and not nearly
complete.
If you stumble over something which is supposed to work, either make a
bug report at http://sourceforge.net/projects/gemrb or come to the
official IRC channel #GemRB at FreeNode.
AUTHOR
The GemRB Project development team at http://gemrb.org
COPYING
Copyright (C) 2003-2011 The GemRB Project
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
GEMRB(6)