[MOD][0.22.x] Station Tether

[MassCraxx]

Station Tether System Upgrade

 

This mod adds a new System Upgrade to the game: The Station Tether

 

While permanently equipped to a station, nearby alliance ships and player ships of the same alliance are tethered to the station. Tethered ships will not lose hull hp.

 

The Station Tether makes it possible to store vulnerable ships and even ship hulls at stations without having to worry about their destruction on alien and pirate attacks. It is meant to be an alternative to a docking mechanic.

 

Be aware that by default the system will not prevent block and ship destruction. Instead of making the ships invincible, the system checks every 0.25 seconds if any of the tethered ships have lost hp since the last check and restores it if necessary. This has the advantage that the ship's hull can still be repaired. However, this behavior still allows damage in general and will therefore not prevent destruction if enough damage is dealt within these 0.25 seconds. This behavior can be easily changed (see section Options).

 

Updated version available on Steam Workshop

 

Installation instructions

1) Copy zip content to ../Avorion/data/scripts/systems

2) Open ../Avorion/data/lib/upgradegenerator.lua in a text editor and add the following line to the UpgradeGenerator.add(..) block

UpgradeGenerator.add("data/scripts/systems/stationtether.lua", 0.5)

 

 

Advanced Options

 

Between lines 12 and 15 there are some constants that can be adjusted to change some behavior of the tether:

 

• debug = false
  Set to true to allow the tether to be used without any restrictions.
   
  
• makeTetheredInvincible = false
  Set to true to make tethered ships invincible instead of restoring their health every 0.25 seconds. Invincible ships will not allow any change to the hull hp and can therefore not be repaired. Since only invincible ships prevent one-shot kills, this option should be considered on PvP servers.
   
  
• slowShipsDown = false
  Experimental: Set to true to slow down tethered ships that are faster than 1000 m/s.
   
  
• maxTetherSpeed = 30
  Only ships below this value (default 300 m/s) will be tethered.
  

 

 

Known Issues

 

• the tethered indicator icon on top of the screen has a delay after being removed
  
• the tethered indicator icon on top of the screen may be occluded by other system upgrade icons like the valuables scanner
  
• tethered ships will not glow and lasers will not move with the ship if player HUD is hidden by F8
  

 

 

Changelog

 

 

v0.5 (Avorion v0.22+)

• add tagged client functions callable
  
• fix missing icon

v0.4

• only tether ships <= 300m/s
  
• fix error feedback handling
  

v0.3

• check if station actually has power
  
• add experimental ship slow down (disabled by default)
  
• fix range on low rarity
  

v0.2

• restore hp instead of invincibility
  
• add players of same alliance
  
• fix performance
  

v0.1

• first working approach
  

stationtether-0.5.zip

[Kamo]

Yum, nice mod ! :)