legacy.txt

The source code of Doom legacy for windows

 -----------------------------
 [3] ADDITIONS TO DEATHMATCHES
 -----------------------------

 [3-1]: Shooting up and down
 ===========================

     There's nothing changed, except of course a totally new
     deathmatch experience.


     About the BFG : the bfg ball can be fired up or down, but
     the invisible rays that spray from you are totally independent of
     your aiming. The invisible BFG rays have always 'autoaim', they're
     not dependent of your aim. Let's be clear: apart from being able
     to shoot the BIG BFG BALL up or down, the side-effect of the BFG
     is like before.


 [3-2]: Auto aim toggle
 ======================

     We wanted to keep the compatibility with the older Doom gameplay,
     but we needed also to go forward and bring some more depth to the
     deathmatches. On of these steps, is going for the manual-aiming.

     You may feel like it's unbalanced if some people use the autoaim,
     as they don't have to do the effort of aiming right, and others
     don't use it and do their best to aim up and down right...

     NEW since Legacy v1.2 : with allowautoaim (see console.txt) , you can
         disable autoaiming, that is, impose manual aim to all players
         in a network game, use with caution!!


 [3-3]: Weapon changes
 =====================

     We didn't dare of course change the existing weapons functionality!

     You may appreciate however, the fact that you can remap every
     weapon to any key, in the Setup Controls menu. Since you can map two
     keys per 'control', you can keep the original keys '1'-'8' for the
     weapons, and add a shortcut to your preferred ones. eg: '5' and 'r'
     for rockets...

     New weapons are planned in the future releases: probably a grenade
     nearly like Quake1 ones. Maybe an addon for the rocket launcher to
     transform it into a 'guided rockets' launcher... like the Revenant's
     fireballs.


 [3-4]: New cheats
 =================

     'idcd##' : Will work only if MSCDEX driver is loaded.
                Similar to the 'idcmus##', but for CD Audio tracks.
                Example : idcd02 start cd track 2.

     'idfly'  : Fly around levels, using 'jump' key to get altitude.


