Difference between revisions of "Tutorial:Modifing Kerbals"

From Kerbal Space Program Wiki
Jump to: navigation, search
(Updated the information to the latest release (1.0.4))
Line 2: Line 2:
 
{{TOC|align=right}}
 
{{TOC|align=right}}
 
{{Box|type=warning|This tutorial requires you to edit the main configuration file for a saved game. It is recommended that you make a backup copy of the file prior to editing in the event your editing prevents the saved game from loading.  If you attempt to complete this tutorial while KSP is running, your save file will be severely damaged.}}
 
{{Box|type=warning|This tutorial requires you to edit the main configuration file for a saved game. It is recommended that you make a backup copy of the file prior to editing in the event your editing prevents the saved game from loading.  If you attempt to complete this tutorial while KSP is running, your save file will be severely damaged.}}
This tutorial will detail how to modify or create Kerbals. Customization is limited to their names, behavior, and status.
+
This tutorial will detail how to modify or create Kerbals. Customization is limited to their names, gender, type, behavior, and status.
  
 
==Requirements==
 
==Requirements==
Line 16: Line 16:
 
## '''Searching''' for ''ROSTER''. (Win: {{Key press|Control|F}}, Mac: {{Key press|Command|F}}) '''or you can'''
 
## '''Searching''' for ''ROSTER''. (Win: {{Key press|Control|F}}, Mac: {{Key press|Command|F}}) '''or you can'''
 
## '''Navigate''' (Win: {{Key press|Control|End}}, Mac: {{Key press|Command|Down}}) to the end of the file and {{Key press |page up}} until you see ''ROSTER'', it's the last section.
 
## '''Navigate''' (Win: {{Key press|Control|End}}, Mac: {{Key press|Command|Down}}) to the end of the file and {{Key press |page up}} until you see ''ROSTER'', it's the last section.
# Once located, the ''ROSTER'' section contains active personnel and personnel awaiting hire:
+
# Once located, the ''ROSTER'' section contains active personnel and personnel awaiting hire, each in a ''<tt>KERBAL{}</tt>'' section. Crew that can be hired have the type “Applicant”.
#*'''Active''': Each one is defined by a ''<tt>CREW{}</tt>'' entry.
 
#*'''Awaiting hire''': All prospective hires are within an ''<tt>APPLICANTS{}</tt>'' subsection and each is defined by a ''<tt>RECRUIT{}</tt>'' entry.
 
 
# '''Modify''' or '''create''' Kerbals as you wish. '''Reference''' the statistics below if needed.
 
# '''Modify''' or '''create''' Kerbals as you wish. '''Reference''' the statistics below if needed.
 
# '''Save''' the file and '''close''' it.
 
# '''Save''' the file and '''close''' it.
Line 26: Line 24:
 
Each Kerbal is defined by the following statistics:
 
Each Kerbal is defined by the following statistics:
 
#'''name''' = Full name, visually limited to approximately 18 characters.
 
#'''name''' = Full name, visually limited to approximately 18 characters.
 +
#'''gender''' = The gender, possible values are: “Male” and “Female”.
 +
#'''type''' = Recruit type, can be “Crew”, “Applicant” or “Tourist”.
 
#'''brave''' = Courage, floating decimal from 0 to 1, as of v0.23 only effects behavior.
 
#'''brave''' = Courage, floating decimal from 0 to 1, as of v0.23 only effects behavior.
 
#'''dumb''' = Stupidity,  floating decimal from 0 to 1, as of v0.23 only effects behavior.
 
#'''dumb''' = Stupidity,  floating decimal from 0 to 1, as of v0.23 only effects behavior.
#'''badS''' = Badass trait, boolean (true or false), if set to true this kerbal is fearless.
+
#'''badS''' = Badass trait, boolean (true or false), if set to true this Kerbal is fearless.
#'''state''' = State of the kerbal; One of the following: “unassigned”, “On mission”, “EVA”(?) and “Dead”.
+
#'''state''' = State of the kerbal; One of the following: “Available”, “On mission”, “EVA”(?) and “Dead”.
 
#ToD = Time of death, you shouldn't modify this value, for new Kerbals use the ToD value of an existing Kerbal.
 
#ToD = Time of death, you shouldn't modify this value, for new Kerbals use the ToD value of an existing Kerbal.
 
#idx = Unique ID, you shouldn't modify this value, for new Kerbals set to -1.
 
#idx = Unique ID, you shouldn't modify this value, for new Kerbals set to -1.
 +
#''<tt>CAREER_LOG{}</tt>'' = A summary of the activities performed by the recruit.
 +
