https://github.com/agnes4m/vsq

VALVE-Server Queries，基于与求生之路2服务器协议，一款可以查询求生服务器状态的库
https://github.com/agnes4m/vsq

Last synced: 18 days ago
JSON representation

VALVE-Server Queries，基于与求生之路2服务器协议，一款可以查询求生服务器状态的库

• Host: GitHub
• URL: https://github.com/agnes4m/vsq
• Owner: Agnes4m
• License: gpl-3.0
• Created: 2023-01-11T11:15:21.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-02-18T13:44:10.000Z (over 1 year ago)
• Last Synced: 2024-10-10T21:13:49.453Z (about 1 month ago)
• Language: Python
• Size: 45.9 KB
• Stars: 6
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


# 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.✨_



    





    





## 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:[email protected]