This guide covers server administration, console commands, faction management, and universe maintenance for your StarMade server on Legion Hosting. For initial setup and player connection instructions, see StarMade Server Setup Guide.
1. Server Console
The StarMade server provides a console accessible via the Console tab in GPanel. Type commands directly into the console input field. The server must be running to accept commands.
2. Admin Access
To gain admin access in-game, use the SUPER_ADMIN_PASSWORD configured in server.cfg.
- Connect to the server as a player.
- Open the in-game chat and type:
/login [SUPER_ADMIN_PASSWORD] - You will receive admin privileges for the current session.
You can also add permanent admins by editing the admin configuration files in the server directory.
server.cfg to prevent unauthorized admin access.
3. Common Server Commands
Commands can be typed in the GPanel console or in-game chat (prefixed with /) when logged in as admin.
| Command | Description |
|---|---|
/help |
Lists available commands. |
/status |
Shows server status and connected players. |
/kick [player] |
Kicks a player from the server. |
/ban [player] |
Bans a player from the server. |
/unban [player] |
Removes a player's ban. |
/tp [player] [x] [y] [z] |
Teleports a player to specific coordinates. |
/give [player] [item] [amount] |
Gives items to a player. |
/god_mode [player] |
Toggles invincibility for a player. |
/change_sector [player] [x] [y] [z] |
Moves a player to a different sector in the universe. |
/save |
Forces a world save. |
/shutdown [seconds] |
Shuts down the server after the specified delay. Use /shutdown 0 for immediate shutdown. |
/shutdown for clean shutdowns. Always prefer /shutdown 0 or the GPanel Stop button over force-killing to prevent universe data corruption.
4. Faction Management
StarMade features a faction system where players can create and join factions. As admin, you can manage factions through commands:
- View factions -- Check the server logs or use faction commands to see active factions.
- Resolve disputes -- Use teleport and kick commands to handle faction conflicts.
- Clean up abandoned factions -- Remove inactive factions and their structures to free up server resources.
5. Universe Maintenance
Backups
To back up your StarMade universe:
- Stop the server (or use
/saveto force a save first). - Download the world directory and configuration files via SFTP.
- Store the backup in a safe location.
Performance Optimization
- Regularly clean up abandoned ships and stations that consume server resources.
- Monitor memory usage in GPanel -- StarMade can be memory-intensive with large builds.
- Consider setting entity limits in
server.cfgto prevent performance degradation.
6. Configuration File Reference
Key configuration files are located in the server root directory:
| File | Purpose |
|---|---|
server.cfg |
Core server settings (name, password, max clients, admin password). |
blacklist.txt |
List of banned player names/IPs. |
whitelist.txt |
List of allowed players (when whitelist mode is enabled). |
admins.txt |
List of permanent server administrators. |
7. Troubleshooting
| Issue | Solution |
|---|---|
| Server crashes with OutOfMemoryError | The server needs more RAM. Contact support to increase your allocation, or reduce the universe size and entity count. |
| Players cannot connect | Verify the server is running, check IP and port in GPanel's Network tab, and ensure the password is correct. |
| Server lag / low TPS | Clear abandoned structures, reduce max players, or increase memory allocation. |
| Universe corruption | Restore from a backup. If no backup exists, try reinstalling the server (this resets the universe). |
Related Articles
Need Help?
If you run into issues with your StarMade server, open a support ticket and include your server IP, a description of the problem, and any relevant error messages from the GPanel console.
