Difference between revisions of "Tutorial:Making a planet"

From Kerbal Space Program Wiki
Jump to: navigation, search
(Added Kopernicus planet creation page. I'm gone till the 15th, so I'll do the rest later.)
 
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{merge|Tutorial:Making Planets}}
 
It was never very easy to create planets in KSP - it often required decompiling, which is against the EULA. After a long time looking, a mod called Kopernicus was released and found, making it easy to make planets.
 
It was never very easy to create planets in KSP - it often required decompiling, which is against the EULA. After a long time looking, a mod called Kopernicus was released and found, making it easy to make planets.
 
==Specifications==
 
==Specifications==
Line 10: Line 11:
 
*An image editor
 
*An image editor
 
*Kopernicus 0.1
 
*Kopernicus 0.1
Many developers prefer text editors like Notepad++, a rather advanced program. Image editors usually are advanced, but even Paint would work.
+
Many developers prefer text editors like Notepad++, a rather advanced program. Image editors usually are advanced, but even Paint would work. You can find Kopernicus [https://github.com/BryceSchroeder/Kopernicus here]. Updated forum information can be found [http://forum.kerbalspaceprogram.com/threads/114649 here].
To download Kopernicus 0.1, search the forums or Google for it. If you go to a page with Kopernicus 0.0.9, there should be a little piece of text and a link to the newest version.
+
 
 
===2. Setting up the basic file===
 
===2. Setting up the basic file===
 
Create a file, and name it: PLANET.cfg
 
Create a file, and name it: PLANET.cfg
 
Change PLANET to your planet or moon's name.
 
Change PLANET to your planet or moon's name.
 
Inside the file, write this in:
 
Inside the file, write this in:
<code>
+
<pre>
 
@Kopernicus:AFTER[Kopernicus]
 
@Kopernicus:AFTER[Kopernicus]
 
{
 
{
Line 23: Line 24:
 
  }
 
  }
 
}
 
}
</code>
+
</pre>
 
This declares that the file is a Kopernicus configuration file and a celestial body.
 
This declares that the file is a Kopernicus configuration file and a celestial body.
 +
===3. Adding the essential modules===
 +
Kopernicus configs are broken up into different segments described as in this tutorial as modules. An @ symbol before a module overrides the existing module - allowing for Kerbin to turn orange or something. It is unknown whether children of modules are affected by the parent's overriding.
 +
The 2 required modules are <code>Properties</code> and <code>Orbit</code>. They require several parameters, listed here:
 +
<pre>
 +
Properties
 +
{
 +
description = in game description
 +
radius = half of the diameter of the planet - used to define size of sphere with texture
 +
geeASL = planet's gravity in Kerbin gravities
 +
rotationPeriod = day in seconds
 +
rotates = whether it rotates | true or false
 +
tidallyLocked = is one side of the planet locked towards it's parent | true or false
 +
initialRotation = distance in degrees from the rotation point of origin
 +
isHomeWorld = is the space centre on this planet | true or false
 +
timewarpAltitudeLevels = set the altitude for 1, 5, 10, 50, 100, 1,000, 10,000 and 100,000x timewarps | example for allowing every level at sea level: 0 0 0 0 0 0 0 0
 +
ScienceValues
 +
{
 +
  landedDataValue = multiplier for science points provided by surface samples or ground EVA reports
 +
  spashedDataValue = same as ^, but for oceans
 +
  flyingLowDataValue = same as ^, but for EVA and crew reports whilst flying below the flyingAltitudeThreshold
 +
  flyingHighDataValue = same as ^, but for flying above the flyingAltitudeThreshold but below the spaceAltitudeThreshold
 +
  inSpaceLowDataValue = same as ^, but for flying just above the spaceAltitudeThreshold
 +
  inSpaceHighDataValue = same as ^, but for flying high above the spaceAltitudeThreshold
 +
  recoverValue = multiplier for all science transmitted back
 +
  flyingAltitudeThreshold = < in metres from sea level
 +
  spaceAltitudeThreshold = < in metres from sea levels
 +
}
 +
}
 +
Orbit
 +
{
 +
referenceBody = body the planet is orbiting, Kerbol is Sun
 +
inclination = distance at ascending node from horizontal in degrees, relative to the parent's equator
 +
eccentricity = unknown, likely the eccentricity of an ellipse (as KSP uses conics for orbits)
 +
semiMajorAxis = average of pe and ap: pe + ap / 2 = this
 +
longitudeOfAscendingNode = set to 0 to be safe; angle from reference plane to ascending node
 +
argumentOfPeriapsis = set to 0 to be safe; angle from ascending node to periapsis
 +
meanAnomalyAtEpoch = set to 0 to be safe; angular distance from pericenter which body would have if in a circular orbit with constant speed and same orbital period as actual object
 +
epoch = keep at 0; used to define specific epoch of the orbit
 +
color = use rgb, but change values to 1/255*value
 +
}
 +
</pre>
 +
 +
===4. Choosing what to do===
 +
Use the code bible below to help you find what you want to do.
 +
==Code bible==
 +
Contents:
 +
*Atmospheres
 +
**Adding an atmosphere
 +
**Adding an atmosphere effect NOT DONE
 +
 +
===Adding an atmosphere===
 +
Add into the <code>Body</code> module and edit as necessary:
 +
<pre>
 +
