A2SQuery
Contents
A2SQuery#
A2SQuery is a python implementation of Valve’s A2S protocol.
Features#
A2SQuery can retrieve various information from any game server that implements the protocol. This includes all Source and GoldSource games. The library will handle connecting, parsing, and even automatically respond to challenge requests.
Note
A2SQuery does not support multi-packet responses as they are impossible parse without knowing information about the server beforehand.
Prerequisites#
Python >= 3.6
Installation#
Install the library via pypi with:
pip install a2squery
Getting Started#
To start querying servers, we’ll need an
instance of a2squery.A2SQuery
. We can either create one manually,
or use a context manager. For this example, we will be using a context manager.
>>> from a2squery import A2SQuery
>>> with A2SQuery("127.0.0.1", 27015) as a2s:
Now, with a the A2SQuery instance, we can query the game server.
Tip
When using a2squery.A2SQuery
without a context manager.
Remember to call a2squery.A2SQuery.close()
when finished.
>>> from a2squery import A2SQuery
>>> with A2SQuery("127.0.0.1", 27015) as a2s:
>>> print(a2s.info())
SourceInfo(
protocol=17, name="Awp Bhop", map="awp_iceworld",
folder="csgo", game="Counter-Strike: Global Offensive",
app_id=730, players=43, max_players=64, bots=0,
server_type=ServerType.Dedicated, environment=Environment.Linux,
password=False, vac=True, version="1.38.4.4", extra_data_flag=177,
mode=None, witnesses=None, duration=None,
port=27015, steam_id=85568392924437989, spectator_port=None,
spectator_name=None, keywords="awp,bhop,a2squeryiscool", game_id=730
)
Reference Pages#
Topics#
Supported Games#
App ID |
Game |
Notes |
---|---|---|
… |
All Half-Life/Half-Life 2 mods and games |
|
10 |
||
440 |
||
550 |
||
730 |
||
1002 |
||
2400 |
This game has various unique fields on |
|
4000 |
||
17710 |
||
70000 |
||
107410 |
The query port is the server port + 1. |
|
115300 |
||
211820 |
||
244850 |
The query port is the server port + 1. |
|
304930 |
The query port is the server port + 1. |
|
251570 |
||
252490 |
||
282440 |
||
346110 |
||
108600 |