SpaceTradersAPI / api-docs

The API documentation for the SpaceTraders API
143 stars 36 forks source link

Ship Condition Update #87

Closed thebrubaker closed 8 months ago

thebrubaker commented 8 months ago

Overview

Taking ship actions such as navigating and extracting will now have a chance of a negative event occurring which degrades the condition of the frame, reactor or engine on a ship. Better ships will degrade at a lower rate than cheap ships (the goal is to think of drones as almost disposable, but your command ship should be maintained).

All of the values for event frequency, repair cost, and scrap earnings are ballparked, so things will need to be adjusted from player feedback. Some of the design goals include:

Negative Events

Currently only navigating and extracting have a chance of a negative event, but we will be adding most ship actions such as siphoning, docking, jumping, and warping into the logic. The traits of the waypoint involved currently increase the chances of a negative event (explosive gases for instance double the chances of damage to the ship)

Ship Damage

Ships take damage from negative events which lower the condition of the affected component. The lower the condition of the component, the more damage that will incur over time, so it is beneficial to keep your important ships maintained. Higher quality ships, such as the command ship, will take less damage from events than cheaper ships, such as drones. The condition of a ship ranges from 0 to 1, and will be restored to 1 when repaired. The integrity of the component will degrade with each repair, and eventually it will make more sense to scrap a ship than repair it.

Condition vs Integrity

Condition is repairable and is always restored to a value of 1. The integrity of the component is the long term wear and cannot be repaired. The integrity of the component is lowered every time you repair your ship.

Scrapping

Scrapping your ship will provide your agent with credits relative to the cost of the ship, the condition of the components, the mounts and modules attached, and the current price of ship parts / plating at the shipyard. You won't get a great price for your mounts and modules, so you will likely want to remove anything valuable. Cargo will be destroyed and not factored into the credits given.

Repairing

Repairing your ship costs credits and the cost of this repair will factor in the type of component, the condition of the component (more damaged components are more expensive to repair), and the price of ship parts and plating at the market.

Changes