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

v 1.7

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

Oz runs on version 1009 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 if the server is running deathmatch or teamplay. If a server is running capture the flag, then clients will need the small client side download.

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 v1.7:

Capture the Flag game mode!  Turn on with the mp_ctf variable in multiplayer.cfg.  If you are running an Oz CTF server then clients WILL need the Oz CTF client side download.  It contains the flag models and fire & ice player models.  Servers can use the new ctf_teamlist variable to set the teams (default is fire vs ice, and includes player models).  Included with 1.7 are many .dat files for common half-life deathmatch maps that converts them into Oz CTF maps.  The command: "dropflag", will drop the flag if you are carrying it.  The object of capture the flag is to take the other team's flag back to your own base.  If you take the other team's flag, you recieve one point.  If you capture the other team's flag, you recieve 10 points.  If you return your own flag to your base (just touching it will do this), then you recieve one point.  Flag carriers will have the flag attached to them.  If you kill the flag carriers, and return your flag, then you get extra points. (the point values can be adjusted in the configuration files)

SuperGlock Rune: 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!


===================================================
 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.

CAPTURE THE FLAG MAPS:

Infinity .dat files for these maps are included.  They convert the normal deathmatch map into capture the flag if the server has the mp_ctf variable set to "1":

x-fire
doublecross
crossfire
stalkyard
lambda_bunker
quarry
outcry
gasworks
rustmill
spider
scary_1
xbounce
rats
deathlab
frenzy
boot_camp

You may also make your own Infinity .dat files with the Infinity mod for either normal deathmatch or capture the flag.  Infinity dm .dat files reside in Oz/dm_dat and Infinity ctf .dat files reside in Oz/ctf_dat.  Visit the Infinity website at http://www.planethalflife.com/infinity/ for more information.

===================================================
 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 features support for deathmatch and ctf .dat file reading for files generated by the Infinity in-game map editor.

After using Infinity to place spawn points for weapons/items/ammo on your favorite maps and saving them to the .dat file, place it either in Oz/dm_dat for deathmatch maps, or in Oz/ctf_dat if it's going to be used for Oz CTF.

To activate for deathmatch maps, make sure there are .dat files for the maps in the Oz/dm_dat folder and set the infinity_dm_map_configs variable to 1.

To activate for ctf maps (deathmatch maps with the flag entities added to them, or ctf only maps), make sure there are .dat files for the maps in the Oz/ctf_dat folder and set the infinity_ctf_map_configs variable to 1.

For more information about the Infinity map editing modification, visit the website: http://www.planethalflife.com/infinity/

===================================================
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 Oz17.zip, unzip it to Sierra/Half-Life/.  If you're using the installer, just run it and follow the onscreen instructions.  Use the -game oz command or included shortcuts 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.  If you have version 1.1 or 1.2 installed DELETE THE OZ.CFG FILE.

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
tadao@stargate.net

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.
