HCS Important Setup Guide

Before You Start

Don’t worry about all the folders inside the package. They are required for the controller to work properly, and you do not need to modify them manually.

Just follow this guide and use the setup wizard. It will help you configure everything step by step.

What is HCS?

HCS (Hytale Control Suite) is a controller that lets you manage your Hytale server from a web dashboard and Discord.

• Start / Stop / Restart the server
• Monitor RAM and CPU
• Upload and manage mods
• Receive Discord notifications
• Schedule system shutdown
• View logs and activity

Requirements

• Windows
• Node.js installed
• A Hytale server already installed
• A Discord bot token
• A Discord channel ID

All the scripts you need are inside Controller.v1.1/scripts. You can also create shortcuts for the scripts you use the most.

Step-by-Step Installation

1. Install — Run install.bat to install everything needed for HCS.
2. Configure — Run configure.bat and complete the setup wizard.
3. Start Controller — Run start.bat to launch the controller.
4. Stop Controller — Run stop.bat whenever you need to stop it.

Configuration Wizard

The setup wizard will ask you for:

• Discord bot token
• Discord channel ID
• Hytale server folder
• Hytale config.json path
• Server start file
• Dashboard URL (localhost, LAN IP or DDNS)

At the end of the process, the wizard creates the configuration file automatically.

Starting the Controller

When you run start.bat, the controller starts and shows the controller status, the log window and the dashboard URL.

Open the dashboard URL in your browser. Once the controller is online, you can also close the CMD windows because the Node.js process keeps running in the background.

Dashboard Access

• Local only: http://127.0.0.1:3000
• Local network: http://YOUR_LOCAL_IP:3000
• Public DDNS: http://your-ddns:3000

Logs

Logs are stored in runtime.log. The log file is cleared every time the controller starts.

Important Notes

• Do not delete the project folders.
• Do not modify core files unless you know exactly what you are doing.
• Always use the scripts inside the scripts folder.
• The dashboard does not open automatically when the controller starts.
• The controller must be running for Discord and the dashboard to work.

Quick Summary

1. Run install.bat
2. Run configure.bat
3. Run start.bat
4. Open the dashboard in your browser