SSLF - Shared Server List Format

From HLSW Wiki

Shared Server List Format (SSLF) Version: 1.0

Contents 1 Introduction 2 Format 2.1 General 2.2 PARAMETERLIST 2.3 Format - KEY 2.3.1 Name Key (1 Parameter) 2.3.2 Update Key (2 Parameter) 2.3.3 Server Key (4 paramters) 3 Example list 4 Credits

Introduction

The SSLF format has been developed to have common scheme for server lists which can be used with many tools and as well be edited with every normal text editor.

Format

General

The format of SSLF files is read line by line. The first line should always contain the follwing string:

SSLF - Shared Server List Format - Version 1.00

Every line after this is interpreted as KEY=PARAMETERLIST, blank lines and lines beginning with # oder // will be ignored.

PARAMETERLIST

Every parameter in the parameterlist is divided by a space character. If a name contains spaces, it has to be enclosed by quote signs ("..."). Special characters have to be written in a special way:

• " => \"
• \ => \\
• ASCII 13 => \n
• ASCII 10 => \r
• ASCII 08 => \t

All ASCII characters below 32h can be written as \<figure><figure>. So ASCII 31 would be written as \31. This being possible, one could of course use \13 instead of \n, but \n should be used because it's easier to read.

e.g. the parameterlist

   Shared  Server   List   Format    "Shared \"Server List\" Format"

would be interpreted as:

• parameter 1: Shared
• parameter 2: Server
• parameter 3: List
• parameter 4: Format
• parameter 5: Shared "Server List" Format

Format - KEY

The KEY consists of letters only (case sensitive). In version 1.0, there are 2 keys: Name and Server.

Name Key (1 Parameter)

1. parameter - Name of the serverlist

The Name key is some sort of variable that is set. It doesn't matter where it is defined. If more then one Name key exists only the last one will be taken.

Example: Name="SSLF test Serverlist"

Update Key (2 Parameter)

1. parameter - URL: Update URL
2. parameter - Interval: Update interval in days

Update="<url>" <update interval in days>

Server Key (4 paramters)

1. parameter - game: Name of the game
2. parameter - address: IP:PORT Adress of the server
3. parameter - password: Password of the server
4. parameter - servername e.g. "-|=- Liquid Tension - Colloseum of Death -=|=- www.ltx-clan.de -=|-"

• Example 1: Server=Half-Life 62.27.42.76:27030 bierfass "-|=- Liquid Tension - Colloseum of Death -=|=- www.ltx-clan.de -=|-"
• Example 2: Server=Half-Life 123.123.123.123:27015 "password with \"space\"" "noname"
• Example 3: Server=Half-Life 34.34.34.55:27010 "" "noname"(when there is no password set)

Example list

SSLF - Shared Server List Format - Version 1.00

// This is an example serverlist !!!

Name="Example serverlist 1"

Update="http://www.test.com/serverlist.sslf" 1

Server=Half-Life 62.27.42.76:27030 bierfass
Server=  Half-Life 123.123.123.123:27015 "Password with \"Space\""
Server=Half-Life 34.34.34.55:27010 ""

Credits

SSLF support by the following programms:

• HLSW (http://www.hlsw.de)

Developed by HLSW|Strimo & [See]Friedfisch