Atmosphere
 +
{
 +
lightColor = tint of the light, in r,g,b format.
 +
enabled = true | you want one don't you?
 +
containsOxygen = true/false on oxygen in atmosphere
 +
altitude = height from sea level in metres
 +
PressureCurve
 +
{
 +
  key = use altitude pressure format | simple example of Kerbin:
 +
  key = 70000 0
 +
  key = 0 1
 +
}
 +
TemperatureCurve
 +
{
 +
  key = use altitude temperature-in-celcius forumat | simple example of Kerbin:
 +
  key = 70000 -270
 +
  key = 0 18
 +
}
 +
}
 +
</pre>
 +
 
==Done!==
 
==Done!==
 
At the moment, coding in Kopernicus is not completed, due to the enormity of the subject. It will be done soon.
 
At the moment, coding in Kopernicus is not completed, due to the enormity of the subject. It will be done soon.
 +
 +
[[Category:Tutorials|Making a planet]]
 +
[[Category:Modding Tutorials|Making a planet]]

Latest revision as of 11:22, 29 April 2020

It has been suggested that this page or section be merged into Tutorial:Making Planets. (Discuss)

It was never very easy to create planets in KSP - it often required decompiling, which is against the EULA. After a long time looking, a mod called Kopernicus was released and found, making it easy to make planets.

Specifications

  • Length: 15-30 minutes
  • Difficulty: Medium
  • For version: 1.0.x

Steps

1. Obtaining the prequisites

You will need:

  • A text editor
  • An image editor
  • Kopernicus 0.1

Many developers prefer text editors like Notepad++, a rather advanced program. Image editors usually are advanced, but even Paint would work. You can find Kopernicus here. Updated forum information can be found here.

2. Setting up the basic file

Create a file, and name it: PLANET.cfg Change PLANET to your planet or moon's name. Inside the file, write this in:

@Kopernicus:AFTER[Kopernicus]
{
 Body
 {
 }
}

This declares that the file is a Kopernicus configuration file and a celestial body.

3. Adding the essential modules

Kopernicus configs are broken up into different segments described as in this tutorial as modules. An @ symbol before a module overrides the existing module - allowing for Kerbin to turn orange or something. It is unknown whether children of modules are affected by the parent's overriding. The 2 required modules are Properties and Orbit. They require several parameters, listed here:

Properties
{
 description = in game description
 radius = half of the diameter of the planet - used to define size of sphere with texture
 geeASL = planet's gravity in Kerbin gravities
 rotationPeriod = day in seconds
 rotates = whether it rotates | true or false
 tidallyLocked = is one side of the planet locked towards it's parent | true or false
 initialRotation = distance in degrees from the rotation point of origin
 isHomeWorld = is the space centre on this planet | true or false
 timewarpAltitudeLevels = set the altitude for 1, 5, 10, 50, 100, 1,000, 10,000 and 100,000x timewarps | example for allowing every level at sea level: 0 0 0 0 0 0 0 0
 ScienceValues
 {
  landedDataValue = multiplier for science points provided by surface samples or ground EVA reports
  spashedDataValue = same as ^, but for oceans
  flyingLowDataValue = same as ^, but for EVA and crew reports whilst flying below the flyingAltitudeThreshold
  flyingHighDataValue = same as ^, but for flying above the flyingAltitudeThreshold but below the spaceAltitudeThreshold
  inSpaceLowDataValue = same as ^, but for flying just above the spaceAltitudeThreshold
  inSpaceHighDataValue = same as ^, but for flying high above the spaceAltitudeThreshold 
  recoverValue = multiplier for all science transmitted back 
  flyingAltitudeThreshold = < in metres from sea level
  spaceAltitudeThreshold = < in metres from sea levels
 }
}
Orbit
{
 referenceBody = body the planet is orbiting, Kerbol is Sun
 inclination = distance at ascending node from horizontal in degrees, relative to the parent's equator
 eccentricity = unknown, likely the eccentricity of an ellipse (as KSP uses conics for orbits)
 semiMajorAxis = average of pe and ap: pe + ap / 2 = this
 longitudeOfAscendingNode = set to 0 to be safe; angle from reference plane to ascending node
 argumentOfPeriapsis = set to 0 to be safe; angle from ascending node to periapsis
 meanAnomalyAtEpoch = set to 0 to be safe; angular distance from pericenter which body would have if in a circular orbit with constant speed and same orbital period as actual object
 epoch = keep at 0; used to define specific epoch of the orbit
 color = use rgb, but change values to 1/255*value
}

4. Choosing what to do

Use the code bible below to help you find what you want to do.

Code bible

Contents:

  • Atmospheres
    • Adding an atmosphere
    • Adding an atmosphere effect NOT DONE

Adding an atmosphere

Add into the Body module and edit as necessary:

Atmosphere
{
 lightColor = tint of the light, in r,g,b format.
 enabled = true | you want one don't you?
 containsOxygen = true/false on oxygen in atmosphere
 altitude = height from sea level in metres
 PressureCurve
 {
  key = use altitude pressure format | simple example of Kerbin:
  key = 70000 0
  key = 0 1
 }
 TemperatureCurve
 {
  key = use altitude temperature-in-celcius forumat | simple example of Kerbin:
  key = 70000 -270
  key = 0 18
 }
}

Done!

At the moment, coding in Kopernicus is not completed, due to the enormity of the subject. It will be done soon.