Skip to content

harveyt/KPlanes

Repository files navigation

Contract Pack: K-Planes

By: 610yeslovely

The K-Planes contract pack adds various contracts to encourage and reward building of planes from very early stages, through X-plane style rocket planes, to SSTO (single-stage to orbit) planes.

Origins

This mod is inspired by and indeed uses some assets, configuration from the original GAP mod, which is also a MIT license.

The original author of GAP inigma gave blanket permission to use anything and everything from GAP on the KSP Forums.

Purpose

This pack is planet pack agnostic and tech tree agnostic, but the description assumes either Stock, semi-Stock (2.5x or 2.7x scale like JNSQ or KSRSS), or Earth-scale planets (RSS/RO/RP-1). The pack can also be used alongside GAP or deriviatives and does not need them for any shared assets, though some of the early contracts are almost the same as the milestones from GAP (because they were copied and made planet agnostic).

Initially you will find contracts to build your first powered aircraft, then several contracts which increase the speed, height and/or distance that plane can travel. Bonus points are usually awarded for landing back at the KSC Runway, but you can land anywhere that is safe.

After these the real K-Plane contracts arrive: building rocket powered air-launched X-1 style aircraft, acheiving Mach 1, 2, 3, getting to the stratosphere (18km to 50km for Earth scale) for sub-orbital flights.

Later contracts are more speculative and involve reaching Mach 4, Mach 5, to space (80km), and orbital. Some contracts require SSTO (single-stage to orbit) and some let you use boosters, but still require wings (think Space Shuttle), and some involve leaving satellites or cargo in space.

Far future contracts might include taking certain tonnage to other moons or planets and returning the craft and landing back at Kerbin/Earth.

Installation

I highly recommend installing mods using CKAN as it will correctly add required dependencies, however for those who like a more tedious life you can manually install them and possibly get less of my attention if there are issues.

Required Dependencies:

Recommended Part Dependencies:

Recommended Helper Dependencies:

Recommended IVA Dependencies, to fly inside the plane:

How Scaling Works

Speeds

Speeds are measured in m/s and are always the same for any planet. Roughly speaking Mach numbers are multiples of 343 m/s, though the actual Mach number will vary depending on pressure, temperature and altitude. However, since speed records are usually constrained by altitude, which do scale, non-stock scale planets will be harder due to the altitude requirements.

Correctly limiting to an actual Mach number is pretty complicated, in the future this may change.

Altitudes

Altitudes are scaled by the planets FlyingHigh, SpaceLow and SpaceHigh altitudes as follows:

  • TroposphereLow : ~15% from sea level to FlyingHigh.
  • TroposphereHigh : ~30% from sea level to FlyingHigh.
  • StratosphereLow : ~40% from sea level to FlyingHigh.
  • StratosphereHigh : ~70% from sea level to FlyingHigh.
  • MesosphereLow : always equals FlyingHigh.
  • MesosphereHigh : ~20% from FlyingHigh to SpaceLow.
  • ThermosphereLow : ~40% from FlyingHigh to SpaceLow.
  • SpaceLow : is where space starts in KSP.
  • SpaceLEO : is roughly how high ISS travels, or about 12% from SpaceLow to SpaceHigh.
  • SpaceMEO : always equals SpaceHigh, which in KSP seems to mean MKO / MEO (Mid-Kerbin or Mid-Earth Orbit).

The computations are algorithms which will work for any planet scale, but here are examples for common scales.

For Stock (1x):

  • TroposphereLow: 3 km
  • TroposphereHigh: 5 km
  • StratosphereLow: 7 km
  • StratosphereHigh: 13 km
  • MesosphereLow, FlyingHigh : 18 km
  • MesosphereHigh: 30 km
  • ThermosphereLow: 40 km
  • SpaceLow : 70 km
  • SpaceLEO : 90 km
  • SpaceMEO : 250 km

For KSRSS, JSNQ (2.7x), the atmosphere is usually very similar to stock scale, though SpaceLow is usually 10km higher. Therefore only slightly harder for Modern / Future contracts.

  • TroposphereLow: 3 km
  • TroposphereHigh: 5 km
  • StratosphereLow: 7 km
  • StratosphereHigh: 13 km
  • MesosphereLow, FlyingHigh : 18 km
  • MesosphereHigh: 30 km
  • ThermosphereLow: 45 km
  • SpaceLow : 80 km
  • SpaceLEO : 430 km
  • SpaceMEO : 2863 km

For RSS (Earth), the atmosphere is much thicker, so much higher altitudes are needed. Hard mode!

  • TroposphereLow: 5 km
  • TroposphereHigh: 10 km
  • StratosphereLow: 20 km
  • StratosphereHigh: 45 km
  • MesosphereLow, FlyingHigh : 50 km
  • MesosphereHigh: 70 m
  • ThermosphereLow: 85 km
  • SpaceLow : 140 km

Distances

Distance contracts are scaled by the planets circumference, again using algorithms that work for any scale. Below are examples for common scales.

For Stock (1x):

  • Shop Hop : 50 km
  • Domestic : 100 km
  • Continental : 250 km
  • Intercontinental : 750 km
  • Polar : ~1,885 km
  • Equatorial : ~3,770 km

For KSRSS, JSNQ (2.7x), over twice as far, not that much harder.

  • Shop Hop : 130 km
  • Domestic : 250 km
  • Continental : 700 km
  • Intercontinental : 2,000 km
  • Polar : ~5,000 km
  • Equatorial : ~10,000 km

For RSS (Earth), distances are ten times stock scale, so this is Hard Mode!

  • Shop Hop : 530 km
  • Domestic : 1,000 km
  • Continental : 2,700 km
  • Intercontinental : 8,000 km
  • Polar : ~20,000 km
  • Equatorial : ~40,000 km

Changes

0.3.0 Release - Start and Early contracts second pass (17th Dec 2022)

  • Fixed distance contracts, now seem to work better.
  • Added Polar, Circum-Polar and Round The World distances.
  • Some testing, but still not recommended for general gameplay.

0.2.0 Release - Start and most Early contracts (17th Dec 2022)

  • Most of the GAP milestone contracts now present.
  • Progression should work, and everything should scale to homeworld scale.
  • Only slightly tested, so probably still not recommended for general gameplay.

0.1.0 Release - Start contracts (1st Dec 2022)

  • Not really functional, but general idea started.

License

All content is MIT licensed.

  • KASA logo derived from NASA svg downloaded from Wikipedia
  • KACA logo dervied from NACA svg downloaded from Wikipedia

Source

Source is available on GitHub.

KSP Forum is the home page for discussions.