Site hosted by Angelfire.com: Build your free website today!

BAB.stats Chronos Server Manual

Preface

BAB.stats is a statistics system for Delta Force games by Novalogic. It consists of two parts: the server side scripts (BAB.stats Server) and the scores uploading application (BAB.stats Uploader) which must be run on the same PC as the game server. The server side application is based on PHP and MySQL. Many game servers can upload scores to the same web server so you are free to build a stats network comprising of any number of game servers.

Before installing and using, you might want to read Frequently Asked Questions.

Installation

NOTE: before doing anything make sure your webspace provider has PHP and MySQL support. If your hosting company doesn't support these features you won't be able to install the stats pages. You must also understand what you are doing, if you don't know what PHP and MySQL are better find someone who could install stats for you, otherwise installation will become a pain, especially if you don't completely understand this installation section. However, if you understand what is said in this section you will be able to install stats in 10 minutes.

1. Unzip everything.

2. Open "config.php" in main directory with any text editor (like Notepad), set your database parameters (database host, database name, user name, password and table prefix), as well as the user name and password of the administrator. If you are not sure what your database settings are contact your hosting company. Table prefix is useful if you want to have more than one stats page installed on the same database. It can be anything you want - if table prefix is set to "ttt" for example all tables for the current stats page will begin with "ttt". By editing the "config.php" file, you can also set how many records you want to be displayed in the lists, and so on. There are more parameters in "config.php" that I won't cover here, just open the file and read the comments near each variable to find out what it does.

3. Open "rating.php" in main directory and edit how many rating points the player is given for his stats. I will not talk about it here - just read the comments in that file to find out the meaning of each variable. You must edit this file before you actually start to track and upload the stats, becouse later changes will not have any effect on stats that were tracked earlier. If the default settings satisfy you, you can leave it as-is.

4. Create the database. If you use free web hosting provider you will probably already have at least one database. You need to specify name of that database in "config.php" file. If you don't know your database settings please contact your hosting company. If you saved the email from your webspace provider when you registered your account, all necessary database settings are probably there.

5. Upload everything to your webspace (you can use any FTP client for this purpose, or your hosting company's own facilities (if they exist). You can upload to any directory.
NOTE: you must retain the directory structure!

6. Check if there is "upload" and "maps" folders in where you uploaded everything. If these are not there, you must create them.

7. Installation. BAB.stats provides an install script that does this job for you. Simply enter this in your browser:

http://www.your_domain.com/stats_directory/install.php

This will create all the necessary tables and CHMOD "upload" and "maps" directories to 777. If it fails you will need to CHMOD them with your FTP client manually. Don't forget to delete the "install.php" file from web server afterwards!
NOTE: if you do not intent to use FTP upload, you do not need to have "upload" folder CHMOD 777. Though, you MUST CHMOD "maps" to 777 if you want to be able to upload map images/thumbnails. The easiest and the most common way to CHMOD these folders by using FTP client is to login to your FTP, navigate to the directory where stats are installed, right-click on the folder you want to CHMOD, and set the permissions to "777". This process might be different in various FTP programs, so you should read the help files of your FTP client.

8. If the installation was successful you can type this in your browser's URL field:

http://www.your_domain.com/stats_directory

9. Now you must add some servers in Administration Panel in order to start uploading stats. For instructions how to use Administration Panel please go to "Administration Panel" section of this document.

10. Done!

Upgrading from previous versions of BAB.stats

This is impossible to do. This version of BAB.stats (Chronos) has a completely different database structure, stats are stored in a different way, so trying to convert the database into new format would couse a big loss in accuracy of the stats, as there was no timing information tracked in previous versions.

Requirements

The Webserver must support MySQL and PHP 4.0

Changing the look and feel of stats pages

BAB.stats Server pages are completely template-driven. For a complete manual on template editing go to Theme Maker's Manual (Currently unavailable, but you can use the old manual from the previous version - you must know a lot about template system used in BAB.stats though!).

Administration Panel

To use the Administration Panel you must point your browser to

http://www.your_domain.com/stats_directory/admin.php

You must login first. For a complete manual on using the Administration Panel go to Administration Panel Manual.

Credits

Tomas Stucinskas a.k.a Baboon (Author of the Uploader and Server scripts)
E-mail: baboon@ai-hq.com
WWW: http://www.ai-hq.com

Avenger - provided several game servers to test the programs, and overally helped a lot

Dancer - helped with testing of the programs

RED BULL - rank and weapon images, BAB.stats Chronos Logo

CONDA - provided a very important info on BHD internals (you're da man :D)

Folk at chancellor.ai-hq.com - for useful information and other help

User Support

The official BAB.stats page is located at http://www.ai-hq.com/babstats. There is also a user support forum where you can ask questions, make suggestion or just talk about anything. If you find any bug or have a suggestion or anything else I encourage you to post there. Please make sure your question was not answered before! I do not provide any support via ICQ, only if you have very specific question feel free to email me. Support Forum is the fastest way to get your problem solved! Due to lack of time, I do not install stats for anyone, you will have to do it yourself.

Security Issues

It will improve security a lot if you place the "config.php" file outside your public html directory. Set the path to this file in .htaccess wich should be located in the stats directory.

Licence

Please read "licence.txt" included in the package.