Subscribe to download
[JON] Jawa's Orbital Navigation

For a Sigma Draconis server specific version of this script, follow the link below:
https://gtm.steamproxy.vip/sharedfiles/filedetails/?id=2583291777

This script was made to assist in navigating around planets. It generates orbital, drop, and surface coordinates. Since you cannot jump into a gravity well you either have to already have coordinates just outside the gravity well or jump even farther from the planet and fly in on slow sub-light engines. This script avoids this difficulty by providing exact coordinates to jump to. This script is useful for jumping to planets, dropping packages from orbit, or landing at a desired landing zone.

When you run this script it will output orbital, drop, and surface coordinates for all planets in the system. These coordinates will be based on your current position so they will be as close to you as possible. You can also specify custom GPS coordinates to be use for calculations in addition to your current position. The jump coordinate is fairly obvious, it is a point just outside the planet's gravity that you can jump to. The drop coordinates are inside the planets gravity so that you can release a drop pod (or bomb!) and it will be pulled to the surface. The surface coordinates are directly under the drop coordinates which are directly under to orbital coordinates..

The script will also accept GPS coordinates as input. This allows you to generate all the coordinates (jump, drop, and surface) given any other single point. So if you have surface coordinates you can generate the drop and jump coordinates or the other way around. It also allows you to generate coordinates for someone else. All the have to do is give you their coordinates.

• Coordinate generation for nearest jump, drop, and surface position
  
• Coordinate generation for all planets
  
• Coordinate generation based off of input GPS
  
• Ability to use custom planets
  
• Ability to specify orbital distance via command

To start:

1. Place a programmable block and load the script.
   
2. Click run to see results.

This is all you need to do, but there are more options. The script accepts two command formats.

Format 1: GPS:GPS_NAME:X:Y:Z:Planet_Name:Padding_Distance
Format 2: Padding_Distance

-Format 1:
--GPS:
Entering GPS coordinates as an argument makes the program output data based on the GPS coordinates in addition to the data based on your ship's coordinates. The GPS coordinates are only accepted in the format used by the game when you use the "Copy to clipboard" option. You can replicate this format by typing, but it is recommended to simply use the "Copy to clipboard" button in the GPS tab.

--Planet_Name: (optional)
This argument is optional. This allows you to specify the planet your GPS coordinates are related to.
The name is case sensitive. The default planet names are lowercase for this script. If you add your own planets it is recommended to enter their names in lowercase letters as well. If you do not enter this argument the program will calculate which planet is closest to the coordinates you entered and will use that planet's data for calculations.

--Padding_Distance: (optional)
When using Format 1, this argument can only be used after the Planet_Name argument.
This argument allows you to change the distance between the orbit coordinates and the edge of gravity for the planet. The default is 500m. This means that if you fly or jump to the orbit coordinates you will be 500 meters outside of the range of the planet's gravity.

-Format 2:
This format is used when you only want to change the orbit distance without adding GPS coordinates.
This argument allows you to change the distance between the orbit coordinates and the edge of gravity for the planet. The default is 500m. This means that if you fly or jump to the orbit coordinates you will be 500 meters outside of the range of the planet's gravity.

Output is placed in the "Custom data" section of the programmable block and is in the following format:

If you open the code for the script there is the option to add custom planets and change the default orbit and drop padding distances. When adding planets you will need to know the name, position, radius, and gravitational influence radius. new planets can be added to the "ADD NEW PLANETS HERE" section, and default planets can be removed in the "Default Planets Here" section. A template is provided in the code for adding new planets.

in the section titled "Change Constants Between These Lines" you can change the default distances for how far inside the gravitational influence of planets you want the drop coordinates to be and how far outside the gravitational influence the orbital coordinates to be. The orbital coordinates can also be changed on the fly using the commands listed above.

Since planets are not perfect spheres and their terrain changes elevation it is not possible to generate surface coordinates at the exact elevation for a specific point. Because of this the surface coordinates may be somewhat above or below the actual point on the surface.

Special thanks to Freak_Gene who posted all the planet info on the Steam General Discussions board for SE.

For those of you using custom planets, you will find that the planet position in the Sandbox.sbs is the for the corner of the panet's bounding box, not the center. You can use this script by Pennywise to easily find the center position of your planets. https://gtm.steamproxy.vip/sharedfiles/filedetails/?id=558846217

Let me know if you have any feedback or bugs to report.