A planet's mass will pull every ship in a certain distance towards the planet (default: 3 ly). This can be used to save fuel: move just to the edge of the warp well and let the planet pull you. To move inside a warp well, you must go at Warp 1; Warp 1 ships are not pulled.
Preconditions:
- AllowGravityWells is enabled;
- Ship does not already orbit a planet;
- Ship has moved by itself (towed ships move with their tower, and are affected by gravity wells if their tower is);
- If the ship has hyperjumped, it is affected only if AllowHyperjumpGravWells is enabled;
- If the ship has moved normally, it is affected only if its speed is not Warp 1.
A ship is pulled towards the planet for which the following holds:
- If RoundGravityWells is enabled, the distance between ship and planet must be less or equal to GravityWellRange.
- If RoundGravityWells is disabled, the two conditions (Abs(Planet_X - Ship_X) ≤ GravityWellRange and (Abs(Planet_Y - Ship_Y) ≤ GravityWellRange must be fulfilled (i.e. the planet must be no more than GravityWellRange light years from the ship in X and Y direction; wrapping is supported).
If more than one planet is in range, the ship is pulled towards the one with the highest Id. If no planet is in range, the ship is not affected.
While the ship is moved by gravity wells, it does not need fuel, and is not in danger of hitting mines.
