GameserverLister

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
  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 | Platforms | Source type/protocol | Server list source(s) | |---------------------------------------------|----------------------------------|----------------------|----------------------------------------------------------------------------------------------| | 7 Days to Die | PC | Valve | Valve ¹ | | America's Army: Proving Grounds | PC | Valve | Valve ¹ | | ARK: Survival Evolved | PC | Valve | Valve ¹ | | Arma 2 | PC | Valve | Valve ¹ | | Arma 3 | PC | Valve | Valve ¹ | | Battlefield 1942 | PC | GameSpy | bf1942.org, openspy.net, qtracker.com | | Battlefield Vietnam | PC | GameSpy | openspy.net, qtracker.com | | Battlefield 2 | PC | GameSpy | bf2hub.com, playbf2.ru, openspy.net, b2bf2.net, gameppy.com | | Battlefield 2142 | PC | GameSpy | novgames.ru, openspy.net, play2142.ru | | Battlefield: Bad Company 2 | PC | fesl/theater | Project Rome (emulatornexus.com) | | Battlefield 3 | PC | Battlelog | battlelog.com | | Battlefield 4 | PC, PS3, PS4, Xbox 360, Xbox One | Battlelog | battlelog.com | | Battlefield Hardline | PC, PS3, PS4, Xbox 360, Xbox One | Battlelog | battlelog.com | | Battlefield 1 | PC | Gametools API | api.gametools.network | | Battlefield 5 | PC | Gametools API | api.gametools.network | | Call of Duty | PC | Quake3 | Activision | | Call of Duty: United Offensive | PC | Quake3 | Activision | | Call of Duty 2 | PC | Quake3 | Activision | | Call of Duty 4: Modern Warfare | PC | Quake3 | Activision | | CoD4x Mod | PC | Quake3 | cod4x.ovh | | Counter Strike | PC | Valve | Valve ¹ | | Counter Strike: Condition Zero | PC | Valve | Valve ¹ | | Counter Strike: Source | PC | Valve | Valve ¹ | | Counter Strike: Global Offensive | PC | Valve | Valve ¹ | | Crysis | PC | CryMP.org API | crymp.org | | Crysis Wars | PC | GameSpy | jedi95.us | | Day of Defeat | PC | Valve | Valve ¹ | | Day of Defeat: Source | PC | Valve | Valve ¹ | | DayZ | PC | Valve | Valve ¹ | | DayZ (Arma 2 mod) | PC | Valve | Valve ¹ | | Deus Ex | PC | GameSpy | 333networks.com, errorist.eu, newbiesplayground.net, oldunreal.com | | Duke Nukem Forever | PC | GameSpy | 333networks.com | | Forgotten Hope 2 | PC | GameSpy | fh2.dev | | Garry's Mod | PC | Valve | Valve ¹ | | Insurgency | PC | Valve | Valve ¹ | | Insurgency: Sandstorm | PC | Valve | Valve ¹ | | James Bond 007: Nightfire | PC | GameSpy | openspy.net, nightfirepc.com | | Left 4 Dead | PC | Valve | Valve ¹ | | Left 4 Dead 2