AlliedModders (
-   HLstatsX:CE (
-   -   Frequently Asked Questions (FAQ) (

Mavrick4283 11-23-2012 14:44

Frequently Asked Questions (FAQ)

And welcome to the first created FAQ entry on this side of the forum.
Below you will find a small index page with questions and the link to a possible answer.

Please note that although most questions have been formed to cover most issues, they can deviate a bit from the actual problem you as a user are experiencing.
I simply ask you to take your time reading, since most issues are solved in the answer.

If for any reason the question you have is not answered in the faq below, please use the forum's search function first! Threads that repeat questions already answered will be closed / moved / deleted / burned alive / send to my dog for consumption! You have been warned!!

If you have an addition to the FAQ, please send me a PM with at least the question and answer.


HLstatsX:CE Modteam

While this FAQ has been around for a while now, it's been written for version 1.6.10.
It might work with versions below that as well, though I can't guarantee nor support it!

Thanks to Rawh for the original FAQ section.

Mavrick4283 11-23-2012 14:44

Re: Frequently Asked Questions (FAQ)
Q: Are there any manuals for installing HlStatsX:ce ?

A: Yes there are! Please click on any link to go to that manuals page.

Installation Manual (Link Disabled)

Mavrick4283 11-23-2012 14:45

Re: Frequently Asked Questions (FAQ)
Q: How can I resolve the 0/0 players notation on the website?
Q: How can I resolve the 366573:0:0 maptime notation on the website?
Q: My server is getting the error: "NOT ALLOWED SERVER"

A: This can be because of a few issues:
  1. Take a look at the Hosting Blacklist? Is your webhoster mentioned? If so, stop everything you are trying to do, it won't work, get a different hoster!!!
  2. Is the Daemon running?
  3. Is the port that the Daemon is listening on open? (is it firewalled or are you perhaps behind a router?)
  4. Do you have the correct modtype for the gameserver you are running? (ie. DoD:S and not DoD gold)
  5. Is the server you wish to include in the stats also filled in as a gameserver under the gametab (admin section)?
  6. Have you added the loggaddress to the config?
    Either add the following to the server.cfg or the autoexec.cfg file:

    logaddress_add ip:port

    logaddress_add ip port
    ip and port being the ip and port your hlstats daemon is running on. If this is the same machine, be sure to use the internal ip ( for example, do not use!).
  7. The server's rcon password is not the same with that it is configured with.
    Please login as admin on the website.
    Go to the gameslist and click on the gamemod you are hosting.
    Click on the tab called "edit server" and then on the link called "configure".
    A new page should be shown in which is a textbox with the option of filling in a rcon password.
    Make sure the rcon on both this textfield and your gameserver are the same.
  8. RESTART the daemon

Mavrick4283 11-23-2012 14:50

Re: Frequently Asked Questions (FAQ)
Q: I'm getting errors with Geo::IP::PurePerl. What is it? What does it require?
Q: The users country flags do not work, I only get the default flags, why?

A: HlstatsX:CE has the option of allowing country flags. It requires certain programs in order for this to work. Geo::IP::PurePerl is such a package and can be installed in a different of ways:

Via linux command line (cli)
To install Geo::IP::PurePerl via cli you will need to be root and type the following:

perl -MCPAN -e 'install Geo::IP::PurePerl'
Via Cpanel

Again go to a linux command line. Do the following as root:

install Geo::IP::PurePerl

It should now be installed.

With ppm on Windows.
If using ActivePerl, open Perl Package Manager. Search for Geo-IP-PurePerl. Mark for Install. Run marked actions.
If Geo-IP-PurePerl is not found, you may need to add a repository for it.

After installing Geo::IP::PurePerl you will need to set the method you are going to use with the flags.
Go to the /scripts/GeoLiteCity/ directory, and execute the file called "". It might be nessecary to chmod the file to +x (execute) before you will be able to run it. This will download the GeoLiteCity.dat.

Now the only thing left is to go to your stats website, login as admin, choose "HLstatsX:CE Settings", browse down to "award settings" and select "GeoIP lookup via binary file" option. Restart the daemon afterwards!

Mavrick4283 11-23-2012 14:52

Re: Frequently Asked Questions (FAQ)
Q: What is this GeoLiteCity.dat file and how do I get it?

A: GeoLiteCity.dat is a file that is used for Geo-ip lookups (country flags in stats). It is one of the options in the HlstatsX:CE settings tab of the website interface (after being logged in as admin).

Currently HLX:CE supports looking up IP location through the GeoLiteCity.dat file or through the MySQL database. We highly recommend that you use the GeoLiteCity.dat file instead of the database as these lookups can be quite intensive.

If you are on a Linux system, we have provided the necessary script to obtain the GeoLiteCity.dat file. We do not have a Windows script at this time.

On a Linux system follow these steps:
  1. SSH to the server you installed the "scripts" folder on and change directory into "scripts/GeoLiteCity".
  2. At the shell type "./"
  3. This will download the binary and decompress it properly.
  4. Verify that your setting in HLX:CE admin console is set to use the GeoLiteCity.dat file and not the database

You can schedule, using CRON, that script to run on a monthly or weekly basis if you wish. The script will download a new copy every time from the GeoLiteCity web site and automatically update your .dat file.

On a Windows machine you must manually obtain the file and extract it as GeoLiteCity.dat.

To do this:
  1. Change your directory to that where you file is stored in. There should be a directory there called "GeoLiteCity". Change to this directory.
  2. Download the following file:
  4. Using 7zip (or another program that can handle .gz files) extract the file GeoLiteCity.dat into the GeoLiteCity directory.

Mavrick4283 11-23-2012 14:54

Re: Frequently Asked Questions (FAQ)
Q: Can I host the website and gameserver on a Dynamic IP?

A: Tricky question! Yes, it might be possible and also it might not be possible.

If the gameserver and stats website is on the same machine but keeps on having an other outside (read: on the internet) IP, then you can do the following:
  • Set it all up as explained in one of the manuals you can find here.
  • Register the pc that is hosting the gameserver with dynamic address at DynDNS.
  • Enter the admin part of your statswebsite.
  • Go to the "Game Settings" part and click on the mod/game you are hosting.
  • Click the add server link. Fill in those parts as described here:

    Server Address: Fill in the local ip address (do NOT use
    Server Port: Fill in the gameservers gameport.
    Server Name: Fill in the name of the gameserver.
    Rcon Password: Fill in the rcon password you have set on the gameserver.
    Public Address: Fill in the gameservers DynDNS host + port (host:ip).
    Game Mod: Are you running a mod for adminning or someting else? Select it out of the dropdown menu.

  • Restart the Daemon
  • Give other people the link to the DynDNS host you created.

Mavrick4283 11-23-2012 14:56

Re: Frequently Asked Questions (FAQ)
Q: Anyone know of any good hosts I can get hlstatsx:ce installed & run on?

A: There have been numerous of posts around the forum which give out examples of places you can host them at.
The list you will find here isn't conclusive or in any way facilitated by us. The links have just been gathered by the mod team and put in one post for your convienince.

Whitelist (please check these!)


Mavrick4283 11-23-2012 14:58

Re: Frequently Asked Questions (FAQ)
Q: Can I import earlier created log files into the database?
Q: Is it possible to run hlstatsx:ce without realtime updating?
Q: Can I ftp my files over from an other machine to import them into the database?

A: Yes!

To do this manually on a linux host, you would use the follow syntax

From the directory

cat /path/to/logfiles/* | /usr/bin/perl ./ -s -t --norcon --server-ip YourServerIp --server-port 27015
On Windows

type c:\path\to\logfiles\*.log | c:\path\to\perl.exe c:\path\to\ -s -t --norcon --server-ip YourServerIp --server-port 27015
Also, Woody has made a wonderful perl tool which allows you all to do this automatically through ftp. As of 1.6.1 this tool is included in "scripts/hlstatsftp".

Mavrick4283 11-23-2012 14:59

Re: Frequently Asked Questions (FAQ)
Q: Can I disable stats / logging on specific maps?

A: Yes, most mods support this. You can delete the logaddress for hlx in a map.cfg file (where map is the name of the map you wish to disable it on) and it should stop logging to the daemon when that map is on.


logaddress_del IP:PORT (or logaddress_delall)

logaddress_del IP PORT

Mavrick4283 11-23-2012 15:00

Re: Frequently Asked Questions (FAQ)
Q: Is it possible to create my own heatmaps?

A: The original maintainer of the HLX:CE heatmaps package is no longer working on the development. No developerment has happened with the Heatmaps package, and it has stalled out. We are not officially supporting this module anymore.

All times are GMT -4. The time now is 16:06.

Powered by vBulletin®
Copyright ©2000 - 2018, vBulletin Solutions, Inc.