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

v 2.0

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

Oz runs on version 1100 of Half Life or newer.

Contents:

	 1.  Discription.
	 2.  Runes.
	 3.  New/special additions.
	 4.  Listing of configurable items.
	 5.  Instructions for configuration file use.
	 6.  Suggestions.
	 7.  Maps.
	 8.  Commands.
	 9.  Infinity DM and CTF .dat files.
	10.  Z_Malloc errors.
	11.  No Free Edicts errors.
	12.  Installation.
	13.  Credits/Contacts

===================================================
 1.

Oz is a multiplayer mod for Valve's Half Life.  No files are necessary for clients to play.

Oz features an immense amount of configurability 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.  You can use Wordpad, Notepad, or any other text file editor to open the cfg files.  With the config files 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 map, like lighting, or the player, like their max health or max charge, won't take effect until a map change or 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.

===================================================
 2.
Runes:

These runes will provide the player with special abilities.  Look for them on the map as HEV suits with colored shells.

Protection: Light green shell, the user recieves half damage.

Low Gravity: Yellow shell, the user can jump higher and recieves less falling damage.  The fraction of gravity for the user is adjustable by the server.

Super Hook: Orange shell, your grappling hook will do more damage, will fly faster, and pull you faster.  Damage is adjustable by the server.

Vampire: Purple shell, you will gain 1 health for every 2 damage you deal to someone else.

Booby Trap: Upon death, the user will explode taking out anyone nearby.  The rune only works if the user dies in some other way besides using the "kill" command.  The damage of the explosion is adjustable by the server.

Regeneration:  Green shell, grants the owner continually rising health and armor.  Rates of health and armor increasing are adjustable by the server.

Haste:  Dark blue shell, grants the owner's weapons with double the firing rate.  Does not effect the gluon.

Cloaking:  Light blue shell, grants the owner partial invisibility, "Predator" style.  Amount of visibility is adjustable by the server.

Crowbar:  Red shell, makes the owner's crowbar do infinite damage aka instant kills!

Frag:  White shell, grants the owner additional points for each kill.  Number of extra frags is adjustable by the server.

SuperGlock: Light purple shell, gives the owner unlimited ammo with his/her glock, secondary fire becomes a zoom, and while zoomed, it gives almost one shot kills!

Runes are kept until a player dies, drops one, or disconnects.  Runes can be discarded with the "droprune" command.  To see what your current rune is, use the "runestatus" command.  If you do not know how to use these commands, refer to the grappling hook binding example above.

===================================================
 3.
Special Additions for v2.0:

None.  This is a port of the original Oz Deathmatch to the newest Half-Life SDK 2.0.


===================================================
 4.

A list of almost everything that is configurable follows:

capture the flag scoring (per capture, steal, and return)
weapon priority
weapon auto switching
disabling weapons
starting weapons and ammo
max ammo
ammo with items
ammo with weapons
magazine sizes
weapon damages
weapon recoil
weapon rates of fire
projectile speeds
reload times
mp5 tracers (none, all, or every other shot)
weapon accuracy
optional silencers on some weapons
optional sniper modes on some weapons
many specific variables for each weapon
option for letting all weapons fire underwater
number of each rune in game
disabling runes
many specific varaiables for each rune
respawn times for ammo, weapons, items, runes
optional "Night Ops" mode with configurable light level
optional random spawning of weapons, items, ammo

toggleable player identification
player max health
player starting health
player max armor
player starting armor
player lung capacity
recharge times for health and suit wall chargers
capacities of health and suit wall chargers
wall charger charging rates
adjustable locational damage for head, chest, stomach, arms, and legs
blood amounts in multiplayer
adjustable scoring for kills, suicides, world kills, team kills, flag returns, flag captures, and flag steals.

toggleable offhand grappling hook
grapple air speed
grapple water speed
grapple drag speed
grapple damage
grapple glow
grapple color
optional random grapple color

rpg color
gauss primary color
gauss secondary color
hornet colors
tripmine color

and more!

===================================================
 5.

How to change settings: Simply edit the 6 config files in the "cfg" folder.  You can use wordpad, notepad, or any other text editor to open .cfg files.  The changes will show up when you start a game.  You can also change any of the settings while playing.  The variables are explained in the config files.

===================================================
 6.

A few suggestions:

Always start Oz with the included shortcuts.

Please do not make the grappling hook drag speed faster than 1000, otherwise it becomes disorienting for hpbs and nullifys the purpose of the super hook rune.

Try not to put more than 12 runes in the server at any time, they will create too much lag.

Servers running weapon damages extremely high (like one shot/one kill) are usually not very fun when the ping differences between players is large.

Please try to keep it fair, as said above, over-powered weapons are usually not very fun.

===================================================
 7.

"How come there are no maps in the Create Game menu?"

This is due to the half-life menu system and it can't be fixed by us.  It is part of a section of code that is not available to the public.  Currently, the menu system will only look in the current mod's directory for the maps folder.  You still have complete access to everything in the valve folder, however.  You can either copy over you maps folder (wasting space) or just go ahead and start the game.  It will stop loading because it cannot find a map.  At that point, just type "map somename" and hit enter.  It will finish loading and you can play.

Sorry for the inconvenience, but there is nothing we can do about it.


===================================================
 8.

Commands:

+hook - fires the offhand grappling hook.

runestatus - displays what rune you are carrying on the screen.

droprune - drops your current rune.

dropflag - drops the flag if you have it on a CTF server.

To bind these commands to keys use the following method:

Pull down the console while in game with the ~ (tilde) key.  Type bind <key> <command> where <key> is any key on your keyboard and <command> is any of the above listed commands.

For example, if you want to make the G key fire the grappling hook, you would type this:

bind g +hook

Then hit your enter key to lock the command in.  Now pushing and holding the g key will fire the grappling hook.

===================================================
 9.

Infinity DM and CTF .dat files.

Oz NO LONGER SUPPORTS INFINITY DAT FILES.  This feature may come back in future versions, but as of now it is not supported.


===================================================
10.

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

===================================================
11.

No Free Edicts errors:  These are caused by either having too many weapons/items/ammo in a map from the Infinity mod or trying to give the player too much ammo when they spawn.  Make sure that the player can accept all the ammo you are giving them, otherwise the ammo spawns in the world and uses up too many free edicts.

===================================================
12.

Installation:  if you're using the Oz20.zip, unzip it to Sierra/Half-Life/.  Version 2.0 is based on the new SDK 2.0 and the previous installation of Oz should be deleted completely if present.

Note: if you DID NOT use the installer, the included Oz shortcut may need 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.

===================================================
13.

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


Questions?  Comments?

"Willi" Roberson - Lead Programmer, Webpage Design, Founder
willi@planetquake.com

Jammer - Programmer
jmeyer@austin.rr.com

Sojyn - Linux Build
sojyn@xnet.com

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

Telcanty - Webpage Design
french@mainsite.com

Teq - Menu Graphics, Programmer
longjd@postmaster.co.uk

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 - 2000.
Oz Deathmatch is a trademark of AfterShock Productions.  All Rights Reserved.
