
                            D O O M S D A Y   2 0 2 6
                            =========================

                  A roguelike dungeon crawler for the terminal
          Originally by Dave Scheifler, Digital Equipment Corp, 1986-1987
                Ported to Unix (macOS / Linux) and OpenVMS x86-64

   This is the 40th anniversary tribute edition of the classic DoomsDay
   2000, released as DoomsDay 2026 in December 2026 to honor the original
   1986 game and its enduring legacy in the VMS and roguelike communities.


 HISTORY
 -------

   DoomsDay 2000 is an iconic sci-fi roguelike originally created for the
   VMS operating system on DEC VAX computers.  Dave Scheifler developed the
   game on a DEC VAX mainframe in 1986 after nearly a year of testing and
   released it in 1987.

   Once released over the early internet, it spread rapidly to Digital
   Equipment Corporation (DEC) offices worldwide.  Scheifler famously
   tracked its spread using pushpins on a world map in his office.

   Years before id Software released its famous first-person shooter, DEC
   employees routinely referred to DoomsDay 2000 simply as "Doom."

   Retrocomputing enthusiasts regularly group DoomsDay 2000 alongside
   foundational mainframe titles like Moria, VAXtrek, and Dungeon
   (mainframe Zork).

   Unlike traditional fantasy roguelikes, the game drops players into a
   futuristic alien invasion, featuring randomized "strange devices" that
   must be identified at libraries or tested through risky trial and error,
   across 16 randomly generated regions.

   Following its mainframe success, the game was adapted into commercial
   shareware for Macintosh in 1992 under the title Mission Thunderbolt.
   Its complete history is cataloged on MobyGames.


 BUILDING
 --------

   Unix (macOS / Linux)
   ~~~~~~~~~~~~~~~~~~~~

   Requirements: C compiler (cc/gcc/clang), ncurses library, make

   macOS:   make            (ncurses is included with Xcode tools)
   Linux:   make            (install libncurses-dev or ncurses-devel first)

   The binary is produced as ./doomsday2026

   OpenVMS x86-64 (9.x)
   ~~~~~~~~~~~~~~~~~~~~~

   Requirements: VSI C compiler

   Place sources in [.SRC] under the build directory, then:

     $ @BUILD                  Full build (compile + link)
     $ @BUILD LINK             Link only (skip compilation)
     $ @BUILD CLEAN            Remove objects and executable

   The executable is produced as DOOMSDAY2026.EXE


 STARTING THE GAME
 -----------------

   Unix:      ./doomsday2026
   OpenVMS:   RUN DOOMSDAY2026

   The game reads options from doom.opt (DOOM.OPT on VMS) in the current
   directory.  You can edit this file to change your character name, toggle
   the introduction, and configure display preferences.  See OPTIONS below.

   On first launch, your character's attributes (Strength, Dexterity,
   Intelligence, Vision, Hearing) are rolled randomly.  You begin on
   dungeon level 1 of the MegaTech underground facility.

   If a save file exists (doom.dat / DOOM.DAT) in the current directory,
   the game automatically restores it on startup.  There is no separate
   load command -- simply run the game and your progress is resumed.


 THE STORY
 ---------

   The year is 2026.  An alien species known as the Zytt has invaded Earth.
   You are an operative sent into the vast underground MegaTech facility on
   two critical missions:

     Mission 1:  Recover the L.A.M.B. (Laser Anti-Matter Beam) device,
                 hidden somewhere in the upper levels.

     Mission 2:  Descend to the deepest reaches of the facility, locate
                 and destroy Queen Zytt, then escape through the StarGate.

   Along the way you will encounter hostile creatures, scavenge weapons and
   equipment, use MegaTech installations, and try to survive long enough to
   save the world.


 THE DISPLAY
 -----------

   The screen is divided into three areas:

     Top area      The dungeon map.  Your character is shown as an @ sign.
                   Walls are shown as # and corridors as passages between
                   rooms.  Doors appear as + (closed) or - (open).  Stairs
                   are < (up) and > (down).

     Right panel   Your vital statistics: name, level, HP, attributes,
                   weapon class (WC), armor class (AC), experience, depth,
                   and active status effects.

     Bottom area   Messages from the game.  Press 'm' to review the last
                   20 messages (requires log-messages in doom.opt).


 MOVEMENT
 --------

   You can move in 8 directions using vi keys, the number pad, or arrows:

                    vi keys        numpad        meaning
                    -------        ------        -------
                       y              7          northwest
                       k              8          north
                       u              9          northeast
                       h              4          west
                     SPACE            5          rest (stay in place)
                       l              6          east
                       b              1          southwest
                       j              2          south
                       n              3          southeast

                       <                         go up (stairs)
                       >                         go down (stairs)

   RUNNING:  Use the capital letter (H/J/K/L/Y/U/B/N) or press '.' then a
   direction to run.  Running moves you quickly in that direction, turning
   corners automatically, until something interesting happens.


 COMMANDS
 --------

   All commands are single keystrokes.  Some require a follow-up direction
   or inventory item letter.  Items in your inventory are assigned letters
   starting from 'a'.

   Movement & Rest
     h/j/k/l/y/u/b/n   Move in 8 directions (see above)
     H/J/K/L/Y/U/B/N   Run in the corresponding direction
     SPACE              Rest for one turn
     < / >              Go up / down stairs
     .  then <dir>      Run in specified direction

   Combat
     a <dir>            Attack an adjacent creature with wielded weapon
     f <dir>            Fire wielded ranged weapon in a direction
     t <item> <dir>     Throw an item in a direction
     r                  Reload the currently wielded weapon
     x                  Exchange wielded weapon and reserve weapon

   Items
     g                  Get (pick up) items at your location
     G                  Get an item from a container at your location
     d <item>           Drop an item
     T <item> <dir>     Toss item(s) into an adjacent space
     w <item>           Wield an item as your weapon
     W <item>           Wear an item (armor, helmet, etc.)
     R <item>           Remove a worn item
     A <item>           Activate (turn on) an item
     D <item>           Deactivate (turn off) an item
     e <item>           Eat an item
     q                  Quaff / drink from an item
     E <item>           Examine an item closely
     C <item>           Charge / recharge an item

   Exploration
     o <dir>            Open a door or container in adjacent space
     c <dir>            Close a door in adjacent space
     s                  Search adjacent spaces (repeat for thoroughness)
     S                  Toggle auto-search (slower movement, always searching)
     i <dir>            Inspect an adjacent location
     F <dir>            Fix / repair an adjacent installation

   Information
     I  or  *           Toggle inventory window
     m                  Review recent messages
     v                  Show version and current score
     /                  Show your general health
     ?                  Display help

   Game
     p                  Pause (rest until fully healed or interrupted)
     X                  Checkpoint -- save game state to doom.dat
     Q                  Quit and save game
     z                  Toggle options (auto-take, cursor, ignore, verbosity)


 TAB COMMANDS
 ------------

   Press TAB followed by a second key for advanced commands:

     TAB c <item>       Close an inventory item (container)
     TAB d <dir>        Disable a trap on adjacent floor or item
     TAB D <item>       Disable a trapped inventory item
     TAB e <dir>        Empty an inventory item into adjacent space
     TAB f <dir>        Fill an inventory item from adjacent reservoir
     TAB F <item>       Fix / repair an inventory item
     TAB g              Get an item out of an inventory container
     TAB I              Show info on a specific inventory slot
     TAB j <dir>        Jump over an intervening space
     TAB l <dir>        Look in a direction for objects, enemies, or traps
     TAB n <dir>        Name a friendly creature
     TAB N              Name a class of unidentified device
     TAB o <item>       Open an inventory item (container)
     TAB p              Pause soundly (only wake if attacked or healed)
     TAB s <dir>        Shove / push in a direction
     TAB t <item> <dir> Throw an item an approximate distance
     TAB T <item> <item> Toss an item into an inventory container
     TAB ?              Assorted help topics


 INVENTORY WINDOW
 ----------------

   Press 'I' or '*' to toggle the inventory window.  While it is open:

     Ctrl-b / Ctrl-f    Page up / page down through inventory
     Up / Down arrow    Scroll one item at a time
     Left / Right arrow Move the inventory window to left/right side
     Ctrl-h / Ctrl-p    Reposition an inventory item to a new slot
     Ctrl-n             Relocate an item to the top or bottom


 CHARACTER ATTRIBUTES
 --------------------

     Strength (STR)     Affects melee damage, carrying capacity
     Dexterity (DEX)    Affects hit chance, evasion, speed
     Intelligence (INT) Affects item identification, device use
     Vision (VIS)       Affects how far you can see in the dark
     Hearing (HRG)      Affects detection of nearby creatures

   You gain experience points (EXP) by defeating creatures.  Accumulating
   enough EXP causes you to gain a level, improving your hit points and
   other capabilities.


 WEAPONS & ARMOR
 ---------------

   Wield a weapon with 'w', wear armor with 'W'.  Your weapon class (WC)
   determines melee and ranged damage; your armor class (AC) reduces
   incoming damage.

   Ranged weapons (pistols, rifles, etc.) require ammunition.  Use 'r' to
   reload.  Press 'x' to swap between your primary weapon and reserve.

   Some weapons and items need power cells to operate -- recharge them at
   a Generator installation or with the 'C' command if you have cells.


 ITEMS OF NOTE
 -------------

   Pills         Come in various colors.  Effects are randomized each game.
                 They can heal, poison, enhance or reduce attributes, cure
                 status effects, or worse.  Use a Library to identify them
                 before consuming.  39 different pill types exist.

   Light Globe   Illuminates the area around you.  Activate it with 'A'.
                 Runs on charges; recharge at a Generator.

   Spacesuit     Essential for Mission 2 -- the StarGate sequence requires
                 an activated spacesuit or you will suffocate.

   Keycards      Required to open locked doors on certain levels.

   L.A.M.B.      The objective of Mission 1.  A powerful device hidden
                 somewhere in the facility.


 INSTALLATIONS
 -------------

   Scattered throughout the dungeon are MegaTech installations.  Step onto
   one and you will be prompted to use it:

     AutoDoc            Medical facility.  For a fee, heals wounds (w),
                        cures all status effects (s), or provides full
                        treatment (h).  "MediMech Industries, a subsidiary
                        of MegaTech, thanks you for your patronage."

     Transmat Booth     Teleportation service.  Pay per level of distance
                        to instantly travel to another dungeon level.

     Vending Machine    Purchase basic supplies: gyrojets, cookies, light
                        globes, power cells, needles.

     Bank               Deposit coins for safekeeping, withdraw later, or
                        check your balance.  "A penny saved is a penny
                        earned, Citizen!"

     Library            Identify unknown items for 25 credits.  Especially
                        useful for identifying pills.

     Factory Outlet     The MegaTech shop.  Buy weapons (combat knife,
                        gyrojet pistol, laser pistol), armor (leather and
                        kevlar jackets), supplies (light globes, power
                        cells, gas masks, grenades).

     Reclamation Center Sell junk items (corpses, scrap metal, broken
                        bottles, dead power cells, etc.) for a few credits.

     Water Fountain     Drink to restore a few hit points and possibly
                        cure dizziness, confusion, or vulnerability.

     Generator          Recharge an item's power cells.  Small chance of
                        overload (ouch).

     StarGate           A mysterious device.  Critical to completing
                        Mission 2 after defeating Queen Zytt.


 STATUS EFFECTS
 --------------

   Various attacks and items can inflict status conditions:

     Poisoned       Ongoing damage each turn; cure at AutoDoc or with pill
     Confused       Movement direction is randomized
     Stunned        Cannot act for several turns
     Webbed         Cannot move; must wait or struggle free
     Blind          Cannot see the map
     Dizzy          Impaired accuracy and movement
     Irradiated     Ongoing damage from radiation exposure
     Vulnerable     Reduced armor effectiveness


 CREATURES
 ---------

   The dungeon is inhabited by over 70 types of creatures, ranging from
   giant spiders and wild dogs on the upper levels to fearsome Mechs,
   Dreadnoughts, and the Zytt command hierarchy in the depths.

   Some creatures have special abilities:
     - Spiders spin webs that immobilize you
     - Vipers and centipedes inject poison
     - Floating eyes cause confusion by staring
     - Munchkins and snagglepusses steal your items
     - Vampire mists drain your life force
     - Flutterbangs and bubbles explode on death
     - Mechs, Enforcers, and other machines have ranged attacks
     - The Zytt Commander and Queen Zytt can teleport

   Friendly creatures (Utility 'bots, Androids) will not attack unless
   provoked.  They follow you around and occasionally nuzzle.


 TIPS FOR SURVIVAL
 -----------------

   - Search often.  Pressing 's' multiple times in the same spot yields
     more thorough results.  Hidden doors and traps may be nearby.

   - Manage your money.  Deposit coins at a Bank early; installations
     charge fees for everything, and dying with coins on hand loses them.

   - Identify pills at a Library before eating them.  A pill of death is
     exactly what it sounds like.

   - Keep a light source active.  A charged light globe greatly extends
     your vision range.

   - Reload your weapon before entering new areas.  Running out of ammo
     in the middle of a firefight with an Enforcer is unpleasant.

   - Use the Transmat Booth to skip past cleared levels.  It costs money
     but saves considerable time and risk.

   - Don't neglect armor.  A kevlar jacket can mean the difference between
     surviving a Mech's blast and a quick death.

   - Rest ('p') in safe areas to recover HP, but beware -- enemies may
     find you while you sleep.

   - For Mission 2, you MUST have an activated spacesuit before using the
     StarGate, or you will suffocate.  Plan ahead.

   - The exchange command ('x') lets you swap weapons instantly.  Keep a
     melee weapon in reserve for when enemies close in.

   - Visit the Reclamation Center to sell junk.  Corpses, scrap metal,
     and broken items are worth a few credits each.


 OPTIONS FILE (doom.opt)
 -----------------------

   Place one option per line.  Lines starting with '!' are negated.

     name:<name>            Character name (up to 29 characters; first 12
                            displayed).  Default: Capt. Hazard
     introduction           Show story introduction on new game
     !introduction          Suppress the introduction
     brief                  Terse mode -- less descriptive text
     verbose                Full descriptions (default)
     bold-cursor             Player shown in bold
     blink-cursor           Player shown blinking
     reverse-cursor         Player shown in reverse video
     bold-objects           Objects shown in bold
     reverse-objects        Objects in reverse video
     bold-installations     Installations shown in bold
     reverse-installations  Installations in reverse video
     highlight-location     Blink player after major transitions
     show-unexplored        Mark unexplored areas with dots
     log-messages           Enable message log (for 'm' command)
     scoreboard             Record scores to doom.scb on death/win
     auto-take              Automatically pick up items when walking over them
     no-bell                Disable alert bell
     male / female          Character gender
     statistics             Show session statistics on exit


 SAVE & SCORE
 ------------

   Press 'Q' to quit and save.  Press 'X' to checkpoint (save without
   quitting).  The save file is doom.dat.  The scoreboard is doom.scb.


 CREDITS
 -------

   DoomsDay 2000, Copyright (c) 1986-1987 as an unpublished work
   by Dave Scheifler, Digital Equipment Corporation.

   Unix and OpenVMS x86-64 ports reconstructed from the original
   OpenVMS VAX/AXP binary.

   Published December 2026 as the 40th anniversary tribute edition.

