Alternate Serverlist

From Wiki

There are three kinds of alternate serverlist. The lists which parse the official serverlist, the ones which get there input from DSHelper and the Condor-Club way to get this info.

Contents 1 Parsing the official serverlist 1.1 The easy way 1.2 The hard way 2 Use DSHelper to get the Serverlist data 3 The Condor-Club way 4 Known alternate serverlists 5 RAW output of the alternate serverlist 5.1 Example 5.2 Attention

Parsing the official serverlist

The easy way

The condor team provide a very easy access to the data of the serverlist. The only thing you have to know is the address. It's the the normal address just added the additional parameter output=raw. So you can use this both addresses:

• http://www.condorsoaring.com/serverlist.php?output=raw
• http://www.condorsim.com/serverlist.php?output=raw

Every data is divided by the chars ||. So you can easily parse the output and display it on your own website.

The hard way

There is also a alternative way to get the serverlist data. Forget the extra parameter output=raw and parse the normal html output of the serverlist. This way is more error prone than the easy way because your parsing function will break as soon as the condor team changes something on the serverlist page. Therefor I recommend the easy way.

Use DSHelper to get the Serverlist data

Beside the Condor dedicated server DSHelper can upload the needed info for a serverlist too.

You just have to check if the checkbox Use an alternative Serverlist (picture 1) in the settings and there in the section serverlist is enabled (enabled is the default setting) and if the check box Show on alternative serverlist (picture 2) in every single DSHelper server setting is checked (enabled by default).

With these standard settings your server will be displayed on the alternate Serverlist which is located here: http://condor.hitziger.net/serverlist

Picture 1

Picture 2

The informations on the alternate serverlist are a bit more extended than the standard official serverlist. If enabled you can see who is on the server, what is talked and if the task is a Condor-Club task it will provide a link where you can get more infos about this task. Don't worry if you don't want to display any of this extra informations. It's all adjustable in the DSHelper serverlist settings. You can even setup a delay so the informations will be for example five minutes behind the current flight.

You can also add your own alternative serverlist to DSHelper you just need the serverlist webserver files and the right serverlist settings.

The Condor-Club way

Condor-Club looks for active server, joins the active server for a short period of time and extract the needed informations. You will find more informations here.

Known alternate serverlists

• http://condor.hitziger.net/serverlist (uses DSHelper)
• http://www.postfrontal.com/CondorServer (uses DSHelper)
• http://www.condor-club.eu/serverinfo/222 (uses Condor-Club technique)
• http://www.swissraces.com/pages/misc/server-list.php (uses parsings official serverlist)
• http://www.condorsim.fr/communaute/serveurs-multijoueurs-f122.html (available after login - uses parsings official serverlist)

RAW output of the alternate serverlist

The alternate serverlist from me supports also RAW output like the official serverlist. You have to call the following url to get the RAW output:

• http://condor.hitziger.net/serverlist/?output=raw

This output has the same syntax like the output of the official serverlist.

The alternate serverlist gives you some more possibilities to get more data. You can ask for extended raw support, users of a server and text/events. Use the this url to see what's possible:

• http://condor.hitziger.net/serverlist/?output=features

Every single feature is diveded by ||

The feature syntax is: feature=output value;extra variable(s)

Example

standard=raw -> this is the standard raw output. You have to call the serverlist with the parameter /?output=raw

user=user;id;serverurl -> this is the user output. You have to call the serverlist with the parameter /?output=user and you need two additional variables. The ID and the serverurl. A complete call would look like /?output=user&id=2&serverurl=JFMFZCMFFZMDRSRDFLH

You have to notify the serverlist that you want one of the extended features. You have to call the following url to do this:

• http://condor.hitziger.net/serverlist/?output=start

The output is a number which is the id you need for the extendedraw, user and talk output. You have to call "start" only once. If you don't call a "output" within 10 minutes the ID will be deleted from the database and you have to call "start" again.

Now that you have the ID you can call the extended raw output. Do this in the following way:

• http://condor.hitziger.net/serverlist/?output=extendedraw&id=xy (xy is the id you got from the "start" call)

The "user" and "talk" output are used in the same way. You just have to tell from which server you want this data by providing the server url without "cndr://". It should look like this:

• http://condor.hitziger.net/serverlist/?output=user&id=xy&serverurl=JFMFZCMFFZMDRSRDFLH (JFMFZCMFFZMDRSRDFLH is just a example)
• http://condor.hitziger.net/serverlist/?output=talk&id=xy&serverurl=JFMFZCMFFZMDRSRDFLH

Definition of the type field in the "user" output

Attention

All commands which needs the ID looks when the last call from you was and display only the changes until the last call. The very first call outputs everything but after that it will show only changes. If you receive a empty output it just means there are no changes since your last call. The "extendedraw" and the "user" output got a field action. This field is defined in the following way:

• 0 = new
• 1 = changed data
• 2 = deleted

The as deleted marked entries are only 2 minutes in the database until they got really deleted. So don't use a refreshintervall greater than 1:59 minute or you will maybe miss some deleted servers/users.