Description
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
| Command | Action |
|---|---|
| !start | Start server |
| !stop | Stop server |
| !restart | Restart server |
| !webmod | Open mod dashboard |
| !shut | Schedule shutdown |
| !abort | Abort shutdown |
📦 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:
| Mode | Example |
|---|---|
| Local | http://127.0.0.1:3000 |
| Local Network | http://192.168.1.25:3000 |
| Public (DDNS) | http://your-ddns:3000 |
📁 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.