Difference between revisions of "Tutorial:Modifing Kerbals"

From Kerbal Space Program Wiki
Jump to: navigation, search
(Overhauled and expanded, will request move to "Tutorial:How to modify or create Kerbals")
Line 1: Line 1:
For years (all those ones you spent timewarping to Jool) Kerbal kind has had the last name Kerman, but no longer..
+
==How to modify or create Kerbals==
 +
This tutorial will detail how to modify or create Kerbals. Customization is limited to their names, behavior, and status.
  
Today, I'm going to teach you to rename your Kerbals with whatever name you like! You can make Yuri Kerman, Neil Armstrong, or Mr. Munman if you really want. I personally use it for giving them the names of my friends and pile driving them with a rocket.
+
===Requirements===
 +
*Knowledge of the location of the KSP installation directory.
 +
*Simple text editor.
  
==NOTICE==
+
===Installation directory defaults===
This tutorial works on '''both Windows and Mac'''. The only difference is that the Kerbal Space Program directory will be named '''KSP-osx''' rather than '''KSP-win.'''
+
*'''Steam''': program files(x86)/steam/steamapps/common/Kerbal Space Program
 +
*'''Non-Steam''': In your download location, the default directory name varies by operation system:
 +
**'''Windows''': KSP-win
 +
**'''Mac''': KSP-osx
  
==Stage one: File locating!==
+
==Locating and understanding the ROSTER section==
Go to your KSP directory! Steam users can find it in their program files(x86)/steam/steamapps/common/Kerbal Space Program and non-steam users will find it in their downloads folder, assuming you haven't used it. Then, enter your saves file. Enter the file that is named after the save you wish to edit. See that file that says 'persistent'? Open it with a word editor of your choice. Now we'll find the part to edit.
+
'''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.'''
  
=WARNING!=
+
  1.'''Open''' the ''saves'' directory in your KSP installation directory.
AS OF VERSION 0.23, CHANGING A KERBALS COURAGE OR STUPIDITY WILL CAUSE THEM BOTH TO APPEAR NEAR ZERO IN THE MAP VIEW, AND WILL CAUSE THE KERBAL TO BE AFRAID OF EVERYTHING.  THE CHANGE WILL BE VISIBLE IN THE ASTRONAUT COMPLEX AND IN THE "CREW" TAB OF THE VEHICLE ASSEMBLY BUILDING, BUT IT WILL NOT BE THE SAME WHILE FLYING.  A FIX IS CURRENTLY NOT AVAILABLE. CHANGE AT YOUR OWN RISK.
+
  2.'''Open''' the directory of the specific saved game you wish to modify.
 +
  3.'''Open''' the file named ''persistent.sfs'' with any simple text editor.
 +
  4.'''Locate''' the personnel section by either:
 +
    a.'''Searching''' for ''ROSTER''. (Win: CTRL+F, Mac: CMD+F) '''or you can'''
 +
    b.'''Navigate''' (Win: CTRL+End, Mac: ?) to the end of the file and page up until you see ''ROSTER'', it's the last section.
  
==Stage two: Kerbal to Armstrong!==
+
Once located, the ''ROSTER'' section contains active personnel and personnel awaiting hire:
Press both CTRL (Control) and F (On Macs: CMD (Command) + F) at the same time: It will pull up a window which allow you to find the names. Type in Applicants and press Up or Down - there will only be one. Then close the small popup window and scroll down a little. Kerbal names! You can now replace them as you wish.
+
*'''Active''': Each one is defined by a ''CREW{}'' entry.
 
+
*'''Awaiting hire''': All prospective hires are within an ''APPLICANTS{}'' subsection and each is defined by a ''RECRUIT{}'' entry.
Now all you have to do is change the values of each astronaut.
 
 
 
name = The astronauts name.  It can be changed to anything.
 
 
 
brave = The astronauts bravery.  Adjusting this will change how the astronaut reacts to different situations.  Acceptable Values are anything from 0 to 1.
 
 
 
dumb = The astronauts intelligence. The higher the number, the dumber the astronaut.  Acceptable Values are anything from 0 to 1.
 
 
 
