redeclipse — script to launch the Red Eclipse FPS game client

Synopsis

[ -hhomedir ] [ -ppackagedir ] [ -osauerdir ] [ -glogfile ]

[ -df{0|1} ] [ -dwwidth ] [ -dhheight ] [ -du{agf123} ] [ -dv{0|1} ] [ -dasamples ] [ -dcdepth ] [ -dddepth ] [ -dsbits ]

[ -x'command(s)' ] [ -k{0|1} ] [ -v{0..4} ] [ --help ]

[ -ss{0..3} ] [ -smservermaster ] [ -saservermasterport ]

Description

Red Eclipse is a single-player and multi-player first-person ego-shooter, built as a total conversion of Cube Engine 2, which lends itself toward a balanced gameplay, with a general theme of agility in a variety of environments.

redeclipse is a script which executes the redeclipse binary from the /usr/lib/games/redeclipse directory.

The recommended way to change the settings of the client are to edit the config.cfg and init.cfg files in the home directory.

The redeclipse client starts a local loopback server upon launch which it uses to connect to for singleplayer, hence many of the server options are accepted by the redeclipse binary as well (see redeclipse-server(6)). To edit the specific settings related to the loopback server, use the localexec.cfg and localinit.cfg files in the home directory.

Caveats

Many of these options will, if used, be permanently saved in the init.cfg file.

Options

Filesystem options

-hhomedir
Sets your home directory to homedir. Red Eclipse will look for files in this directory in addition the normal installation directory. All user files will be written to the home directory. Defaults to $HOME/.redeclipse/.

-ppackagedir
Includes the data files found in packagedir. Can be used for adding additional mods. Packages will be loaded in the order specified. By default redeclipse only includes data files in its working directory /usr/share/games/redeclipse/data/, and in the temp subdirectory of the home directory.

-osauerdir
Sets the path to your Sauerbraten directory. If Red Eclipse can find your Sauerbraten directory, you can load and play Sauerbraten maps from withing Red Eclipse.

-glogfile
Output log to logfile. Path is set relative to homedir unless a leading '/' is used, uses stdout if -g is given without a parameter. Defaults to log.txt.

Video options

-df{0|1}
Turns fullscreen mode on or off. 0 to disable, 1 to enable. Defaults to 1.
This configuration is stored in init.cfg

-dwwidth
Sets screen width to width. If height not specified, also sets height to 3/4 of width. min is 320.
This configuration is stored in init.cfg

-dhheight
Sets screen height to height. If width not specified, also sets width to 4/3 of height. min is 320.
This configuration is stored in init.cfg

-du{agf123}
Set shader and glsl options. 'a' enables shadows and forces glsl off, 'g' enables shadows and forces glsl on, 'f' or no parameters disables shadows, 1-3 sets shader quality. Multiple options can be combined.
This configuration is stored in init.cfg

-dv{0|1}
Turns vertical sync on or off. 0 to disable, 1 to enable. Defaults to 0.
This configuration is stored in init.cfg

-dasamples
Sets full-scene anti-aliasing (FSAA) to samples samples.
This configuration is stored in init.cfg

-dcdepth
Sets colour depth (bits per pixel) to depth.
This configuration is stored in init.cfg

-dsbits
Sets stencil buffer bits to bits.
This configuration is stored in init.cfg

-dddepth
Sets z-buffer depth to depth.
This configuration is stored in init.cfg

General options

-x'command1; command2; ...'
Executes a list of commands once Red Eclipse has started up.

-k{0|1}
Enables or disables kid mode, which reduces blood and death effects somewhat. 1 enables reduced gore, defaults to 0.
This configuration is stored in init.cfg

-v{0..4}
Sets verbosity. This affects how much information is printed to the console. 0 is the least verbose, 4 is the most verbose, defaults to 0.
This configuration is stored in init.cfg

--help
Display this manpage

Server options

-ss{0..3}
Sets the server type of the local server. 0 for local only, 1 for private, 2 for public, 3 for dedicated. Defaults to 1. If set as dedicated (3) redeclipse will act similarly to redeclipse-server and not start the GUI.

-smservermaster
Connects to servermaster to get the list of available servers, defaults to play.redeclipse.net.

-saservermasterport
Contacts the master server using port servermasterport, defaults to 28800.

Examples

redeclipse -p$HOME/mod/data

Load data from an additional directory.

redeclipse -h$HOME/redeclipse_configs/

Reads and writes the configuration files to the specified directory instead of $HOME/.redeclipse/.

redeclipse -x'mode 7; trialweapon 0; map hinder'

Sets game mode to time trial, trialmode weapon to empty hands, and starts a game on the map "hinder".

Authors

Red Eclipse's main developers are Quinton "quin" Reeves and Lee "eihrul" Salzman

This manual page was written by Martin Erik Werner <martinerikwerner@gmail.com>

History

Red Eclipse was forked as a continuation of the game Bloodfrontier, which in turn was based on the Cube2 engine and the Sauerbraten game. Red Eclipse and Sauerbraten are now developed in parallel.