
===================================================
Oz Deathmatch

v 1.3

http://www.planethalflife.com/aftershock/oz/

Oz only runs on version 1009 of Half Life or newer.
===================================================



Oz is a server side multiplayer mod for Valve's Half Life.  No files are necessary for clients to play. Simply log onto an Oz server.

Oz features an immense amount of customizability due to the use of .cfg files.    Simply change the values in the config files located in the "cfg" folder to have them take effect.  With the config file you can change MANY things, including damage amounts, max ammo/health/armor, and the ability to disable/enable weapons in your server.  You can even select what each player should start with in their inventory.  All standard features of Half Life are supported except single player.  All the variables are also accessible in game, just type the variable you want to change with the according numeric value following it.  Almost all changes will take effect immediately, but some things that have to do with the player, like their max health or charge, won't take effect until they die.


Additionally, Oz has an offhand grappling hook used with the command, "+hook".  Simply bind this to a key once you join a server.

Example:

Pull down the console and type, "bind <key> +hook".  Of course replace <key> with any key on your keyboard.  Now pressing and HOLDING that key will fire the grapple, releasing it will release the grapple.


Special Additions for v1.3:

New Config Files:  The Oz.cfg has been REPLACED with 6 seperate config files that make it easier to find certain settings, and to reduce problems with the Oz.cfg file being too large.  All the new config files are found in the "cfg" folder in the Oz directory.  THE OZ.CFG IS NO LONGER USED!

Settings.scr File:  The new settings.scr file (downloaded seperately) let's the server make changes within Half Life itself, instead of using the Oz.cfg file.  The settings are changed in Half Life in the Advanced menu for setting up a server.  That menu will ALWAYS over-ride the values in the config files if you're running a normal server.  The config files will be used with listen (dedicated) servers.

Blood:  The amount of blood seen in-game can be adjusted via the player.cfg file.  Beware that the more blood, the more lag.

Colors:  The colors of all projectile trails and lasers can be changed now in the weapons.cfg file.  (HINT: setting the color to zero for the tripmines makes the beam invisible!)

Locational Damage:  The damage multipliers for each corresponding hit location can be adjusted now in the player.cfg file.

Flares:  A secondary fire function for the hand grenades has been added.  The projectiles thrown are bright flares that will illuminate an area for a period of time.  The length of time that they last and the time before normal hand grenades explode can now be adjusted in the weapons.cfg file.

Projectile Speeds:  The flying velocity of certain projectiles can be adjusted.

Night Ops Revision:  The light level while in Night Ops mode is now adjustable!

Weapon Rate of Fire:  The rate of fire for the weapons can be adjusted.  Imagine shooting 50 rounds in less than a second with the mp5!

Weapon Recoil:  The amount of recoil can be adjusted for all corresponding weapons.

Weapon Priority:  The priority of weapons can now be set (used when auto switch is on, it sets which weapon, if you have it, will be switched to automatically)

Silenced Glock:  The silenced glock has been moved to a variable similar to the silenced mp5 option in the weapons.cfg file.  This preserves the original secondary fast firing mode.

Secondary Grenades:  A secondary fire function has been added for the hand grenades that tosses out a brightly glowing flare.  This is excellent for use in Night Ops.

Optional Sniper Modes:  The glock and mp5 can have their secondary fire replaced with a zoom similar to the crossbow.  While zoomed, the mp5 is super accurate and shoots at a slower rate.

Random Spawning:  When enabled all items, weapons, and ammunition will randomly spawn throughout the level.  They will usually be in some proximity to their original spawning points.

MP5 Tracers:  You may now adjust the tracers from the mp5, either turning them on, off, or having a tracer every other shot.

Water Weapons:  A toggle has been added that lets all weapons fire underwater.

Scoring:  The number of points gained or lost can be set for kills, suicides, world kills, and team kills.

Player Lung Capacity:  The length of time that a player can stay underwater is now adjustable.


Bug Fixes that are new for v1.3:

Message Of The Day:  The motd is fixed!  It now shows for the appropriate amount of time instead of randomly appearing, IF it appeared.

Grappling Hook:  Full revision of the grappling hook code.  While hanging the grapple is now COMPLETELY stable, no matter the player's ping/lag.