badS = Stands for Bad Ass.  IF you set this to true, the kerbonaut will not be afraid of anything.  Jebediah Kerman has this enabled.
 
 
 
State = The state of the Kerbonaut.  0 = For hire.  1 = Hired.  2 = On a mission. 3 = Dead.
 
 
 
'''Don't mess with the other values.'''  
 
  
 +
  5.'''Modify''' or '''create''' Kerbals as you wish. '''Reference''' the statistics below if needed.
 +
  6.'''Save''' the file and '''close''' it.
 +
  7.'''Run''' KSP to use your new crew.
  
 +
==Kerbal statistics==
 
[[File:AmercanKerbal.png|thumb|A custom AmeraKerbal]]
 
[[File:AmercanKerbal.png|thumb|A custom AmeraKerbal]]
'''WARNING:''' If the ToD is below the time of your save, the Kerman won't show up until the time passes.
+
Each Kerbal is defined by the following statistics:
 +
#'''name''' = Full name, visually limited to approximately 18 characters.
 +
#'''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.
 +
#'''badS''' = Badass trait, boolean (true or false), if set to true this kerbal is fearless.
 +
#'''state''' = State of the kerbal; 0 = unassigned, 1 = on mission, 2 = ?, 3 = dead.
 +
#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.
  
==Stage Three: Using the Kerbals!==
+
===Bug Advisory===
You can now use your kerbals after recruiting them. You can change the names of recruits if you want to make sure not to name one you can't use yet, but it's not required.
+
'''As of v0.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. Change at YOUR OWN RISK.'''
  
Untill next time! Note: If you change Jebediah, Bob, or Bill's names, they will no longer have the Orange flight suits, so don't do that!
+
==The Original Three==
 +
If you change the names of the original three Kerbals (Jebediah, Bob, or Bill), they will no longer have the orange flight suits.

Revision as of 16:47, 11 March 2014

How to modify or create Kerbals

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

Requirements

  • Knowledge of the location of the KSP installation directory.
  • Simple text editor.

Installation directory defaults

  • Steam: program files(x86)/steam/steamapps/common/Kerbal Space Program
  • Non-Steam: In your download location, the default directory name varies by operation system:
    • Windows: KSP-win
    • Mac: KSP-osx

Locating and understanding the ROSTER section

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.

  1.Open the saves directory in your KSP installation directory.
  2.Open the directory of the specific saved game you wish to modify.
  3.Open the file named persistent.sfs with any simple text editor.
  4.Locate the personnel section by either:
   a.Searching for ROSTER. (Win: CTRL+F, Mac: CMD+F) or you can
   b.Navigate (Win: CTRL+End, Mac: ?) to the end of the file and page up until you see ROSTER, it's the last section.

Once located, the ROSTER section contains active personnel and personnel awaiting hire:

  • Active: Each one is defined by a CREW{} entry.
  • Awaiting hire: All prospective hires are within an APPLICANTS{} subsection and each is defined by a RECRUIT{} entry.
  5.Modify or create Kerbals as you wish. Reference the statistics below if needed.
  6.Save the file and close it.
  7.Run KSP to use your new crew.

Kerbal statistics

File:AmercanKerbal.png
A custom AmeraKerbal

Each Kerbal is defined by the following statistics:

  1. name = Full name, visually limited to approximately 18 characters.
  2. brave = Courage, floating decimal from 0 to 1, as of v0.23 only effects behavior.
  3. dumb = Stupidity, floating decimal from 0 to 1, as of v0.23 only effects behavior.
  4. badS = Badass trait, boolean (true or false), if set to true this kerbal is fearless.
  5. state = State of the kerbal; 0 = unassigned, 1 = on mission, 2 = ?, 3 = dead.
  6. ToD = Time of death, you shouldn't modify this value, for new Kerbals use the ToD value of an existing Kerbal.
  7. idx = Unique ID, you shouldn't modify this value, for new Kerbals set to -1.

Bug Advisory

As of v0.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. Change at YOUR OWN RISK.

The Original Three

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