This wiki is archived and useful information is being migrated to the main bzflag.org website

List Server

From BZFlagWiki
Revision as of 02:13, 21 November 2007 by JeffM2501 (Talk | contribs) (Global Registration)

Jump to: navigation, search

Overview

The BZFlag list server is a public service provided by the project administrators. By default all official game clients will connect to the list server to retrieve a list of publicly available game servers as well as to authenticate Global Registration data.

Technology

The list server is written in php and runs on top of an apache web server. It uses a pair of MYSQL databases to store data. The user portion of the database is shared with the PHPBB2 software that isused to run the BZFlag forums. The source code for the list server is licensed under the LGPL as part of the BZFlag Source Code under the 'db' project.

URL

Multiple URLs are provided for the list server. Some Internet Service Providers (ISPs) are known to cache web traffic on the default HTTP port (port 80). For users with such ISPs it may benefit them to use an alternate URL.

Valid URLs are;

Global Registration

The list server is the authentication point for the Global Registration system. The registration system lets users tie their user accounts from the fBZFlag Forums to the playing account.

The list server is used to verify each users login credentials and provide a temporary token for the client to pass to the game server. The game server then verifies the token with the list server, and gets any authentication info it may need, such as user groups.

Hosting

Currently the list server runs on the same web server as the official BZFlag bulletin boards found at http://my.BZFlag.org/bb/ in the United States.

Outages

The project administrators attempt to keep list server outages to a minimum, but the current list server implementation does not handle heavy traffic loads as well as it could. Discussion and design work has been done on ways to improve the list server, anyone who would like to help with this project should read the Development Goals section on the list server, as well as discuss ideas with the development staff on IRC.

Public Usage Policy

The list server is subject to the BZFlag List Server Usage Policy. This policy states what the intended uses of the service are, as well as accepted behaviors of it's users are.

See also

Global Registration

List Server Usage Policy

BZFlag Forums

BZFS