Difference between revisions of "Debug Toolbar"

From Kerbal Space Program Wiki
Jump to: navigation, search
m (Needs updating)
m (Cheats)
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Outdated|
+
[[File:Console, upon loading.png|thumb|The debug toolbar upon loading into the game.]]
* Redesigned in 1.2
 
}}
 
[[File:Debug Toolbar.png|thumb|The debug toolbar open with the tab “Cheats”]]
 
 
The '''Debug Toolbar''' is a window designed for testing and debugging purposes. It can however also be used by the average player to ease gameplay, cheat or “goof off”.
 
The '''Debug Toolbar''' is a window designed for testing and debugging purposes. It can however also be used by the average player to ease gameplay, cheat or “goof off”.
 +
With RightShift+F12, the toolbar can be opened. As of 1.7.0, it has seven sections: Console, Database, Cheats, Physics, Contracts, [[Kerbals]], and may have additional sections added for game expansions or DLCs. (In the future, outside plugins may be able to add debug screens, but this remains to be seen.)
  
With {{Key press|[[Mod]]|F12}} the toolbar can be opened. It has four sections: Cheats, Debug, Database and Progress.
+
==Console==
 +
The console outputs the current states of many of the processes running in the loading and playing of KSP. The Console drop-down menu has six subscreens: Debugging, Input Locks, Performance, Flight Info, Version Info, and DeltaV Info.
 +
===Debugging===
 +
[[File:Debugging, upon loading.png|thumb|The debugging screen, upon loading the game.]]
 +
This screen has five true/false options related to the console log and localization:
 +
#  Show All Log Errors on the Screen
 +
#  Show All Log Exceptions on the Screen
 +
#  Immediately Flush Log File to Disk
 +
#  Write missing localization keys to log as they are accessed
 +
#  Show localization keys on-screen(instead of translated text)
  
== Cheats ==
+
===Performance===
This section contains multiple checkboxes and buttons used to ease gameplay or debugging in cheaty ways.
+
[[File:Performance, in menu.png|thumb|The performance subscreen.]]
 +
This screen has a performance graph as well as six related displays, in millibytes:
 +
*  Used Heap Size
 +
*  Allocated
 +
*  Reserved
 +
*  Unused Reserve
 +
*  Mono Heap
 +
*  Mono Heap Used
  
