nugget-doom(6)

📦
version 6.1.0 · 2 versions
, in nixpkgs unstable

🎀 nugget-doom 🎀

okay so this is the Games Manual page for nugget-doom, section 6 of the manual, bestie — and it's a lot, so buckle up 💖

✨ NAME ✨

nugget-doom — Nugget Doom is a fork of Fabian Greffrath's Doom source port Woof!, and the whole point is that it implements extra features on top. icon behavior, no cap 🫶

🌸 SYNOPSIS 🌸

nugget-doom [OPTIONS]

💅 DESCRIPTION 💅

So Woof! is a source port built on top of Team Eternity's WinMBF, and its whole mission is making that thing accessible on modern systems. Nugget Doom is developed based on the Woof! code, and it's aiming to implement additional features that aren't present in Woof! itself. literally that's the vibe — same foundation, extra sprinkles 🦋

⭐ GENERAL OPTIONS ⭐

the everyday stuff, the main character options 💅

  • -config <file> — load your main configuration from the file you specify, instead of the default one.
  • -devparm — developer mode. go off, dev queen 👑
  • -file <files> — load the PWAD files you list here.
  • -help — print the command line help and be on your way.
  • -iwad <file> — specify exactly which IWAD file to use.
  • -nomusic — disable music. silent disco era 😭
  • -nosfx — disable sound effects.
  • -nosound — disable all sound output, periodt.
  • -quiet — print with minimum verbosity. lowkey mode 🫶
  • -save <directory> — pick the path you load and save games from. if that directory doesn't exist, it gets automatically created for you — no manual mkdir needed, slay ✨
  • -shotdir <directory> — pick the path where screenshots get saved. same deal: if it doesn't exist, it's automatically created 🎀
  • -verbose — print debugging info with maximum verbosity. it's giving loud and proud 📢
  • -version — print the program version and exit. quick vibe check.

🎮 GAME START OPTIONS 🎮

how you actually start playing — the setup era 🌈

  • -beta — press beta emulation mode (complevel mbf only).
  • -coop_spawns — start a single player game with item spawns as in a cooperative netgame.
  • -dog — enables a single helper dog. one (1) good boy 🐶
  • -dogs <n> — overrides the current number of helper dogs, setting it to n.
  • -episode <n> — start playing on episode n (1-99).
  • -fast — monsters move faster. stressed monsters fr 😭
  • -loadgame <ps> — load the game on page p (0-7) in slot s (0-7). use 255 to load an auto save.
  • -nm — alias to -skill 5.
  • -nomo — alias to -nomonsters.
  • -nomonsters — disable monsters. peaceful icon behavior 🌸
  • -pistolstart — enables automatic pistol starts on each level.
  • -respawn — monsters respawn after being killed. they're back and they're mad 💀
  • -skill <skill> — set the game skill, 1-6 (1: easiest, 5: hardest, 6: custom). a skill of 0 disables all monsters only in -complevel vanilla.
  • -speed <n> — increase or decrease game speed, as a percentage of normal.
  • -turbo <x> — turbo mode, bestie 🔥 the player's speed is multiplied by x%. if unspecified, x defaults to 200. values are rounded up to 10 and down to 400.
  • -uv — alias to -skill 4.
  • -warp <x> <y>|<xy> — start a game immediately, warping to ExMy (Doom 1) or MAPxy (Doom 2).

🖥️ DISPLAY OPTIONS 🖥️

screen size discourse, let's go 🎀

  • -1 — don't scale up the screen. implies -window.
  • -2 — double up the screen to 2x its normal size. implies -window.
  • -3 — triple up the screen to 3x its normal size. implies -window.
  • -fullscreen — run in fullscreen mode. main character energy, full frame 👑
  • -noblit — disable blitting the screen.
  • -nodraw — disable rendering the screen entirely. not me rendering nothing 🙈
  • -nograbmouse — don't grab the mouse when running in windowed mode.
  • -nouncapped — disables uncapped framerate.
  • -uncapped — enables uncapped framerate. frames go brrr ⭐
  • -window — run in a window.

🌐 NETWORKING OPTIONS 🌐

