Avorion Dedicated Server Configuration Guide

Edit all Avorion server settings through the XGamingServer Panel Startup page and the server.ini configuration file.

This guide covers all available settings for your Avorion server, from basic panel settings to the full server.ini configuration.

Basic Server Configuration

Basic settings such as Max Players, Server Name, and Difficulty can be configured directly in the Startup page.

Stop Your Server

Access the XGamingServer Panel and Stop your Avorion server.

Edit Your Settings

In the sidebar, go to Startup. Edit the settings you want to change.

Start Your Server

Start your server to apply the changes.

Server.ini Configuration

For advanced settings, you can edit the server.ini file directly.

Stop Your Server

Log in to the XGamingServer Panel and Stop your Avorion server.

Open the Config File

In the sidebar, go to Files. Navigate to /galaxy/Avorion/ and open server.ini.

Edit and Save

Adjust your desired settings and click save.

Start Your Server

Start your server to apply the changes.

📝 Note: Basic settings found in Startup must be set there and will override server.ini values.

Avorion Server Settings

Below is a full list of all Avorion server.ini settings. The most up-to-date list for each version can be found in /galaxy/Avorion/server.ini - readme.txt.

⚠️ Warning: Certain settings are not recommended to be changed on existing worlds.

Gameplay Settings

SettingDefault ValueDescription
Scenario1Server scenario: Creative (0), Normal (1). Warning: changing breaks saves!
SeedsNcLR1IyrCWorld generation seed. Warning: changing breaks saves!
Difficulty0Game difficulty: -3 (Beginner) to 3 (Insane).
HardcoreEnabledfalseEnables hardcore difficulty.
InfiniteResourcesfalseGives players unlimited resources.
PlayTutorialfalseForces tutorial on login (disabled for multiplayer).
CollisionDamage1Collision damage scale: 0 (off) to 1 (full).
SafePlayerInputfalseDeprecated. Verifies player input, may cause lag.
PlayerToPlayerDamagetrueAllows players to damage each other.
LogoutInvincibilitytrueMakes ships invincible after logout.
LogoutInvincibilityDelay30Seconds until ship becomes invincible after logout.
ShipyardBoundBuildingtrueRestricts building to shipyard sectors.
FullBuildingUnlockedfalseUnlocks all building knowledge for new players.
RepairingAlwaysAllowedfalseEnables repairs even during combat.
BlockOverlapExploitfalseAllows infinite block overlap exploits.
PermaDestructionfalseShips lost forever on destruction.
DockingRestrictionstrueRestricts docking of certain objects.
BarriertrueEnables barrier to galaxy center.
StorylinetrueEnables guided storyline.
BehemothEventsfalseEnables Behemoth DLC events.
UnlimitedProcessingPowerfalseRemoves ship size limits from material knowledge.
UnlimitedShipSizefalseAllows oversized ships at max processing power.
RelationLossFactor1Multiplier for faction relation loss.
RelationGainFactor1Multiplier for faction relation gain.
StartingResources0Starting resources: -4 (quick start) to 0.
DamageMultiplier1Multiplier for NPC damage.
InitialRelations0Initial faction relations: -3 (friendly) to 3 (hostile).
MapFactions350Number of factions on the map.
Rifts200Number of rifts on the map.
ResourceAsteroidFactor1Multiplier for resource asteroids.
ResourceWreckageFactor1Multiplier for resource wreckages.
EventsFactor1Multiplier for event frequency.
PreciseAIAimfalseMakes AI aim perfectly.
BlockDestructionThreshold1HP % when blocks start breaking.
DevModefalseEnables developer mode.
ExplicitCallablestrueRequires functions to be marked as callable.
RiftMassFactor1Multiplier for mass allowed in rifts.
RiftDamageFactor1Multiplier for Xsotan damage in rifts.
BigWreckageDespawnTime1800Seconds until large wreckages despawn.
SmallWreckageDespawnTime900Seconds until small wreckages despawn.
MaximumFightersPerSectorAndPlayer-1Max fighters per sector/player (-1 = unlimited).
MaximumStationsPerSector-1Max stations per sector (-1 = unlimited).
MaximumBlocksPerCraft-1Max blocks per craft (-1 = unlimited).
MaximumVolumePerShip-1Max volume per ship (-1 = unlimited).
MaximumVolumePerStation-1Max volume per station (-1 = unlimited).
MaximumPlayerShips-1Max ships per player (-1 = unlimited).
MaximumPlayerStations-1Max stations per player (-1 = unlimited).
MaximumAllianceShips-1Max ships per alliance (-1 = unlimited).
MaximumAllianceStations-1Max stations per alliance (-1 = unlimited).
MaximumAllianceShipsPerMember-1Max alliance ships per member (-1 = unlimited).
MaximumAllianceStationsPerMember-1Max alliance stations per member (-1 = unlimited).
MaximumBlocksPerTurret250Max blocks per turret design (-1 = unlimited).
BoardingAllowedtrueEnables ship boarding.
MinimumCraftSize0Minimum ship dimension (0 = no limit).
MinimumBlockSize0.01Minimum block dimension (0.00001-0.01).
MaxShipVelocity0Maximum ship speed in m/s (0 = unlimited).
PlayerInventorySlots1000Number of player inventory slots.
AllianceInventorySlots1000Number of alliance inventory slots.
Version2.5.7Game version (auto-updated).
sameStartSectortruePlayers start in same sector.
xsotanInvasionSectors5Number of simultaneous Xsotan invasion sectors.
startUpScriptdata/scripts/server/server.luaServer startup script path.
startSectorScriptstartsectorStart sector generator script.
motdMessage of the day shown on login.

