🐍 OpenGSQ - Python library for querying game servers
Project description
OpenGSQ Python Library
The OpenGSQ Python library provides a convenient way to query servers from applications written in the Python language.
Supported Protocols
from opengsq.protocols.ase import ASE
from opengsq.protocols.battlefield import Battlefield
from opengsq.protocols.doom3 import Doom3
from opengsq.protocols.gamespy1 import GameSpy1
from opengsq.protocols.gamespy2 import GameSpy2
from opengsq.protocols.gamespy3 import GameSpy3
from opengsq.protocols.gamespy4 import GameSpy4
from opengsq.protocols.minecraft import Minecraft
from opengsq.protocols.quake1 import Quake1
from opengsq.protocols.quake2 import Quake2
from opengsq.protocols.quake3 import Quake3
from opengsq.protocols.raknet import Raknet
from opengsq.protocols.samp import Samp
from opengsq.protocols.satisfactory import Satisfactory
from opengsq.protocols.scum import Scum
from opengsq.protocols.source import Source
from opengsq.protocols.teamspeak3 import Teamspeak3
from opengsq.protocols.unreal2 import Unreal2
from opengsq.protocols.vcmp import Vcmp
from opengsq.protocols.won import WON
Requirements
- Python 3.6+
Installation
The recommended installation method is using pip:
pip install --upgrade opengsq
or, install from source manually with:
python setup.py install
Usage
Query server using Source, example output: tests/results/test_source/test_get_info.json
import asyncio
from opengsq.protocols import Source
async def main():
source = Source(host='45.147.5.5', port=27015)
info = await source.get_info()
print(info)
asyncio.run(main())
Rcon server using Source Remote Console, example output: tests/results/test_source/test_remote_console.txt
import asyncio
from opengsq.exceptions import AuthenticationException
from opengsq.protocols import Source
async def main():
with Source.RemoteConsole('123.123.123.123', 27015) as rcon:
try:
await rcon.authenticate('serverRconPassword')
result = await rcon.send_command('cvarlist')
print(result)
except AuthenticationException:
print('Fail to authenticate')
asyncio.run(main())
Command-line interface
This library additionally provides an opengsq
command-line utility
which makes it easy to query game servers from your terminal. Run
opengsq -h
for usage.
# query server using source protocol
opengsq source --host 123.123.123.123 --port 27015 --function get_info
Tests and Results
See tests/protocols for the tests.
See tests/results for tests outputs.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.