Introduction (Readme)

From Doomsday Wiki
Jump to: navigation, search

Introduction

The Doomsday Engine is a "source port" of id Software's Doom and Raven Software's Heretic and Hexen, which were popular PC FPS games in the early-to-mid 1990s. Doomsday enhances these classic games with many features including 3D graphics, fully customizable controls and client/server networking, making them more accessible to modern gamers. However, the feel of the original games has been kept intact, ensuring sublime nostalgia or an exciting introduction into the pioneering games of the genre.

Doomsday and the associated ports of Doom, Heretic and Hexen have been in development since 1999; the first versions were released in late 1999 and early 2000. Several people have been involved in the project (see Acknowledgements).

Features

User interface:

Graphics:

Resources:

Audio:

  • Plugin based driver architecture
  • Uses FMOD Ex for audio playback (sound effects, music, CD audio tracks)
  • Supports the open source SDL_mixer for sound effects and music files
  • DirectSound3D, EAX 2.0, Windows Multimedia (for MIDI)
  • External music files in MP3 and other formats
  • 3D positional sound effects
  • Environmental echo and reverb effects
  • Runtime sound effect resampling to 22/44 KHz with 8/16 bits

Multiplayer:

  • TCP-based client/server networking
  • Automatical discovery of servers running on the local network
  • Central master server for discovery of servers on the internet
  • Standalone server running as a daemon/background process
  • Standalone Doomsday Shell tool for server management (both local and remote)
  • Supports up to 15 player games
  • Clients can join games in progress
  • In-game chat and server management (via a shell login)

Other:

Requirements

  • At least one WAD file from the original Doom, Heretic, Hexen, or other supported game
  • Minimum OS version: Windows Vista
  • DirectX 8 (or newer)
  • A display adapter capable of OpenGL 2.0 hardware acceleration

Game modes

One game plugin, such as libdoom, is able to run in many different modes. Each mode emulates a specific version of the original game and typically has its own IWAD file.

Below is a list of all the game modes supported by the game plugins distributed with Doomsday: libdoom (previously called jDoom), libheretic (jHeretic) and libhexen (jHexen).

Plugin Game Mode Description
libdoom doom1-share Shareware Doom v1.9
doom1 Registered Doom v1.9
doom1-ultimate Ultimate Doom*
doom2 Doom 2
doom2-plut Final Doom: Plutonia Experiment
doom2-tnt Final Doom: TNT Evilution
chex Chex Quest
hacx HacX
libheretic heretic-share Shareware Heretic
heretic Registered Heretic
heretic-ext Heretic: Shadow of the Serpent Riders**
libhexen hexen Hexen v1.1
hexen-v10 Hexen v1.0
hexen-dk Hexen: Death Kings of Dark Citadel
hexen-demo The 4-level Hexen Demo
* = has a 4th episode ** = has episodes 4 and 5

To help libhexen recognize the IWAD of the 4-level Hexen (beta) demo, you should rename the IWAD to hexendemo.wad.

Documentation

Additional documentation is available online in the Doomsday Engine Wiki. Information in the wiki includes:

Known issues

Doomsday is a work in progress, so there usually is a number of known issues that will be addressed in the future.

Bugs and Features
The official place to report new bugs, submit feature requests and browse the existing reports is the Deng Team's own Issue Tracker.
Multiplayer Issues
There is a to-do list of known multiplayer issues and needed enhancements maintained by skyjake.

Introduction

The Doomsday Engine is a "source port" of id Software's Doom and Raven Software's Heretic and Hexen, which were popular PC FPS games in the early-to-mid 1990s. Doomsday enhances these classic games with many features including 3D graphics, fully customizable controls and client/server networking, making them more accessible to modern gamers. However, the feel of the original games has been kept intact, ensuring sublime nostalgia or an exciting introduction into the pioneering games of the genre.

Doomsday and the associated ports of Doom, Heretic and Hexen have been in development since 1999; the first versions were released in late 1999 and early 2000. Several people have been involved in the project (see Acknowledgements).

