Skip to main content

VALVE-Server Queries(now for L4D2)

Project description

VALVE-Server Queries

✨基于A2S协议,一款可以查询求生服务器状态的库✨

✨Based on the agreement with the Left 4 Dead 2 server, a library that can query the status of the survival server.✨

GitHub stars GitHub issues
## Description说明 目标是实现服务器全链接(1/N)

🎉 available已实现

  • ipv4连接到求生之路2服务器并返回基本信息(A2S_INFO)
  • ipv4连接到求生之路2服务器并返回在线玩家信息(A2S_PLAYER)

📖 to do list可能会做

  • 暂无

👌 pip安装

    pip install VSQ

📖 use使用

函数包括

    # 总信息
    server  (ip : str , port : int , times = 60) -> dict
    ip:ipv4 ,port:端口号 , times 默认为60,也就是说一分钟内同时调用任意函数,服务器将使用第一次的缓存,这可以使得防止被当做DDOS
    # 格式 {'header':xx,'protocol':xxx,...}
    header, protocol, name, map_, folder, game, appid, players, max_players, bots, server_type, environment, visibility, vac, version, edf
    # 分别代表服务器返回的参数

    # 玩家信息
    players (ip : str , port : int , times = 60) -> dict:
    # 格式
    {
    'header':1,
    'Players':
        [{
            'Index':0,
            'Name':xxx,
            'Score':114514,
            'Duration':int but who care
        },
        {
            ...
        }
        ]
    }

🍻 exemple示例代码

如果我想要获取服务器名字/地图/玩家数量
    from VSQ import l4d2
    ip:str = '127.0.0.1' 
    port:int = 20715 
    name = l4d2.name(ip,port)
    map_ = l4d2.map_(ip,port)
    players = await l4d2.players(ip,port)
    print(name)
    print(map_)
    print(players)

如果我想要获取服务器所有信息的字典(所有的键在上面,其中edf是bytes类,后面还有额外的附带信息所以有21个键对,如果有需求可以看源代码
    from VSQ import l4d2
    ip:str = '127.0.0.1' 
    port:int = 20715 
    server_dict = await l4d2.server(ip,port)
    print(server_dict)

    from VSQ import l4d2
    ip:str = '127.0.0.1' 
    port:int = 20715 
    players_data =  await l4d2.players(ip,port)
    players_number = players_data['header']
    for i in players_data['Players'][0]
        print('player_name',i['Name'])

🌐 Communicate with me联系我

email:Z735803792@163.com

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vsq-0.1.1.tar.gz (19.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vsq-0.1.1-py3-none-any.whl (32.9 kB view details)

Uploaded Python 3

File details

Details for the file vsq-0.1.1.tar.gz.

File metadata

  • Download URL: vsq-0.1.1.tar.gz
  • Upload date:
  • Size: 19.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.9.10 Windows/10

File hashes

Hashes for vsq-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c22d82b015efeca920c1c34c29bd44ceeb78ea6e66d475fd192d198637db1c16
MD5 61f1ec9207032723a0882e91f0346a8b
BLAKE2b-256 84f3804e967811faa16ea937a477a5a222d1e6ae19cf0100792eb6007857a735

See more details on using hashes here.

File details

Details for the file vsq-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: vsq-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 32.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.9.10 Windows/10

File hashes

Hashes for vsq-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d0419cee446b0f61e7803d721c93d52041f28c66762e3a32ade81a838a873352
MD5 2ada9b936bd40cbd318208c8909c5264
BLAKE2b-256 0a0256eade94f0c921fe87feec6a9ad68edf71896ab428a0fefb919c13525e56

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page