Skip to content

Installation

This is a complete installation guide on how to install Promised Worlds for Kerbal Space Program.

System Requirements

List Minimum Recommended
KSP Version 1.12.x 1.12.5
RAM 16GB 32GB
GPU 2GB VRAM 4GB VRAM
Storage 5GB Free Space 10GB Free Space
Platforms Windows Windows (Linux/MacOS have issues when testing)

CKAN

  • Select "Promised Worlds - Debdeb" for the Debdeb system. CKAN will install the required dependencies.
  • Select "Promised Worlds - Tuun" for the Tuun system. CKAN will install the required dependencies.

SpaceDock

(SpaceDock is no longer supported as it has caused numerous download issues upon users and developers)

Manual (GitHub)

  • Download the latest version from releases. You will need the Core zip file, along with the zip file for any systems you want. You can install any of the systems you like - you don't have to take them all.
  • Extract the Core zip file, and put the contents of GameData in your GameData directory.
  • For each system you want:
    • Extract the system's zip file, and put the contents of its GameData in your GameData directory. It will add a directory within PromisedWorlds.
  • Download the mod's dependencies:
  • Kopernicus (Read the Kopernicus install Guide, as Kopernicus requires it's own dependencies)
  • KSP Community Fixes (Fixes most issues with interstellar travel.)
  • Singularity (Singularity is only required if you wish to use wormholes)

Other Dependencies are ALREADY BUNDLED with Promised Worlds, however, if the files do not correctly install, we've left these links here:

Options

In the PromisedWorlds directory there is PromisedWorldsSettings.cfg with options for the mod:

  • Skybox (Requires Sigma Skybox Replacements) (Release 2.0.0 and above)
  • Wormholes (Requires Singularity for shaders)
  • DistanceFactor (How far from Kerbol the systems will be)
  • Rescale (Resize the systems, requires Sigma Dimensions)
  • RealisticStarSize (Makes the stars more realistically sized relative to the planets)
  • RemoveStockScreens (Removes Stock Loading Screens and only uses Promised Worlds Media as loading screens)

(Upon the release of 2.0.0, you can change these settings in-game with the icon that is in the top right corner of the main menu of KSP, labeled "PW", requires restart upon changing settings)

Compatible Mods

Mod Category Compatibility Mod Details
Quality Of Life Kerbalism Adds Radiation Belts + More
Rational Resources Support Included
Space Dust Scoop/Gather Fuels
Visuals (Recommended) Volumetrics V5 Adds Clouds, Aurora, Atmosphere Scatters
PlanetShine Planet ground/space Reflections
Distant Object Enhancement Planetary Flares
Firefly Adds Re-entry effects
Parallax Continued Adds Detailed Terrain
Deffered Adds Deffered Rendering (Optional)
Planet Packs Outer Planets Mod Compatibility Checked
Minor Planets Expansion Compatibility Checked
Cosmic Serenity Compatibility Checked
Kcalbeloh Compatibility Checked
KSS 2 Compatibility Checked
Sol/RSS Compatibility Checked (only in 10x Rescale)
JNSQ Compatibility Checked (only in 2.5x Rescale)

Outdated Mods/Incompatibility

Compatibility Mod Reason/Conflict
Parallax V1/V2 Unsupported/No Configs
Principia (N-Body Sim) No issues/Causes instability in orbits
Volumetrics V4/V3 and prior Unsupported/No Configs
Free EVE Unsupported/No Configs
TiltEm Adds Axial Tilt - Current TiltEm causes issues but remains useable
General/Old planet packs (KSP 1.11.X/prior) Untested/May cause issues

Common fixes (Q/A)

Q: Clouds are not appearing on any Promised Worlds Celestial Body, what do I do?

A: Check to see if you have EVE Redux. Currently, Promised Worlds does not support EVE Redux/Free EVE, and only supports Volumetric EVE, which is a paid mod, and can be found here: Volumetric EVE

Q: Parallax is giving me errors when I start the game, what do I do?

A: This is due to an incorrect install, or missing dependencies for either Promised Worlds, or Parallax Continued. Check the install guide at the top of this page, and if the issue still persists, report an issue on the Repository.

Q: None of the Promised Worlds bodies load when I go to map view, what is causing this?

A: This is due to missing dependencies for Kopernicus, check if you have all the dependencies, listed on the Kopernicus page in the "README" section.

Q: Does Promised Worlds have lower graphics settings?

A: Promised Worlds Supports Graphics Mods to make use of better visuals. Those mods themselves include settings to reduce lag and improve performance for lower-end devices. At the top of this page, we have a recommended specs sheet to get the maximum performance out of Promised Worlds.

Known issues with Promised Worlds as of (1.2.1):

  • With Visual Enhancement Mods installed (Parallax/EVE), Celestial Body eclipses may become out of alignment with their parent object, or may cast a shadow on themselves in pure sunlight.
  • With Emissive mods installed, Donk will temporarily become red when Exiting it's Sphere of Influence.