Shogo Coop Mod version 1.11
Running on Shogo Retail version 2.2
Release Documentation
11/4/2002

Tom Chang
http://members.cox.net/tchang875
tchang875@cox.net
-- Please visit my website or email me for additional support.

Shogo Coop Features/Changes
---------------------------
Shogo Coop is a cooperative multiplayer modification of Monolith's Shogo Mobile Armor Division.
The full retail version 2.2 of Shogo Mobile Armor Division is required to play this mod.

PLEASE READ THIS ENTIRE SECTION!! It contains important information on gameplay.

- All players start the game in the level called 00_LOBBY. 
  The game host should wait here until all clients connect before exiting the level.

- New levels will not start until every player is ready. This means that each
  player must have loaded the level and pressed a key to signal that they are
  done reading the mission briefing. The game will sit in a "waiting for players"
  screen until the last player clicks in.

- Game difficulty, including enemy hitpoints, damage, and shot rate, is determined
  at the beginning of each level based on the number of players in the game.
  Since the game supports up to 5 players, the max difficulty is 5. Sorry, this is
  not adjustable.

- Only the game host can save and load games. This is done through the single
  player menu like in single player games. Games can only be saved once per level.
  Auto-saving will occur at the beginning of each level and the host is allowed 
  one additional save after that. If you restore the auto-saved game, you will
  regain the ability to save in that level.

- Restoring the game can be done at any time, including in the Lobby. There is no
  limit to the number of times you can restore games. All players will begin
  restored games with full health but reduced ammo, in the location where the host was
  standing when the game was saved.

- On the level called "The Favor", there is a pipe that the player must be sucked into.
  A bug in the level only allows the first player in a coop game to be sucked in. 
  Please reserve your save until after the host gets sucked in. Then he can restore the 
  saved game which will bring the other players into the pipe as well.

- The game is over if any player dies. You may not respawn. However, the host will
  be allowed to restore a saved game at this time.

- There is no friendly fire, with the exception of the squeaky toy. Just don't make 
  your friend cry while he's getting shot at.

- During in-game decision dialogs, whoever chooses the answer first will decide the
  fate for all players in the game.

- The AI in this mod are generally smarter and tougher than in original Shogo. To compensate
  for this, players are given more health and start with all available weapons.
 
- Connecting to a game through the console, and changing worlds with the World
  command, are both disabled. Sorry for the inconvenience but it was necessary to
  prevent cheating.

- This mod will also work with the dedicated Shogo server (shogosrv.exe). 
  However, a dedicated host may not save the game nor reload saved games. 
  If players die while on a dedicated host, the only option is to restart 
  the current level by using the rs command (see below). Hosting with Shogosrv
  is not recommended. 

- Frame rate limiting is enabled by default under the Frame Rate section of the
  multiplayer settings dialog. If you're running Shogo on a P3 or better, or GeForce 
  or better, I highly recommend you leave it enabled as it helps in-game dialog and 
  cinematics run much better. A value of less than 115 seems to work fine, although
  it may require some tweaking depending on your computer.

- The connection speed setting you choose in the multiplayer settings dialog must
  match the type of connection you actually have. If you don't know what type of
  connection you have, choose ISDN-T1.

- Shogo Coop works with any custom single player levels. To load a custom level, 
  first place it in the Custom folder (same as coop.rez). Then host a multiplayer game 
  like you would normally, but choose the custom level instead of 00_LOBBY on the 
  level select screen.

- On the "History of Warfare" level there is a very difficult jump that needs to be made across
  a pit. An easy way to pass this part is to not jump at all. Instead, walk as close as possible
  to the wall on the left side of the pit. Simply strafe along the wall all the way across the pit.

How to start Shogo Coop
-----------------------
Sections from here on out are optional reading.

1. Patch Shogo up to version 2.2. The mod will not work with previous versions.

2. Copy the file Coop.rez to the Custom folder in your Shogo root directory.

3. Start Shogo. This will bring up an options screen on your desktop.

4. Click Customize. 

5. You should see Coop.rez under available rez files. Click Add to add it to
   rez files to load. Make sure Coop.rez is the only file under rez files to load.

6. Click Launch Shogo.

7. View or skip the intro movies to get to the Shogo main menu. Click Multiplayer
   to bring up the multiplayer settings dialog.

8. Choose to either host or join a game. Choose a network protocol. Click Next.
9. Name yourself. Choose a color and a mca type. The mca you choose here will last throughout the course 
    of the game. Choose the connection speed that correctly matches your connection. Leave the limit 
    frame rate check enabled, with a value of 115 or less. Click Next.
10. If you're hosting, enter a game name and the number of max players (up to 5). Click Next.
11. Under the retail levels section, highlight the map 00_LOBBY and click Add. 00_LOBBY should now be the
    only level under the game levels section. If there are other levels present, remove them. Click Finish.
