Simple script to fetch server list from a Quake 3 based master server and save it to a file.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
README.md
q3serverlist.php

README.md

Quake 3 Server List Script

Simple script to fetch all servers from a Quake 3 based master server and then save it to a file for easier parsing. Example of how it can be used. :)

Requirements

  • php-cli OR decent web hosting

Usage

Fetch all servers from master server and put addresses of online ones to DB file

CLI:

$ php q3serverlist.php getservers

Webspace:

/q3serverlist.php?action=getservers

Get data from all servers that are present in DB file and write it to list file

CLI:

$ php q3serverlist.php refreshlist

Webspace:

/q3serverlist.php?action=refreshlist

Clean DB from all offline servers or those not meeting filtering criteria

CLI:

$ php q3serverlist.php cleanup

Webspace:

/q3serverlist.php?action=cleanup

Passing external config file in arguments:

CLI:

$ php q3serverlist.php somedir/config2.php getservers

Webspace:

/q3serverlist.php?config=somedir/config2.php&action=getservers

Additionally to secure access to the script on webspace set $secret variable to anything that only you will know, then pass it in GET like this:

/q3serverlist.php?secret=mysecret&action=refreshlist

Master Server Compatibility

  • Quake 3 Arena
  • Enemy Territory
  • Jedi Knight 2
  • Jedi Knight: Jedi Academy
  • Return to Castle Wolfenstein
  • Call of Duty
  • Call of Duty 2
  • Call of Duty United Offensive

... and any other Quake 3 based master server.