1PRBOOM-PLUS(6) Games Manual PRBOOM-PLUS(6)
2
6 prboom-plus - PrBoom+, a version of Doom for Unix, Linux and Windows
7 systems
8
10 prboom-plus [options] [values|files]
11
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 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
25 -complevel lvl
26 This sets the compatibility mode that PrBoom+ runs in. If you
27 need to change this, see README.compat.
28 -loadgame { 0,1,2,3,4,5,6,7 }
30 Instructs PrBoom+ to load the specified saved game immediately.
31 -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 -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 -respawn
46 Tells PrBoom+ that monsters that die should respawn (come back
47 to life) after a while. Not for the inexperienced.
48 -fast Tells PrBoom+ to make all the monsters move and react faster.
50 Not for the inexperienced.
51 -nomonsters
53 Tells PrBoom+ to include no monsters in the game.
54 -nocheats
56 Disable applying cheats from dehacked files.
57
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 -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 -deh deh_file
71 Tells PrBoom+ to load the dehacked patch deh_file.
72
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 -playdemo demofile
80 Play the recorded demo demofile.lmp.
81 -timedemo demofile
83 Play the recorded demo demofile.lmp, reporting information about
84 the length of the demo (in gametics) afterwards.
85 -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 -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 -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 -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 -avidemo fileprefix
108 Grabbing of the screenshots to frmXXXX.tga.
109 -skipsec x
111 Skip X secs during viewing of the demo.
112 -warp x -skipsec y
114 Will skip y seconds on level x.
115 -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 -levelstat
122 Outputs a text-file called levelstat.txt containing level-by-
123 level information on times, kills, items and secrets.
124 -spechit xxx
126 Provides a spechits magic number, overriding the program's
127 default value.
128 -nomonsters
130 For playback of -nomonsters demos recorded with Doom.exe 1.2.
131 -respawn
133 For playback of -respawn demos recorded with Doom.exe 1.2.
134 -auto Enables the autoloading of wads according to the lmp file-name.
136 See below for information.
137 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 -force_monster_avoid_hazards
148 For viewing old desynching doom-compatible PrBoom demos recorded
149 with "monster_avoid_hazards 1" in config.
150 -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 -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 -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 -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 -force_prboom_friction
172 For emulation of old buggy behaviour whereby Boom's friction and
173 bobbing code were not faithfully replicated.
174 -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 -force_lxdoom_demo_compatibility
180 For emulation of all bugs in demo compatibility mode in lxdoom.
181 -boom_deh_parser
183 Forces the Boom DEH parser.
184 -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
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 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 -port portnum
209 Specifies the local port to use to communicate with the server
210 in a netgame.
211 -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 -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 -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 -avg Equivalent to -timer 20.
228 -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
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 -height h
240 Specifies the height of the PrBoom+ window, in pixels. Default
241 is 200, the height must be greater than 200.
242 -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 -vidmode gl
249 Use the OpenGL video mode. The default is to use the software
250 video mode.
251 -fullscreen, -nofullscreen
253 These options toggle fullscreen mode. The default is fullscreen.
254 -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 -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 -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 -nodraw
276 Suppress all graphical display. Only for debugging & demo test‐
277 ing.
278 -aspect NxM
280 For using a different aspect ratio; e.g. -aspect 5x4, -aspect
281 8x5 or -aspect 2x1.
282 -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 -resetgamma
289 Restores the original gamma after a crash.
290 -geom NxM
292 Basic syntax, for temporarily using a particular resolution
293 without saving this in the cfg; e.g. -geom 1280x1024.
294 -geom WidthxHeight[w|f]
296 Advanced syntax, w - windowed, f - fullscreen. Examples: -geom
297 320x200f, -geom 640x480w.
298
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 -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 -nomusic
309 Disables playing of music in the game.
310 -nojoy Disables joystick support.
312 -nomouse
314 Prevents the mouse being grabbed by the PrBoom+ window.
315 -shorttics
317 Forces the same mouse behaviour as when recording (i.e. the con‐
318 verse of "-longtics").
319
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 -save savedir
327 Causes PrBoom+ to save games in the directory specified by
328 savedir instead of ~/.prboom-plus/.
329 -shotdir shotdir
331 Causes PrBoom+ to save screenshots in shotdir instead of the
332 current directory.
333
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 -debugfile debug_file
341 Causes some debugging information, mainly network info, to be
342 written to the named file as PrBoom+ runs.
343 -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 -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 -bexout bexdbg
356 Causes diagnostics related to bex and dehacked file processing
357 to be written to the names file.
358 -blockmap
360 Use if PrBoom-Plus reports a buggy blockmap.
361
363 prboom-plus.cfg(5), prboom-plus-game-server(6)
364 For more information, see the README that came with PrBoom+, the Boom
366 documentation, and your original Doom documentation.
367 Doom is a registered trademark of id software (http://www.idsoft‐
369 ware.com/).
370
372 See the file AUTHORS included with the PrBoom+ distribution.
373 2011-06-27 PRBOOM-PLUS(6)