<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.bzflag.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Deliot</id>
	<title>BZFlagWiki - User contributions [en]</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.bzflag.org/api.php?action=feedcontributions&amp;feedformat=atom&amp;user=Deliot"/>
	<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/Special:Contributions/Deliot"/>
	<updated>2026-05-05T01:29:06Z</updated>
	<subtitle>User contributions</subtitle>
	<generator>MediaWiki 1.43.5</generator>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=8099</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=8099"/>
		<updated>2011-10-24T17:30:16Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
==Assumptions==&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
==Difficulty==&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
==Directions==&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit &#039;&#039;&#039;serversettings.php&#039;&#039;&#039; such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; is also used by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
*There are many places in the &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; file that are customized to the MySQL tables names used in the official BZFlag Global Registration Server.  These MySQL table names may conflict with YOUR table names.  To find them, search &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for &amp;quot;bzbb3_&amp;quot; (as seen in the code sample below).  Edit/Replace them as necessary to match the table prefix you used for YOUR phpbb3 MySQL tables:&lt;br /&gt;
&lt;br /&gt;
      &#039;&#039;&#039;(before)&#039;&#039;&#039;    &lt;br /&gt;
      $result = sqlQuery (&amp;quot;&lt;br /&gt;
      SELECT g.group_id FROM bzbb3_user_group ug, bzbb3_groups g&lt;br /&gt;
      WHERE g.group_id=ug.group_id AND ug.user_pending=0 AND ug.user_id = $playerid&amp;quot;);&lt;br /&gt;
&lt;br /&gt;
      &#039;&#039;&#039;(after)&#039;&#039;&#039;&lt;br /&gt;
      $result = sqlQuery (&amp;quot;&lt;br /&gt;
      SELECT g.group_id FROM phpbb_user_group ug, phpbb_groups g&lt;br /&gt;
      WHERE g.group_id=ug.group_id AND ug.user_pending=0 AND ug.user_id = $playerid&amp;quot;);&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are ON and set.  The BZFS server isn&#039;t &amp;quot;public&amp;quot; in the traditional sense but it is &amp;quot;public&amp;quot; according to our new &amp;quot;private&amp;quot; LAN list server, so the public settings must be ON, and the private &#039;&#039;&#039;-q&#039;&#039;&#039; setting must be OFF.&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-groupdb&#039;&#039;&#039; option.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
==Testing==&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
==Acknowledgments==&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=8098</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=8098"/>
		<updated>2011-10-24T17:28:16Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
==Assumptions==&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
==Difficulty==&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
==Directions==&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit &#039;&#039;&#039;serversettings.php&#039;&#039;&#039; such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; is also used by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
*There are MANY places in the &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; file that are customized to the MySQL tables names used in the official BZFlag Global Registration Server.  These MySQL table names may conflict with YOUR table names.  To find them, search &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for &amp;quot;bzbb3_&amp;quot; (as seen in the code sample below).  Edit/Replace them as necessary to match the table prefix you used for YOUR phpbb3 MySQL tables:&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;before&#039;&#039;&#039;    &lt;br /&gt;
$result = sqlQuery (&amp;quot;&lt;br /&gt;
      SELECT g.group_id FROM bzbb3_user_group ug, bzbb3_groups g&lt;br /&gt;
      WHERE g.group_id=ug.group_id AND ug.user_pending=0 AND ug.user_id = $playerid&amp;quot;);&lt;br /&gt;
&lt;br /&gt;
&#039;&#039;&#039;after&#039;&#039;&#039;&lt;br /&gt;
$result = sqlQuery (&amp;quot;&lt;br /&gt;
      SELECT g.group_id FROM phpbb_user_group ug, phpbb_groups g&lt;br /&gt;
      WHERE g.group_id=ug.group_id AND ug.user_pending=0 AND ug.user_id = $playerid&amp;quot;);&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are ON and set.  The BZFS server isn&#039;t &amp;quot;public&amp;quot; in the traditional sense but it is &amp;quot;public&amp;quot; according to our new &amp;quot;private&amp;quot; LAN list server, so the public settings must be ON, and the private &#039;&#039;&#039;-q&#039;&#039;&#039; setting must be OFF.&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-groupdb&#039;&#039;&#039; option.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
