one_click_kag_server is a program which tries to fully automate the creation of a King Arthur's Gold server.

Related tags

General Utilitieskag
Overview

one_click_kag_server

one_click_kag_server is a program which tries to fully automate the creation of a King Arthur's Gold server.

It will:

  • Create a virtual machine for you on DigitalOcean
  • Configure the machine to run KAG
  • Create SSH keys
  • Upload and setup mods
  • Setup security configuration such as list of admins
  • Deploy the KAG server with automatic restarts enabled

It can also help with common maintenance tasks such as:

  • Restarting the server with different configuration, such as new mods
  • Viewing the server logs
  • Opening a TCPR console
  • Opening an SSH connection to the server

Everything can be configured from a single config file (see config.yaml).

This is a viable alternative to running a server on your local machine, without the hassle of setting up port forwarding etc. It's also an alternative to dedicated KAG hosting sites such as https://gshost.us/, with the advantage of costing less and not charging based on configuration such as max players. For example, a minimum spec server on DigitalOcean costs $0.007/hour or $5/month (see here). Since this project makes it easy to create and delete servers, you may want to run a more expensive, powerful machine for just a couple of hours and then delete it when you're done.

kagtcprlib example

An admin interface for RCON access can be deployed with the rcon command, using kagtcprlib.

Contact Eluded#1367 on Discord if you have any feedback or need help getting set up.

Instructions

Setup

Before using one_click_kag_server, there are a few things to setup.

  1. Install Python (3.7+) on your system. https://www.python.org/downloads/
  2. Clone this repository. If you don't have Git installed you can also click Code -> Download ZIP from GitHub.
  3. Install one_click_kag_server requirements. Open a terminal in this directory and run pip install -r requirements.txt
  4. Make an account on DigitalOcean. See https://cloud.digitalocean.com/registrations/new
  5. Setup a payment method on DigitalOcean
  6. Create an API token on DigitalOcean.
    • Go to API
    • Click Generate New Token
    • Choose a name for the token and give it both read and write scope

Estimated time: ~10 minutes.

Creating a server

This section describes how to create a server, assuming you have followed the setup instructions above.

  1. Edit config.yaml with a text editor to configure your server.
    • secrets
      • digitalocean_key the DigitalOcean API token you created earlier. Do not share this with anyone, since it gives full access to your account.
    • droplet configures the virtual machine
      • name is the name of the virtual machine (make sure it only contains characters URL-safe characters, so no spaces)
      • region is the short name (a.k.a. slug) for the DigitalOcean region to deploy the server in. If you want a US based server you can leave it as nyc1. For an EU server you could try ams3. For a full list of possible regions see https://slugs.do-api.dev/ (open the Regions tab).
      • image is the type of virtual machine to deploy. Don't change this unless you know what you're doing.
      • size_slug is the size of the machine to deploy. Think about this carefully because there are many options, though more powerful machines are more expensive. For a full list of possible sizes see https://slugs.do-api.dev/ (open the Droplet Sizes tab).
      • backups is whether or not to configure backups. You shouldn't need them, since it's so easy just to delete and re-create your server later.
    • kag configures the KAG server
      • autoconfig can contain any regular option from KAG's autoconfig.cfg
        • sv_name the name of the server
        • sv_info the server description
        • sv_maxplayers the max number of players
        • sv_gamemode the gamemode (e.g. TDM or CTF)
        • sv_register whether to list the server publicly
        • sv_password the password to connect to the server (can be empty for a public server)
        • sv_rconpassword the RCON password for the server
        • security_seclevs path to seclevs file. Don't change this.
      • mods is a list of mods to use. If you add a mod here, also copy it into the Mods directory in this project.
      • security
        • superadmins list of usernames of superadmins
        • admins list of usernames of admins
  2. Open a terminal in this directory and run python -m one_click_kag_server.main up to deploy the server.
    • You should see a bunch of log messages whilst the server is being configured.
    • After around 2 minutes the server should be ready, and you should see a message saying DONE. Server running at {ip_address}. Your server should be ready to play on.

If you wish to have multiple config files with different names then you can pass the --config-file option to switch between them.

Remember to destroy the droplet with one_click_kag_server down once you've finished with the server, since it will be costing you money as long as it's running.

