Author : $Author: jwalstra $ Revision : $Revision: 1.11 $ Checkout Date : $Date: 2003/05/18 15:14:17 $ Source File : $Source: /home/cvs/SniperArena/Info/SA_README.html,v $ GNU GENERAL PUBLIC LICENSE Version 2, June 1991 See LICENSE or http://www.fsf.org/license/gpl.txt Coded using "vim". The only editor you'll ever need.
This mutator is a port of the UT Sniper Rifle. The mutator can be used in normal and arena play.
Arena style removes all the weapon pickups and replaces all ammo with the Sniper Rifle ammo. When you spawn, you are spawned with the Sniper Rifle. The Sniper Rifle can not be thrown. Normally in arena mode, the translocator is disabled, however the server is allowed to turn it on.
In non-arena style, the Sniper Rifle replaces the Lightning Gun. The Lightning Guns ammo is also replaced with Sniper Rifle ammo.
This mutator offers the ability to change most of the default settings like fire rates, the amount of ammo in the pickups, bonus and penalties for killing or being killed, etc. Some of these features will allow you to emulate the popular "Zark" sniper mutator from UT. Check the Server Configuration section for more information.
spoon (aka supun)
Col Kassad - For the making the sniper rifle models work.
Fuzz[Frnz] - For the sniper ammo pickup and the Frnz logo.
Sniper Clan Frnz - For testing and being the best clan out there. :)
Ob1 - For being my Unrealscript Jedi master and being the first person I turn to when I'm clueless.
Epic - The rifle model came from UT. I'll call it even for the familiar looking health and ammo stations, re-charging translocator, and the shield gun :) Seriously, did you guys like WFUT?
The archived file should contain the following files (along with images for the README)
This archive should be unzipped into your UT2003 base directory in order for the files to be placed in the correct location. SA109 will not interfere with a currently installed Sniper Arena, since it does not replace or over-write older files. Since SA109's ini file is completely different from previous version, a default version is placed in your System directory. You will need to edit SA109.ini to use your previous setting, if you have been using an older version of Sniper Arena. See the Server section for information on how to set these values.
Once you have installed Sniper Arena 109, you will need to edit your server .ini file. Servers use UT2003.ini if not told differently.
You need to add ServerPackages=SA109 into the [Engine.GameEngine] section.
[Engine.GameEngine] . ( other lines ) . ServerPackages=SA109
If you are using UTSecure, Sniper Arena 109 can run with bCheckSets set to True (tested against UTSecure 2.11). Sniper Arena 109 has the following MD5 information. This information can also be found in UT2003/System/SA109.md5.
Executing Class Engine.MasterMD5Commandlet ================================================== MD5 Database Management ================================================== Performing full MD5 on SA109.u GUID = [84C4D3ADD7110C8CD000C6874E3993B7] MD5 = [11c56fd4e1c2ef3770a4c0afee0fd666] Success - 0 error(s), 0 warning(s)
You will need to add, to the section of the version of UTSecure you are currently using, the following lines ...
[UTSecure###.UTChecker] . ( other lines ) . Checks=( FName="SA109.u", MD5="0322ca4b499fff6a506a3588b76382cc", ... MD5Type=2,GUID="100C0122D711F484D000C6874E3993B7", MaxGenerations=1) bCheckSets=true
NOTE - Having extra spaces at the end of the line has been known to cause problems. I'm too lazy to test it, so for good measure don't put extra spaces at the end of the line. UT2003 urban legend #1. Oh yeah, the "..." just means continuation of the line.
At this point, normally I'd tell you to edit the SA109.ini to your liking, but Sniper Arena 109 offers better ways to configure the mutator over hand editing the .ini file. So I'll defer this topic till after you start a server. If you like hand editing .ini files, skip this section until you edit your .ini file.
UT2003 has two says to start a server. One is via the Host Multiplayer Game menu in UT2003, the other is by using UCC.exe ( Windows ) or ucc-bin ( Linux ). For more information on UT2003 command line see The Admin Page. Here is an example ...
UCC.exe server <map>?game=<game class>mutator=SA109.MutSniperArena109ver ... ini=<ini file> log=<log file>
./ucc-bin server <map>?game=<game class>mutator=SA109.MutSniperArena109ver ... ini=<ini file> log=<log file>
With the server up, it's time to configure the server.
There are three ways to configure Sniper Arena 109.
UT2003 allows for configuration of some mutators via the Configure Mutator located under the Mutator tab in the Host Mutliplayer Game section. Just select "Frnz Sniper Arena 109" then click "Configure Mutator" to bring up the configuration GUI.
More information on this style can be found in the Client - Instant Action Section, since it's pretty much the same thing.
Web Admin is a feature of UT2003 that allows an admin to administrate the server via their web browser. It allow you to set the game rules from your web browser. You need to have your server configured to allow for web administration in order to configure Sniper Arena in this fashion.
To get to the Sniper Arena settings, click on Defaults, then SniperArena109. This will bring up the Sniper Arena settings. When done, click Accept to save the setting. Click on Restart Level to restart the server using the new settings.
|Arena Mode||Controls whether the game is arena style or normal.|
|Translocation in Arena Mode||Controls whether the translocator can be used in arena mode.|
|Default Scope||The default scope for a new players and admin forced scope.|
|Force Scope||Force players to use the Default Scope.|
|Bot Rifle Sound||Sets the rifle sound for the bots.|
|Show Help Message||Controls whether a help message is displayed.|
|Help Timer||Time interval between when 'Help' messages are displayed.|
|Help Message||Help message text.|
|Maximum Ammo||Maximum sniper ammo a player can carry.|
|Initial Amount||Amount of sniper ammo a player is spawned with.|
|Ammo Drop||Amount of ammo in dropped ammo pack.|
|Ammo Pickup||Amount of ammo in map pickups.|
|Fire Rate||Seconds between firing.|
|Crouched Fire Rate||Seconds between firing when crouched.|
|Headshot Radius||Radius around the head bone that will be considered a head shot.|
|Headshot Damage||Damage caused by a head shot.|
|Normal Damage||Normal body damage.|
|Momentum||Amount of momentum to apply to hit player.|
|Adjust Attributes||Allow adjustment of player attributes when killed or when scoring a kill.|
|Add Headshot Health||Amount of health added for a head shot.|
|Add Headshot Frags||Amount of frags added, in addition to default frags, for a head shot.|
|HeadshotAddShield||Amount of shield points added for a head shot.|
|Add Headshot Adrenaline||Amount of adrenaline added, in addition to default adrenaline, for a head shot.|
|Add Bodyshot Health||Amount of health added for a body shot.|
|Add Bodyshot Frags||Amount of frags added, in addition to default frags, for a body shot.|
|Add Bodyshot Shield||Amount of shield points added for a body shot.|
|Add Bodyshot Adrenaline||Amount of adrenaline added, in addition to default adrenaline, for a body shot.|
|Remove Headshot Frags||Amount of frags to remove for being head shot.|
|Remove Headshot Adrenaline||Amount of adrenaline to remove for being head shot.|
|Remove Bodyshot Frags||Amount of frags to remove for being body shot.|
|Remove Bodyshot Adrenaline||Amount of adrenaline to remove for being body shot.|
A sample of the SA109.ini file exist in the UT2003/Help/SniperArena/SA109 directory. This file should be copied to the UT2003/System directory, if it does not already exist there. Here is what SA109.ini looks like.
; See "Help/SniperArena/SA109/SA_README.html" for help [SA109.ServerInfo] bArenaStyle=True bAllowTranslocator=False DefaultZoomStyle=1 bForceZoomStyle=False bShowHelp=True BotRifleSound=0 HelpTimer=60 HelpMessage=For help with Frnz Sniper Arena, type 'mutate sahelp' in the console MaxAmmo=50 InitialAmount=30 DropAmmoAmount=5 PickupAmount=10 FireRate=0.600000 CrouchFireRate=0.600000 HeadShotRadius=8.000000 HeadshotDamage=100 BodyDamage=45 Momentum=20000 bAdjustPlayer=False HeadshotAddHealth=10 HeadshotAddFrag=1 HeadshotAddShield=0 HeadshotAddAdrenaline=0 BodyshotAddHealth=0 BodyshotAddFrag=0 BodyshotAddShield=0 BodyshotAddAdrenaline=0 HeadshotRemoveFrag=2 HeadshotRemoveAdrenaline=0 BodyshotRemoveFrag=1 BodyshotRemoveAdrenaline=0
Here is a description of the properties. All these properties are located in the [SA109.ServerInfo] section of SA109.ini
|bArenaStyle||Boolean||true||Controls whether the game is arena style or normal.|
|bAllowTranslocator||Boolean||false||Controls whether the translocator can be used in arena mode.|
|DefaultZoomStyle||Integer||1||Sets the default scope.
|bForceZoomStyle||Boolean||false||Force the DefaultZoomStyle on all players.|
|BotRifleSound||Integer||0||The sound a bot's rifle makes when fired.
|bShowHelp||Boolean||true||Controls whether a help message is displayed.|
|HelpTimer||Float||60.00000||Time interval between when 'Help' messages are displayed.|
|HelpMessage||String||For help with Frnz Sniper Arena, type 'mutate sahelp' in the console.||Help message text.|
|FireRate||Float||0.60000||Seconds between firing.|
|CrouchFireRate||Float||0.60000||Seconds between firing when crouching.|
|MaxAmmo||Integer||50||Maximum sniper ammo a player can carry.|
|InitialAmount||Integer||30||Amount of sniper ammo a player is spawned with.|
|bDropAmmo||Boolean||False||Allow ammo to be dropped when player is killed.|
|DropAmmoAmount||Integer||5||Amount of ammo in dropped ammo pack.|
|HeadShotRadius||Float||8.00000||Radius around the head bone that will be considered a head shot.|
|HeadshotDamage||Integer||100||Damage caused by a head shot.|
|BodyDamage||Integer||45||Normal body damage.|
|Momentum||Integer||20000||Amount of force to apply to hit player.|
|bAdjustPlayer||Boolean||False||Allow adjustment of player attributes when killed or when scoring a kill.|
|HeadshotAddHealth||Integer||10||Amount of health added for a head shot.|
|HeadshotAddFrag||Integer||1||Amount of frags added, in addition to default frags, for a head shot.|
|HeadshotAddShield||Integer||0||Amount of shield points added for a head shot.|
|HeadshotAddAdrenaline||Integer||0||Amount of adrenaline added, in addition to default adrenaline, for a head shot.|
|BodyshotAddHealth||Integer||0||Amount of health added for a body shot.|
|BodyshotAddFrag||Integer||0||Amount of frags added, in addition to default frags, for a body shot.|
|BodyshotAddShield||Integer||0||Amount of shield points added for a body shot.|
|BodyshotAddAdrenaline||Integer||0||Amount of adrenaline added, in addition to default adrenaline, for a body shot.|
|HeadshotRemoveFrag||Integer||2||Amount of frags to remove for being head shot.|
|HeadshotRemoveAdrenaline||Integer||0||Amount of adrenaline to remove for being head shot.|
|BodyshotRemoveFrag||Integer||1||Amount of frags to remove for being body shot.|
|BodyshotRemoveAdrenaline||Integer||0||Amount of adrenaline to remove for being body shot.|
|PickupAmount||Integer||10||Amount of ammo in map pickups.|
Sniper Arena has two map pickups. One is the Frnz Sniper Rifle. This pickup is only available when the server is set to non-arena mode. The seconds is the Frnz Sniper Ammo, which gives you sniper bullets.
Sniper Rifle Pickup
Sniper Arena offers four types of scopes.
UT2003 Zoom (default)
UT2003 Clean Zoom
If you are planning on playing offline, you can change the settings of Sniper Arena via the Configure Mutator ability under the Mutator tab in the Instant Action section.
Just highlight Frnz Sniper Arena 109 in the Available Mutators list, click Add, and it should move over into the Active Mutators list.
If you highlight Frnz Sniper Arena 109 again, you'll notice that it will display a description and a button called Configure Mutator. If you click on the button, a configure menu system will appear that will allow you to change the setting in Sniper Arena. Currently, there is no way to automatically restore the default values. Default values can be found in the Server - Hand Edit SA109.ini
The General tab controls the basic functions of the mutator. You can choose from the following settings on this screen.
|Arena Mode||Controls whether the game is arena style or normal.||Checked|
|Allow Translocation||Controls whether the translocator can be used in arena mode.||Not Checked|
|Default Scope||The default scope for a new players and admin forced scope.||UT|
|Bot Rifle Sound||Sets the rifle sound for the bots.||Unreal|
|Force Default Scope on Players||Force players to use the Default Scope.||Not Checked|
|Show Help Message||Controls whether a help message is displayed.||Checked|
|Help Message||Help message text.||NA|
|Help Timer||Time interval between when 'Help' messages are displayed.||60|
The Rifle tab controls the settings of the rifle. You can choose from the following settings on this screen.
|Fire Rate||Seconds between firing.||.60|
|Crouched Fire Rate||Seconds between firing when crouched.||.60|
|Headshot Radius||Radius around the head bone that will be considered a head shot.||8.0|
|Headshot Damage||Damage caused by a head shot.||100|
|Body Damage||Normal body damage.||45|
|Momentum||Amount of momentum to apply to hit player.||20000|
|Maximum Ammo||Maximum sniper ammo a player can carry.||50|
|Initial Amount||Amount of sniper ammo a player is spawned with.||30|
|Ammo Drop||Amount of ammo in dropped ammo pack.||5|
|Ammo Pickup||Amount of ammo in map pickups.||10|
The Attributes tab controls attributes that affect a player when killed or when they have killed.
|Adjust Player Attributes||Allow adjustment of player attributes when killed or when scoring a kill.||Not Checked|
|Headshot + Health||Amount of health added for a head shot.||10|
|Headshot + Frags||Amount of frags added, in addition to default frags, for a head shot.||1|
|Headshot + Shield||Amount of shield points added for a head shot.||0|
|Headshot + Adren.||Amount of adrenaline added, in addition to default adrenaline, for a head shot.||0|
|Bodyshot + Health||Amount of health added for a body shot.||0|
|Bodyshot + Frags||Amount of frags added, in addition to default frags, for a body shot.||0|
|Bodyshot + Shield||Amount of shield points added for a body shot.||0|
|Bodyshot + Adren.||Amount of adrenaline added, in addition to default adrenaline, for a body shot.||0|
|Headshot - Frags||Amount of frags to remove for being head shot.||2|
|Headshot - Adren.||Amount of adrenaline to remove for being head shot.||0|
|Bodyshot - Frags||Amount of frags to remove for being body shot.||1|
|Bodyshot -Adren.||Amount of adrenaline to remove for being body shot.||0|
The commands hudtype, zs_on, zs_off, and zs_toggle have been removed in favor of the mutate commands.
The new commands use the mutate command format. They can be called as a spectator, and when you are alive or dead in the game.
|mutate sahelp||Brings up the help screen.|
|mutate sarifle||Brings on the rifle configuration screen.|
|mutate saserver||Brings on the server information screen.|
The mutate commands can be bound to a key for quick access. The following is the UT2003 console command to bind a key. Replace <key> with the keyboard key your wish to press in order to bring up the desired screen.
set input <key> mutate sahelp set input <key> mutate sarifle set input <key> mutate saserver
mutate sahelp brings up this menu screen.
The in-game help screen displays important information about playing Sniper Arena for the current server. The information changes based on the setting of the server, the setting for Sniper Arena on the current setting, and your current rifle settings.
mutate sarifle brings up this menu screen.
This screen allows you to select a sniper scope, turn on and off zoom sounds, and set the rifle shot sound you wish to be heard from your rifle. Any changes on this screen will be saved. If the server is running with Force Default Scope enabled, you will not be able to select a different scope. You will still be able to change the zoom and rifle sounds.
mutate saserver brings up this menu screen.
This screen shows the server settings of the current server.
The in-game thanks page.
If the GUI is not your cup of tea, you can always hand edit the SniperArena.ini file to your liking. All properties are part of the [SA109.ClientInfo] section.
|Scope||Integer||0||Your sniper scope
|RifleSound||Integer||0||Your rifle shot sound|
|bZoomSound||Boolean||true||Controls whether sounds are played when you zoom.|