12. If you're connecting to a host, click Add to add the host's ip address : port number (27888) to your list.
    For ipx games just wait a few seconds for the session to register. Highlight the session name once it
    appears and click Finish. This will take you to the Lobby.
13. To get out of the Lobby, go and touch Gate A.


Troubleshooting
---------------
--Mod Specific Issues:

Problem:  Can't join a game.

Solution: If it's a tcp/ip game, check to see that the host's ip address and 
	  port number is added to your game list. The default port number is 27888.
	  Use the add button to add the host's address with the format ip:port.
	  If the host is behind a firewall or router, port 27888 must be open and
	  the host machine must be set as the default route or the DMZ host.
	  
	  If it's an ipx game, the correct network interface must be used. If your
	  machine has more than one network card, try them all. 


Problem:  Can't start a new level.

Solution: Wait a little longer in case a player has a slow computer or connection.
	  Level changes can take up to 120 seconds. Have every player click in 
	  a few more times to make sure that their click registered on the server.
	  If all else fails, click ~ to go to the console, and type quit.


Problem:  Can't save a game.

Solution: You can only save once per level. Have you used it up already?


Problem:  Keep dying during spawning.

Solution: Restart/restore the game a few more times. Players spawn in slightly randomized
	  locations so it should eventually work out.


Problem:  Can't move.

Solution: Check to see if a player just died. Even dead players can still chat so
	  ask around and find the culprit. Once any player dies, all player movement
	  is disabled and the game is presumed to be over.

	  By default, keyboard strafing is not enabled so make sure you change the
	  keyboard controls before playing.


Problem:  Can't load a custom map.

Solution: Custom maps can't be loaded through the single player menu anymore. The
	  host has to load the map through the custom map section in the multiplayer
	  settings dialog.


Problem:  Can't play single player.

Solution: Of course not. This is a multiplayer mod so if you want to play one player
	  you still have to start the game through the multiplayer menu. Once the game
	  is started, the single player menu will be enabled so you can save games.


--Shogo Specific Issues:
  
Problem:  Can't see game menus and intro scenes.

Solution: If you're using a GeForce type video card, make sure that vertical sync 
	  is disabled for Direct3d games. Run regedit and go to the section:
	  HKEY_LOCAL_MACHINE\Software\NVIDIA Corporation\Global and add a new key value.
	  Name the key value NVTweak. Go under the NVTweak you just created and add
	  a new dword value. Give it value name CoolBits and value data 3. Make sure
	  hexadecimal is selected as the data type. 
	  Go to control panel/display/settings/advanced/.
	  Click the tab that represents your GeForce card. Click additional properties.
	  Go under the Direct3d tab. Click more Direct3d. If there is a section called
	  vertical sync, set the vertical sync mode to always off.
	  
	  If there is no section called vertical sync, download and install a more recent
	  version of the detonator xp drivers for your GeForce card. Then redo the steps above.	  

	  Note that version 23.11 of the detonator drivers will sometimes cause menu problems 
	  even if vertical sync is turned off. If this is the case, revert to version 21.83.

	  If you're not using a GeForce card, a solution that seems to work on all cards
	  is to limit the game's frame rate to about 50. Type maxfps=50 in the console,
	  or type 50 for the frame rate in the multiplayer settings dialog. The game will
	  be somewhat choppy with this setting but at least it fixes the menu problem. Note
	  that a setting of 50 here will also fix the dialog problem mentioned next.

Problem:  In game dialog skips or gets cut off before it's finished.

Solution: Limit the game's frame rate. In the multiplayer settings dialog that you use
	  to host or connect to games, there is a section entitled Frame Rate. Make
	  sure it's checked and a value is entered for the maximum frame rate. A value
	  of 115 seems to work for a P3 with a Geforce2, but you might need to go lower 
	  for faster systems. Play around with this value a bit and see what happens.

Problem:  The frame rate is much lower than expected from your video card.
	  
Solution: You may need to lower the Special FX Detail. Setting this on high causes a dramatic
          performance hit on high end video cards. Go to the Shogo Main Menu. Go under
	  options/display/advanced setting. Change Special FX Detail to low for best results.
 
	  Go to the Shogo advanced options and try enabling single-pass multi-texturing.	  

	  Are you overclocking? Shogo actually runs slower if your agp bus is overclocked
	  beyond spec. Change your bus speed so that the agp bus is running at 66mhz.

Problem:  The game has lots of lag/latency.

Solution: Like all first person shooters, Shogo runs much smoother on a lan connection.
	  If you're trying to play over internet, a dsl or faster connection is highly
	  recommended. Change the connection speed setting in the multiplayer settings
	  dialog to match the type of connection you have. If there is still lag, change
	  to a slower connection speed. Be forewarned that a modem connection will 
	  cause lag no matter what settings you use.  

Problem:  Get a "Can't load level" error message when changing levels.

Solution: Delete the Shogo.rez file in your Shogo directory and replace it with a 
	  new copy from the Shogo CD. 






 