Keen:Remote Client

This article is a draft. It will be completed soon.

Remote Client

The remote client is a server manager for Keen Software House games that allows admins to monitor and manage all of their dedicated servers remotely. It includes features like monitoring performance, session settings management, player management, faction management, chat, message of the day, the ability to restart servers, and the ability to trigger a game save at any time. This is made possible by a web API that is built into the dedicated server.

Version:

0.6.4

Client Installing

Steam Tools

Select from the list

The remote client can be installed and run from Steam tools library or using SteamCMD with appID 919670.

To install from Steam:

Click Tools from the Library menu (See Steam Tools picture)

Install Medieval Engineers - Remote Client from the list (See Select from the list picture)

There have been many questions about where the Remote Client should be installed. The answer is it should be installed wherever you want to monitor your server(s) from. Install it anywhere.

• You do not NEED to install it where your dedicated server(s) is installed. The remote client connects to your existing medieval engineers dedicated server(s).

• You CAN install it where your dedicated server(s) are installed if you wish to use it as a way to monitor activity. It can be an easy way to check multiple instances for activity.

Server Configuring

Run as Admin

Set up API

CFG File

It Works!!!

Before you can connect to your dedicated server(s) you will need to configure the remote API settings and open ports. It is important to note that you must run the dedicated server as an administrator in order for the API to function*. (See Run as Admin picture)

Click the Remote API tab to configure the API

Enable Remote API

Enables or disables the entire remote API.

Enable Public API

Enables read-only API access for users who don't have the API key.

Remote API Port

The port to use for remote access. This must be unique for each instance that shares the same IP address. 8080 is the default but, because it is an http port, the odds that it is already in use are high. Try increasing to 8081, 8082, etc. if it doesn't work after everything is configured.

Remote API Key

This is the password to access the admin controls through the remote API. It must follow a very strict secure format.

Generate Remote API Key

This fills the Remote API Key text box with a randomly generated key.

When the server starts you should see "Remote Server Listener started. Listening on port ____" (See It Works!!! picture)

The remote API can alternately be configured using the MedievalEngineers-Dedicated.cfg file. (See CFG File picture)

You can test LOCAL access with a web browser using a URL formatted as follows http://localhost:PORT/vrageremote/v1/server/ping. You should receive a "Data" response with a "Result" : "Pong".

*If you are unable to run your server as an admin because it is on a rented server host then you should contact your server host's technical support to enable use of this feature. The server has to be run with administrator priviledges and the required ports need to be opened as explained below.

Port Opening

Advanced Settings

In order to use the remote API over the internet, the port you selected must be accessible. This means that all firewalls on the server and the router must allow traffic to pass through them on this port. This means standard port forwarding for routers. The port will also need to be opened in Windows' firewall. That process is described below.

1. Open Windows Defender Firewall 2. Click Advanced Settings on the left side

Inbound Rules

3. In the advanced settings panel, click Inbound Rules on the left side

New Rule...

4. Once you have the inbound rules loaded, click New Rule... on the right side

Port Rule

5. On the first wizard page select Port Rule

Port rule is not the most secure option. If you wish to limit your rule specifically to the dedicated server program you are free to do so.

For simplicity, this guide will only show you how to open a port, skipping advanced options.

TCP Port

6. The remote API uses TCP. Select 'Specific local ports and add your port number to the text box

You can enter multiple ports here seperated by commas or a range of contiguous ports with a dash in-between. A common configuration for three servers would use ports 8080, 8081, and 8082. Those ports could be entered as 8080-8082.

All Networks

7. Enable all network types

It is more secure to choose only the type of network that you use but determining network types is beyond the scope of this guide.

Description

8. Give your rule a name and description

A tip for naming rules is to include the port(s). This makes it easier to identify them from the list. However, extra care must be given to update the name when the ports are altered.

Rule created

9. Your rule should appear in the Inbound Rules list with the name you gave it

Check that the rule is Enabled (Yes) and its Action is allowed (Allow)

You can test INTERNET access with a web browser using a URL formatted as follows http://IPADDRESS:PORT/vrageremote/v1/server/ping. You should receive a "Data" response with a "Result" : "Pong".

Client Connecting

Adding a server

Client Operating

Player count

Chat and Player Management

Session Management

Client Notifying

Email Setup

Notification Setup