==Testing==&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
==Acknowledgments==&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=8097</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=8097"/>
		<updated>2011-10-24T17:23:34Z</updated>

		<summary type="html">&lt;p&gt;Deliot: /* Directions */&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
==Assumptions==&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
==Difficulty==&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
==Directions==&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit &#039;&#039;&#039;serversettings.php&#039;&#039;&#039; such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; is also used by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
*There are MANY places in the &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; file that are customized to the MySQL tables names used in the official BZFlag Global Registration Server.  These MySQL table names may conflict with YOUR table names.  To find them, search &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for &amp;quot;bzbb3_&amp;quot; (as seen in the code sample below).  Edit/Replace them as necessary to match the table prefix you used for YOUR phpbb3 MySQL tables:&lt;br /&gt;
    $result = sqlQuery (&amp;quot;&lt;br /&gt;
      SELECT g.group_id FROM bzbb3_user_group ug, bzbb3_groups g&lt;br /&gt;
      WHERE g.group_id=ug.group_id AND ug.user_pending=0 AND ug.user_id = $playerid&amp;quot;);&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are ON and set.  The BZFS server isn&#039;t &amp;quot;public&amp;quot; in the traditional sense but it is &amp;quot;public&amp;quot; according to our new &amp;quot;private&amp;quot; LAN list server, so the public settings must be ON, and the private &#039;&#039;&#039;-q&#039;&#039;&#039; setting must be OFF.&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-groupdb&#039;&#039;&#039; option.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
==Testing==&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
==Acknowledgments==&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7384</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7384"/>
		<updated>2010-12-14T20:02:52Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
==Assumptions==&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
==Difficulty==&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
==Directions==&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit &#039;&#039;&#039;serversettings.php&#039;&#039;&#039; such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; is also used by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are ON and set.  The BZFS server isn&#039;t &amp;quot;public&amp;quot; in the traditional sense but it is &amp;quot;public&amp;quot; according to our new &amp;quot;private&amp;quot; LAN list server, so the public settings must be ON, and the private &#039;&#039;&#039;-q&#039;&#039;&#039; setting must be OFF.&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-groupdb&#039;&#039;&#039; option.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
==Testing==&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
==Acknowledgments==&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7325</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7325"/>
		<updated>2010-11-02T18:21:45Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are ON and set.  The BZFS server isn&#039;t &amp;quot;public&amp;quot; in the traditional sense but it is &amp;quot;public&amp;quot; according to our new &amp;quot;private&amp;quot; LAN list server, so the public settings must be ON, and the private &#039;&#039;&#039;-q&#039;&#039;&#039; setting must be OFF.&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7324</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7324"/>
		<updated>2010-11-02T18:17:54Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are set:&lt;br /&gt;
 #The BZFS server isn&#039;t &amp;quot;public&amp;quot; in the traditional sense but it is &amp;quot;public&amp;quot; according to our new &amp;quot;private&amp;quot; &lt;br /&gt;
 #list server, so the public settings must be ON, and the private -q setting must be OFF.&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7323</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7323"/>
		<updated>2010-11-02T18:13:38Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are set:&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 # Tells server not to respond to &amp;quot;pings&amp;quot;. This makes the server private.&lt;br /&gt;
 # Leave this commented out.&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7322</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7322"/>
		<updated>2010-11-02T18:12:34Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are set:&lt;br /&gt;
 -public &amp;quot;My LAN BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 # Tells server not to respond to &amp;quot;pings&amp;quot;. This makes the server private.&lt;br /&gt;
 # Leave this commented out.&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist http://10.14.101.15/phpbb/bzfls.php&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7321</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7321"/>
		<updated>2010-11-02T18:11:14Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are set:&lt;br /&gt;
 -public &amp;quot;My Private BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 # Tells server not to respond to &amp;quot;pings&amp;quot;. This makes the server private.&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist http://10.14.101.15/phpbb/bzfls.php&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7320</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7320"/>
		<updated>2010-11-02T18:10:04Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are set:&lt;br /&gt;
 -public &amp;quot;My Private BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 #-q&lt;br /&gt;
 -publiclist http://10.14.101.15/phpbb/bzfls.php&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7319</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7319"/>
		<updated>2010-11-02T18:09:15Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;##List Server Connection##&#039;&#039;&#039; section to include something like the following.  See the [[Sample conf]] for more info.  In particular, it is important that &#039;&#039;&#039;-publicaddr&#039;&#039;&#039; and &#039;&#039;&#039;-publiclist&#039;&#039;&#039; are set:&lt;br /&gt;
 -public &amp;quot;My Private BZFlag Server&amp;quot;&lt;br /&gt;
 -publicaddr 10.14.101.15:5154&lt;br /&gt;
 -p 5154&lt;br /&gt;
 -q&lt;br /&gt;
 -publiclist http://10.14.101.15/phpbb/bzfls.php&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7318</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7318"/>
		<updated>2010-11-02T15:09:36Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 clients authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7317</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7317"/>
		<updated>2010-11-02T15:08:04Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 action: CHECKTOKENS - verify player token from game server&lt;br /&gt;