If you have any issues with the above then please report them to me on Discord (Eluded#1367).

Commands

one_click_kag_server offers a few different commands for maintenance of the server.

up

Run python -m one_click_kag_server.main up to deploy the virtual machine and start KAG.

down

Run python -m one_click_kag_server.main down to destroy the virtual machine.

restart-kag

Run python -m one_click_kag_server.main restart-kag to restart the KAG server. This will also upload any new mods or configuration, for example if you've changed autoconfig in config.yaml.

kag-logs

Run python -m one_click_kag_server.main kag-logs to view the KAG logs in real-time.

ssh

Run python -m one_click_kag_server.main ssh to open an SSH connection to the server. This requires SSH to be installed on your system.

rcon

Run python -m one_click_kag_server.main rcon to open a web based RCON client for remote administration of the KAG server.

Important notes

State

Information about the server is stored in a state file (by default state.pkl in this directory). Every time one_click_kag_server runs, this file is updated. If you delete or move the file then information about the server will be lost, and one_click_kag_server will create a brand new server if you run it again. If you lose your state file, you may need to manually login to DigitalOcean and delete your droplet(s). Also, if you want to deploy multiple servers then you may need multiple state files (use the --state-file argument to change this.)

SSH Keys

one_click_kag_server creates a new SSH key pair for virtual machines access, and uploads this to your DigitalOcean account. These keys can be found under ssh_keys/. If you want to access the server with some other SSH client then you need to use this key pair. For example $ ssh -i ssh_keys/one_click_kag_server_aa0ff419 root@$SERVER_HOST.

Owner
Benjamin Gorman
Benjamin Gorman
🌲 A simple BST (Binary Search Tree) generator written in python

Tree-Traversals (BST) 🌲 A simple BST (Binary Search Tree) generator written in python Installation Use the package manager pip to install BST. Usage

Jan Kupczyk 1 Dec 12, 2021
✨ Voici un code en Python par moi, et en français qui permet d'exécuter du Javascript en Python.

JavaScript In Python ❗ Voici un code en Python par moi, et en français qui permet d'exécuter du Javascript en Python. 🔮 Une vidéo pour vous expliquer

MrGabin 4 Mar 28, 2022
Python based tool to extract forensic info from EventTranscript.db (Windows Diagnostic Data)

EventTranscriptParser EventTranscriptParser is python based tool to extract forensically useful details from EventTranscript.db (Windows Diagnostic Da

P. Abhiram Kumar 24 Nov 18, 2022
Small project to interact with python, C, HTML, JavaScript, PHP.

Micro Hidroponic Small project to interact with python, C, HTML, JavaScript, PHP. Table of Contents General Info Technologies Used Screenshots Usage P

Filipe Martins 1 Nov 10, 2021
SH-PUBLIC is a python based cloning script. You can clone unlimited UID facebook accounts by using this tool.

SH-PUBLIC is a python based cloning script. You can clone unlimited UID facebook accounts by using this tool. This tool works on any Android devices without root.

(Md. Tanvir Ahmed) 5 Mar 09, 2022
cssOrganizer - organize a css file by grouping them into categories

This python project was created to scan through a CSS file and produce a more organized CSS file by grouping related CSS Properties within selectors. Created in my spare time for fun and my own utili

Andrew Espindola 0 Aug 31, 2022
A fancy and practical functional tools

Funcy A collection of fancy functional tools focused on practicality. Inspired by clojure, underscore and my own abstractions. Keep reading to get an

Alexander Schepanovski 2.9k Jan 07, 2023
Similar looking domain detection using python fuzzywuzzy

Major cause of phishing and BEC incident is similar looking domain, if you detect it early, you can prevent incidents early, python fuzzywuzzy module let you do that

2 Nov 07, 2021
Control-Alt-Delete - Help Tux Escape Beastie's Jail!

Control-Alt-Delete Help Tux escape Beastie's jail by completing the following challenges! Challenges Challenge 00: Drinks: Tux needs to drink less. Ch

NDLUG 8 Oct 31, 2021
API Rate Limit Decorator

ratelimit APIs are a very common way to interact with web services. As the need to consume data grows, so does the number of API calls necessary to re

Tomas Basham 575 Jan 05, 2023
Python utilities for writing cross-version compatible libraries

Python utilities for writing cross-version compatible libraries

Tyler M. Kontra 85 Jun 29, 2022
A simple gpsd client and python library.

gpsdclient A small and simple gpsd client and library Installation Needs Python 3 (no other dependencies). If you want to use the library, use pip: pi

Thomas Feldmann 33 Nov 24, 2022
Extract the download URL from OneDrive or SharePoint share link and push it to aria2

OneDriveShareLinkPushAria2 Extract the download URL from OneDrive or SharePoint share link and push it to aria2 从OneDrive或SharePoint共享链接提取下载URL并将其推送到a

高玩梁 262 Jan 08, 2023
one_click_kag_server is a program which tries to fully automate the creation of a King Arthur's Gold server.

one_click_kag_server is a program which tries to fully automate the creation of a King Arthur's Gold server.

Benjamin Gorman 4 Jan 05, 2022
Small Python script to parse endlessh's output and print some neat statistics

endlessh_parser endlessh_parser is a small Python script that parses endlessh's output and prints some neat statistics about it Usage Install all the

ManicRobot 1 Oct 18, 2021
Just some scripts to export vector tiles to geojson.

Vector tiles to GeoJSON Nowadays modern web maps are usually based on vector tiles. The great thing about vector tiles is, that they are not just imag

Lilith Wittmann 77 Jul 26, 2022
Application for easy configuration of swap file and swappiness priority in slackware and others linux distributions.

Swap File Program created with the objective of assisting in the configuration of swap file in Distributions such as Slackware. Required packages: pyt

Mauricio Ferrari 3 Aug 06, 2022
A tool to create the basics of a project

Project-Scheduler Instalação Para instalar o Project Maker, você necessita está em um ambiente de desenvolvimento Linux ou wsl com alguma distro debia

2 Dec 17, 2021
A python program to find binary, octal and hexadecimal of a decimal.

decimal-converter This little python program can convert a decimal in to, Binary Octal Hexadecimal Needed Python 3 or later or a online python compile

Chandula Janith 0 Nov 27, 2021
Patch the pclntable from Go binaries

Pretrain and Fine-tune a T5 model with Flax on GCP This tutorial details how pretrain and fine-tune a FlaxT5 model from HuggingFace using a TPU VM ava

6 Oct 05, 2022