X-Stats

X-Stats v0.8 is the first public release of an awesome, new stat-keeping tool for servers. Check out the screenshot to see a handful of its...

Download

Uploading...
Do not refresh or leave this page!

File Description

X-Stats v0.8 is the first public release of an awesome, new stat-keeping tool for servers. Check out the screenshot to see a handful of its totally unique options!

Read More

Download 'xstats_v0.8.zip' (37KB)

Screenshots
Readme
Website: http://x-tools.insurgent-nighthawks.com
E-Mail: LuckyMe@insurgent-nighthawks.com
Version: X-Stats v0.8

About X-Tools: X-Stats
======================
There are several points why you should have X-Stats as your game server statistics.
The biggest benefit of X-Stats is that it creates the statistics at the moment of request, this makes it very flexible and gives you even the possibility to compare players with each other, down to the level you need it, like kills per weapon per map per gametype.Or you can see who is having more kills, picked up more weapons and achieved more goals, all per 100 games, so that it is easier to compare between each other.Another great feature is that you can filter the statistics as you want to. You like to see the statistics only for a specific weapon and / or a single game type or map, no problem, just select what you want. If you have more than one game server for the same game than X-Stats will show the statistics for all the servers, but you can filter it down to a single server as you want. If you have more than one game server for the same game than X-Stats will show the statistics for all the servers, but you can filter it down to a single server as you want.

Important for administrators!!! X-Stats is very easy to install. If your system full fills the requirements then you just copy the files to your server and surf to it. X-Stats will recognise the new installation and automatically install itself to your needs. Therefore anybody hosting a game server and a web site can use X-Stats easily.Also the update with the latest log files is very easy, you don't need to download the log file from your game server, compile the statistics and then upload them again to your website. X-Stats does all of that for you. You just need to tell it where to find the log file and it will do the rest for you, it can even archive the log files for you.

In future releases X-Stats will keep the chats that you had during a game, if they are provided in the log file of the game, like in Call of Duty (CoD), so that you can read them through as you wish. And I am also going to implement a feature to have statistics on a clan level and the possibility to see different names that a player has been using in the past. And I have other great features on my list, but I am not going to tell you just yet about it.


What are the special features of X-Stats?
=========================================
I am proud to say that X-Stats is capable of things that other game server statistic programs can't provide.
- Statistics accross several servers of the same game.
- You can compare players with each other directly.
These two features are very nice, especially when it comes to clans which like to compare players with each other and those which do have more than one server.
This features are available because the statistics are produced on request and are not pre-compiled before uploaded. Therefore X-Stats works completely different to any other game server statistics program out there.
Since X-Stats is based on PHP it is also indipendent from any OS. You can run MyStats on any plattform that is supported by PHP. Currently this is UNIX, Linux, Mac OS X, Novell NetWare, OS/2, RISC OS, SGI IRIX, AS/400 as well as Windows. And MySQL, which is also needed, is also available on most of these platforms.


Which games does X-Stats support?
=================================
Right now it only supports Call of Duty and United Offensive. but I am planning to include more games in the near future. As we are playing a lot of Counter Strike Source I will focus on that game first.
Other games I will add depending on the requests I receive. So please post in the wish list.


How much does X-Stats cost?
===========================
Nothing, it is free for eveybody as descriped in the GNU license:
Copyright (c) 2004 Sascha Rhein. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".


What do I need to run X-Stats?
==============================
In order to run X-Stats you need to have the following programs installed and configured properly:
- Web-Server (Apache 1.2 or higher, or any other - I have not tested any other)
- PHP 4.2 (or higher)
- MySQL 4.0 (or higher)
You don't need any other access to the server, but HTTP and FTP access in order to upload X-Stats and if you want to upload your log files.


Why does it look so different?
==============================
The concept behind X-Stats is to provide you with very detailed, flexible and indepth game statistics and in the near future those will be available across may different games.
Due to the fact that all the games have different teams, maps, weapons, etc. I am not able to provide you with pictures for all of them. Therefore I decided - for now anyway - to stick to pure text based information.
Even so it looks boring it is also for the benefit of the people looking at the stats. The loading time is much lower without any graphics involved.



/****************************************************/
/*  X-Tools: X-Stats, the most flexible game stats                          */
/*  http://x-tools.insurgent-nighthawks.com                                 */
/*  ======================================================================  */
/*                                                                          */
/*  Copyright (c) 2004-2005 Sascha Rhein. Permission is granted to copy,    */
/*  distribute and/or modify this document under the terms of the GNU Free  */
/*  Documentation License, Version 1.2 or any later version published by    */
/*  the Free Software Foundation; with no Invariant Sections, no Front-     */
/*  Cover Texts, and no Back-Cover Texts. A copy of the license is included */
/*  in the section entitled "GNU Free Documentation License"                */
/*                                                                          */
/****************************************************/





