.TH LIEROLIBRE 6 2012-11-14 "lierolibre 0.5" "lierolibre Manual"


.SH NAME

lierolibre \- script to launch lierolibre


.SH SYNOPSIS

.SY lierolibre
[\fIinputfile \fR[\fIinputdir \fR[\fIoutputfile\fR]]]
.YS

.SY lierolibre
.OP \-f\fR|\fB\-\-file inputfile
.OP \-d\fR|\fB\-\-dir inputdir
.OP \-w\fR|\fB\-\-write outputfile
.OP \-v\fR|\fB\-\-sdlvideo videodriver
.OP -h\fR|\fB\-\-help


.SH DESCRIPTION

lierolibre is an  old-school earthworm action game. It is a direct fork of Liero.
.PP
.IP Features:
.RS
.IP \[bu] 2
2 worms, 40 weapons, great playability, two game modes: Kill'em All and Game of Tag, plus AI-players without true intelligence!
.IP \[bu] 2
Extensions via a hidden F1 menu:
.RS
.IP \[bu] 2
Replays, game controller support, powerlevel palettes
.RE
.IP \[bu] 2
Fullscreen, x2, x3 and x4 scaling via the F5, F6, F7 and F8 keys
.RE

.PP
.B lierolibre
is a script which executes the
.BR lierolibre
binary from the
.I /usr/lib/games/lierolibre
directory. The script defaults to using the directory
.IR /usr/share/games/lierolibre
as the
.I inputfile
parameter.

.PP
If
.I inputfile
points to a directory (which is the default case),
.B lierolibre
copies the file
.I liero.cfg
from this directory to
.I $HOME/.lierolibre/
unless it already exists in this location.
.I liero.cfg
is a plain text file which can be modified, go wild! But don't be surprised if the game crahes ;)


.SH OPTIONS

.TP
[\fB\-f\fR|\fB\-\-file\fR] \fIinputfile
Reads game variables from the given file or directory.

.IP
If
.I inputfile
points to a directory or a file with an unknown extension, and
.I inputdir
is not set,
.br
OR
.br
if
.I inputfile
points to a directory and
.I inputdir
is set,
.br
the game will try to load the
.I liero.cfg
file from
.I $HOME/.lierolibre/
first, otherwise it loads it from the directory of
.IR inputfile .

.TP
[\fB\-d\fR|\fB\-\-dir\fR] \fIinputdir
Reads the files
.I LIERO.CHR LIERO.SND NAMES.DAT
from the given directory. If not set, the game uses the directory of
.I inputfile
instead.

.TP
[\fB\-w\fR|\fB\-\-write\fR] \fIoutputfile
Writes all game variables to a plain text file.

.TP
\fB\-v\fR|\fB\-\-sdlvideo \fIvideodriver
Sets the SDL_VIDEODRIVER environment variable.

.TP
\fB-h\fR|\fB\-\-help
Print a brief help overview.

.SH EXAMPLES

.B lierolibre mymod/LIERO.EXE
.RS 4
Reads game variables from a (potentially) modded EXE file, and reads game data from files in
.IR mymod/ .
.RE

.B lierolibre -f mymod/LIERO.EXE -d /usr/share/games/lierolibre -w mymod_liero.cfg
.RS 4
Reads game variables from a (potentially) modded EXE file and writes them to a plain text config file (and starts the game).
.RE

.B lierolibre mymod_liero.cfg mydata
.RS 4
Reads game variables from a custom plain text config file, and reads the game data from another directory.
.RE


.SH AUTHORS

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


.SH HISTORY

Joosa Reikkinen "Mets„nEl„imet"
.br
created the original Liero game and graphics.

Erik Lindroos "Gliptic", with help from Mario Carbajal "basro"
.br
re-created Liero as OpenLiero, which later became the official version of Liero.

Martin Erik Werner "arand"
.br
created lierolibre as a direct fork from Liero (OpenLiero).

"sea"
.br
created the replacement sounds used in lierolibre.


.SH "SEE ALSO"

.BR lierolibre-extractgfx (6)
.BR lierolibre-packgfx (6)
.br
.BR lierolibre-extractsounds (6)
.BR lierolibre-packsounds (6)
.br
.BR lierolibre-extractlev (6)
.BR lierolibre-packlev (6)