multiplayer hours, iykyk 🦋

  • -altdeath — start a deathmatch 2.0 game. weapons do not stay in place, and all items respawn after 30 seconds.
  • -autojoin — automatically search the local LAN for a multiplayer server and join it.
  • -avg — Austin Virtual Gaming: end levels after 20 minutes.
  • -connect <address> — connect to a multiplayer server running on the given address.
  • -deathmatch — start a deathmatch game.
  • -dedicated — start a dedicated server, routing packets but not participating in the game itself. it's the group chat admin who never speaks 💀
  • -dm3 — start a deathmatch 3.0 game. weapons stay in place, and all items respawn after 30 seconds.
  • -dup <n> — reduce the resolution of the game by a factor of n, reducing the amount of network bandwidth needed. data diet ✨
  • -extratics <n> — send n extra tics in every packet as insurance against dropped packets. safety net, we love her 🫶
  • -frags <n> — the -frags option allows you to deathmatch until one player achieves n frags, at which time the level ends and scores are displayed. if n is not specified, the match is to 10 frags.
  • -left — run as the left screen in three screen mode.
  • -nodes <n> — autostart the netgame when n nodes (clients) have joined the server.
  • -oldsync — use original network client sync code rather than the improved sync code.
  • -port <n> — use the specified UDP port for communications, instead of the default (2342).
  • -privateserver — when running a server, don't register with the global master server. implies -server. stealth mode activated 🙈
  • -right — run as the right screen in three screen mode.
  • -server — start a multiplayer server, listening for connections.
  • -servername <name> — when starting a network server, specify a name for the server.
  • -solo-net — start the game playing as though in a netgame with a single player. this can also be used to play back single player netgame demos.
  • -timer <n> — for multiplayer games: exit each level after n minutes.

🧚 DEHACKED AND WAD MERGING 🧚

the deep lore section, lowkey obsessed 💜

  • -blockmap — forces a (re-)building of the BLOCKMAP lumps for loaded maps.
  • -bsp — forces rebuilding of nodes.
  • -deh <files> — load the given dehacked/bex patch(es).
  • -dumptranmap <alpha> <name> — dump tranmap lump, given an alpha level (opacity percentage). valid values are 0 through to 99.
  • -force_old_zdoom_nodes — forces extended (non-GL) ZDoom nodes.
  • -noautoload — disable auto-loading of .wad and .deh files.
  • -nocheats — ignore cheats in dehacked files.
  • -nodeh — avoid loading DEHACKED lumps embedded into WAD files.
  • -nomapinfo — disable UMAPINFO loading.
  • -nooptions — avoid loading OPTIONS lumps embedded into WAD files.
  • -reject_pad_with_ff — pad the remaining REJECT table space with 0xff.
  • -tranmap — forces the (re-)building of the translucency table.

📼 DEMO OPTIONS 📼

recording and playback, the archivists of the group chat 🎀

  • -fastdemo <demo> — plays the given demo as fast as possible. speedrun the playback fr 🔥
  • -levelstat — write level statistics upon exit to levelstat.txt.
  • -longtics — record a high resolution "Doom 1.91" demo.
  • -maxdemo <size> — sets the initial size of the demo recording buffer (KiB). this is no longer a hard limit, and the buffer will expand if the given limit is exceeded — she grows 💅
  • -playdemo <demo> — play back the demo named demo.lmp.
  • -record <demo> — record a demo named demo.lmp.
  • -recordfrom <s> <demo> — record a demo, loading from the given save slot. equivalent to -loadgame <s> -record <demo>.
  • -recordfromto <demo1> <demo2> — allows continuing <demo1> after it ends or when the user presses the join demo key, the result getting saved as <demo2>. equivalent to -playdemo <demo1> -record <demo2>.
  • -shorttics — play with low turning resolution to emulate demo recording.
  • -skipsec <min:sec> — skip min:sec time during viewing of the demo. -warp <x> -skipsec <min:sec> will skip min:sec time on level x.
  • -tas — lifts strict mode restrictions according to DSDA rules.
  • -timedemo <demo> — play back the demo named demo.lmp, determining the framerate of the screen.

🌈 COMPATIBILITY 🌈