Grappling Hook message only shows up if the hook is enabled at the beginning of the game.

Weapon Auto Switch:  When weapon auto switch is disabled the player will now spawn with the glock in use instead of the crowbar (had many complaints about this).

Connection Problems:  Many clients were recieving error messages while connecting to Oz servers.  These problems have been resolved with the help of Valve.  If you experience connection problems it is most likely because the server is not running v1.3.

Z_MALLOC errors:  These were caused by not allocating enough memory for the Oz.cfg file and sometimes crashed the server.  Simply adding -zone 256 or larger numbers to the Oz shortcuts resolved the problem.  We have also reduced the size of the config file by moving to multiple config files.  The Oz.cfg is no longer used, instead use the config files in the "cfg" folder in your Oz directory.



Note: the included Oz shortcut probably needs to be modified based on your system (IF you want to use the shortcut).  Currently, it will look for the hl.exe in c:\sierra\half-life.  Just right click the shortcut and pick properties, than edit the command line for hl.exe.  Everything else in that line MUST stay the same, otherwise the mod will not be loaded.  If this mod was installed through half life, you can "activate" it on the custom game menu.



Installation:  Unzip the Oz13.zip into your Half-Life directory.  Let it overwrite anything it warns you about.  It will make it's own Oz folder and all the needed files are included inside.  Use the -game oz command to set up a server, and refer to http://www.planethalflife.com for server settings.  If previous versions of Oz (1.0 or earlier) exist on your computer, DELETE THE OZ.INI FILE.

Included files and their directory structure after installation:

Half-Life/Oz/cfg/multiplayer.cfg
Half-Life/Oz/cfg/weapons.cfg
Half-Life/Oz/cfg/grapple.cfg
Half-Life/Oz/cfg/player.cfg
Half-Life/Oz/cfg/special.cfg
Half-Life/Oz/cfg/colors.cfg

Half-Life/Oz/dlls/mp.dll

Half-Life/Oz/game.cfg
Half-Life/Oz/listenserver.cfg
Half-Life/Oz/readme.txt
Half-Life/Oz/oz.cfg
Half-Life/Oz/server.cfg
Half-Life/Oz/liblist.gam
Half-Life/Oz/custom.hpk
Half-Life/Oz/settings.scr
Half-Life/Oz/motd.txt
Half-Life/Oz/mapcycle.txt
Half-Life/Oz/OZ.LNK (shorcut)
Half-Life/Oz/OZDS.LNK (shortcut)


Custom config files:  If you'd like to make your own seperate customized config files for Oz without constantly changing the Oz.cfg file every time follow these directions:

1.  Copy and past the config file you want, then rename it accordingly.
2.  Make the changes to your custom config file and save it.
3.  Either execute the cfg file in game by typing "exec mycfg.cfg" or add that line to the bottom of one of the existing config files.

Now Oz will execute your config file after the one you specified, putting your changes in place.  This makes it easier for you to have more than one config file.  You can do things like realism configs that only have realistic weapons with higher damage values, or explosive configs where everyone only has use of explosive weapons.


Please contact us with ideas, bug reports, or general fan mail;-)


Questions?  Comments?

"Willi" Roberson - Head Programmer, Webpage Design, Founder
tadao@stargate.net

Hardware - Idea Resource, Head Tester
broken1@home.com

Bard - Grappling Hook Programmer
bard@ludd.luth.se

Beelzabub - Programmer
beelzabub@gamedesign.net

Clear Dark - Programmer
ccyycy@hotmail.com

Nobody - Launcher Programmer
heykids17@hotmail.com

Skeptah - Graphic Arts
chriss07@hotmail.com

Sven Viking - Coop Play Specialist
dd2@iname.com

Telcanty - Webpage Design
french@mainsite.com

Gerbil - Programmer
gerbil@telefragged.com


The Oz Team hopes you enjoy Oz Deathmatch!

Half-Life is a trademark of Valve Software and Sierra Online, used with permission.
Oz Deathmatch is  Copyright Aftershock Productions, 1999.
Oz Deathmatch is a trademark of AfterShock Productions.  All Rights Reserved.
