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 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
Skywater 130nm Klayout Device Generators PDK

Skywaters 130nm Technology for KLayout Device Generators Mabrains is excited to share with you our Device Generator Library for Skywater 130nm PDK. It

Mabrains 18 Dec 14, 2022
Abby's Left Hand Modifiers Dictionary

Abby's Left Hand Modifiers Dictionary Design This dictionary is inspired by and

12 Dec 08, 2022
A thing to simplify listening for PG notifications with asyncpg

asyncpg-listen This library simplifies usage of listen/notify with asyncpg: Handles loss of a connection Simplifies notifications processing from mult

ANNA 18 Dec 23, 2022
Python Libraries with functions and constants related to electrical engineering.

ElectricPy Electrical-Engineering-for-Python Python Libraries with functions and constants related to electrical engineering. The functions and consta

Joe Stanley 39 Dec 23, 2022
ticktock is a minimalist library to view Python time performance of Python code.

ticktock is a minimalist library to view Python time performance of Python code.

Victor Benichoux 30 Sep 28, 2022
Nmap script to guess* a GitLab version.

gitlab-version-nse Nmap script to guess* a GitLab version. Usage https://github.com/righel/gitlab-version-nse cd gitlab-version-nse nmap target --s

Luciano Righetti 120 Dec 05, 2022
A collection of tools for biomedical research assay analysis in Python.

waltlabtools A collection of tools for biomedical research assay analysis in Python. Key Features Analysis for assays such as digital ELISA, including

Tyler Dougan 1 Apr 18, 2022
Run async workflows using pytest-fixtures-style dependency injection

Run async workflows using pytest-fixtures-style dependency injection

Simon Willison 26 Jun 26, 2022
Aurin - A quick AUR installer for Arch Linux. Install packages from AUR website in a click.

Aurin - A quick AUR installer for Arch Linux. Install packages from AUR website in a click.

Suleman 51 Nov 04, 2022
Stubmaker is an easy-to-use tool for generating python stubs.

Stubmaker is an easy-to-use tool for generating python stubs. Requirements Stubmaker is to be run under Python 3.7.4+ No side effects during

Toloka 24 Aug 28, 2022
Check the basic quality of any dataset

Data Quality Checker in Python Check the basic quality of any dataset. Sneak Peek Read full tutorial at Medium. Explore the app Requirements python 3.

MalaDeep 8 Feb 23, 2022
A hashtag from string extract python module

A hashtag from string extract python module

Fayas Noushad 3 Aug 10, 2022
Factoral Methods using two different method

Factoral-Methods-using-two-different-method Here, I am finding the factorial of a number by using two different method. The first method is by using f

Sachin Vinayak Dabhade 4 Sep 24, 2021
Simple RGB to HEX game made in python

Simple RGB to HEX game made in python

5 Aug 26, 2022
Group imports from Windows binaries

importsort This is a tool that I use to group imports from Windows binaries. Sometimes, you have a gigantic folder full of executables, and you want t

【☆ ゆう ☆ 】 15 Aug 27, 2022
UUID version 7, which are time-sortable (following the Peabody RFC4122 draft)

uuid7 - time-sortable UUIDs This module implements the version 7 UUIDs, proposed by Peabody and Davis in https://www.ietf.org/id/draft-peabody-dispatc

Steve Simmons 22 Dec 20, 2022
cpp20.py is a Python script to compile C++20 code using modules.

cpp20.py is a Python script to compile C++20 code using modules. It browses the source files to determine their dependencies. Then, it compiles then in order using the correct flags.

Julien VERNAY 6 Aug 26, 2022
Python program for Linux users to change any url to any domain name they want.

URLMask Python program for Linux users to change a URL to ANY domain. A program than can take any url and mask it to any domain name you like. E.g. ne

2 Jun 20, 2022
Python code to remove empty folders from Windows/Android.

Empty Folder Cleaner is a program that deletes empty folders from your computer or device and removes clutter to improve performance. It supports only windows and android for now.

Dark Coder Cat | Vansh 4 Sep 27, 2022