System Settings

SettingDefault ValueDescription
MaxTimeStep1Maximum tick length in seconds.
saveInterval600Seconds between auto-saves.
sectorUpdateTimeLimit300Seconds before unloading inactive sectors.
emptySectorUpdateInterval0.5Seconds between empty sector updates.
workerThreads25Threads for game simulation (limit to CPU cores).
generatorThreads2Threads for sector generation/loading.
scriptBackgroundThreads2Threads for async script tasks.
aliveSectorsPerPlayer5Extra sectors kept in memory per player.
weakUpdatetrueOptimizes empty sector simulation.
profilingfalseEnables performance tracking.
sendCrashReportstrueSends crash reports to developers.
hangDetectiontrueReports when server stops responding.
backupstrueCreates hourly backups.
backupsPathCustom backup location (empty = default).
statsLoggingtrueTracks server stats in CSV format.
simulateHighLoadServerfalseSimulates high server load for testing.
commandsFilePath to server command file.
sendSectorDelay2Delay when sending sector data to clients.
placeInShipOnDeathDelay7Seconds without ship after destruction.
respawnAloneDelay12Solo respawn delay after ship destruction.
respawnMultiplayerDelay92Multiplayer respawn delay after ship destruction.
autoSavePerformanceDatafalseAuto-saves performance data on issues.
performanceDataAutoSaveFiles10Max performance data files kept.
timeBetweenPerformanceDataAutoSaves30Seconds between performance data saves.
fileClusteringfalseAggregates small files on shutdown.
clusterFileSize200000000Size in bytes of clustered files.
clusteringThreads8Threads for file clustering.

Networking Settings

SettingDefault ValueDescription
port27000Server listening port.
broadcastInterval5Seconds between full network updates.
isMultiplayertrueEnables multiplayer functionality.
isListedfalseLists server in public directories.
vacSecuretrueEnables VAC anti-cheat (Steam only).
sendStatsToAdminstrueSends performance stats to admins.
useSteamtrueUses Steam networking (recommended).
forceSteamfalseForces Steam networking without fallback.
rconIpRCON interface IP address.
rconPasswordRCON password (empty = disabled).
rconPort27015RCON interface port.
maxReceivableMessageSize52428800Max message size in bytes.
networkingThreads2Threads for network processing (min 2).
safeBytesPerClientPerTick1048576Max bytes per client per tick.
suspiciousTickHistorySize50Ticks analyzed for suspicious behavior.
maxSuspiciousTicks30Suspicious ticks before client disconnection.

Administration Settings

SettingDefault ValueDescription
maxPlayers10Maximum players allowed (+1 admin). Warning: not designed as MMO!
nameAvorion ServerServer name in server lists.
descriptionAn Avorion ServerServer description in server lists.
passwordLogin password (empty = no password).
pausablefalseAllows server to be paused.
accessListModeBlacklistUser filtering: 'whitelist' or 'blacklist'.
steamIdOverride0Debug login as specific SteamID.

Meta Settings

SettingDefault ValueDescription
branchSingleplayer branch identifier (ignored in server).

How is this guide?

40% Off — Limited TimeGet your Avorion server todayInstant setup, DDoS protection, and 24/7 support included.
Get a Server

On this page