Author Topic: FOnline status  (Read 6026 times)

Offline Wipe

  • Rotator
  • Random is god
FOnline status
« on: April 18, 2014, 03:01:14 pm »

FOnline servers monitor, working as extension for ServerBoy by Cpt.Rookie and Vaultman, adding few own features (more informations about ServerBoy can be found here). Main differences include:
  • Less focusing on single servers, and more on comparing statistics of few of them
  • Provide more details (links to website, IRC channel, etc.) about each game, helping players which want to try something new/different
  • Use day as a basic unit, instead of minute
  • Preprocess collected data, so it can be used by third-party applications
  • Include singleplayer games on games list

Current list of servers has been build basing on threads in FOnline-related forums ( and, list of servers tracked by ServerBoy and (site has closed (?) during development stage of the project), ModDB page of FOnline engine, and found FOnline-related channels on ForestNet statistics.


First name of ServerBoy project, back in times, when it was working as IRC bot on #2238 channel. It's also how ServerBoy is referenced on page and its source. As a gratitude of a long service for whole FOnline community, Librarian got his own statistics page, which can be found here ;).

At this stage, most of data available is taken directly from Librarian, and merged every night with own pings result. Once merging is done, highest amount of players in given day is saved and used during rebuilding of data files. Additionally, rebuilding is done every 10 minutes basing own results plus data merged last night.

Mirrors of ServerBoy database dumps can be found here or here.

Data files

All exposed data is saved in JSON format, what should make further processing easier, despite of used language and platform.
Collected data can be accessed in three different ways:
  • Requesting specific part(s) of data by using JSON module, which serves as minimalistic API (recommended)
  • Accessing files in data folder directly
  • Downloading data dump and analyzing files
First option is probably best if you're planning to create third-party application and base on data provided by FOdev. You don't have to worry about parsing config file (which contains only part of URL), as you get result as single JSON object. Not counting config.json and status.json, it's not guaranteed that paths and filenames will stay as they are now - they may change without notice during updates.

Your code is bad, and you should feel bad

Just like previous project of Rotators, this one is also available for everyone to check and play with. Suggestions, bug reports, and commits are welcome.

At current stage, documentation is close to none, if we don't count source itself. It probably show up at some point, depending if there would be anyone interested in improving/extending page functionality. Code is prepared to work with new sub-pages without need to rework whole thing, thanks to using modules. Each module is "responsible" for serving different part of the page, but they can also request functions from other modules.

As for client-side configuration file parser (which may be required for other options), there is few versions already present, written in Perl, PHP, and JavaScript.
Obviously, last one is most feature-rich, and most frequently updated. All basic functions are written in "clean" JavaScript, so there shouldn't be problems using it together with your favourite framework. If you check end of the script closely, you'll see that functions loading JSON files are separated, pretty simple, and does not require deep knowledge about all other parts of the code. Currently such "extensions" covers jQuery, and partially PrototypeJS. Feel free to pull request adding other frameworks! :)
Games are meant to be created, not played...

Offline Wipe

  • Rotator
  • Random is god
Re: FOnline status
« Reply #1 on: April 18, 2014, 03:05:10 pm »
Related project
IRC status

Source code:

irssi script returning summary of online players across all known servers. Originally created for Street Queens gang members, which (at that time) was playing on few servers. Script is running since some time on ForestNet network, attached to nick Wipe.

Unlike other status checkers on IRC, this one does not provide changing channel topic or announcing when server goes up/down - it is not planned to add them in future too.
If you need such functionalities on your game channel, it's better to contact with jan0s1k or Misiołap, which are maintaining scripts with such features, or already covering game channel(s) (for example Misiołap is taking care of #reloaded).
Other than that, script does not check servers on its own, but uses data provided by FOdev.

Main trigger, returning servers summary similiar to players distribution page, just in text form ;)

!status, !s
Returns short status of one server only, depending on channel where its been triggered.
Currently works on: #2238, #AshesOfPhoenix, #FO2

!fonline server [serverId]
Same as !status, but works on all channels.
- serverId is the same as defined in config file ("fo2238" for FOnline: 2238. etc.)

!fonline records
List of most populated servers in FOnline history, including closed servers.

List of commands can be also found in source top comment.
Games are meant to be created, not played...

Offline JovankaB

  • Rotator
  • JovankaB
Re: FOnline status
« Reply #2 on: April 19, 2014, 12:44:46 pm »
Great tool, congratulations.

Offline lisac2k

  • Rotator
  • Uncle Pyro
Re: FOnline status
« Reply #3 on: April 19, 2014, 02:37:08 pm »
Yes, especially the averaging and trend graphs, they look awesome to me! Lovely 8)
I'll probably burn in hell for all the eternity for rewarding you with a single inverted rotgut only...

Re: FOnline status
« Reply #4 on: July 03, 2014, 08:25:11 pm »
FOnline: New Asylum ip is outdated

should be:

Re: FOnline status
« Reply #5 on: July 04, 2014, 10:11:04 am »
Please guys make finally singleplayer game because we have enough good servers to play... We do not need to server with small changes and such as clones where nobody plays. 8)

Offline Wipe

  • Rotator
  • Random is god
Re: FOnline status
« Reply #6 on: July 08, 2014, 10:56:46 am »
FOnline: New Asylum ip is outdated

should be:

Changed, should be OK once server is back.
Games are meant to be created, not played...