This guide covers all admin commands, mod support, and server management tools available for your Avorion dedicated server on Legion Hosting. Learn how to manage players, control the galaxy, install mods, and troubleshoot common issues. For initial server setup and configuration, see our Avorion Server Setup Guide.

Admin Setup

Avorion uses an XML-based admin system that grants specific players elevated permissions. Admins are defined in the admin.xml file or can be added through in-game commands.

Adding Admins via admin.xml

The admin.xml file is located in your galaxy's save folder (e.g., galaxies/your_galaxy_name/admin.xml). You can edit this file through GPanel's File Manager.

<?xml version="1.0" encoding="UTF-8"?>
<admin>
    <admin id="76561198012345678" />
    <admin id="76561198087654321" />
</admin>

Each <admin> entry contains a player's Steam ID (SteamID64 format). To find a player's Steam ID:

1. Go to the player's Steam profile
2. If their profile URL uses a custom name, use a SteamID lookup tool to find their SteamID64
3. The SteamID64 is a 17-digit number starting with 7656119

Adding Admins In-Game

If you are already an admin, you can add other admins using the in-game chat command:

/admin <playerName>

This adds the specified player to the admin list immediately without requiring a server restart.

Common Admin Commands

Admin commands are entered in the in-game chat (press Enter to open chat) with a / prefix. These can also be executed from the GPanel server console.

Player Management

Server Control

Teleportation and Navigation

Galaxy Management

As an admin, you have tools to manage the galaxy structure and sectors.

Sector Management

Material Tiers

Avorion's galaxy is organized in rings of increasing material tiers, radiating inward toward the barrier at the core. Understanding this helps when teleporting players or managing sector content.

Mod and Workshop Support

Avorion has robust Steam Workshop support, allowing you to extend your server with community-created mods.

Installing Mods

1. Find the mod you want on the Steam Workshop for Avorion
2. Note the Workshop ID from the mod's URL (the number at the end)
3. Stop the server in GPanel
4. Open GPanel's File Manager
5. Navigate to the galaxies/your_galaxy_name/ directory
6. Edit the modconfig.lua file (create it if it does not exist)
7. Add the mod's Workshop ID to the configuration
8. Start the server — the mod will be downloaded automatically

modconfig.lua Format

-- Avorion Mod Configuration
modLocation = ""
forceEnabling = false

mods =
{
    {workshopid = "1234567890"},
    {workshopid = "0987654321"},
    {workshopid = "1122334455"},
}

Mod Management Tips

• Add mods one at a time and test after each addition to identify compatibility issues
• Some mods require a galaxy reset to take full effect (especially those that modify sector generation)
• Check mod comments and descriptions for known incompatibilities before installing
• Keep a backup of your modconfig.lua and galaxy folder before adding or removing mods
• Server-side-only mods do not require clients to install them, but most gameplay mods need both sides

Troubleshooting

Server Not Appearing in Browser

1. Verify listed=true in your server.ini or startup variables
2. Check that the Steam query port (steamQueryPort) is accessible — this is typically your game port + 1
3. Wait 2-3 minutes after server startup for the Steam listing to propagate
4. Try connecting via Direct Connect to confirm the server is running
5. Ensure the server has fully started by checking for Server startup complete in the console

Server Crashes

If your Avorion server is crashing, follow these steps:

1. Check crash logs — Look in the GPanel console and the logs/ folder within your galaxy directory for error messages
2. Remove recently added mods — If crashes started after adding a mod, remove it from modconfig.lua and restart
3. Check sector corruption — If the crash occurs when loading a specific sector, that sector may be corrupted. Use /regeneratesector from the console (if accessible) or delete the sector file from the sectors/ folder
4. Update the server — Ensure your server is running the latest version through GPanel
5. Reduce worker threads — If the server is running out of resources, try reducing workerThreads and generatorThreads in server.ini
6. Restore from backup — If all else fails, restore the galaxy folder from a backup taken before the issues began

Performance Issues

• High tick time — Use /status to check server performance. High tick times indicate the server is struggling to keep up with simulation demands.
• Too many loaded sectors — Each sector with players or active AI consumes resources. Encourage players to avoid spreading too far across the galaxy simultaneously.
• Large ships — Ships with excessive block counts increase simulation load. Consider setting guidelines for maximum ship sizes.
• Station spam — Many player-built stations in a single sector can degrade performance. Monitor sector entity counts with /sector.

Player Connection Problems

• Version mismatch — All players must be on the same game version as the server. Ensure everyone has updated through Steam.
• Mod mismatch — Players need the same mods installed. If a player cannot connect, verify their mod list matches the server's modconfig.lua.
• Timeout errors — Can indicate server overload or network issues. Check server performance with /status.
• Password issues — If players report the password is not working, verify the password in your startup variables and server.ini match.

Quick Reference

The most commonly used admin commands for daily server management:

# Check server health
/status

# See who is online
/players

# Save all data
/save

# Broadcast a message
/say Server restarting in 5 minutes!

# Kick a player
/kick PlayerName

# Ban a player
/ban PlayerName

# Teleport to a player
/tp PlayerName

# Give resources to a player
/give PlayerName 10000 Trinium

# View current sector info
/sector

# Check galaxy seed
/seed

# Safely shut down
/stop

Related Articles

• Avorion Server Setup Guide
• How to Find Your Server IP and Port
• How to Upload Files via SFTP
• Getting Started with Your New Server

Need Help?

If you need further assistance with Avorion server administration or have questions about specific commands, our support team is ready to help. Submit a support ticket and we will respond as soon as possible.