Web Launcher Reference

Machine Entry

Features:

• Add Machine: - Creates a new machine entry, which than needs setup on a physical machine. Machine entries are used to deploy ShardServer software, optional plug-ins, and for the assignment of regions across machines to form a cluster.
• Manage Plugins: - Optional plug-ins that maybe installed or uninstalled upon a given machine. Custom plug-ins maybe created.
• Update/Restart Launcher: - Update to latest client side launcher software if a new version is available, otherwise allows for restarting of the client side launcher software.
• Update Available!/Manage Shards Server: - Shows when an update is available, allows you to pick any version to install from drop down list.
• Open Local Logs: - Present if the log browser plug-in is installed on the machine. When clicked opens a web browser on the host machine that allows selecting of individual log files to view.

Information Displayed:

• Status: - Online or Offline, shows if the installed machine is actively connected to the web launcher server.
• Server Address: - IP Address of the host that the machine is installed on.
• Name: - User assigned name for the machine. Used for internal management of machines, and assignment of regions to machines by machine name.
• ID: - Unique alpha-numeric identifier of the installed machine. Important for troubleshooting via pm2 status and other commands.
• Hostname: - Name assigned to the host system that the machine is installed upon.
• CPUS: - Number of detected Cores/Virtual cores on the host machine.
• RAM: - Amount of ram detected on the host machine.

Launcher - Subsection Launcher Version - Version of the client side launcher software installed on the current machine.

ShardsServer - Subsection Update/Install Version - Install any version of ShardServer available, also shows when an update is available. Version - Current version of the ShardServer installed on the machine.

Cluster - Clusters represent a game server's configuration, covering region servers, global wide options, access lists, mods installed, and other options.

Cluster Control Status - Online / Offline. Cluster Control must be online for regions to connect to it, and always attempts to startup automatically. Provider - The Citadel server where the installed Cluster Server is hosted. This must be set, currently only a single option exists, but in the future there maybe multiple cluster providers in order to handle capacity needs, or serve other geographical regions. E.G. A EU cluster provider that has the clusters hosted in an EU data center, instead of a USA data center. Manage - Select a cluster server version to install. Updates when available are also shown here. Current Installed Version - Shows the currently installed cluster server software version if any.

Regions - List of all region entries associated with this cluster configuration. Region Entry - Each region has a number of settings which maybe setup. Maximum Users - How many users are allowed in a given region? Currently if any region has reached its max capacity, players attempting to login to the server will enter a login queue until the region is no longer at max users. Index - Represents the port the particular region will be bound to. This is port 3000 plus the assigned index. Machine - The machine entry assigned to this particular region entry or nil if no machine entry is assigned. A machine entry must be assigned for a region to be able to start. Split up regions to run over multiple physical hosts by using multiple machine entries that represent each physical host. Required - True/False, if set to true, a cluster won't be listed as visible or accept regular non-admin level players until all regions marked as Required have the status of accepting users. Autostart - True/False, if set to true, the region will attempt to automatically start when 'Start Server' is pushed. Currently starting regions after initial cluster startup is not supported, so all regions you wish to run must be set to autostart. Obj Threads - Number of object threads to use for this region. Address - World - Subregion - Created - Timestamp of when this particular region entry was created. Last Updated - Timestamp of when this particular region entry was last updated. Status - Only shown when the region is running, shows the current status of the region server. This is either starting up, or accepting users.

Configuration Server Name Server Description Access Restriction Server Visibility White List Required Auto Restart Backup Frequency Log Level Contact E-mail

Network Sending Queue Size Send Timeout Send Buffer Size Connection Timeout

Client Flood Protection Window Size MS Message Maximum

Hack Protection Player Position Tolerance

Event Tracking Redis Host Redis Database Index

Created Updated

Access List Access List Entry Name Access Level User Id Region Admin Add User Remove Created Updated

Mods Mod List Add Mod Mod List Entry Name Add Client Bundle Name Type Value Delete Mod Entey Created Updated

Starting Templates Template List Add Starting Template

Template Entry Name Template Access Level Delete Created Updated