Package: vrage-api
vrage_apiSpace Engineers Dedicated Server Remote API in PythonThis module is essentially a python wrapper around therequestsmodule to interact with the Space Engineers Dedicated Server Remote API. This module is (will) also be used in a server management tool which provides insight to your server(s). Currently if you run the GUI tool, you can’t get any insight into players that have logged on and played on the server, performance over a period of time, chat logs, existing planets/asteroids and floating objects for example.Once you have installed the package, you can view some of the example commands in the [examples](./examples/) folder. The example [commands.py](./examples/commands.py) will load a .env file in the root folder, so you can copy the.env-exampleas.envand fill out the information as required. All non ‘get’ commands will require the–dataargument to pass a variable such as EntityId or SteamID. Ensure that you install argparse if you want to test out the commands using this scriptpip install argparse.Function endpoint dataGETget_players <./examples/get/players.json>- Gathers data about all the players such as: SteamID, Display Name, Faction, Faction Level and Pingget_asteroids <./examples/get/asteroids.json>- Gathers data about all the asteroids in the current session such as: EntityId, position and display nameget_floating_objects <./examples/get/floating_objects.json>- Gathers data about all the floating objects that exist in the current session such as: EntityId, Kind, Position, Mass and Speedget_grids <./exmaples/get/grids.json>- Gathers data about all the grids that exist in the current session such as: EntityId, Display Name, Position, Mass, Owner SteamID, total amount of PCU, powered status, etc…get_planets <./examples/get/planets.json>- Gathers data about all the planets that exist in the current session such as: EntityId, Display Name and Positionget_chat <./examples/get/chat.json>- Gathers data about all the chat messages in the current session such as: SteamID, Display Name, Content (Message) and Timestampget_server_info <./examples/get/server_info.json>- Gathers data about the server such as: ServerId, Server Name, Total uptime, CPU load, World Name, Version, total amount of Players, total used PCU etc…get_server_ping<./examples/get/server_ping.json>- Simple healthcheck for the server that responds “Pong” if successful.get_banned_players <./examples/get/banned_players.json>- Gathers data about all banned players such as:get_kicked_players <./examples/get/kicked_players.json>DELETE / BAN / KICKAll delete endpoints will typically just return a HTTP status code of 200 even if the EntityID doesn’t exist…:{
    "meta": {
        "apiVersion": "1.0",
        "queryTime": 0.1115
    }
}So some care is required if you really want to identify for example, if a player has actually been kicked/banned properly based on gathering the data after performing a specific action.A centralized API for multiple servers (and ensuring things like log history, player history) will be linked here directly once developed.How to usefrom vrage_api.vrage_api import VRageAPIapi = VRageAPI(url=”http://localhost:8080”, token=”my-secret-token”)
players = api.get_players()for player in players[“data”][“Players”]:print(player[“SteamID”], player[“DisplayName”])if player[“SteamID”] == 12341234567856780:api.player_ban(steam_id=12341234567856780)NoteThis project has been set up using PyScaffold 4.2.2. For details and usage
information on PyScaffold seehttps://pyscaffold.org/.