so your old stuff actually works, we love backwards compatibility 🫶

  • -cl <version> — alias to -complevel.
  • -complevel <version> — emulate a specific version of Doom/Boom/MBF. valid values are "vanilla", "boom", "mbf", "mbf21".
  • -gameversion <version> — emulate a specific version of Doom. valid values are "1.9", "ultimate", "final", "final2", "chex". requires -complevel vanilla.
  • -setmem <version> — specify DOS version to emulate for NULL pointer dereference emulation. supported versions are: dos622, dos71, dosbox. the default is to emulate DOS 7.1 (Windows 98).
  • -spechit <n> — use the specified magic value when emulating spechit overruns.
  • -statdump <filename> — dump statistics information to the specified file on the levels that were played. the output from this option matches the output from statdump.exe (see ctrlapi.zip in the /idgames archive).

💀 OBSCURE AND LESS-USED OPTIONS 💀

the cryptids of the option list 🙈

  • -cdrom [windows only] — save configuration data and savegames in c:\doomdata, allowing play from CD.
  • -nogui — don't pop up a GUI dialog box to show the error message. just tell me in text, i can handle it 😭
ok that's part 1 bestie — there's more coming, don't go anywhere 💖

💖 IWAD SEARCH PATHS 💖

okay so to play, an IWAD file is needed. This is a large file containing all of the levels, graphics, sound effects, music and other material that make up the game. IWAD files are named according to the game; the standard names are:

  • doom.wad, doom1.wad, doom2.wad, tnt.wad, plutonia.wad — Doom, Doom II, Final Doom
  • hacx.wad, chex.wad — Hacx and Chex Quest - more obscure games based on the Doom engine.
  • freedm.wad, freedoom1.wad, freedoom2.wad — The Freedoom open content IWAD files.

The following directory paths are searched in order to find an IWAD:

  • Current working directory — Any IWAD files found in the current working directory will be used in preference to IWADs found in any other directories.
  • DOOMWADDIR — This environment variable can be set to contain a path to a single directory in which to look for IWAD files. This environment variable is supported by most Doom source ports.
  • DOOMWADPATH — This environment variable, if set, can contain a colon-separated list of directories in which to look for IWAD files, or alternatively full paths to specific IWAD files.
  • $HOME/.local/share/games/doom — Writeable directory in the user's home directory. The path can be overridden using the XDG_DATA_HOME environment variable (see the XDG Base Directory Specification).
  • /usr/local/share/doom, /usr/local/share/games/doom, /usr/share/doom, /usr/share/games/doom — System-wide locations that can be accessed by all users. The path /usr/share/games/doom is a standard path that is supported by most Doom source ports. These paths can be overridden using the XDG_DATA_DIRS environment variable (see the XDG Base Directory Specification).

The above can be overridden on a one-time basis by using the -iwad command line parameter to provide the path to an IWAD file to use. This parameter can also be used to specify the name of a particular IWAD to use from one of the above paths. For example, -iwad doom.wad will search the above paths for the file doom.wad to use.

🎀 FILES 🎀

  • $HOME/.local/share/nugget-doom.cfg — The main configuration file for Nugget Doom. See default.cfg(5).
  • $HOME/.local/share/nugget-doom/nugget-doomsav*.dsg — Savegame files.
  • $HOME/.local/share/nugget-doom/tranmaps/ — Cached translucency tables.
  • /usr/share/nugget-doom/autoload, $HOME/.local/share/nugget-doom/autoload/ — WAD files and DEH patches in the subdirectories of these paths are added automatically when a WAD file of the corresponding name is loaded.

👀 SEE ALSO 👀

💅 AUTHOR 💅

Nugget Doom is written and maintained by Alaux. It is based on the Woof! source code, released by Fabian Greffrath.

Copyright © id Software Inc; Copyright © 1999 id Software, Chi Hoang, Lee Killough, Jim Flynn, Rand Phares, Ty Halderman; Copyright © 2004 James Haley; Copyright © 2005-2016 Simon Howard; Copyright © 2020-2022 Fabian Greffrath; Copyright © 2020-2022 Roman Fomin.

This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.

okay bestie, that's the whole page — the source/version and date footer are chilling at the very bottom, and this one's nugget-doom(6). catch u later, mwah 💖

📦 where this page comes from