=== Always available ===
+
===Flight Info===
These options are available at any time, however they may not always have an effect.
+
This screen shows the location of the active vessel, the time, and the current reference body and frame.
* '''Show/Hide Input Lock Stack:''' Shows or hides a list showing if a certain type of input is locked and why, for example when staging has been locked with Mod+L.
+
===Version Info===
* '''Pause on vessel unpack:''' Currently does not have any effect.
+
This screen simply shows the current version and any expansions.
* '''Unbreakable Joints:''' When active, connections between parts cannot break.
+
===[https://en.wikipedia.org/wiki/Delta-v Delta-V] Info===
* '''No Crash Damage:''' When active, parts cannot be destroyed by crashing into each other or anything else. They can however still be destroyed by other means, such as overheating and splashing down '''hard'''.
+
The main focus of this screen is a list of all the stages and each stage's DeltaV, Thrust, [https://en.wikipedia.org/wiki/Thrust-to-weight_ratio Thrust to Weight Ratio], amongst other stats. Five true/false options for changing the main display:
* '''Infinite Fuel:''' When active, parts that require [[liquid fuel]], [[oxidizer]], [[solid fuel]], [[xenon gas]] or [[intake air]] will run without consuming and requiring the resource.
+
#  Show Parts -- adds a part list for each stage
* '''Infinite RCS:''' When active, parts that require [[monopropellant]] will run without consuming and requiring the resource.
+
#  Show Vacuum(true on default) -- toggles between atmosphere and vacuum readouts
* '''Infinite EVA Fuel:''' When active, the jetpack of a [[kerbonaut]] on [[EVA]] will work without consuming and requiring the resource.
+
#  Show all stages -- toggles between showing stages with or without thrust
* '''Allow Part Clipping in Editors:''' When active, the editor will not check if a newly placed part would collide with existing ones, hence allowing intersecting parts ("clipping").
+
#  Show Engine Info -- adds an engine specification readout for each stage
* '''Biomes visble in map:''' When active, the [[biome]]s are indicated with various colors in [[map view]] and in the GUI of the [[Tracking Station]].
+
#  Verbose Logging
  
=== Only available during flight ===
+
==Database==
These options are only shown during a flight.
+
The Database screen has statistics for the number of assets currently available, along with a tool to reload the asset database(only available in the main menu) and the texts dictionary. Also available is a complete list of all assets used by the game or mods, including a list of assemblies in use by the game.
* '''Show/Hide Flight Debug Stats:''' Shows or hides some stats in the top right corner of the game.
 
** ''UT:'' Internal game time.
 
** ''Physics Time Ratio:'' Internal [[time warp]] speed.
 
** ''Lat:'' Latitude relative to currently orbited body.
 
** ''Lon:'' Longitude relative to currently orbited body.''
 
** ''Ref Body:'' The body in whose [[sphere of influence]] the craft currently is. The mapping is the same as in [[Orbit#Reference code|ORBIT]] definition.
 
** ''Frame of Reference:'' Meaning unknown.
 
** ''Vfrm:'' Meaning unknown.
 
** ''Ext Temp:'' Exterior temperature at the craft's position. Equal to the reading of a [[2HOT Thermometer]].
 
* '''Hack/Unhack Gravity:''' When enabled, reduces the gravity of all [[celestials]] greatly.
 
* '''Show/Hide Whack A Kerbal:''' Shows or hides a second window which can be used to create abstract bodies. When the third mouse button (usually the middle mouse button or scroll wheel) is pressed, a body with the selected properties will be created at the position of the mouse cursor.
 
** ''Object Type:'' The kind of body that will be created. Available options: Sphere, Capsule, Cylinder, Cube, and Plane; default Sphere.
 
** ''Object Mass:'' The body's mass. Can be any number between 1.0 and 100.0, default 15.0.
 
** ''Object Size:'' The body's size. Can be any number between 0.1 and 10.0, default 0.6.
 
** ''Speed:'' The body's initial velocity. Can be any number between 1.0 and 100.0, default 30.0.
 
:: Setting all these to max will destroy anything and spamming them will create lag and possibly crash the game. It can be used for testing the strength of a vessel.
 
  
== "Hidden" Cheats ==
+
==Cheats==
To access, when on the cheats menu, holding {{Key press|[[Mod]]}} for 5 seconds will bring up some extra options inside the current cheat menu (This works in the [[KSP]] menu (where the player can access the buildings)). These options can be used to give funds, science, reputation, etc.
+
[[File:Cheats.png|thumb|right|The Cheats screen, seen from the launchpad.]]
 +
This screen has ten true/false options that change the gameplay of KSP:
 +
#  Hack Gravity -- Slider changes gravity from 0.01 Gs to 10 Gs.
 +
#  Unbreakable Joints -- Parts will never disconnect.
 +
#  No Crash Damage -- Removes the possibility that parts will explode due to collision with other vessels or the ground.
 +
#  Ignore Max Temperature -- Removes the possibility that parts will explode due to heating.
 +
#  Infinite Propellant
 +
#  Infinite Electricity
 +
#  Pause on Vessel Unpack -- The game will be paused when launching.
 +
#  Biomes Visible -- Recolors
 +
#  Part Clipping in Editors
 +
#  Non-Strict Part Attachment Checks
 +
A tool also exists to modify science/reputation by increments of ±100 or ±10 and funding by increments of ±100000 or ±1000 or to maximize any of these:
 +
Technology -- Researches all researchable techs with no Resource cost.
 +
Facility -- Upgrades all facilities to the maximum level.
 +
Experience -- Trains all your Kerbals to maximum experience.
 +
Progression -- Activates the three previous options.
 +
===Set Orbit===
 +
This subscreen has two commands:
 +
#  Set Orbit -- Seven numerical entries from which you can set any orbit around any celestial body.
 +
#  From here you can teleport to within 150 meters of any object.
 +
===Difficulty===
 +
This subscreen has seven true/false options which are set to true upon startup of a new savegame, but can be set to false to increase difficulty.
 +
#  Allow revert to launch
 +
#  Allow revert to editor
 +
#  Allow quick saving
 +
#  Allow quick loading
 +
#  Ignore agency mindset(False on default)
  
== Gameplay Tweaks == <!-- using capitalisation from Squad -->
+
===Object Thrower===
With version [[0.24]] the Debug Toolbar gets a new tab ''Gameplay Tweaks''. With the options there it is possible to disable features which decrease the difficulty and were available before. Those features include [[stock craft]] in [[career]] mode, respawning of lost crew member, reverting, quicksaves and quickloads.
+
[[File:Object Thrower, in use.png|thumb|right|The object thrower in use.]]
 +
Like the legacy Whack-A-Kerbel, this subscreen allows you to throw either a cube or a sphere, at any mass, size or speed, by middle-clicking.
  
It is also possible to ignore agency mindsets on [[contract]]s.<!-- what does that mean? --><ref>“[https://www.youtube.com/watch?v=OtX3DljOKaI Kerbal Space Program - 0.24 Early Access - Even More Updates]” by Scott Manley released on July 14, 2014</ref>
+
==Physics==
 +
[[File:Physics.png|thumb|right|The physics subscreen from the launchpad.]]
 +
This screen has options to load, save, and change the physics database, to visualize auto struts, and for orbit targeting.
 +
===Aero===
 +
This subscreen has three true/false options that change the way aero data is visualized for the player:
 +
Display Aero Data in action menus
 +
Display Aero Data GUI
 +
Display Aero Forces in Flight
 +
Force Display Scale
 +
Also available are three modifiers that allow you to physically change aero forces:
 +
#  Global Lift Multiplier
 +
#  Lift/Drag Multiplier
 +
#  Body Lift Multiplier
 +
===Drag===
 +
First on this subscreen is an option to turn on or off drag itself.
 +
Also available is seven options and modifiers relating to drag:
 +
#  Replace Drag Cubes with Spherical Model
 +
#  Apply Drag as Acceleration Instead of Force
 +
#  Apply Drag To Non-Physical Parts
 +
#  Apply Non-Physical Part Drag At Parent CoM
 +
#  Global Drag Multiplier
 +
#  Drag Cube Multiplier
 +
#  Angular Drag Multiplier
 +
===Thermal===
 +
This subscreen has three sections: GUI, Thermal Escape, and Physics.
 +
GUI- Here, you can change how the player detects heat.
 +
Thermal Escape- Here, you can toggle Radiation, Conduction, and Convection and change the factor at which they affect the universe.
 +
Physics- Here you can change the physics of heat formation with four sliders:
 +
#  Generation Factor
 +
#  Newtonian Temperature Factor
 +
#  Solar Luminosity At Home
 +
#  Solar Insolation At Home
  
== References ==
+
==Contracts==
<references />
+
In this screen you can change all contracts: Active, Offered, Archive, and future.
 +
 
 +
==Kerbals==
 +
[[File:Kerbals, Astronaut Complex.png|thumb|The Kerbals screen seen from the Astronaut Complex]]
 +
This screen has a list of all kerbals, even applicants.
 +
===Create===
 +
This subscreen allows you to create kerbals with any name, gender, role, experience, courage, stupidity, and with attributes including Veteran and Badass.

Revision as of 23:31, 7 August 2019

The debug toolbar upon loading into the game.

The Debug Toolbar is a window designed for testing and debugging purposes. It can however also be used by the average player to ease gameplay, cheat or “goof off”. With RightShift+F12, the toolbar can be opened. As of 1.7.0, it has seven sections: Console, Database, Cheats, Physics, Contracts, Kerbals, and may have additional sections added for game expansions or DLCs. (In the future, outside plugins may be able to add debug screens, but this remains to be seen.)

Console

The console outputs the current states of many of the processes running in the loading and playing of KSP. The Console drop-down menu has six subscreens: Debugging, Input Locks, Performance, Flight Info, Version Info, and DeltaV Info.

Debugging

The debugging screen, upon loading the game.

This screen has five true/false options related to the console log and localization:

  1. Show All Log Errors on the Screen
  2. Show All Log Exceptions on the Screen
  3. Immediately Flush Log File to Disk
  4. Write missing localization keys to log as they are accessed
  5. Show localization keys on-screen(instead of translated text)

Performance

The performance subscreen.

This screen has a performance graph as well as six related displays, in millibytes:

  • Used Heap Size
  • Allocated
  • Reserved
  • Unused Reserve
  • Mono Heap
  • Mono Heap Used

Flight Info

This screen shows the location of the active vessel, the time, and the current reference body and frame.

Version Info

This screen simply shows the current version and any expansions.

Delta-V Info

The main focus of this screen is a list of all the stages and each stage's DeltaV, Thrust, Thrust to Weight Ratio, amongst other stats. Five true/false options for changing the main display:

  1. Show Parts -- adds a part list for each stage
  2. Show Vacuum(true on default) -- toggles between atmosphere and vacuum readouts
  3. Show all stages -- toggles between showing stages with or without thrust
  4. Show Engine Info -- adds an engine specification readout for each stage
  5. Verbose Logging

Database

The Database screen has statistics for the number of assets currently available, along with a tool to reload the asset database(only available in the main menu) and the texts dictionary. Also available is a complete list of all assets used by the game or mods, including a list of assemblies in use by the game.

Cheats

The Cheats screen, seen from the launchpad.

This screen has ten true/false options that change the gameplay of KSP:

  1. Hack Gravity -- Slider changes gravity from 0.01 Gs to 10 Gs.
  2. Unbreakable Joints -- Parts will never disconnect.
  3. No Crash Damage -- Removes the possibility that parts will explode due to collision with other vessels or the ground.
  4. Ignore Max Temperature -- Removes the possibility that parts will explode due to heating.
  5. Infinite Propellant
  6. Infinite Electricity
  7. Pause on Vessel Unpack -- The game will be paused when launching.
  8. Biomes Visible -- Recolors
  9. Part Clipping in Editors
  10. Non-Strict Part Attachment Checks

A tool also exists to modify science/reputation by increments of ±100 or ±10 and funding by increments of ±100000 or ±1000 or to maximize any of these: Technology -- Researches all researchable techs with no Resource cost. Facility -- Upgrades all facilities to the maximum level. Experience -- Trains all your Kerbals to maximum experience. Progression -- Activates the three previous options.

Set Orbit

This subscreen has two commands:

  1. Set Orbit -- Seven numerical entries from which you can set any orbit around any celestial body.
  2. From here you can teleport to within 150 meters of any object.

Difficulty

This subscreen has seven true/false options which are set to true upon startup of a new savegame, but can be set to false to increase difficulty.

  1. Allow revert to launch
  2. Allow revert to editor
  3. Allow quick saving
  4. Allow quick loading
  5. Ignore agency mindset(False on default)

Object Thrower

The object thrower in use.

Like the legacy Whack-A-Kerbel, this subscreen allows you to throw either a cube or a sphere, at any mass, size or speed, by middle-clicking.

Physics

The physics subscreen from the launchpad.

This screen has options to load, save, and change the physics database, to visualize auto struts, and for orbit targeting.

Aero

This subscreen has three true/false options that change the way aero data is visualized for the player: Display Aero Data in action menus Display Aero Data GUI Display Aero Forces in Flight Force Display Scale Also available are three modifiers that allow you to physically change aero forces:

  1. Global Lift Multiplier
  2. Lift/Drag Multiplier
  3. Body Lift Multiplier

Drag

First on this subscreen is an option to turn on or off drag itself. Also available is seven options and modifiers relating to drag:

  1. Replace Drag Cubes with Spherical Model
  2. Apply Drag as Acceleration Instead of Force
  3. Apply Drag To Non-Physical Parts
  4. Apply Non-Physical Part Drag At Parent CoM
  5. Global Drag Multiplier
  6. Drag Cube Multiplier
  7. Angular Drag Multiplier

Thermal

This subscreen has three sections: GUI, Thermal Escape, and Physics. GUI- Here, you can change how the player detects heat. Thermal Escape- Here, you can toggle Radiation, Conduction, and Convection and change the factor at which they affect the universe. Physics- Here you can change the physics of heat formation with four sliders:

  1. Generation Factor
  2. Newtonian Temperature Factor
  3. Solar Luminosity At Home
  4. Solar Insolation At Home

Contracts

In this screen you can change all contracts: Active, Offered, Archive, and future.

Kerbals

The Kerbals screen seen from the Astronaut Complex

This screen has a list of all kerbals, even applicants.

Create

This subscreen allows you to create kerbals with any name, gender, role, experience, courage, stupidity, and with attributes including Veteran and Badass.