How to install

The Doomsday.pkg installer package contains two applications:

  • Doomsday Engine: launcher frontend for starting Doomsday
  • Doomsday Shell: tool for running and monitoring your own multiplayer servers (introduced in version 1.10)

We also provide the Doomsday Engine and Doomsday Shell applications as individual downloads that you can drag and drop anywhere you like. You can find these in the Build Repository. However, the automatic updater will always download a full installer package.

The first time you start the frontend, a setup wizard will guide you through setting up some game profiles.

To uninstall, move Doomsday Engine and Doomsday Shell to the Trash. If you wish to also delete your frontend game profiles, savegames and other persistent data, delete the ~/Library/Application Support/Doomsday Engine folder.

Features

User interface:

Graphics:

Resources:

Audio:

  • Plugin based driver architecture
  • Uses FMOD Ex for audio playback (sound effects, music, CD audio tracks)
  • Supports the open source SDL_mixer for sound effects and music files
  • FluidSynth for MIDI playback using SF2 soundfonts
  • QuickTime for music playback
  • External music files in MP3 and other formats
  • 3D positional sound effects
  • Environmental echo and reverb effects
  • Runtime sound effect resampling to 22/44 KHz with 8/16 bits

Multiplayer:

  • TCP-based client/server networking
  • Automatical discovery of servers running on the local network
  • Central master server for discovery of servers on the internet
  • Standalone server running as a daemon/background process
  • Standalone Doomsday Shell tool for server management (both local and remote)
  • Supports up to 15 player games
  • Clients can join games in progress
  • In-game chat and server management (via a shell login)

Other:

Requirements

  • At least one WAD file from the original Doom, Heretic, Hexen, or other supported game
  • Minimum OS version: Mac OS X 10.6
  • Supported CPU architectures: 64-bit/32-bit Intel
  • A display adapter capable of OpenGL 2.0 hardware acceleration

Game modes

One game plugin, such as libdoom, is able to run in many different modes. Each mode emulates a specific version of the original game and typically has its own IWAD file.

Below is a list of all the game modes supported by the game plugins distributed with Doomsday: libdoom (previously called jDoom), libheretic (jHeretic) and libhexen (jHexen).

Plugin Game Mode Description
libdoom doom1-share Shareware Doom v1.9
doom1 Registered Doom v1.9
doom1-ultimate Ultimate Doom*
doom2 Doom 2
doom2-plut Final Doom: Plutonia Experiment
doom2-tnt Final Doom: TNT Evilution
chex Chex Quest
hacx HacX
libheretic heretic-share Shareware Heretic
heretic Registered Heretic
heretic-ext Heretic: Shadow of the Serpent Riders**
libhexen hexen Hexen v1.1
hexen-v10 Hexen v1.0
hexen-dk Hexen: Death Kings of Dark Citadel
hexen-demo The 4-level Hexen Demo
* = has a 4th episode ** = has episodes 4 and 5

To help libhexen recognize the IWAD of the 4-level Hexen (beta) demo, you should rename the IWAD to hexendemo.wad.

Documentation

Additional documentation is available online in the Doomsday Engine Wiki. Information in the wiki includes:

Known issues

Doomsday is a work in progress, so there usually is a number of known issues that will be addressed in the future.

Bugs and Features
The official place to report new bugs, submit feature requests and browse the existing reports is the Deng Team's own Issue Tracker.
Multiplayer Issues
There is a to-do list of known multiplayer issues and needed enhancements maintained by skyjake.

Synopsis

doomsday [-iwad dir] [-game mode] [-wnd] [-wh w h] [-v] [-file file ...]

Note that the command line is not interpreted according to GNU conventions. Everything following -- is ignored. @ can be used to specify a response file whose contents are added to the command line.

Options

