Sniper Arena 2K4
Author        : $Author: jwalstra $
Revision      : $Revision: 1.2 $
Checkout Date : $Date: 2004/05/11 03:42:46 $
Source File   : $Source: /home/cvs/SA2K4/Help/README.html,v $

// Copyright (C) 2003 John Walstra
// spoon@spoonware.org
// http://spoonware.org
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//
// See LICENSE.uc or LICENSE

About

This is the UT2004 version of my UT2003 Sniper Arena. For UT2003, Epic decided to remove the sniper rifle. This did not sit well with the sniper community of Unreal Tournament ( UT99 ) who were being left out in the cold. So for UT2003, I decided to create a simple mutator that would add back the sniper rifle. After 11 releases, the simple mutator evolved into more than just an arena mutator.

Then it was announced that UT2004 would include the sniper rifle, I figured my work was done. However, while the UT2004 sniper rifle is very nice, it still does not cater to those that play arena style. So now, here we are. The UT2004 version of my sniper "arena".

Enjoy,
spoon (aka supun)
http://spoonserver.org

Thanks

Col Kassad - For the making the sniper rifle models work.

Installation

This version uses the same SA2K4Media package as Sniper Arena 2K4 100.

The archived file should contain the following files (along with images for the README)

  • System/SA2K4_101.u
  • System/SA2K4Media_100.u
  • System/SA2K4_101.ucl
  • System/SA2K4_101.md5
  • System/SA2K4Media_100.md5
  • Help/SA2K4_101/README.html ( this document )
  • Help/SA2K4_101/LICENSE
  • Help/SA2K4_101/images/* ( related help images )
  • Web/SA2K4WebAdmin/* ( web admin pages )
  • Web/images/SA2K4/* ( web admin images )

This archive should be unzipped into your UT2004 base directory in order for the files to be placed in the correct location.

Server

Post Install

Once you have installed Sniper Arena 2K4, you will need to edit your server .ini file. Servers use UT2004.ini, if not told differently.

You need to add a few entries to your server's ini file. The Engine.GameEngine is required in order for a connecting client to receive the mutator from the server via a download, if they do not have it already. The UWeb.WebServer section is required for configuring the mutator via a web browser. In the sample below, replace 2 with the next available number if 2 is already in use.

[Engine.GameEngine]
ServerPackages=SA2K4Media_100
ServerPackages=SA2K4_101

[UWeb.WebServer]
Applications[2]=SA2K4_101.WebServerAdmin
ApplicationPaths[2]=/SA2K4WebAdmin

If you use AntiTCC or UTSecure, here is the MD5 information.

SA2K4_101 has the following MD5 information.

Executing Class Engine.MasterMD5Commandlet
==================================================
 MD5 Database Management
==================================================

Performing full MD5 on SA2K4_101.u

 GUID = [E047A930D8119AA7D000C6874E3993B7]
  MD5 = [e8dcf848cbaeb389a4f9735acaae6bdc]

Success - 0 error(s), 0 warning(s)

SA2K4Media_100 has the following MD5 information.

Executing Class Engine.MasterMD5Commandlet
==================================================
 MD5 Database Management
==================================================

Performing full MD5 on SA2K4Media_100.u

 GUID = [F21A57C7D811FCA2D000C6874E3993B7]
  MD5 = [2b7abaf28438d2173ad018f89e74ba62]

Success - 0 error(s), 0 warning(s)

Starting A Server

UT2004 has two ways to start a server. One is via the Host Game menu in UT2004, the other is by using UCC.exe ( Windows ) or ucc-bin ( Linux ).

Windows

UCC.exe server <map>?game=<game class>mutator=SA2K4_101.MutSniperArena 
ini=<ini file> log=<log file>

Linux

./ucc-bin server <map>?game=<game class>mutator=SA2K4_101.MutSniperArena \
  ini=<ini file> log=<log file>

With the server up, it's time to configure the server.

Configuration

There are two ways to configure Sniper Arena 2K4.

  1. Configure Mutator
  2. Web Admin Configuration

It is not recommended that you configure the mutator by hand.

Configure Mutator

UT2004 allows for configuration of some mutators via the Configure Mutators located under the Mutators tab in the Host Game section. Just select "Sniper Arena 2K4 101", click add, then click Configure Mutators, at the bottom of the screen, to bring up the configuration GUI.

This will open a page and display items that can be configured for your selected mutators. Sniper Arena 2K4 will have an Open button. Click this to open the configuration screen for Sniper Arena 2K4.

Help

The Help Message screen is used to set the help message that appears in the console.

Help Message
Show help MessageCheck box to enable/disable the help message
Help MessageHelp message text
Help Timer (seconds)Delay between messages in seconds.

Configurations

The Configurations screen is used map the game type to a configuration. First click on a game type in the Game Types box. The corisponding configuration will be highlighted in the Configurations box. If you click on a different configuration in the Configuration box, that configuration will be used for that game type. The same configuration can be used with multiple games types.

The Edit Configuration section on this screen allows you configure the configurations. Just select the configuration you wish to edit in the drop down box and click on Edit.

General

The General tab contain general game options and the name of the configurations.

General
Arena ModeCheck for arena mode, unchecked for lightening gun/stock sniper rifle replacement
Allow translocatorIf checked, the translocator will not be removed in arena mode.
Spawn with sniper rifleIf checked, players spawn with the sniper rifle in non-arena mode/replacement mode.
Arena safe link gunIf checked, players will be allowed to pick up a link gun that does not do damage.
Allow special weaponsIf checked, weapons that are built into the map are not removed.
Allow health pickupsIf checked, health items will remain in the map.
Allow shield pickupsIf checked, shield items will remain in the map.
Allow damage amplifierIf checked, the damage amplifier pickup will remain in the map.
Allow super weaponsIf checked, super weapons will remain in the map for arena mode.

Scope

The Scope tab contain scope related configurations.

Scope
Force Default ScopeIf checked, player will be forced to play with the scope below.
Available ScopesScope player would be forced to play with, if forced.
Maximum Zoom MultiplierControl the distance you can zoom.

Rifle

The Rifle tab contain the rifle related configurations.

Rifle
Normal Fire RateSeconds between firing.
Crouched Fire RateSeconds between firing when crouched.
Headshot RadiusRadius around the head that will be considered a head shot
Headshot DamageDamage caused by a head shot
Body DamageDamage cause by a normal body shot
Vehicle DamageDamage to a vehicle
Hit MomentumAmount of momentum to apply to hit player.
Team Momentum AdjIncrease or decrease the amount of boost applied to teammates
Fire RangeDistance the rifle can fire
Bot Sniper Rifle SoundThe sound of the rifle used by the bot.
Sniper Rifle ModelThe rifle model to be used
Show Tracer BulletIf checked, a tracer fire effect will be displayed
Show Smoke CloudIf checked, a smoke cloud will be emitted by the snipe rifle.

Ammo

The Ammo tab contain the ammo related configurations.

Ammo
Maximum Ammo AmountMaximum sniper ammo a player can carry.
Initial AmountAmount of sniper ammo a player is spawned with.
Drop Ammo AmountAmount of ammo in dropped ammo pack.
Pickup Ammo AmountAmount of ammo in map pickups.

Attributes

The Attributes tab contain the bonuses and penalties for killing or being killed

Attributes
Adjust Player AttributesAllow adjustment of player attributes when killed or when scoring a kill.
Headshot + HealthAmount of health added for a head shot.
Headshot + FragsAmount of frags added, in addition to default frags, for a head shot.
Headshot + ShieldAmount of shield points added for a head shot.
Headshot + Adren.Amount of adrenaline added, in addition to default adrenaline, for a head shot.
Headshot + Ammo.Amount of ammo added for a head shot.
Bodyshot + HealthAmount of health added for a body shot.
Bodyshot + FragsAmount of frags added, in addition to default frags, for a body shot.
Bodyshot + ShieldAmount of shield points added for a body shot.
Bodyshot + Adren.Amount of adrenaline added, in addition to default adrenaline, for a body shot.
Bodyshot + Ammo.Amount of ammo added for a body shot.
Headshot - FragsAmount of frags to remove for being head shot.
Headshot - Adren.Amount of adrenaline to remove for being head shot.
Bodyshot - FragsAmount of frags to remove for being body shot.
Bodyshot - Adren.Amount of adrenaline to remove for being body shot.

Web Admin Configuration

Web Admin is a feature of UT2004 that allows you to administrate the server via a web browser. It allows 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. Sniper Arena 2K4 however does not use the normal web admin pages. It uses it's own pages. To access these pages, you need to go to http://yourserver:port/SA2K4WebAdmin in your web browser.

Main Page

The Main Page shows the current configuration setup. What is shown is a list of game types and which configuration it will use. A configuration can be use by multiple games types.

Help Message

The Help Message page is used to set the help message that appears in the console.

Help Message
Show help MessageCheck box to enable/disable the help message
Seconds between messagesDelay between messages in seconds.
Help MessageHelp message text

Configuration

The Configuration page is used map the game type to a configuration. First click on a game type in the Game Types box. The corisponding configuration will be highlighted in the Configurations box. If you click on a different configuration in the Configuration box, that configuration will be used for that game type. The same configuration can be used with multiple games types. Click Update to save the configuration map.

The Edit Configuration section of this page allows you configure the configurations. Just select the configuration you wish to edit in the drop down box and click on Edit.

Configuration - Edit Page

General
Arena Mode?Check for arena mode, unchecked for lightening gun/stock sniper rifle replacement
Allow translocator in arena model?If checked, the translocator will not be removed in arena mode.
Spawn with sniper rifle in normal mode?If checked, players spawn with the sniper rifle in non-arena mode/replacement mode.
Allow safe link gun in arena mode?If checked, players will be allowed to pick up a link gun that does not do damage.
Keep special weapons?If checked, weapons that are built into the map are not removed.
Allow health pickups?If checked, health items will remain in the map.
Allow shield pickups?If checked, shield items will remain in the map.
Allow damage amplifier pickups?If checked, the damage amplifier pickup will remain in the map.
Allow super weapons?If checked, super weapons will remain in the map for arena mode.
Scope
Force default scope?If checked, player will be forced to play with the scope below.
Default ScopeScope player would be forced to play with.
Scope MultiplierControl the distance you can zoom.
Rifle
Normal Fire RateSeconds between firing.
Crouched Fire RateSeconds between firing when crouched.
Headshot RadiusRadius around the head that will be considered a head shot
Headshot DamageDamage caused by a head shot
Normal DamageDamage cause by a normal body shot
Vehicle DamageDamage to a vehicle
Hit MomentumAmount of momentum to apply to hit player.
Teamboost Adjustment %Increase or decrease the amount of boost applied to teammates
Range of FireDistance the rifle can fire
Show Tracer Round?If checked, a tracer fire effect will be displayed
Show Smoke Cloud?If checked, a smoke cloud will be emitted by the snipe rifle.
Rifle ModelThe rifle model to be used
Bot Rifle SoundThe sound of the rifle used by the bot.
Ammo
Maximum AmmoMaximum sniper ammo a player can carry.
Initial AmountAmount of sniper ammo a player is spawned with.
Ammo DropAmount of ammo in dropped ammo pack.
Ammo PickupAmount of ammo in map pickups.
Attributes
Adjust AttributesAllow adjustment of player attributes when killed or when scoring a kill.
Headshot - Add HealthAmount of health added for a head shot.
Headshot - Additional FragsAmount of frags added, in addition to default frags, for a head shot.
Headshot - Add ShieldAmount of shield points added for a head shot.
Headshot - Additional AdrenalineAmount of adrenaline added, in addition to default adrenaline, for a head shot.
Headshot - Add AmmoAmount of ammo added for a head shot.
Bodyshot - Add HealthAmount of health added for a body shot.
Bodyshot - Additional FragsAmount of frags added, in addition to default frags, for a body shot.
Bodyshot - Add ShieldAmount of shield points added for a body shot.
Bodyshot - Additional AdrenalineAmount of adrenaline added, in addition to default adrenaline, for a body shot.
Bodyshot - Add AmmoAmount of ammo added for a body shot.
Headshot - Remove FragsAmount of frags to remove for being head shot.
Headshot- Remove AdrenalineAmount of adrenaline to remove for being head shot.
Bodyshot - Remove FragsAmount of frags to remove for being body shot.
Bodyshot - Remove AdrenalineAmount of adrenaline to remove for being body shot.

Map Vote

You can enable Sniper Arena 2K4 via the map vote. It can be added via the UT2004 Web Admin or by adding the GameConfig lines to UT2004.ini.

GameConfig=(GameClass="XGame.xDeathMatch",Prefix=,Acronym=,GameName="DM SA2K4",
            Mutators="SA2K4_101.MutSniperArena",Options=)

Sniper Arena 2K4, by default, will match the configuration to the game type, however this can be over-riden. The option is SAConfig and it must be passed in via the Options parameter. For example, if you have two death-match games, and wish them to uses different configurations, you would specify different SACOnfig values for each games.

GameConfig=(GameClass="XGame.xDeathMatch",Prefix=,Acronym=,GameName="Test 1",
            Mutators="SA2K4_101.MutSniperArena",Options="SAConfig=0")
GameConfig=(GameClass="XGame.xDeathMatch",Prefix=,Acronym=,GameName="Test 2",
            Mutators="SA2K4_101.MutSniperArena",Options="SAConfig=1")

Valid values are 0 through 9. You can find the correct SAConfig number by looking at the main page on the web admin page, the web admin configuration edit page, or by looking on the mutator configuration, general tab by the configuration name.

Client

Items

Sniper Arena 2K4 has two sniper models, the stock UT2004 and the UT99 sniper rifle.

UT2004 Sniper Rifle

UT2004 Sniper Rifle Pickup

UT99 Sniper Rifle

UT99 Sniper Rifle Pickup

Scopes

Sniper Arena offers five types of scopes.

UT99 Scope
UT99 Scope
UT2004 Scope
UT2004 Scope
UT2003 Scope
UT2003 Scope
UT99/2004 Hybrid
UT99/2004 Hybrid

and no scope ( not shown ).

Console Commands

Most of the Sniper Arena 2K4 commands use the mutate command format. They can be called as a spectator, and when you are alive or dead in the game.

Commands
mutate sahelpBrings up the help screen.
mutate sarifleBrings on the rifle configuration screen.
mutate saserverBrings on the server information screen.
zoominWhile zoomed, will increase the zoom.
zoomoutWhile zoomed, will decrease the zoom.

The mutate commands can be bound to a key for quick access. The following is the UT2004 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
set input <key> zoomin 
set input <key> zoomout

Client Menu Screen

Help Tab

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.

Rifle Tab

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.

Sever Info Tab

mutate saserver brings up this menu screen.

This screen shows the server settings of the current server.

About Tab

The in-game thanks page.

Known "Problems"

  • Weapons lockers have UT2004 sniper model in them, even if you are using UT99 sniper model.

Releases

Release 101

  • Fixed the web admin so it would work with IE.
  • Fixed the problem with the UT99 skin being used on the UT2004 sniper rifle.

Release 100 (First Release)

  • Ported UT2003 Sniper Arena to UT2004