Station Ships

Station Ships

Amounts

A station has several ships on board. Default is scavengers 3, defense_ships 3, police_ships 8, traders 3 to 10 and shuttles 0 to 3.

The first 3 can be redefined in shipdata.plist with

max_scavengers
max_defense_ships
max_police

Schedules

The system itself launches at regular intervals the shuttles (15 min), traders (6-20 min) and police_patrols (5 min) until the max value is reached.

Police patrols only launch by schedule from the main station and no shuttles and traders are launched by schedule from stations with scannClass: CLASS_ROCK. However starting from version 1.69.1 traders are launching from Rock Hermits.

Launches

Other ships are only launched by stationAI commands. Launching by AI is done with the AI-commands:

launchScavenger
launchMiner

Both commands use the same counter and launch until max_scavengers is reached. They also do a check for ships around the station and in the launching queue.
When there is already a miner flying around the station (or already on the launching list), launchMiner will do nothing. When there are equal or more scavengers than max_scavenger flying around the station or on the launching list, launchScavenger will do nothing.

launchShuttle
launchTrader
launchEscort
launchShipWithRole: role

All four can launch without a limit. traders have a 10% change of becoming a sunskim trader. Otherwise he makes a witchspace jump and returns at the witchspacepoint of the same system.

launchPatrol
launchPolice
launchDefenseShip
launchPirateShip

launchPolice will try to launch four police ships, when available, with one single launch instruction.

All four commands use the same counter but patrols and police launch until max_police is reached and defenseShip and pirateShip launch until max_defense_schips is reached. For defense and pirates to launch the mothership must have a target otherwise the AI returns "TARGET_LOST".

Patrol-, Police- and DefenseShip are chosen from the pool of ships with role "police" or "interceptor". Patrol ships get a "planetPatrolAI" and Police or DefenseShips both get a "policeInterceptAI".

DefenseShips can be redefined with a definition in shipdata with key: "defense_ship" or "defense_ship_role". On launching all the DefenseShips get the new role of "defense_ship". However, custom DefenseShips from shipdata keep their original AI.

Dockings

On docking the appropriate counters are lowered again. Docking of traders is counted, but leaving traders are only counted if launched by schedule not if launched by AI-command.