1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212
|
.TH @CAPPNAME@ 6 2012-09-11 "Red Eclipse 1.3" "Red Eclipse Manual"
.SH NAME
@APPNAME@ \- script to launch the Red Eclipse FPS game client
.SH SYNOPSIS
.SY @APPNAME@
'\" Filesystem options
.OP \-h\fRhomedir
.OP \-p\fRpackagedir
.OP \-o\fRsauerdir
.OP \-g\fRlogfile
'\" Video options
.OP \-df\fR{0|1}
.OP \-dw\fRwidth
.OP \-dh\fRheight
.OP \-du\fR{agf123}
.OP \-da\fRsamples
.OP \-dd\fRdepth
'\" General options
.OP \-x\fR'command(s)'
.OP \-v\fR{0..4}
.OP \-\-help
'\" Server options
.OP \-ss\fR{0..3}
.OP \-sm\fRservermaster
.OP \-sa\fRservermasterport
.SH 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.
.PP
.B @APPNAME@
is a script which executes the
.BR @APPNAME@
binary from the
.I @LIBEXECDIR@/@APPNAME@
directory.
.PP
The recommended way to change the settings of the client are to edit the
.I config.cfg
and
.I init.cfg
files in the home directory.
.PP
The @APPNAME@ 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 @APPNAME@ binary as well (see
.BR @APPNAME@-server (6)).
To edit the specific settings related to the loopback server, use the
.I localexec.cfg
and
.I localinit.cfg
files in the home directory.
.SH CAVEATS
Many of these options will, if used, be permanently saved in the init.cfg file.
.SH OPTIONS
.SS Filesystem options
.TP
.BI \-h homedir
Sets your home directory to
.IR 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
.IR $HOME/.@APPNAME@/ .
.TP
.BI \-p packagedir
Includes the data files found in
.IR packagedir .
Can be used for adding additional mods. Packages will be loaded in the order specified. By default @APPNAME@ only includes data files in its working directory
.IR @DATADIR@/@APPNAME@/ ,
and in the
.I temp
subdirectory of the home directory.
.TP
.BI \-o sauerdir
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.
.TP
.BI \-g logfile
Output log to
.IR logfile .
Path is set relative to
.IR homedir
unless a leading \'\fB/\fR' is used, uses stdout if
.B -g
is given without a parameter. Defaults to
.IR log.txt .
.SS Video options
.TP
.BR \-df {0|1}
Turns fullscreen mode on or off. 0 to disable, 1 to enable. Defaults to 1.
.IP
This configuration is stored in init.cfg
.TP
.BI \-dw width
Sets screen width to
.IR width .
If height not specified, also sets height to 3/4 of width. min is 320.
.IP
This configuration is stored in init.cfg
.TP
.BI \-dh height
Sets screen height to
.IR height .
If width not specified, also sets width to 4/3 of height. min is 320.
.IP
This configuration is stored in init.cfg
.TP
.BI \-da samples
Sets full-scene anti-aliasing (FSAA) to
.I samples
samples.
.IP
This configuration is stored in init.cfg
.TP
.BI \-dd depth
Sets z-buffer depth to
.IR depth .
.IP
This configuration is stored in init.cfg
.SS General options
.TP
.B \-x\fR'\fIcommand1\fR; \fIcommand2\fR; \fI...\fR'
.
Executes a list of commands once Red Eclipse has started up.
.TP
.BR \-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.
.IP
This configuration is stored in init.cfg
.TP
.B \-\-help
Display this manpage
.SS Server options
.TP
.BI \-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) @APPNAME@ will act similarly to @APPNAME@-server and not start the GUI.
.TP
.BI \-sm servermaster
Connects to
.I servermaster
to get the list of available servers, defaults to play.redeclipse.net.
.TP
.BI \-sa servermasterport
Contacts the master server using port
.IR servermasterport ,
defaults to 28800.
.SH EXAMPLES
.B @APPNAME@ -p$HOME/mod/data
.RS 4
Load data from an additional directory.
.RE
.B @APPNAME@ -h$HOME/@APPNAME@_configs/
.RS 4
Reads and writes the configuration files to the specified directory instead of
.IR $HOME/.@APPNAME@/ .
.RE
.B @APPNAME@ -x'mode 7; trialweapon 0; map hinder'
.RS 4
Sets game mode to time trial, trialmode weapon to empty hands, and starts a game on the map "hinder".
.RE
.SH AUTHORS
Red Eclipse's main developers are Quinton "quin" Reeves and Lee "eihrul" Salzman
.PP
This manual page was written by Martin Erik Werner <martinerikwerner@gmail.com>
.SH 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.
.SH "SEE ALSO"
.BR @APPNAME@-server (6).
|