Knowledgebase

Avorion Console Commands and Configuration Settings

Command Line Options

These are the arguments passed to the server via the command line. To add command line arguments to your Avorion server, go to the Game Settings tab of your control panel, and click on the blue button "Show Advanced Options".

### Possible Command Line Arguments:

Command Line

Arg/Default

Effect

--help

(none)

Show help message

--port

27000

Listening port of the server

--max-players

10

Maximum number of online players

--save-interval

300

Timestep between savings

--server-name

(entered by user)

Server name, will be displayed when queried - added in 0.10.1

--galaxy-name

(entered by user)

Galaxy name, appended to datapath, final path will be [datapath]/[galaxyname] - added in 0.10.1

--datapath

(entered by user)

Folder the galaxies will be stored in, will be prepended to galaxy name

--admin

(Steam ID)

Steam id(s) of the administrator(s) of the server

--seed

(random

Seed of the server

--difficulty

0

Difficulty of the server. Allowed values are: -3, -2, -1, 0, 1, 2, 3

--infinite-resources

--------

Enable infinite resources for all players

--collision-damage

1

Amount of damage done to an object on collision, from 0 to 1. 0: no damage, 1: full damage

[Experimental] If enabled, updates sent from players to server are double checked and only control input is accepted to avoid cheating/hacking.Disabling this will result in much smoother performance at the time of this writing. Enabling this may result in very bad performance over slow networks.

PlayerToPlayerDamage

true

Enables/Disables player to player damage server wide.

LogoutInvincibility

true

A player's ships are indestructible as long as the player is offline.

LogoutInvincibilityDelay

30

The time in seconds that a player must be offline until his ships become invincible.

DevMode

false

Enables/Disables devmode

BigWreckageDespawnTime

1800

Time in seconds it takes for new (as in: not created by the generator but during gameplay, such as combat) large wreckages (more than 15 blocks) to disappear.

SmallWreckageDespawnTime

900

Time in seconds it takes for new (as in: not created by the generator but during gameplay, such as combat) small wreckages (15 blocks or less) to disappear.

ResourceDropChance

0.4

[Currently unused] Chance of resources dropping from destroyed blocks

LootDiminishingFactor

0.005

[Currently unused] Multiplier that's applied to the value of a block/wreckage/ship to determine the dropped money and resources.

TurretDropChanceFromBlock

0.005

[Currently unused] The chance that a turret will drop from a block of wreckage when it is destroyed

TurretDropChanceFromCraft

0.25

[Currently unused] The chance that a turret will drop from an NPC space craft when the craft is destroyed

TurretDropChanceFromTurret

0.025

[Currently unused] The chance that a turret will drop from an NPC space craft when the turret is destroyed

SystemDropChanceFromBlock

0.005

[Currently unused] The chance that a ship system will drop from a block of wreckage when it is destroyed

SystemDropChanceFromCraft

0.2

[Currently unused] The chance that a ship system will drop from an NPC space craft when the craft is destroyed

ColorDropChanceFromCraft

0.05

[Currently unused] The chance that a color will drop from a space craft when the craft is destroyed

ColorDropChanceFromBlock

0.0025

[Currently unused] The chance that a color will drop from a block of wreckage when it is destroyed

MaximumFightersPerSectorAndPlayer

-1

The total number of fighters that can be in one sector at once, defaults to -1, meaning infinite.

MaximumBlocksPerCraft

-1

The total number of blocks that any ship can be made up of, defaults to -1, meaning infinite

MaximumVolumePerShip

-1

The total volume that ships can reach, defaults to -1, meaning infinite (Needs testing if it applies to AI)

MaximumVolumePerStation

-1

The total volume that stations can reach, defaults to -1, meaning infinite (Need testing if it applies to AI)

MaximumPlayerShips

-1

The total number of ships a player may own at any one time, defaults to -1, meaning infinite

MaximumPlayerStations

-1

The total number of stations a player may own at any one time, defaults to -1, meaning infinite

sameStartSector

true

Indicates if all players should start in the same sector. If false, a random empty sector on the outer rim is populated and used as the home sector for each new player.

startUpScript

data/scripts/server/server.lua

Specifies a Lua script to run on server startup.

startSectorScript

startsector[.lua]

Specifies a Lua script to run when generating a start sector for a player.

[System Options]

Option

Default Setting

Effect

saveInterval

600

The time between server saves, in seconds.

sectorUpdateTimeLimit

300

The time that sectors which don't qualify for out-of-sector-simulation are kept within memory.

emptySectorUpdateInterval

0.5

The time between update steps of sectors without players.

workerThreads

1

Number of concurrent threads that are used to update sectors. (Identical to the "Threads" setting ingame.)

generatorThreads

2

Number of concurrent threads that are used to generate new sectors while players are calculating nav routes.

scriptBackgroundThreads

2

Number of concurrent threads that are used to run heavy script calculations that are called during gameplay, an example would be the generation of new ship models

aliveSectorsPerPlayer

Multiplayer: 5 Singleplayer: 500

Number of sectors kept alive for each player and alliance on the server, provided that there are player or alliance ships in that sector.

weakUpdate

true

Indicates if the sectors without players should be simulated with a "weak" update, which is less accurate but a lot faster than the normal update step.

profiling

false

Toggles performance and memory profiling. Server performance may suffer slightly, but /status command will print a lot more detailed output.

immediateWriteout

true

Deprecated in v0.12 and above] Controls whether ships and sector files are to be written to disk immediately after a player changes sectors.

[Networking]

Option

Default Setting

Effect

port

27000

The default port to access the server on. Does not affect the TCP/UDP game traffic port or the query ports.

broadcastInterval

5

The time between server mass update broadcasts in seconds.

isPublic

true

Privacy setting. If enabled, only one administrator is allowed on the server and the server will not show up on the LAN menu. (Same as the command line parameter -public)

isListed

true

Privacy setting. If enabled together with useSteam, the server will show up in public server lists. (Same as the ingame setting "List Publicly")