INDEX
1. Requirements
2. File list
3. Installation guide
4. Configuration of X-Stats
5. Import of log files
6. PHP-Nuke specialities
7. Non PHP-Nuke specialities
8. Version history
9. Trouble shooting
10. Known bugs





~-_-~-_-~-_-~-_-~-_-~-_-~   1. REQUIREMENTS   ~-_-~-_-~-_-~-_-~-_-~-_-~

You basically need a web site on which you want to show the statistics. And
your provider should give you the possibility to use PHP and MySQL.

ATTENTION: Even so X-Stats is easy to integrate into PHP-Nuke you have to have
MySQL as a database as I have not implemented into all the databases that
PHP-Nuke is capable of. Please check with your web site provider if you are not
sure.

And if you don't use PHP-Nuke then you need to know how a web site works and
how to see a link to your X-Stats index.php file. Further more you have to know
the connection details of your MySQL database. Your web site provider can give
you this information easily. And you need to know how to use FTP in order to
copy the X-Stats files on to your server and to upload the game log files to
your website, should you not want X-Stats is doing this for you automatically.
Either way you need to know the FTP address and the password to access your
game server log files and your web server.

You don't need to know how to do anything in PHP nor in MySQL or anything like
that.






~-_-~-_-~-_-~-_-~-_-~-_-~   2. FILE LIST   ~-_-~-_-~-_-~-_-~-_-~-_-~

Here is an overview of the files that are used by X-Stats. Should you use
X-Stats without X-stats than please copy the files marked with an asterix (*)
in the description to the same folder of your wish.


modules\x-stats\index.php   ----------   *shows the statistics to visitors
modules\x-stats\style.css   ----------   *Theme file for styling your site
modules\x-stats\x-stats-config.php   -   config file, will be created
modules\x-stats\x-stats-header.php   -   *contaions header information
modules\x-stats\x-stats-lib.php   ----   *function library for X-Stats

admin\case\case.x-stats.php   --------   file for PHP-Nuke integration
admin\links\links.x-stats.php   ------   contains links for PHP-Nuke
admin\modules\x-stats.php   ----------   *admin page for X-Stats

images\admin\x-stats.gif   -----------   image shown in PHP-Nuke admin panel






~-_-~-_-~-_-~-_-~-_-~-_-~   3. INSTALLATION GUIDE   ~-_-~-_-~-_-~-_-~-_-~-_-~

An easy installation and maintainance of all X-Tools is one of my biggest goals
and I hope you agree that it is easy to install it. Let's see....

The first thing you need to do is to upload X-Stats to your server. This
depends on if you are using PHP-Nuke or not. If you do, just upload it so that
the folders within the folder "html" matches the folders of your PHP-Nuke
installation. Content of admin folder into the admin folder of your PHP-Nuke
installation, etc. If you don't use PHP-Nuke then take the content of

modules\x-stats
admin\modules

and copy all of them into the same folder of your wish.

