HCS - Hytale Control Suite

A remote management suite for Hytale servers with Web Dashboard and Discord integration.

HCS combines a server controller, a web interface, and a Discord bot into a single control system designed to simplify server administration.

🎮 What is HCS?

HCS (Hytale Control Suite) allows you to control and monitor your Hytale server from:

• 🌐 Web Dashboard
• 💬 Discord

Everything is connected in a single control suite.

⚙️ Main Features

🖥️ Server Control

• Start server
• Stop server
• Restart server
• Track server process PID
• Prevent double server start
• Controller status tracking
• Last action tracking

🌐 Web Dashboard

• Server status overview
• Controller RAM usage
• Server RAM usage
• CPU load monitoring
• Uptime tracking
• Recent activity log
• Quick action buttons
• Shutdown scheduling
• Shutdown abort
• Refresh interval control
• Mod management interface
• Upload mods from browser
• Restore removed mods
• Permanently delete removed mods

💬 Discord Integration

• Discord bot command system
• Remote server control from Discord
• Dashboard link sharing
• Action notifications
• Source tracking (Discord / Dashboard)
• Shutdown scheduling from Discord
• Abort shutdown from Discord

Discord Commands

📦 Mod Manager

• Upload mod files
• Upload mod zip packages
• Install mods
• Uninstall mods
• Restore removed mods
• Permanently delete removed mods
• Active mod list from server config
• Removed mod tracking system

📝 Logging System

• Runtime activity log
• Action tracking
• Clean log at every controller start
• Dashboard activity panel

🧠 Controller System

• Modular controller architecture
• PM2 process management
• Clean runtime environment on startup
• Configuration wizard
• Install wizard
• Remote dashboard access (Local / LAN / DDNS)

🚀 Installation Guide

📋 Requirements

Before installing HCS, make sure you have:

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

🛠️ Step-by-Step Setup

Step 1 - Install

Run:

scripts/install.bat

This will:

• Install dependencies
• Install PM2
• Prepare runtime folders

Step 2 - Configure

Run:

scripts/configure.bat

The wizard will ask for:

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

The configuration file will be created automatically.

Step 3 - Start Controller

Run:

scripts/start.bat

Then open the dashboard URL shown in the launcher.

🌍 Dashboard Access

You can access the dashboard in different ways:

📁 Project Structure

controller.js config/ core/ services/ utils/ web/ runtime/ scripts/

Do not delete project folders.
Use the scripts inside the scripts folder to manage the controller.

📜 Logs

Logs are stored in:

runtime/logs/actions.log

The log file is cleared at every controller start so each session starts clean.

🔄 Basic Usage Flow

install.bat -> configure.bat -> start.bat -> open dashboard

🙏 Credits

HCS uses the following technologies:

• Node.js
• Express.js
• Discord.js
• PM2 Process Manager
• Multer (file upload)

🆘 Support

If you need help, want to report a bug, or need assistance with setup, you can contact me on Discord:

Discord: (https://discord.com/users/364484488392212481)

HCS - Hytale Control Suite

Designed to simplify Hytale server management by combining server control, mod management, monitoring, and Discord integration into a single control suite.