/usr/share/doc/liquidwar-data/html/parameters.html is in liquidwar-data 5.6.4-3ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Command line parameters</TITLE>
</HEAD>
<BODY>
<CENTER>
<A HREF="index.html">Home</A> |
<A HREF="rules.html">Rules</A> |
<A HREF="authors.html">Authors</A> |
<A HREF="mailinglists.html">Mailing lists</A> |
<A HREF="fanfic.html">Fanfic</A> |
<A HREF="options.html">Menus and hot keys</A> |
<A HREF="network.html">Network game</A> |
<A HREF="parameters.html">Command line parameters</A> |
<A HREF="platforms.html">Platform specific issues</A> |
<A HREF="userlevels.html">User levels</A> |
<A HREF="algorithm.html">Core algorithm</A> |
<A HREF="source.html">Source code</A> |
<A HREF="bugs.html">Bugs</A> |
<A HREF="todo.html">To do</A> |
<A HREF="wip.html">WIP</A> |
<A HREF="copying.html">Copying</A>
</CENTER>
<HR>
<CENTER><H1>Command line parameters</H1></CENTER>
<HR>
<H2>Introduction</H2>
<P>When you launch Liquid War 5, you can use command line options.
If you have no problems launching Liquid War,
this section should not interest you very much.</P>
<P>You can use several options at the same time.
The basic syntax for options looks like this:</P>
<PRE>lw -option1 -option2 parameter2 -option3 parameter3 -option4 -option5</PRE>
<P>Note that most of the options are legacy options which where usefull
with the initial releases of Liquid War, when you had to run in a
Windows DOS box, and when there were still plenty of 486 computers
with only 8Mb ram...</P>
<HR>
<H2>Version checking</H2>
<P>These are basic options which can be usefull to figure out
which release of Liquid War is installed.</P>
<UL><LI>"-v" : returns the version number of the program.</LI>
<LI>"-h" : displays a short description and copyright information.</LI>
</UL>
<HR>
<H2>Changing default paths</H2>
<P>Very usefull options, especially if you can not install Liquid War
in default directories or want to put the game in a special place.</P>
<UL><LI>"-cfg myconfigfile.cfg" : causes Liquid War to use the specified
config file.</LI>
<LI>"-dat mydatafilefile.dat" : causes Liquid War to use the specified
datafile. This might be a very interesting option if you run
Liquid War on a GNU/Linux box where you do not have root access and
therefore can not put the datafile in /usr.</LI>
<LI>"-map mycustommapdir" : causes Liquid War to use the specified
directory as the user map directory. The user map directory
is where you can put plain bitmaps to be used as maps.</LI>
<LI>"-tex mycustomtexturedir" : causes Liquid War to use the specified
directory as the user texture directory. The user texture directory
is where you can put plain bitmaps to be used as textures.</LI>
<LI>"-mid mycustommusicdir" : causes Liquid War to use the specified
directory as the user music directory. Any midi file placed in this
directory will be added to the list of available musics.</LI>
<LI>"-server myliquidwarserverfile" : causes Liquid War to use the specified
file as the server executable. This option has no effect for now since
the server is not launched by the client.</LI>
<LI>"-mapgen mylwmapgenfile" : causes Liquid War to use the specified
file as the "lwmapgen" executable. "lwmapgen" is an utility by David Redick
which generates random maps automatically for Liquid War. You might wish
to change this option if random map generation does not work for some reason,
or if you want to use your own map generator.</LI>
</UL>
<HR>
<H2>Troubleshooting switches</H2>
<P>These options give you control on how Liquid War treats
initialisation errors, how much memory it should reserve,
what kind of video mode sit should not choose etc...</P>
<UL><LI>"-vga" :
This option forces Liquid War to use your video card
as if it was only a basic VGA card.
This option is required if you play Liquid War from Windows NT.</LI>
<LI>"-no400300" :
This option disables the VGA 400x300 video mode.
I created this options for I know that some video cards/monitors
don't support the 400x300 mode.</LI>
<LI>"-silent" :
With this option, Liquid War will not play any sound.
It will not search for any sound card.
This can be interesting if you don't have any sound card
or if Liquid War doesn't handle your card correctly.</LI>
<LI>"-nowater" :
Causes Liquid War not to load any water sound.
Use this if Liquid War runs short of memory,
and you should gain about 850kb.</LI>
<LI>"-nosfx" :
Causes Liquid War not to load any sound fx.
Use this if Liquid War runs short of memory,
and you should gain about 150kb.</LI>
<LI>"-nomusic" :
Causes Liquid War not to load any midi music.</LI>
<LI>"-mem n" :
The parameter "n" sets the amount of memory (in Mb)
Liquid War will allocate to do all its calculus.
If this number is too small, you won't be able to play
on all the levels.
If it is too high, Liquid War may not start at all
or crash while you are playing.
The default value is 8.
If you play Liquid War from Windows and Liquid War
refuses to run because this parameter is too high,
then try and give more dpmi memory to Liquid War.</LI>
<LI>"-nojoy" :
This option disables joystick support.</LI>
<LI>"-noback" :
Causes Liquid War not to load the background image.
Use this if Liquid War runs short of memory,
and you should gain about 300kb.</LI>
<LI>"-notex" :
Causes Liquid War not to load any texture.
Use this if Liquid War runs short of memory,
and you should gain about 750kb.</LI>
<LI>"-auto" :
If you set this option, Liquid War won't generate
any error while allocating memory or loading data.</LI>
<LI>"-safe" :
With this option, you will play with a very reduced
version of Liquid War. It looks rather ugly but
should work in a DOS box with only 4Mb of DPMI memory.
Use this if you experience serious memory or device problems.
If Liquid War doesn't start with this option turned on,
I really don't think I can do anything for you...</LI>
<LI>"-nice" :
With this option, Liquid War will use a mode which
is between the default mode and the "safe" mode.</LI>
<LI>"-check" :
With this option, Liquid War will stop as soon as it detects
something strange while initializing.</LI>
<LI>"-stop" :
If you set this option, Liquid War will prompt you for a key
when the init process is completed.</LI>
<LI>"-c" :
This is a weird option, if you turn it on,
the game will only use fonctions which are programmed in C langage.
The default behaviour is to use some functions I rewrote
in assembly langage, so that the game is a little faster.</LI>
</UL>
<HR>
<H2>Debug options</H2>
<P>These options are usefull if you want to debug the game and
trace what's happening.</P>
<UL><LI>"-netlog" :
Dumps all the network traffic on the standard output. This
can help finding problems when trying to connect to the server
in a network game.</LI>
</UL>
<HR>
<H2>Server options</H2>
<P>The server command line options are described in the section
which deals which network games in general. IMHO you need to
understand how network works in LW before trying to tweak
the server 8-)</P>
<HR>
<H2>Other options</H2>
<P>Everything else 8-)</P>
<UL><LI>"-capture" :
Activates the capture mode. In this mode, the game will
dump a .bmp file on the disk several times per second, which
is usefull if you want to create an mpeg movie of your game
session afterwards. You can also activate this mode interactively
by pressing F9 within the game.</LI>
<LI>"-metaserver url" : redefines the URL of the meta-server.
Usefull if you want to use your own meta-server.</LI>
<LI>"-nobeep" :
Disables the system beeps that the application might fire.
These beeps are mostly used on the server to notify clients connections.</LI>
<LI>"-tombola" :
Activates a special mode where scores are not displayed
normally. Instead, the game displays 3 random numbers between 1 - 500.</LI>
</UL>
<HR>
<H2>lwmapgen options</H2>
<P>The external lwmapgen program by David Redick accepts a
number of command line options. You can type:</P>
<PRE>liquidwar-mapgen --help</PRE>
<P>to get a list of all available options under UNIX. Under Windows
the command would be:</P>
<PRE>lwwinmap --help</PRE>
<P>Note that lwmapgen is called automatically by Liquid War
when you click on the "Random map" button.</P>
<P>The idea behind lwmapgen is that you choose a function which
sets the type of map generated, and then pass various arguments
to this function. If you do not explicitly choose a function, one
will be picked up for you randomly, and all other parameters will
use default values.</P>
<P>The most usefull and common options are:</P>
<UL><LI>"--help" :
displays help.</LI>
<LI>"--out filename" :
save bitmap to filename.</LI>
<LI>"--size n" :
bitmap size (an integer between 0 and 5).</LI>
<LI>"--list" :
list all available functions.</LI>
<LI>"--function function_name" :
which function to use.</LI>
</UL>
<P>Here's a typical use of lwmapgen:</P>
<PRE>liquidwar-mapgen --size 3 --function hole --out test.bmp</PRE>
<HR>
<CENTER>
This documentation is also available on:
<A HREF="http://www.ufoot.org/liquidwar/v5">www.ufoot.org/liquidwar/v5</A>.
</CENTER>
</BODY>
</HTML>
|