================================================================================
 = HUTSS - HeZ UT Statistics Server
 = For ASC8/HUT v830 or higher and Java Runtime Environment 5.0
 = by Daan Scheerens aka Defrost (d.scheerens@gmail.com)
 = Version 1.00
================================================================================

=================
 WHAT IS HUTSS :
=================
 HUTSS is a standalone server that will accumulate stats received from servers
 running the ASC8/HUT server controller. It can be configured to support
 multiple servers and even groups of servers. So the stats server doesn't have
 to run on the same machine as where your UT server is running.

====================
 HOW DOES IT WORK :
====================
 At the beginning of every match the ASC8/HUT controller will request a list of
 top players (if enabled). The stats server will select the best from its
 database and send them to the UT server. Once the UT server receives it a small
 list of top players is displayed in the upper right corner of the screen.
 
 At the end of every match the ASC8/HUT controller sends the statistics for the
 finished match to the stats server for processing. The stats server will record
 stats on a global, monthly, weekly and daily base.
 
=====================================
 HOW IS A PLAYERS SCORE DETERMINED :
=====================================
 The score is based on only two parameters and is therefore very simple. The
 first parameter is the amount of ownages and the second is the number of
 fights. The last parameter indicates how many players you have fought, the
 first how many of these fights you have won. So the amount if ownages is always
 less then or equal to the number of fights. You own a player if you have killed
 him/her more times during the match then he/she has killed you.
 
 After every match the players ownages and fights are increased by the number
 of ownages and fights of the last match.
 
 The formula to calculate a players score is:
   1000 * owned ^ 1.2 / fight
 Why this formula? Well because the more ownages you will have the higher your
 score will be. Suppose player 1 has 100 ownages and 10000 fights, player 2 has
 only 40 ownages but 50 fights. Which player is better? It's clear that if we
 were only to count the number of ownages, player 1 will have a higher score.
 This ain't fair for player 2 since his ownage/fight ratio is much higher, and
 in fact he would probably be a much better then player 1. So thats why it is
 divided by the number of fights.
 
 Why not just use owned / fight * 1000 as score? Suppose player 1 has 4 ownages
 and 5 fights, player 2 has 40 ownages and 50 fights. Now this would mean but
 players have a same score of 800 points. But again this isn't fair for player 2,
 since it's much harder to a 4/5 ownage/fight ratio with 50 fights instead of
 only 5 fights. Thats why the number of ownages is raised by a power of 1.2.

==================
 HOW TO INSTALL :
==================

 Installing HUTSS:
 
   1. Make sure JRE 1.5.0 is installed on your server, if not you can download a
      copy from www.javasoft.com
 
   2. Copy the folder hutss to your classpath.
 
   3. Open a new shell / command prompt and change the current path to the
      folder you just copied.
 
   4. Create a new server group for your server by executing the command:
    java hutss.HUTSS create
 
   5. Enter a group name, one or more allowed servers for this group and the
      filename for the stats database file (use .hts as extension).
    
   6. Repeat steps 4 and 5 if you want to create more server groups.
 
   7. Start the Stats Server with the command:
      java hutss.HUTSS 7780
      * replace 7780 with your the port number you would like to use for HUTSS.
      * HUTSS will automatically try to load all files with the .hts extension
        found in the current working directory.

 Configuring a ASC8/HUT server:
 
   1. Shut your server down and open hutserver.ini
 
   2. Scroll to the end of the file and locate the following options:
      UseStatsServer=False
      StatsServer= .....
      StatsServerHost= .....
      StatsServerPort= .....
      * StatsServerHost is ignored by HUTSS, enter any value u like.
 
   3. Update the options, for example:
      UseStatsServer=True
      StatsServer=127.0.0.1
      StatsServerHost=IgnoredByHUTSS
      StatsServerPort=7780
 
   4. Save your changes and start your server!
    
===========
 CREDITS :
===========
 + Mickal 'ATHoS' DEHEZ (mike@hez-studios.net), developer of HeZ UT