#''<tt>FLIGHT_LOG{}</tt>''
 +
##flight = Total number of flights the Kerbal has been on.
  
Each section for the recuits look like this:
+
Each section for the Kerbals look like this:
<pre>RECRUIT
+
<pre>KERBAL
 
{
 
{
name = Americuuh
+
name = Jebediah Kerman
brave = 0.9999999
+
gender = Male
dumb = 0.9999999
+
type = Crew
 +
brave = 0.5
 +
dumb = 0.5
 
badS = True
 
badS = True
state = 0
+
tour = False
ToD = 620815.226647252
+
state = Available
idx = -1
+
ToD = 0
 +
idx = 0
 +
CAREER_LOG
 +
{
 +
flight = 1
 +
0 = Flight,Kerbin
 +
0 = Suborbit,Kerbin
 +
0 = Orbit,Kerbin
 +
0 = Land,Kerbin
 +
0 = Recover
 +
}
 +
FLIGHT_LOG
 +
{
 +
flight = 1
 +
}
 
}</pre>
 
}</pre>
  

Revision as of 16:00, 27 September 2015

This page needs more links to other articles to help integrate it into the Kerbal Space Program Wiki
This tutorial requires you to edit the main configuration file for a saved game. It is recommended that you make a backup copy of the file prior to editing in the event your editing prevents the saved game from loading. If you attempt to complete this tutorial while KSP is running, your save file will be severely damaged.

This tutorial will detail how to modify or create Kerbals. Customization is limited to their names, gender, type, behavior, and status.

Requirements

Locating and understanding the ROSTER section

  1. If you are running KSP, quit to main menu. You don't have to quit the entire game.
  2. Open the saves directory in your KSP installation directory.
  3. Open the directory of the specific saved game you wish to modify.
  4. Open the file named persistent.sfs with any simple text editor.
  5. Locate the personnel section by either:
    1. Searching for ROSTER. (Win: ^ Control+F, Mac: Command+F) or you can
    2. Navigate (Win: ^ Control+ End, Mac: Command+) to the end of the file and Page Up until you see ROSTER, it's the last section.
  6. Once located, the ROSTER section contains active personnel and personnel awaiting hire, each in a KERBAL{} section. Crew that can be hired have the type “Applicant”.
  7. Modify or create Kerbals as you wish. Reference the statistics below if needed.
  8. Save the file and close it.
  9. Run KSP to use your new crew.

Kerbal statistics

Each Kerbal is defined by the following statistics:

  1. name = Full name, visually limited to approximately 18 characters.
  2. gender = The gender, possible values are: “Male” and “Female”.
  3. type = Recruit type, can be “Crew”, “Applicant” or “Tourist”.
  4. brave = Courage, floating decimal from 0 to 1, as of v0.23 only effects behavior.
  5. dumb = Stupidity, floating decimal from 0 to 1, as of v0.23 only effects behavior.
  6. badS = Badass trait, boolean (true or false), if set to true this Kerbal is fearless.
  7. state = State of the kerbal; One of the following: “Available”, “On mission”, “EVA”(?) and “Dead”.
  8. ToD = Time of death, you shouldn't modify this value, for new Kerbals use the ToD value of an existing Kerbal.
  9. idx = Unique ID, you shouldn't modify this value, for new Kerbals set to -1.
  10. CAREER_LOG{} = A summary of the activities performed by the recruit.
  11. FLIGHT_LOG{}
    1. flight = Total number of flights the Kerbal has been on.

Each section for the Kerbals look like this:

KERBAL
{
	name = Jebediah Kerman
	gender = Male
	type = Crew
	brave = 0.5
	dumb = 0.5
	badS = True
	tour = False
	state = Available
	ToD = 0
	idx = 0
	CAREER_LOG
	{
		flight = 1
		0 = Flight,Kerbin
		0 = Suborbit,Kerbin
		0 = Orbit,Kerbin
		0 = Land,Kerbin
		0 = Recover
	}
	FLIGHT_LOG
	{
		flight = 1
	}
}

Bug Advisory

In version 0.23, modifying an existing Kerbal's "brave" or "dumb" values will result in the Kerbal acting in an undesired way despite displaying accurately in the Astronaut Complex and Crew Tab within the Vehicle Assembly Building. Previous and later versions are not affected.

The Original Four

If you change the names of the original four Kerbals (Jebediah, Bob, Bill, and Valentina) they will no longer have the orange flight suits.

Mods

These mods may be of interest to further customize your kerbals:

  • Texture Replacer
  • Kerbal Stats
  • Final Frontier