-iwad
Specifies a directory where to look for IWAD files. Searches for IWADs from all known games and automatically loads them when needed.
-game
Sets the game to load after startup. See Game modes for a list of available games. For example:
-game doom1-ultimate

If -game is not specified, Doomsday will start in "ringzero" mode: a plain console with no game loaded.

-wnd
Starts in windowed mode (also -window). The default is to start in fullscreen mode.
-wh
Sets the size of the Doomsday window. In fullscreen mode specifies which display resolution to use.
-v
Print verbose log messages (also -verbose). Specify more than once for extra verbosity.
-file
Specify one or more resource files (WAD, LMP, PK3) to load at startup. More files can be loaded at runtime with the load command.

More command line options are listed in the Options Reference in the Doomsday Engine Wiki.

Description

The Doomsday Engine is a "source port" of id Software's Doom and Raven Software's Heretic and Hexen, which were popular PC FPS games in the early-to-mid 1990s. Doomsday enhances these classic games with many features including 3D graphics, fully customizable controls and client/server networking, making them more accessible to modern gamers. However, the feel of the original games has been kept intact, ensuring sublime nostalgia or an exciting introduction into the pioneering games of the genre.

Doomsday and the associated ports of Doom, Heretic and Hexen have been in development since 1999; the first versions were released in late 1999 and early 2000. Several people have been involved in the project (see Acknowledgements).

Features

User interface:

Graphics:

Resources:

Audio:

  • Plugin based driver architecture
  • Uses FMOD Ex for audio playback (sound effects, music, CD audio tracks)
  • Supports the open source SDL_mixer for sound effects and music files
  • FluidSynth for MIDI playback using SF2 soundfonts
  • OpenAL
  • External music files in MP3 and other formats
  • 3D positional sound effects
  • Environmental echo and reverb effects
  • Runtime sound effect resampling to 22/44 KHz with 8/16 bits

Multiplayer:

  • TCP-based client/server networking
  • Automatical discovery of servers running on the local network
  • Central master server for discovery of servers on the internet
  • Standalone server running as a daemon/background process
  • Standalone Doomsday Shell tool for server management (both local and remote)
  • Supports up to 15 player games
  • Clients can join games in progress
  • In-game chat and server management (via a shell login)

Other:

Requirements

  • At least one WAD file from the original Doom, Heretic, Hexen, or other supported game
  • A display adapter capable of OpenGL 2.0 hardware acceleration

Game modes

One game plugin, such as libdoom, is able to run in many different modes. Each mode emulates a specific version of the original game and typically has its own IWAD file.

Below is a list of all the game modes supported by the game plugins distributed with Doomsday: libdoom (previously called jDoom), libheretic (jHeretic) and libhexen (jHexen).

Plugin Game Mode Description
libdoom doom1-share Shareware Doom v1.9
doom1 Registered Doom v1.9
doom1-ultimate Ultimate Doom*
doom2 Doom 2
doom2-plut Final Doom: Plutonia Experiment
doom2-tnt Final Doom: TNT Evilution
chex Chex Quest
hacx HacX
libheretic heretic-share Shareware Heretic
heretic Registered Heretic
heretic-ext Heretic: Shadow of the Serpent Riders**
libhexen hexen Hexen v1.1
hexen-v10 Hexen v1.0
hexen-dk Hexen: Death Kings of Dark Citadel
hexen-demo The 4-level Hexen Demo
* = has a 4th episode ** = has episodes 4 and 5

To help libhexen recognize the IWAD of the 4-level Hexen (beta) demo, you should rename the IWAD to hexendemo.wad.

Documentation

Additional documentation is available online in the Doomsday Engine Wiki. Information in the wiki includes:

Known issues

Doomsday is a work in progress, so there usually is a number of known issues that will be addressed in the future.

Bugs and Features
The official place to report new bugs, submit feature requests and browse the existing reports is the Deng Team's own Issue Tracker.
Multiplayer Issues
There is a to-do list of known multiplayer issues and needed enhancements maintained by skyjake.