ServerSage is a self-hosted Discord bot for managing game servers via the BisectHosting StarbaseAPI. Control your servers securely from Discord.
⚠️ This bot is only intended for SelfHosted use. There is not currently a build supporting otherwise.
| Feature | Description | Example Command Usage |
|---|---|---|
| Power Actions | Start, stop, restart, kill servers | /start 63ce2hd8 |
| Server Listing | View servers accessible from the API | /list |
| Resource Stats | Real time CPU, RAM, Disk and Uptime statistics | /stats 63ce2hd8 |
| Remote Command Exec | Send commands to the Servers "Console" window | /command 63ce2hd8 "status" |
| Hidable Servers | Hide servers from bot listing + command use | Configured on setup and in Console |
| Player List Management | Track and clear inactive players | /players clear 63ce2hd8 7d / !players list 63ce2hd8 |
| Log Viewing | View latest or specified server logs | /logs 63ce2hd8 / /logs 63ce2hd8 logs/server.log |
| Steam Query | Query server status via Steam Query protocol | /query 63ce2hd8 |
| Panel → Discord Announce | Forward panel announcements | /announcements 88d78549 |
| Plugin/Mod Management | Enable/Disable Mods/Plugins | /mods list 88d78549 / /mods manage enable GTNH.jar 88d78549 |
| Startup Tab Editing | Modify Startup Options (⏳) | — |
| File Management | Upload/Download Files (⏳) | — |
| Activity Logs | Audit panel actions in Discord (⏳) | — |
ServerSage also offers a built-in console interface running alongside the Discord bot in your terminal, allowing you to interact with the SQLite Database at runtime
| Feature | Description | Example Command Usage |
|---|---|---|
| Reset Config | Reset entire config database with confirmation | reset |
| Update Config | Update a config entry by specifying section.key and value | update discord.control_channel 123456789 |
| Add to Config | Adds a specified entry via section.key and value | add discord.guild_id 3217958712398 |
| List Config | List entire config or a specific section | list (all sections) / list discord (one section) |
| Exit Console | Closes down Console + Bot Process | exit |
📥 Click Me for the Python Downloads Page
To confirm your version: python --version
Pip should come bundled with your Python installation. Verify with: pip --version
If it's missing, refer to the official guide.
You’ll need to register your own bot:
- Go to the Discord Developer Portal
- Create a new application
- Generate a Bot Token, save this for later
- Enable Message Intents
ServerSage connects with the StarbaseAPI to control your servers.
- Log into your Games Panel account
- Navigate to Account → API
- Create a new API key
- Use this key during first-time configuration of the bot
🔐 Keep your API key private. It provides access to all associated servers under your account.
- Clone the repository and enter the folder:
git clone https://github.com/ImKringle/serversage.git && cd serversage - Install required Python packages:
pip install -r requirements.txt - Start the bot:
python bot.py
❗ On first run, an interactive setup will create a SQLite Database for you. Once created, use STDIN for all manual management
Contributions, suggestions, bug reports, and support questions are all welcome!
- Issues: Report bugs, request features, or ask for help on GitHub Issues.
- Pull Requests: Fork, make changes, and submit PRs following existing style and documentation. Thank you for helping improve and support ServerSage!
ServerSage is licensed under a Modified MIT License with a non-commercial clause:
- ✅ Personal use: You are free to use, modify, and distribute ServerSage for personal or educational purposes.
- ❌ Commercial use: Use, sale, or distribution of ServerSage for commercial purposes is not permitted without explicit written permission from the project owner.
See the full license details in the LICENSE file.