Skip to content

cetteup/GameserverLister

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

GameserverLister

ci License Package Last commit

A Python ๐Ÿ command line tool to retrieve game server lists for various games.

Features

  • create/update lists of game servers stored as JSON
  • removal of servers not seen in a configurable timespan
  • search game server's query ports if not contained in server list
  • handle completely broken pagination on Battlelog
  • proxy support for requests to Battlelog

Usage

You can easily install GameserverLister via pip.

pip install GameserverLister

Upgrading from an older version is equally simple.

pip install --upgrade GameserverLister

After installing through pip, you can get some help for the command line options through

$ python3 -m GameserverLister --help
Usage: python -m GameserverLister [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  battlelog
  bfbc2
  gamespy
  gametools
  medalofhonor
  quake3
  unreal2
  valve

Required tools

The server list retrieval for GameSpy-games requires an external tool. In order to retrieve GameSpy servers, you need to set up gslist. gslist was developed by Luigi Auriemma.

Supported games

The scripts support retrieval for following games from the listed sources. If you know more sources for any of the listed games or know other games that support the listed protocols, please create an issue, and I will add them.

Game Source type/protocol Server list source(s)
7 Days to Die Valve Valve ยน
America's Army: Proving Grounds Valve Valve ยน
ARK: Survival Evolved Valve Valve ยน
Arma 2 Valve Valve ยน
Arma 3 Valve Valve ยน
Battlefield 1942 GameSpy bf1942.org, openspy.net, qtracker.com
Battlefield Vietnam GameSpy openspy.net, qtracker.com
Battlefield 2 GamsSpy bf2hub.com, playbf2.ru
Battlefield 2142 GameSpy novgames.ru, openspy.net, play2142.ru
Battlefield: Bad Company 2 fesl/theater Electronic Arts
Battlefield 3 Battlelog battlelog.com
Battlefield 4 Battlelog battlelog.com
Battlefield Hardline Battlelog battlelog.com
Battlefield 1 Gametools API api.gametools.network
Battlefield 5 Gametools API api.gametools.network
Call of Duty Quake3 Activision
Call of Duty: United Offensive Quake3 Activision
Call of Duty 2 Quake3 Activision
Call of Duty 4: Modern Warfare Quake3 Activision
CoD4x Mod Quake3 cod4x.ovh
Counter Strike Valve Valve ยน
Counter Strike: Condition Zero Valve Valve ยน
Counter Strike: Source Valve Valve ยน
Counter Strike: Global Offensive Valve Valve ยน
Crysis GameSpy crymp.net
Crysis Wars GameSpy jedi95.us
Day of Defeat Valve Valve ยน
Day of Defeat: Source Valve Valve ยน
DayZ Valve Valve ยน
DayZ (Arma 2 mod) Valve Valve ยน
Deus Ex GameSpy 333networks.com, errorist.eu, newbiesplayground.net, oldunreal.com
Duke Nukem Forever GameSpy 333networks.com
Forgotten Hope 2 GameSpy fh2.dev
Garry's Mod Valve Valve ยน
Insurgency Valve Valve ยน
Insurgency: Sandstorm Valve Valve ยน
James Bond 007: Nightfire GameSpy openspy.net, nightfirepc.com
Left 4 Dead Valve Valve ยน
Left 4 Dead 2 Valve Valve ยน
Medal of Honor Warfighter Battlelog battlelog.com
Nexuiz Quake3 deathmask.net
OpenArena Quake3 deathmask.net
ParaWorld GameSpy openspy.net
Postal 2 GameSpy 333networks.com
Q3Rally Quake3 deathmask.net
Quake Quake3 deathmask.net
Quake 3 Arena Quake3 quake3arena.com, urbanterror.info, excessiveplus.net, ioquake3.org, huxxer.de, maverickservers.com, deathmask.net
Return to Castle Wolfenstein Quake3 id Software
Rising Storm 2: Vietnam Valve Valve ยน
Rune GameSpy 333networks.com, errorist.eu, newbiesplayground.net, oldunreal.com
Rust Valve Valve ยน
Serious Sam: The First Encounter GameSpy 333networks.com, errorist.eu, newbiesplayground.net, oldunreal.com
Serious Sam: Second Encounter GameSpy 333networks.com, errorist.eu, newbiesplayground.net, oldunreal.com
Soldier of Fortune II: Double Helix Quake3 Raven Software
Squad Valve Valve ยน
Star Wars Jedi Knight II: Jedi Outcast Quake3 Raven Software, jkhub.org
Star Wars Jedi Knight: Jedi Academy Quake3 Raven Software, jkhub.org
SWAT 4 GameSpy swat4stats.com
Team Fortress Classic Valve Valve ยน
Team Fortress 2 Valve Valve ยน
Tremulous Quake3 tremulous.net
Unreal GameSpy 333networks.com, errorist.eu, openspy.net, oldunreal.com, qtracker.com
Unreal Tournament GameSpy 333networks.com, errorist.eu, openspy.net, oldunreal.com, qtracker.com
Unreal Tournament 2003 Unreal2 openspy.net
Unreal Tournament 2004 Unreal2 openspy.net, 333networks.com, errorist.eu
Unreal Tournament 3 GameSpy openspy.net
UrbanTerror Quake3 FrozenSand
Vietcong GameSpy vietcong.tk, vietcong1.eu, qtracker.com
Vietcong 2 GameSpy openspy.net
Warfork Quake3 deathmask.net
Warsow Quake3 deathmask.net
Wheel of Time GameSpy 333networks.com, errorist.eu, newbiesplayground.net, oldunreal.com
Wolfenstein: Enemy Territory Quake3 id Software, etlegacy.com
Xonotic Quake3 deathmask.net, tchr.no

ยน Valve's principal servers are rate limited. If you do not use additional filters to only retrieve matching servers, you will get blocked/timed out. You can pass filters via the -f/--filter argument, e.g. use -f "\dedicated\1\password\0\empty\1\full\1" to only retrieve dedicated servers without a password which are neither full nor empty. You can find a full list of filter options here (the \appid\ filter is applied automatically).

Game server query ports

After obtaining a server list, you may want request current details directly from the game server via different query protocols. However, only the GameSpy and Quake3 principal servers return the game server's query port. Battlelog and the EA fesl/theater do not provide details about the server's query port. So, the respective scripts attempt to find the query port if run with the --find-query-port flag.