in the checktokens textarea enter the username and token info:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 client players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7316</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7316"/>
		<updated>2010-11-02T15:02:16Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, visit &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; again in your web browser for a CHECKTOKENS test:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 client players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
*This guide was inspired by an older message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=93&amp;amp;t=16238&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7314</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7314"/>
		<updated>2010-11-02T05:56:11Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are &#039;&#039;&#039;user_token&#039;&#039;&#039;, &#039;&#039;&#039;user_tokendate&#039;&#039;&#039;, and &#039;&#039;&#039;user_tokenip&#039;&#039;&#039;:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, enter into &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for a CHECKTOKENS test:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 client players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7313</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7313"/>
		<updated>2010-11-02T05:54:41Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files in the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are user_token, user_tokendate, and user_tokenip:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, enter into &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for a CHECKTOKENS test:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 client players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7312</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7312"/>
		<updated>2010-11-02T05:52:06Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are user_token, user_tokendate, and user_tokenip:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, enter into &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for a CHECKTOKENS test:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 client players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;br /&gt;
&lt;br /&gt;
[[Category:Server]]&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7311</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7311"/>
		<updated>2010-11-02T05:46:37Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields created to track the BZFLAG players.  The fields are user_token, user_tokendate, and user_tokenip:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*A number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create any text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s).  In config.cfg:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the client command line (Windows example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error from within the PHPBB3 &amp;quot;main&amp;quot; folder.  For example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, enter into &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for a CHECKTOKENS test:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 client players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7310</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7310"/>
		<updated>2010-11-02T05:37:46Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[List Server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[List Server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields added to track the BZFLAG player.  They are user_token, user_tokendate, and user_tokenip:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create the text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s):&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the command line (Windows client example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error where you placed the PHP document, for example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, enter into &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for a CHECKTOKENS test:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7309</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7309"/>
		<updated>2010-11-02T05:35:55Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[list server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[list server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to house files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; MySQL table must have additional fields added to track the BZFLAG player.  They are user_token, user_tokendate, and user_tokenip:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create the text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s):&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the command line (Windows client example):&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  This web page should appear without error where you placed the PHP document, for example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found at:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering information for a PHPBB3 user:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username&lt;br /&gt;
 password: password&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, enter into &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; for a CHECKTOKENS test:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
*If all previous tests are successful, start your BZFS server and attempt to have registered PHPBB3 players authenticate!!&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
*This guide would not have been possible without the help and guidance of BZFLAG player/admin &amp;quot;Blast&amp;quot;.&lt;br /&gt;
*This guide is based on a message board discussion found http://my.bzflag.org/bb/viewtopic.php?f=30&amp;amp;t=16653&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7308</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7308"/>
		<updated>2010-11-02T05:25:52Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes the server admin understands how to set up a BZFS groups file (see [[Sample Group File]])&lt;br /&gt;
*This article assumes the server admin has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes the server admin understands how to download and install PHPBB3.&lt;br /&gt;
*This article assumes the private [[list server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes the server admin understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[list server]]. &lt;br /&gt;
&lt;br /&gt;
=Difficulty=&lt;br /&gt;
While no particular step in this process is overly difficult, there are many steps, and many interactions between steps.  There are multiple points of failure during this process.&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create the text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] and [[Sample Group File]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s):&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the command line:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart your the [[BZFS]] server.&lt;br /&gt;
*Register one or more test users on the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  For Example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found here:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username (from PHPBB3)&lt;br /&gt;
 password: password (from PHPBB3)&lt;br /&gt;
*A successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a valid token, enter into &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; box something like the following:&lt;br /&gt;
 CHECKTOKENS - verify player token from game server&lt;br /&gt;
 checktokens box on the form:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
and get back:&lt;br /&gt;
 server.ip.address:5154 BZFS0026 007b0003000100000000000000003c0000000c000c000c000c020c 000.000.000.000 Server ID String&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help and guidance of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7307</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7307"/>
		<updated>2010-11-02T05:13:45Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private [[list server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[list server]]. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the [[BZFS]] config file &#039;&#039;&#039;-publiclist&#039;&#039;&#039; option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  See the [[Sample conf]] for more info.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the [[BZFS]] config file and create the text files necessary to use the &#039;&#039;&#039;-userdb&#039;&#039;&#039; and &#039;&#039;&#039;-groupdb&#039;&#039;&#039; options.  See the [[Sample conf]] for more info:&lt;br /&gt;
 #userdb stores user to group mappings.&lt;br /&gt;
 -userdb /path/to/users.txt&lt;br /&gt;
 #groupdb stores group to permission mappings.&lt;br /&gt;
 -groupdb /path/to/groups.txt&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client(s) to include the Private [[List Server]] address or edit the command line that starts the BZFlag game client(s):&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the command line:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
=Testing=&lt;br /&gt;
  &lt;br /&gt;
*Restart your the [[BZFS]] server.&lt;br /&gt;
*Have one or more test users register with the PHPBB3 board you created.&lt;br /&gt;
*Visit the development interface for your private &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; in a web browser.  For Example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data from your private [[List Server]] with that obtained by visiting the official [[List Server]] development interface found here:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering:&lt;br /&gt;
 action: GETTOKEN - get a player token&lt;br /&gt;
 callsign: username (PHPBB3)&lt;br /&gt;
 password: password (PHPBB3)&lt;br /&gt;
*Successful GETTOKEN with the private [[List Server]] should display something like:&lt;br /&gt;
 TOKEN: 0123456789&lt;br /&gt;
*Once you have a token, enter into the CHECKTOKENS box something like the following:&lt;br /&gt;
 USER=0123456789&lt;br /&gt;
and get back:&lt;br /&gt;
 MSG: checktoken callsign=USER, ip=, token=0123456789  group=Group0 group=Group1&lt;br /&gt;
 TOKGOOD: USER&lt;br /&gt;
 BZID: 12345 USER&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7306</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7306"/>
		<updated>2010-11-02T04:56:56Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private [[list server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[list server]]. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the config file -publiclist option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client computer to include the Private List Server or edit the command line that starts the BZFlag game client:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the command line:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
*At this point, testing should begin.  Restart your Apache server, restart your [[BZFLS]] server.&lt;br /&gt;
*Have one or more test users register on the PHPBB3.&lt;br /&gt;
*Visit the development interface for your private bzfls.php in a web browser.  For Example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data obtained by visiting the official List Server development interface found here:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]] by entering:&lt;br /&gt;
 action:GETTOKEN - get a player token:&lt;br /&gt;
 callsign: PHPBB3 username&lt;br /&gt;
 password: PHPBB3 password&lt;br /&gt;
*Attempt to see if your server is listed with the private [[List Server]] by selecting:&lt;br /&gt;
 LIST - list servers&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7305</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7305"/>
		<updated>2010-11-02T04:51:03Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE [[List Server]] and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private [[list server]] will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private [[list server]]. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this (linux example):&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the config file -publiclist option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client computer to include the Private List Server or edit the command line that starts the BZFlag game client:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the command line:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
*At this point, testing should begin.  Restart your Apache server, restart your [[BZFLS]] server.&lt;br /&gt;
*Have one or more test users register on the PHPBB3.&lt;br /&gt;
*Visit the development interface for your private bzfls.php in a web browser.  For Example:&lt;br /&gt;
 &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Compare data obtained by visiting the official List Server development interface found here:&lt;br /&gt;
 http://stats.bzflag.org/bzfls.php&lt;br /&gt;
*Attempt to authenticate with the private [[List Server]]&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7304</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7304"/>
		<updated>2010-11-02T04:43:28Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the config file -publiclist option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the &#039;&#039;&#039;config.cfg&#039;&#039;&#039; file on the BZFlag game client computer to include the Private List Server or edit the command line that starts the BZFlag game client:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
or for the command line:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7303</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7303"/>
		<updated>2010-11-02T04:41:24Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain.&lt;br /&gt;
*Edit the config file -publiclist option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the config file on the BZFlag game client to also include the Private List Server or edit the command line that starts the BZFlag game client:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
or in the Config.cfg file:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7302</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7302"/>
		<updated>2010-11-02T04:40:32Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found:&lt;br /&gt;
 [http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain].&lt;br /&gt;
*Edit the config file -publiclist option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  For Example:&lt;br /&gt;
 -publiclist &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
*Edit the config file on the BZFlag game client to also include the Private List Server or edit the command line that starts the BZFlag game client:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt; -configdir c:\bzflag\config\&lt;br /&gt;
or in the Config.cfg file:&lt;br /&gt;
 set list &amp;lt;nowiki&amp;gt;http://10.14.101.15/phpbb/bzfls.php&amp;lt;/nowiki&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7301</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7301"/>
		<updated>2010-11-02T04:39:13Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found:&lt;br /&gt;
 [http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain].&lt;br /&gt;
*Edit the config file -publiclist option for the [[BZFS]] server to include a link to &#039;&#039;&#039;bzfls.php&#039;&#039;&#039;.  For Example:&lt;br /&gt;
 -publiclist http://10.14.101.15/phpbb/bzfls.php&lt;br /&gt;
Edit the config file on the BZFlag game client to also include the Private List Server or edit the command line that starts the BZFlag game client:&lt;br /&gt;
 C:\BZFlag\bzflag.exe -list http://10.14.101.15/phpbb/bzfls.php -configdir c:\bzflag\config\&lt;br /&gt;
or in the Config.cfg file:&lt;br /&gt;
 set list http://10.14.101.15/phpbb/bzfls.php&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7300</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7300"/>
		<updated>2010-11-02T04:29:39Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found:&lt;br /&gt;
 [HERE][http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain].&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7299</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7299"/>
		<updated>2010-11-02T04:26:42Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:  http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7298</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7298"/>
		<updated>2010-11-02T04:26:10Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking  These tables can be found here:&lt;br /&gt;
http://bzflag.svn.sourceforge.net/viewvc/bzflag/trunk/db/support/database_structure.sql?revision=20248&amp;amp;content-type=text/plain&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7297</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7297"/>
		<updated>2010-11-02T04:25:17Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accommodate player tracking:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgments=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7296</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7296"/>
		<updated>2010-11-02T04:24:44Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
*Next, a number of tables must be added to the PHPBB3 database to accomodate player tracking:&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7295</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7295"/>
		<updated>2010-11-02T04:19:09Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
*The PHPBB3 &#039;&#039;&#039;phpbb_user&#039;&#039;&#039; table must have additional fields added to track the BZFLAG player user_token, user_tokendate, and user_tokenip.  This is how the List Server authenticates each player, by sending an up to 10 digit token to the BZFLAG client:&lt;br /&gt;
 `user_token` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokendate` int(10) unsigned NOT NULL DEFAULT &#039;0&#039;,&lt;br /&gt;
 `user_tokenip` varchar(40) COLLATE utf8_bin NOT NULL DEFAULT &#039;&#039;, &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7294</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7294"/>
		<updated>2010-11-02T04:13:21Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place the following THREE files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database.  Note that this example assumes that the same database is used for MySQL tables used by &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; and by the PHPBB3 installation:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
*For ease of setup, &#039;&#039;&#039;bzfls.php&#039;&#039;&#039; was edited to access files from the &amp;quot;main&amp;quot; PHPBB3 folder (ex: /usr/share/phpbb3/www/).  The following lines were changed to accomplish this:&lt;br /&gt;
 $phpbb_root_path = &#039;/usr/share/phpbb3/www/&#039;;&lt;br /&gt;
 $phpEx = &#039;php&#039;;&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/functions.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_tools.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;includes/utf/utf_normalizer.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;serversettings.&#039;.$phpEx);&lt;br /&gt;
 include($phpbb_root_path.&#039;banfunctions.&#039;.$phpEx);&lt;br /&gt;
  &lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7293</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7293"/>
		<updated>2010-11-02T04:07:17Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the private list server will use the same database as PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients to access both the game server and the private list server. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install and test your [[BZFS]] server.  Make sure clients can connect and play the game.&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (ex: /usr/share/phpbb3/www/), place these three files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
*Edit serversettings.php such that it can connect to your PHPBB3 MySQL database:&lt;br /&gt;
 $dbhost  = &amp;quot;localhost&amp;quot;;&lt;br /&gt;
 $dbname  = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbuname = &amp;quot;phpbb3&amp;quot;;&lt;br /&gt;
 $dbpass  = &amp;quot;********&amp;quot;;&lt;br /&gt;
 $bbdbname = &#039;phpbb3&#039;;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7292</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7292"/>
		<updated>2010-11-02T04:01:09Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
*Install PHPBB3 on a web server, configure settings, test that users can REGISTER to the PHPBB3 board.&lt;br /&gt;
*In the &amp;quot;main&amp;quot; PHPBB3 folder, (in my case /usr/share/phpbb3/www/), install these three files found in the SVN DB Repository (https://bzflag.svn.sourceforge.net/svnroot/bzflag/trunk/db/):&lt;br /&gt;
 bzfls.php&lt;br /&gt;
 serversettings.php.tmpl (rename to serversettings.php)&lt;br /&gt;
 banfunctions.php&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
CURRENTLY BEING EDITED, OCTOBER 2010&lt;br /&gt;
&lt;br /&gt;
Examples:&lt;br /&gt;
&lt;br /&gt;
 first&lt;br /&gt;
 second&lt;br /&gt;
 third&lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7291</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7291"/>
		<updated>2010-11-02T03:41:47Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
CURRENTLY BEING EDITED, OCTOBER 2010&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7290</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7290"/>
		<updated>2010-11-02T03:41:20Z</updated>

		<summary type="html">&lt;p&gt;Deliot: &lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place and has been tested.&lt;br /&gt;
*This article assumes that the server administrator has access to web hosting with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to download and install PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Linux for the [[BZFS]] server.&lt;br /&gt;
*This article was written using Windows clients. &lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
Examples:&lt;br /&gt;
&lt;br /&gt;
blah&lt;br /&gt;
blah&lt;br /&gt;
blah&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
	<entry>
		<id>https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7289</id>
		<title>Private List Server</title>
		<link rel="alternate" type="text/html" href="https://wiki.bzflag.org/index.php?title=Private_List_Server&amp;diff=7289"/>
		<updated>2010-11-02T03:34:45Z</updated>

		<summary type="html">&lt;p&gt;Deliot: Process for setting up a private list server on a LAN for BZFlag client authentication.&lt;/p&gt;
&lt;hr /&gt;
&lt;div&gt;=Overview=&lt;br /&gt;
This article discusses how to create a PRIVATE List Server and have players authenticate via this server.  This is generally not necessary, since BZFlag clients perform [[Global Registration]] via the official bzflag.org [[List Server]].  &lt;br /&gt;
&lt;br /&gt;
However, if a [[BZFS]] server is created within a private LAN network, it may be desirable/necessary to authenticate players locally.&lt;br /&gt;
Pro&lt;br /&gt;
=Assumptions=&lt;br /&gt;
*This article assumes that a working [[BZFS]] server is already in place.&lt;br /&gt;
*This article assumes that the server administrator has access to a web hosting account with MySQL and PHP.&lt;br /&gt;
*This article assumes that the server administrator understand how to install PHPBB3.&lt;br /&gt;
*This article assumes that the server administrator understands how to perform basic editing of PHP code.&lt;br /&gt;
*This article was written using Ubuntu Desktop 10.04 as the base system.  Windows and Mac installations will be different.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Directions=&lt;br /&gt;
&lt;br /&gt;
Examples:&lt;br /&gt;
&lt;br /&gt;
blah&lt;br /&gt;
blah&lt;br /&gt;
blah&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
=Acknowledgements=&lt;br /&gt;
This process would not have been successful without the help of Blast/Blast007.&lt;/div&gt;</summary>
		<author><name>Deliot</name></author>
	</entry>
</feed>