Once you have copied all the files to the server you have to open your Internet
browser and browse to the URL of x-stats.php
(http://www.your-website.com/subfolder/x-stats.php) or you use the admin panel
of PHP-Nuke and click on "X-Stats". In both cases you should see a screen which
asks you for the details about how to connect to your mySQL database. And a
field asking for the prefix of the tables. This can be used if you like to
install X-Stats more than once in the same database. Usually just enter
"x-stats" (without quotation marks) and its fine. Please enter these
information and also the password that you want to use in the future when ever
you enter this administration page of X-Stats.
ATTENTION: Do not use a dash (-) in the database prefix table name as it does
not work in all mySQL versions / settings and can therefore cause problems.
Click on ok and it will create a file called "x-stats-config.php" in the same
folder as index.php and save all the given information in it. No worries, the
password is encrypted.
It will also show you on the screen that it has written all the information to
this file, just click on ok and you will return to the main menu.

You are almost there, the only thing left is to click on the button "Creating
of tables", this will bring you to a screen where you can select the tables you
would like to delete or create. Since this is the installation of X-Stats tick
"All" in the bottom of the list and confirm your selection by typing "yes"
(without quotation marks) in the field underneath. Click ok.

Now you should see a screen which shows you that all the tables have been
created. Just click on ok an you are done with the installation of it.

Please continue with the next section, the configuration of X-Stats.






~-_-~-_-~-_-~-_-~-_-~-_-~   4. CONFIGURATION OF X-STATS   ~-_-~-_-~-_-~-_-~-_-~

You are logged in to X-Stats and you should see the buttons in the main menu.
Please click on "Configure X-Stats". You will see a site which gives you all
the settings and
features you need.
As there is extensive text in the site itself I will not mention it here again.
Just go through each field on the site until you see a button "save changes".
Click on it and you will get a message that the settings you have entered are
saved. Click on ok and you will return to the configuration page. Scroll down
and continue with the settings below the "save changes" button.
Enter the custom name of your game (e.g. "CoD") and click on add. You will get
a page telling you that the game has been added. Please click on okay and you
will return to the configuration page. Scroll down to the game section again
and continue with the next part, the game server settings. Enter the name of
your game server and click on add. You will get to a page which is asking you
for a lot of details. I will again not go into the details of those field here
as there is extensive text in the website itself. Go through it field by field
and enter all the necessary values. Click ok and you will return to the
configuration site. Please click "return to admin panel" and you are done with
the configuration.

Please continue with the next section, the import of log files.






~-_-~-_-~-_-~-_-~-_-~-_-~   5. IMPORT OF LOGFILES   ~-_-~-_-~-_-~-_-~-_-~-_-~

To import log files to X-Stats you log in to your admin panel and from there
you click on the "Import of log file" button.
From here just follow the instructions on the screen, it will guide you
through, step by step. If you have specified wrong values for your local
folders or for the FTP connection to your game server log files than you will
receive an error. If so then please go back to the configuration of that
specific server and double check the settings.






~-_-~-_-~-_-~-_-~-_-~-_-~   6. PHP-NUKE SPECIALITIES   ~-_-~-_-~-_-~-_-~-_-~-_-

Even so X-Tools is well integrated in to PHP-Nuke I have realised that they
have changed the folder structure somewhere in a version between 7.2 and 7.5.
This is not critical and I guess that there are still a lot of servers which do
have a lower version running. Therefore I am not in a rush to change this
before version 1.0.

Another thing, which I am not capable of doing somehting about is the supported
database, even so PHP-Nuke is working with a lot of different databases.
All X-Tools will only be working with mySQL as it currently stands. But I
don't think that this is a big issue. If you wish an integration please post in
the wishlist forum. 







~-_-~-_-~-_-~-_-~-_-~-_-~   7. NON PHP-NUKE SPECIALITIES   ~-_-~-_-~-_-~-_-~-_-

How can you change the layout of X-Stats without PHP-Nuke?
Okay, this is fairly easy cause I have implemented the usage of the styles that
are used in PHP-Nuke, which means you can use any PHP-Nuke theme that is out
there.

Should you like to run it without PHP-Nuke then you can still have a look for
which PHP-Nuke layout you like most and copy the file "style.css" from any
theme folder into your X-Stats folder. There are also several websites from
where you can download additional PHP-Nuke Themes, just google for them.






~-_-~-_-~-_-~-_-~-_-~-_-~   8. VERSION HISTORY   ~-_-~-_-~-_-~-_-~-_-~-_-~

VERSION 0.8
This is the first version of X-Stats available to public. It includes the
following features:
- It creates the statistics at the moment of request.
- Compare players with each other.
- Statistics across several server of the same game.
- Filter statistics to your desire.
- Easy to install.
- Include FTP function to download log files to server.
- Supports Call of Duty (CoD).
- Supports Call of Duty - United Offensive (CoD-UO).






~-_-~-_-~-_-~-_-~-_-~-_-~   9. TROUBLE SHOOTING   ~-_-~-_-~-_-~-_-~-_-~-_-~

FOPEN + FWRITE ERROR MESSAGES
=============================
If you enter the values to connect to your database and receive and error
message similar to this...

Warning: fopen(/modules/x-stats/x-stats-config.php): failed to open stream:
Permission denied in /admin/modules/x-stats.php
Warning: fwrite(): supplied argument is not a valid stream resource

... then please make sure that the user under which you are running your web
server has the permission to create files.



MYSQL SYNTAX ERROR
==================
If you receive an error message like this...

You have an error in your SQL syntax. Check the manual that corresponds to
your MySQL server version for the right syntax to use near '-stats_xstats

... then you have used a dash in the database prefix. Please check in the
"Connect database" section the field "Prefix for database table names:", it
shall NOT contain a dash (-).






~-_-~-_-~-_-~-_-~-_-~-_-~   10. KNOWN BUGS   ~-_-~-_-~-_-~-_-~-_-~-_-~

COD - GUID
==========
There is either a bug in CoD (patch 1.5) or some people are cheating in the
sense that they show up with GUID = 0.
I am working on a fix for this, which should not be to hard and as I have not
started with version 0.9 yet I will release a version 0.8a.


FILTER IN USER STATISTICS
=========================
I have limited the availability of the items in the filter to the selected
server, but I have not limited them to each other. Which means that you select
one filter (e.g. player) and you will still be able to see all other items
(e.g. weapons) available on this server, even so they are not aplicable for the
selected filter (e.g. filtered player as never used this weapon).
I am working on a fix for this, which should not be to hard and as I have not
started with version 0.9 yet I will release a version 0.8a.

Read More

Comments on this File

There are no comments yet. Be the first!

LuckyMe


50 XP


Registered 21st February 2005

1 Files Uploaded

Share This File
Embed File