A2SQuery

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

View a demo application.

Docs

View the full A2SQuery documentation here.

Features

• Sync and Async Implementations - Includes fully featured synchronous and asyncio-driven networking engines with API parity.
• Comprehensive API Coverage - Full protocol implementation spanning the modern Source API and obsolete Source and GoldSource legacy versions.
  • Multi-packet batch assembly for split responses across engines.
  • Supports BZIP2 compressed responses.
  • Handles MTU edge cases for early Source games.
  • Catches and discards malformed or unwanted/extra packets.
• Network Fault Tolerance - Resilient network I/O.
  • Exponential back-off retrying of failed or invalid requests.
  • Per-request socket buffer flushing to eliminate cross-request race conditions and overflow.
  • Enforces limits on challenge handshakes to prevent infinite handshake loops.
  • Saves challenge tokens for faster successive requests.
• Strict Typing (PEP 561) - Fully type hinted with dataclass response structures.
• Standard Library Only - Zero dependencies.

Prerequisites

• Python >= 3.7

Installation

Install the library via PyPi with

pip install a2squery

Examples

More examples available on the docs.

Synchronous

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

Asynchronous

When using a2squery.AsyncA2SQuery without a context manager, you will need to call a2squery.AsyncA2SQuery.connect() to start the connection. Remember to call a2squery.A2SQuery.close() when finished to close the socket.

from a2squery import AsyncA2SQuery

async with A2SQuery("127.0.0.1", 27015) as a2s:
    print(await a2s.info())
    # print(await a2s.rules())
    # print(await 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)