Command to manage and control various types of game servers.
Project description
Game Server Manager
Command to manage and control various types of game servers.
Free software: MIT license
(Coming soon!) Documentation: https://game-server-manager.readthedocs.io.
Requirements
- POSIX Complient System - built and tested on Arch Linux, but should work on any Linux, MAC OSX or Windows Subsystem for Linux version
Uses and requires the following commands:
grep java # optional for Java based servers ln nohup ps screen # optional for screen based servers steamcmd # optional for Steam based servers vim # or whatever your default $EDITOR command is which
Python - built and tested with 3.6, but for full 1.0 release, unit tests will suppport 2.7 and 3.4+ unless there is a compelling reason not to
Features
Allows full management of different types of servers with full configuration supported for each. Existing types (so far):
Generic configurable gameserver types
Custom Screen (custom_screen): Generic gameserver that has an interactive console and can easily be ran via the screen command. Requires additional configuration to work.
Custom Steam (custom_steam): Generic gameserver that can be installed and updated from Steam. Also, optionally support Steam workshop. Requires additional configuration to work.
Custom RCON (custom_rcon): Generic Steam gameserver with Source RCON protocol support. Requires additional configuration to work.
Java (java): Generic Java base gameserver that can be ran with screen. Requires additional configuration to work.
Gameservers for specific games
Minecraft (minecraft): Java based gameserver ran with screen for Minecraft.
ARK (ark): Steam based gameserver with RCON support for ARK: Surivial Evolved.
Quickstart
Install from pip:
sudo pip install game_server_manager gs --help
gs will attempt to use .gs_config.json as the main configuration file. If this does not exist, you must provide all configuration options via command line. -t will speciify type of gameserver and -s will save a .gs_config.json file based on your commandline parameters.
Generic
Generate default config (assuming generic type of custom_screen):
gs -t custom_screen -s status
Edit .gs_config.json with anything that is relevant to your server
Start server:
gs start
Optional: Once you get everything working, make an issue and/or pull request to make a new server type so you do not have to configure in the future!
Minecraft
Existing Install
If you already have an existing install, it is simple to set up gs to run with it:
gs -t minecraft -s status
This will generate a default .gs_config.json file. Edit this to match your existing install.
Java
You much have Java installed to run Minecraft. If you need help installing Java, consult the documentation on the Minecraft wiki:
Firewall
Open any firewall ports you need as detailed on Minecraft wiki:
Install/Start
Assuming you want the latest stable version of Minecraft and the server to run as user minecraft with all of the default settings:
gs -t minecraft -u minecraft -s install gs start gs status
See gs -t minecraft install –help for more details.
ARK
Existing Install
If you already have an existing install, it is simple to set up gs to run with it:
gs -t ark -s status
This will generate a default .gs_config.json file. Edit this to match your existing install.
SteamCMD
Install SteamCMD according to the docs for your OS:
Valve Docs: https://developer.valvesoftware.com/wiki/SteamCMD
Arch Linux: https://wiki.archlinux.org/index.php/Steam#SteamCMD
Open File Limit
Increase Open Files Limit as detailed on ARK wiki:
Firewall
Open any firewall ports you need as detailed on ARK wiki:
Install/Start
Assuming you want the server to run as user ark with all of the default settings and no mods:
gs -t ark -u ark -s install gs start gs status
See gs -t ark install –help for more details.
Multiple Instances
It is common to run multiple ARK servers together as a cluster. To do this, you want to use the instance_overrides config option. Example .gs_config.json
You can run subcommands against all instances at once with -ci @all. You can even run them all in parellel (get for starting and stopping) with -p:
gs start -ci @all -p gs status -ci @all gs stop -ci @all -p
Planned
Stuff planned before the 1.0 release:
Full Unit Test and code coverage (Python 2.7, 3.4+ support)
Documentation
Forge and Curse support for Minecraft servers
Backup command for all servers
Staging support to update servers while still running
Probably more stuff and maybe more server types
Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
History
0.1.2 (2017-12-16)
Changes gs to re-run main command as user if it is different than existing. Removes all extra logic for indivual commands as another user.
0.1.0 (2017-12-15)
First release on PyPI.
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.
Source Distribution
Hashes for game_server_manager-0.1.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9c9db14c9f66f14f7ae9aff84550faf675e0f26a47a0deb30c166f590fec4f72 |
|
MD5 | 136d67a870c991b771bdf455c2a0d5b4 |
|
BLAKE2b-256 | 196138bdfa1d9d0f30802b86066d9e49b74ee5bbc8ed6a30c56a5dd11a34e58a |