A2SQuery

A2SQuery is a Python implementation of Valve's A2S protocol.

Docs

View the full A2SQuery documentation here.

Features

• Multi-packet response support for Source and GoldSource engines.
• Supports BZIP2 compressed responses.
• Handles MTU edge cases for Source games.
• Fully type hinted (PEP 561 compliant) with modern design and dataclass response objects.
• Enforces limits on challenge-response handshakes to prevent infinite recursion loops.
• Zero dependencies.

Prerequisites

• Python >= 3.7

Installation

Install the library via pypi with

pip install a2squery

Example

When using a2squery.A2SQuery without a context manager. Remember to call a2squery.A2SQuery.close() when finished to close the socket.

from a2squery import A2SQuery

with A2SQuery("127.0.0.1", 27015) as a2s:
    print(a2s.info())
    # print(a2s.rules())
    # print(a2s.players())

    # 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
    # )

Supported Games (Non-Exhaustive)