tModLoader Server Management

⚠️ Work in Progress: This toolkit is under active development.
While core features work, some functionality may not be fully stable yet.

---

11/12/25 updates not reflected in readme (yet)
 - file locations are a little fucky wucky, check home/$USER/servers for logs/whitelist.txt/backups

---

A comprehensive server management system for tModLoader with automatic Steam integration, workshop mod syncing and backup management.

---

🎮 What You Get

• Automatic tModLoader Detection - Finds your Steam installation
• Smart Setup Options - Copy, link, or download tModLoader server files
• Complete Management Suite - Start, stop, backup, monitor, and update
• Steam Workshop Integration - Auto-download and manage mods
• Automated Backups - Scheduled world and config backups
• Easy Configuration - Interactive setup and management tools

📋 Essential Commands

Command	Description
./tmod-control.sh	UI

📋 Quick commmands

Command	Description
./tmod-control.sh start	Start the server
./tmod-control.sh stop	Stop the server
./tmod-control.sh status	Check server status

---

📦 System Requirements

Install Dependencies (Debian/Ubuntu)

sudo apt update -y
sudo apt install -y git screen curl jq pigz rsync unzip pv tmux htop ncdu net-tools zip
sudo apt-get install -y apt-transport-https
wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install -y dotnet-runtime-6.0
sudo apt-get install -y dos2unix

For Steam Workshop Features

sudo apt install -y steamcmd

---

📥 Getting tModLoader Server Files

The installer can automatically handle this, but you can also manually download via SteamCMD:

Download Links

• Windows: SteamCMD for Windows
• Linux: SteamCMD for Linux

Manual Download Command

💡 Tip: SteamCMD caches your password after first login

steamcmd \
  +force_install_dir ./tmodloader-server/ \
  +login anonymous \
  +app_update 1281930 validate \
  +quit

🎯 Key Features

🔧 Server Management

• Start/stop/restart with safety checks
• Performance monitoring
• Graceful shutdown handling

💾 Backup System

• Automatic scheduled backups
• World and configuration backup

🎮 Mod Management

• Steam Workshop integration (via steamcmd)

📡 Monitoring & Notifications

• Real-time server status
• Resource usage monitoring
• Player activity tracking

---

🤝 Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

*Need help? Run ./tmod-control.sh help for available commands