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

v 3.0

http://www.planethalflife.com/oz/
http://www.starbraker.com
http://www.sparksonline.org

Oz runs on version 1100 of Half Life or newer.

Contents:

	 1.  Description.
	 2.  Runes.
	 3.  New/special additions.
	 4.  Listing of configurable items.
	 5.  Instructions for configuration file use.
	 6.  Suggestions.
	 7.  Maps and map cfg files.
	 8.  Commands.
	 9.  Infinity DM and CTF .dat files.
	10.  Z_Malloc errors.
	11.  No Free Edicts errors.
	12.  Why is the game smooth on 56K?	
	13.  Installation.

===================================================
 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 into the console 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 players' 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.

Pull down the console and type, "bind <key> +hook" (without quotes).  Of course, replace <key> with any key on your keyboard.

Example:

~ (to bring down console)
bind x +hook
<Enter>
~ (to close console)

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 and decreased reload time.  Does not effect the gluon.

Cloaking:  Light blue shell, grants the owner partial invisibility, "Predator" style.  Amount of visibility is based on player speed and actions.  The faster the player moves the more visible they will become (up to a set limit).  When they fire, they will become 50% visible for 10 seconds, then become cloaked again.

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 v3.0:

[See the Oz3_changelog.txt]



Special Additions for v2.3.1:

a. Fixed a bug where bots could be added by clients.
b. Added the ability to disable bots.
c. Fixed the ability to disable the proximity fuse for satchels.
d. Now the players can pick up more satchels while some are deployed.
e. Splash damage now sets satchels off.
d. Changed the Cloaking rune so that the level of invisibility is based on player's speed and actions.
e. Added per map cfg files, so that a server can have diffrent settings based on the map being played.
f. Improved the bots' overall reaction to threats.
g. Fixed a bug that allowed the bot to target an enemy even if the enemy was not in the bots FOV.
h. Added the ability of the server to control screen shakes variables.
i. Reworked the Rhobot.cfg so that now it is all cvar based, allowing it to be changed on the fly.
j. Bots now have a lower chance of "seeing" cloaked players.
k. Bots with a crowbar rune will switch to that and fight with it until they die.
l. A Variable to allow the admin to choose the model of the runes.  The model list is in the special.cfg.

Special Additions for v2.3:

a. Added Rho-Bot
b. Added colored blood for bots
c. Added Proximity fuses for the satchels.  Once dropped, if you come close they go off!
d. Added random colors/ctf-team colors to tripmines
e. Added Secondary fire to trip mines which has no laser color, but uses more ammo
f. Added bot_speed variable so the speed of the bots can be changed

Special Additions for v2.1:

a. Completely rebuild rune system
b. Added Silenced MP5 options
c. Added Silenced Glock options
d. Added help command
e. Added showmotd command
f. Added showtime command
g. Added showmapname command
h. Added a Random Rune
i. Added Super Speed Rune
j. Added Identify Rune



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

A list of almost everything that is configurable follows:


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
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 hpw's 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?"

If you remove the map folder from your OZ dir, you will get a list of all the maps you have in the valve folder.

For the map config files, I have provided a few examples.  They are just like mini cfg files that are executed right before the map starts. That way they can change all the settings available to the game per map.  I would recommend that you have a map cfg for the map you want to change, and a map cfg for the map after it to change the setting back to your normal default settings.  If this is not done, the changes you make will stay until a diffrent cfg loads and changes them.  If you look at the mapcycle.txt I had added here, you will see that some configs are setup this way.

You can put the map cfg's in the oz folder, or the valve folder.  both will work.

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

Commands:

+hook - fires the offhand grappling hook.

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

droprune - drops your current rune.

help - displays all current commands

info - displays the amount of time left in the map, fraglimit, timelimit, map name.

showmotd - displays the Message Of The Day

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.

Why is the game smooth on 56K? IS lag compensation on?

Oz 3 includes code enhancements called PLASD© that balance the client/server
interaction so that a given server can cycle through players more effeciently
and use server side weapons only when neccesary. This generally results in
better game play for all players in the server. Lag compensation can still
be used in addition, but lag compensation can cause strange behavior in
game play.

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

Installation:  See the Oz3_installation.txt

===================================================


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.
PLASD is © Copyright and trademark of Lacking Imagination Enterprises. All Rights Reserved, used with permission.