|[3-5] Heretic support
|=====================
|
|    Yes! Legacy now can handle heretic.wad as a main wad file, so stating 
|    legacy with heretic.wad in same directory or launching it with "-iwad 
|    heretic.wad" this set legacy in 'heretic state'.
|
|    What we have do is added heretic support to doom engine so the result 
|    isn't exactely heretic engine, so we hope there is no mush trouble 
|    running heretic wad and modifications. For this reason old demo 
|    playback cannot be suppoted. 
|    
|    Anyway now heretic as inherited from legacy new feature : better 
|    network support, opengl, boom support, ... We have also get some 
|    stuff from heretic and that can used by doom was like ambient 
|    sounds, we can now switch weapons switch with missile, legacy 
|    can use "fontbxxx" lumps for the big font graphics....

 ---------------
 [4] THE CONSOLE
 ---------------

  Check 'console.txt' documentation for more about the console.



 ------------------------------
 [5] NETWORK GAME (MULTIPLAYER)
 ------------------------------

 IMPORTANT NOTE!

  NEW, since Legacy v1.2, the network part of Doom has been totally
       rewritten. It now uses a better transfer method for the packets,
       (which is usually faster), and also implements a basic
       Client/Server model, where some critical game options are
       changeable only by the server in multiplayer games.

       Since the network communication is faster, we have upped
       the number of players to 32 !!

 [5-0]: Network under Windows and Linux
 ======================================

     The win32/Linux version of legacy no more work with external
     program like sersetup, ipxsetup, dm, doomatic, hx8, .... This
     version use directely winsock/socket api. So the only way to
     play in network is to use the -server and -connect parameter.
     Or use the launcher who has beautiful interfase that will
     translate your wishes in command line.
     You can also use the build in multiplayer menu that allow you 
     to connect to server and create server.

     The follow is ONLY for dos version.

 [5-1]: Quick-start of a 5-32 players network game (DOS only)
 ============================================================

     To start a game with more than 4 players, we recommend using
     Doomatic. Doomatic is a utility written by us before the source
     release, we wanted to create a deathmatch launcher with all the
     features that we always needed.

     It replaces IPXSETUP and DM. Just read the 'QUICK START' sec-
     tion of DOOMATIC.TXT file to get started with Doomatic.

     Since we've added more than 4 players support into Doom LEGACY,
     we have modified DOOMATIC to allow starting games with up to
     32 players.

     Make sure that the map you use has enough deathmatch starts!

     Search on internet Doom sites, there has been a number of wads
     specifically made for the new Doom ports with more than 4 players.

     Cooperative play with more than 4 players should work with map
     using the JDS cooperative player starts.


 [5-2]: the new Client/Server model
 ==================================

     The network code has been totally rewritten, here are the
     main changes:

     - Doom Legacy allow player to join while in game. No need to 
       restart the game to add a new player ! For Dos user this is not 
       allowed with old drivers it work only with doomatic and with 
       -server and -connect parameters.

     - Doom Legacy version 1.2 and higer supports up to 32 players.

     - The speed is now dependent from the Server. if the server looses
       frames, that is: if it runs too slow, all the other players will
       experience the slow down, or 'choppyness'.

       Thus, make sure that the server's machine runs smooth, example:

       a P100 running the game at 320X200 may be very smooth. while
       a PII 300 at 1024x768 will slow down the network. Why? simply
       because while the server is occupied drawing his screen, he can't
       send or receive any packets, and thus the other players are slowed
       down at the speed of the server (well, now it is possible that
       a PII 300 is very smooth at 1024x768.. but you get the idea).

     - The memory is very important so 16 Mb is a MINIMUM for a server.
       Why? Because a server with not enough memory will often load
       data from the disk, and this will probably slow down the game.

     - Don't forget to put a very good disk cache, like 4 Mb or more.
       A good disk cache will reduce the loading from the server, thus
       reduce possible slow downs.

     - The server can kick any player ouf of the game. The player will
       be returned to the title screen.

     - Consistancy failure now kicks only the player who was not
       'up-to-date', but not the others.

     - Parameters -left -right came back (using 3 screens for left,right
       and front views).

     - Most critical game variables are send to all the players when they
       are changed by the server, and only the server can change them.

       Examples are 'allowjump', 'respawnitemtime', 'deathmatch', ...

     - The new possibilities are barely demonstrated in Legacy v1.2 :
       we can now make any console command work on the network, so there
       are very good things ahead!

     For MS-DOS, the new system is still compatible with IPXSETUP and
     SERSETUP, so you can use these to play games up to 4 players.

     To play with up to 32 players, use DOOMATIC.

     Note that DOOMATIC was created by us long before the release of the
     Doom sources, and it works with the orginal Doom, and with most
     other ports, too. We didn't create DOOMATIC specifically for Legacy,
     but we updated it so that it could start games with more than 4
     players for Legacy.



 [5-3]: Setting up the SERVER (DOS ONLY)
 =======================================

     There is no interface for now.

     The server is the player 0, which is the GREEN player in DOOMATIC.

     Note that the GREEN player in Doomatic, is not necessarily Green
     later in the game : the server can choose any color in the
     Multiplayer menu. Legacy doesn't use the colors from Doomatic,
     but will recognise the Green player of Doomatic as the server.

     In other words, you can't choose who is the server using IPXSETUP.

     We reassure you: this is a hack, and we will add a '-server'
     parameter as soon as possible to determine explicitly the server.

     The color you choose in Doomatic is useful for the original Doom
     game only : it was a key feature of Doomatic, to choose the colour
     you wanted to be instead of getting always the same color from
     IPXSETUP. It became obsolete with Legacy, as you can choose your
     color in the game itself.

     The SERVER has more rights in the game, and no, it can't cheat.
     It can change the game parameters like 'repspawnitem','respawn-
     monsters', ect. and can Kick players. Therefore, choose the server
     with attention.

     NOTE that there is no 'dedicated' server for now, everybody in
     a multiplayer game and even single player, is always a server
     and a client at the same time. That is: in single player, you
     can slow down yourself, when you loose frames, usually in the
     higher resolutions, you will experience a small 'lag' like on
     a 'choppy' multiplayer game.

     See CONSOLE.TXT for more about the server & multiplayer commands.



 [5-4]: the return of -left/-right
 =================================

     We have restored the -left and -right command-line parameters,
     that allowed in the earlier versions of Doom, to play using
     3 monitors: one for the front view, one for the left, and one
     for the right.

     Here is how it works:

     Use DOOMATIC and create a game on the machine that will display
     the 'front view'. Make sure it has the GREEN player color
     (in Doomatic, not in Legacy). Set '-left' and '-right' in the
     local parameters of Doomatic, for the other two machines.
     That is : the 'left view' machine has '-left' in the local
     parameters of Doomatic, the 'right view' machine has '-right'.

     Join the game with the other two computers, and start the game.

     This will work only for SINGLE player, but the player will have
     a very wide view!



 [5-5]: How to play with TCP/IP
 ==============================

|    You can use The launcher to start such game. or use the build in 
|    multiplayer menu that have 'create server' and 'connect server' 
|    option.

  BY HAND
  -------

     Someone will be the server, it is usually the fastest computer.

     A client NEVER slows down the server, but a slow server
     SLOWS DOWN ALL THE CLIENTS!

   * The server types:

     > legacy -server <# of computers>

|    The server will wait until #computer are connected and then 
|    start the game. This is like the old way to start a game. But 
|    is better fair fight since all player start at the same time 
|    and same weapons. Of course other computers can also join latter.
|
|    or 
|
|    > legacy -server 
|    This start server and don't wait any computers. And Start 
|    directely the game. Other player can join latter.
|
|

   * Clients are the other players who join in the server:

     > legacy -connect <ip address of server>

     or

     > legacy -connect
       This will auto-detect a server on a LAN. This only works when
       computers are directly connected. If you play through internet,
       the server can NOT be auto-detected, and you must specify it's
       IP address.


     Example A, 3 players on a LAN:

       player 1 (the server)
       > legacy -server 3

       player 2 (client)
       > legacy -connect

       player 3 (client)
       > legacy -connect

     Example B, 2 players, through internet: