1PRBOOM-PLUS(6)                   Games Manual                   PRBOOM-PLUS(6)
2
3
4

NAME

6       prboom-plus  -  PrBoom+,  a version of Doom for Unix, Linux and Windows
7       systems
8

SYNOPSIS

10       prboom-plus [options] [values|files]
11

DESCRIPTION

13       PrBoom is a version of the first-person shooter game  Doom,  originally
14       released  by  iD  software  in 1993.  It is based on Boom, a version of
15       Doom adapted by TeamTNT (http://www.teamtnt.com/) for Dos. PrBoom  uses
16       the  SDL library, meaning it can run on a variety of different systems,
17       including Windows and Unix/X11.
18
19       PrBoom+ is a Doom  source  port  developed  from  the  original  PrBoom
20       project.   It  adds  uncapped framerate, variable gamespeed, re-record,
21       walkcam, chasecam, full mouselook, FOV and other features without  loss
22       of compatibility with original Doom.
23

GAME OPTIONS

25       -complevel lvl
26              This  sets  the  compatibility mode that PrBoom+ runs in. If you
27              need to change this, see README.compat.
28
29       -loadgame { 0,1,2,3,4,5,6,7 }
30              Instructs PrBoom+ to load the specified saved game immediately.
31
32       -warp { map | epis level }
33              Tells PrBoom+ to begin a new game immediately. For Doom 1 or The
34              Ultimate  Doom, you must specify the episode and level number to
35              begin at (epis is 1 for Knee-Deep in the Dead, 2 for  Shores  of
36              Hell,  3 for Inferno, 4 for Thy flesh Consumed; level is between
37              1 and 9). For Doom 2 or Final Doom, you must specify the map  to
38              begin at, which is between 1 and 32 (30 for German Doom 2).
39
40       -skill n
41              Tells  PrBoom+ to begin the game at skill level n (1 for I'm Too
42              Young To Die; 2 for Hey, Not Too Rough; 3 for Hurt Me Plenty;  4
43              for Ultra-Violent; 5 for Nightmare!).
44
45       -respawn
46              Tells  PrBoom+  that monsters that die should respawn (come back
47              to life) after a while. Not for the inexperienced.
48
49       -fast  Tells PrBoom+ to make all the monsters move  and  react  faster.
50              Not for the inexperienced.
51
52       -nomonsters
53              Tells PrBoom+ to include no monsters in the game.
54
55       -nocheats
56              Disable applying cheats from dehacked files.
57

WAD OPTIONS

59       -iwad iwadname
60              Specifies  the  location of the IWAD file, typically doom.wad or
61              doom2.wad (or doom2f.wad). This tells  PrBoom+  where  the  main
62              .wad file that came with the version of Doom that you own is.
63
64       -file wad1 ...
65              Specifies  a  list of PWAD files to load in addition to the IWAD
66              file. PWAD files modify the existing Doom game, by adding levels
67              or  new  sounds or graphics. PWAD files are widely available for
68              download; try http://www.doomworld.com/idgames/ for starters.
69
70       -deh deh_file
71              Tells PrBoom+ to load the dehacked patch deh_file.
72

DEMO (LMP) OPTIONS

74       -record demofile
75              Instructs PrBoom+ to begin recording a demo,  to  be  stored  in
76              demofile.lmp.   You should specify game options to specify which
77              level and skill to record at.
78
79       -playdemo demofile
80              Play the recorded demo demofile.lmp.
81
82       -timedemo demofile
83              Play the recorded demo demofile.lmp, reporting information about
84              the length of the demo (in gametics) afterwards.
85
86       -viddump filename
87              Record  a movie file, it requires external command-line encoding
88              tools, oggenc2 (ogg vorbis  audio  encoder),  x264  (h264  video
89              encoder)  and mkvmerge (mkv muxer).  It is meant to be used with
90              -timedemo, e.g.   "prboom-plus  -timedemo  anydemo.lmp  -viddump
91              filename.mkv".
92
93       -fastdemo demofile
94              Play  the recorded demo demofile.lmp as fast as possible. Useful
95              for benchmarking PrBoom+, as compared to other versions of Doom.
96
97       -ffmap num
98              Fast forward the demo (play at max speed) until reaching map num
99              (note  that  this  takes  just  a  number, not a map name, so so
100              -ffmap 7 to go fast until MAP07 or ExM7).
101
102       -warp x
103              Warps directly to the start of map x of a recording without ren‐
104              dering  any  of the play up to that point. Pressing Use (<Space>
105              by default) during skipping shows the current frame.
106
107       -avidemo fileprefix
108              Grabbing of the screenshots to frmXXXX.tga.
109
110       -skipsec x
111              Skip X secs during viewing of the demo.
112
113       -warp x -skipsec y
114              Will skip y seconds on level x.
115
116       -recordfromto n.lmp m
117              Play back the demo n.lmp, allowing the user  to  take  over  the
118              controls at a point of his choosing, and save the resulting demo
119              as m.lmp.
120
121       -levelstat
122              Outputs a text-file called  levelstat.txt  containing  level-by-
123              level information on times, kills, items and secrets.
124
125       -spechit xxx
126              Provides  a  spechits  magic  number,  overriding  the program's
127              default value.
128
129       -nomonsters
130              For playback of -nomonsters demos recorded with Doom.exe 1.2.
131
132       -respawn
133              For playback of -respawn demos recorded with Doom.exe 1.2.
134
135       -auto  Enables the autoloading of wads according to the lmp  file-name.
136              See below for information.
137
138   DEMOS OLD VERSIONS COMPATIBILITY PARAMETERS
139       -emulate prboom_ver
140              For  viewing old desynching PrBoom demos with all recording bugs
141              from a  particular  version  emulated.  For  example,  "-emulate
142              2.2.6"  would  be  used  to play back a desynching demo recorded
143              with PrBoom 2.2.6. This would be instead of  using  the  various
144              command-line  options  for  each  recording bug (see below) from
145              that version.
146
147       -force_monster_avoid_hazards
148              For viewing old desynching doom-compatible PrBoom demos recorded
149              with "monster_avoid_hazards 1" in config.
150
151       -force_remove_slime_trails
152              For  viewing  old desynching doom-compatible demos recorded with
153              old versions of PrBoom (< 2.4.6) or PrBoom+ (< 2.4.6.1) that are
154              affected by the "remove slime trails" incompatibility.
155
156       -reject_pad_with_ff
157              For  viewing  old desynching doom-compatible demos recorded with
158              old versions of PrBoom (including 2.2.5 and 2.2.6) that padded a
159              short REJECT with ones instead of zeroes.
160
161       -force_truncated_sector_specials
162              For  emulation of old buggy behaviour whereby Boom's generalized
163              effects could work instead of failing in a compatibility mode in
164              the case of a bad action number.
165
166       -force_no_dropoff
167              For  emulation  of MBF_compatibility behaviour in PrBoom 2.2.2 -
168              2.4.7, whereby things did not drop off ledges  when  they  would
169              have done in MBF.
170
171       -force_prboom_friction
172              For emulation of old buggy behaviour whereby Boom's friction and
173              bobbing code were not faithfully replicated.
174
175       -force_force_boom_brainawake
176              For emulation of Boom's behaviour with respect  to  the  Monster
177              Spawner, which differed slightly from that of "vanilla" Doom.
178
179       -force_lxdoom_demo_compatibility
180              For emulation of all bugs in demo compatibility mode in lxdoom.
181
182       -boom_deh_parser
183              Forces the Boom DEH parser.
184
185       -setmem system
186              The  desynch  in  fez1-924.lmp @ fez1.wad is gone, but you still
187              need to add "-setmem dosbox" or  "-setmem  dos71"  command  line
188              parameter,  because  the default "dos622" memory layout causes a
189              desynch.
190

MULTIPLAYER OPTIONS

192       -net hostname[:port]
193              Specifies that a TCP/IP network game is to be started.  hostname
194              is  the  name of the machine on which the network game server is
195              running (prboom-plus-game-server). For  more  information  about
196              this,  see  prboom-plus-game-server(6)  and the README that came
197              with PrBoom+. port is the port number on the remote  machine  to
198              which  to  connect; if not specified, the default of 5030 (which
199              is the default for prboom-plus-game-server(6) ) is assumed.  The
200              server  will  configure  your  PrBoom+ settings, so that all the
201              players have the same game settings (skill, map etc).
202
203       Also, the server may specify additional PWAD files to play with; if you
204       do  not  have the required .WAD file, PrBoom+ will ask the server for a
205       download path, and attempt to use wget(1) and if necessary unzip(1)  to
206       download and extract the required WAD.
207
208       -port portnum
209              Specifies  the  local port to use to communicate with the server
210              in a netgame.
211
212       -deathmatch
213              No longer used. Tells PrBoom+ to begin a  deathmatch  game,  but
214              this is overridden by the server's settings. Only works for sin‐
215              gle play (!).
216
217       -altdeath
218              Similar to -deathmatch, but implies a different set of rules for
219              the deathmatch game. No longer used (specified by the server).
220
221       -timer mins
222              No  longer  used. Specifies that levels will end after mins min‐
223              utes of play if the level is still being played, but is overrid‐
224              den  by  the  server  in a netgame. Not really useful for single
225              play.
226
227       -avg   Equivalent to -timer 20.
228
229       -solo-net
230              Used to run a single-player network game, without a network game
231              server.  This enables network game items & options for an other‐
232              wise single-player game; some demos are recorded like this.
233

VIDEO OPTIONS

235       -width w
236              Specifies the width of the PrBoom+ window, in pixels. Default is
237              320, the width must be greater than 320.
238
239       -height h
240              Specifies  the  height of the PrBoom+ window, in pixels. Default
241              is 200, the height must be greater than 200.
242
243       -viewangle n
244              Causes the player view to be rotated by a given  offset  (speci‐
245              fied in 45degree increments, in the range 0..7) from the way the
246              player is facing.
247
248       -vidmode gl
249              Use the OpenGL video mode. The default is to  use  the  software
250              video mode.
251
252       -fullscreen, -nofullscreen
253              These options toggle fullscreen mode. The default is fullscreen.
254
255       -window, -nowindow
256              This pair of options also toggle fullscreen mode. They only take
257              effect for this PrBoom+ session and do not alter your configura‐
258              tion file.
259
260       -noaccel
261              For  PrBoom+, this prevents it using the MITShm server extension
262              for passing the screen data to the X server. This option may  be
263              required  if  the  X server is not local. For lsdoom, this tells
264              lsdoom not  to  use  the  accelerated  graphics  functions  that
265              SVGALib  provides  even  when  they are supported for your video
266              card (normally this is autodetected).
267
268       -1, -2, -3
269              Specifies the scale factor by which to enlarge the  window.  The
270              default,  -1,  displays the normal 320x200 pixel Doom screen (or
271              whatever size is specified by the -width and -height  parameters
272              or  in  the  config  file  for  PrBoom+).  If this window is too
273              small, try using -2 or -3 to enlarge the window.
274
275       -nodraw
276              Suppress all graphical display. Only for debugging & demo  test‐
277              ing.
278
279       -aspect NxM
280              For  using  a  different aspect ratio; e.g. -aspect 5x4, -aspect
281              8x5 or -aspect 2x1.
282
283       -videodriver name
284              For setting up the videodriver name that SDL will use  (See  SDL
285              documentation).  "-videodriver default" can be used to force SDL
286              behaviour by default.
287
288       -resetgamma
289              Restores the original gamma after a crash.
290
291       -geom NxM
292              Basic syntax, for  temporarily  using  a  particular  resolution
293              without saving this in the cfg; e.g. -geom 1280x1024.
294
295       -geom WidthxHeight[w|f]
296              Advanced  syntax,  w - windowed, f - fullscreen. Examples: -geom
297              320x200f, -geom 640x480w.
298

I/O OPTIONS

300       -nosound
301              Disables all sound effects and in-game music. This prevents  the
302              sound server loading, which lets the game run a little faster.
303
304       -nosfx Disables  sound  effects during the game. This does not stop the
305              sound server loading,  however,  so  for  best  performance  use
306              -nosound.
307
308       -nomusic
309              Disables playing of music in the game.
310
311       -nojoy Disables joystick support.
312
313       -nomouse
314              Prevents the mouse being grabbed by the PrBoom+ window.
315
316       -shorttics
317              Forces the same mouse behaviour as when recording (i.e. the con‐
318              verse of "-longtics").
319

CONFIGURATION

321       -config myconf
322              Loads an  alternative  configuration  file,  named  myconf.  The
323              default  is prboom-plus.cfg(5), taken from the same directory as
324              PrBoom+ was run from.
325
326       -save savedir
327              Causes PrBoom+ to save  games  in  the  directory  specified  by
328              savedir instead of ~/.prboom-plus/.
329
330       -shotdir shotdir
331              Causes  PrBoom+  to  save  screenshots in shotdir instead of the
332              current directory.
333

DEBUGGING/PROFILING OPTIONS

335       -devparm
336              Development mode. Mostly redundant these days, but it does force
337              non-lazy  generation  of texture lookups which can be useful for
338              level authors debugging PWADs.
339
340       -debugfile debug_file
341              Causes some debugging information, mainly network  info,  to  be
342              written to the named file as PrBoom+ runs.
343
344       -nodrawers
345              Causes no rendering to be done. The only conceivable use of this
346              is (a) a multiplayer server (b) to test the speed of  the  other
347              routines in the program, when combined with -timedemo.
348
349       -noblit
350              Causes  no copying to the screen from the rendering buffer to be
351              performed.  The only conceivable use of this  is  (a)  a  multi‐
352              player server (b) to test the speed of the other routines in the
353              program, when combined with -timedemo.
354
355       -bexout bexdbg
356              Causes diagnostics related to bex and dehacked  file  processing
357              to be written to the names file.
358
359       -blockmap
360              Use if PrBoom-Plus reports a buggy blockmap.
361

SEE ALSO

363       prboom-plus.cfg(5), prboom-plus-game-server(6)
364
365       For  more  information, see the README that came with PrBoom+, the Boom
366       documentation, and your original Doom documentation.
367
368       Doom is a  registered  trademark  of  id  software  (http://www.idsoft
369       ware.com/).
370

AUTHORS

372       See the file AUTHORS included with the PrBoom+ distribution.
373
374
375
376                                  2011-06-27                    PRBOOM-PLUS(6)
Impressum