Skip to content

Latest commit

 

History

History
111 lines (81 loc) · 7.23 KB

README.md

File metadata and controls

111 lines (81 loc) · 7.23 KB
Raw

Astrogator

A space-navigational aide for Kerbal Space Program.

See all the transfers that you could choose from your current location at a glance, including the time till the burn and delta V, and turn them into maneuvers with one click.

See the README in the repo for references and additional acknowledgements.

See the README in the Localization folder for instructions for adding or improving translations for languages other than English.

Installation

Unzip the Astrogator folder into your GameData folder. The structure should look like this:

Kerbal Space Program
+-- GameData
    +-- Astrogator
        +-- Icons
        +-- Localization
        +-- Plugins

Usage

Automatic maneuver node creation

When you're piloting a vessel, maneuver node icons will appear next to the delta V numbers. Click to create maneuver nodes for that transfer:

These typically give immediate encounters for transfers to the Mun from low Kerbin orbit, and sometimes Minmus, Duna, and Jool, but some adjustment is usually needed for other destinations.

Time warping

Click a warp icon to warp to 5 minutes before the corresponding transfer. If it's already within 5 minutes, you'll be auto-warped to the exact time of the transfer.

More transfers, fewer clicks

  • Shows transfers for all main reachable spheres of influence, including from parent spheres of influence, not just bodies with the same parent
  • Supports transfers to vessel's target, regardless of what it is
  • Handles "nested" ejection burns, such as when you need to burn at the right time to escape Laythe at the right time to escape Jool at the right time to reach Kerbin
  • Supports burns to bodies within the current sphere of influence, such as the moons of Kerbin from low Kerbin orbit
  • Uses the active vessel's location and orbital parameters to fill in as many of the input parameters as it can
  • Shows you the results in zero clicks
  • Integrates with the game to streamline use of the data
  • Moves the map view focus automatically
  • Sets the vessel's target
  • Automatically opens maneuver nodes for editing

Settings

Click the wrench to open the settings panel and the back button to close it:

Setting Description
Generate plane change burns If you turn this off, then only (prograde) ejection maneuvers will be calculated. This may be needed if the plane change calculations become disruptive.
Add plane change burns to Δv column If you enable this, then the delta V shown in the table will be the ejection node plus the plane change node. Otherwise only the ejection delta V is shown, to make ejection burns less confusing when flying without maneuver nodes.
Auto-delete user-created maneuver nodes Our method for calculating plane changes doesn't work if other unrelated maneuvers are active. By default, we simply don't calculate them if that happens. Enabling this setting tells Astrogator to go ahead and delete your nodes if it needs to. Use with caution!
Calculate transfers to tracked asteroids When this is enabled, tracked astroids will be included in the list of transfers as if they were celestial bodies.
Automatically target destination When this is enabled, clicking the maneuver node icon will set the destination as the active vessel's target. This can be helpful because it enables the close approach markers.
Automatically focus destination When this is enabled, clicking the maneuver icon will change the map view focus. If the default maneuvers create an encounter with the desired body, then that body will be focused so you can fine tune your arrival; otherwise the destination's parent body will be focused so you can establish the encounter.
Automatically edit ejection node When this is enabled, clicking the maneuver icon will leave the first node open for editing.
Automatically edit plane change node If you enable this, then the second node will be opened for editing instead of the first.
Automatically set SAS to maneuver mode When this is enabled, clicking a maneuver creation button will activate SAS and put it into maneuver mode, which will cause your craft to orient toward the maneuver.
Adjust nodes with translation controls when RCS is off When this is enabled and RCS is turned off, maneuver nodes generated by Astrogator can be adjusted using the HNIJKL translation keys and the joystick translation axes.
Units: Metric Shows delta V in m/s (meters per second)
Units: United States Customary Shows delta V in mph (miles per hour)

Known limitations

  • Blizzy's toolbar is not and will not be supported. 0.23.5 was a long time ago.
  • It's not going to fly your ship for you. Other mods can do that already.
  • Only the phase angle approximation is used, not full porkchop plots, for performance reasons.
  • It doesn't do anything advanced or clever, such as gravity assists or aerobraking or periapsis raising for plane changes; only the basics to save you a trip to alexmoon.github.io/ksp/. If you want to perform a more sophisticated maneuver, you'll have to handle that yourself.
  • We create a real maneuver node for the ejection burn temporarily to calculate the plane change burns. This means you have to refrain from messing with maneuvers while the window is loading.
  • I can't get the maneuver / warp buttons to show their built-in tooltipText property, and they don't seem to have onHover events to set one up manually like we did for the app launcher, so it won't tell you what those icons do.

How to donate

Donate

Credits, acknowledgements, and dedication

Special thanks to all those who have helped to translate Astrogator to other languages!

Language Translators
Spanish Iván (hashashin), Deltathiago98
Chinese QAQdong
Russian Niev, Sooll3
French valens