Difference between revisions of "Debug Toolbar"

From Kerbal Space Program Wiki
Jump to: navigation, search
m (Only available during flight)
(Set Position)
 
(48 intermediate revisions by 17 users not shown)
Line 1: Line 1:
[[File:Debug Toolbar.png|thumb|The debug toolbar open with the tab “Cheats”]]
+
[[File:Console, upon loading.png|thumb|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”.
+
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 toolbar can be opened with Control+Alt+F12 or Alt+Shift+F12 on windows, or RShift+F12 on Linux. It can also be opened on the console versions by pausing the game and pressing this sequence of buttons on the controller (See [[w:Konami Code|Konami Code]]):<br />
 +
{{key press|up}}{{key press|up}}{{key press|down}}{{key press|down}}{{key press|left}}{{key press|right}}{{key press|left}}{{key press|right}}<br />
 +
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.
+
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]]|F12}} 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 -- Note that for unknown reasons, this cheat can cause modded engines to overheat and explode (an example being the cryogenic engines in Bluedog Design Bureau)
 +
#  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.
  
== Gameplay Tweaks == <!-- using capitalisation from Squad -->
+
===Set Orbit===
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.
+
This subscreen has two commands:
 +
#  Set Orbit -- Seven numerical entries from which you can set any orbit around any celestial body. For a circular orbit, Semi-Major Axis is the distance from the center of the body. Add the radius of the body to your desired altitude to get the value you should enter there. You can also set it to 0 and let the safety check enter the lowest safe orbit for you.
 +
#  Rendezvous -- From here you can teleport to within 150 meters of any vessel, asteroid, or comet.
  
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>
+
===Set Position===
 +
Allows you to teleport to a body at zero speed, rather than at an orbital speed.
  
== References ==
+
Check "Use Middle Mouse Click to set Position", then do so from the map screen to specify the latitude and longitude automatically.
<references />
+
 
 +
If you're using it to test an aircraft at altitude, uncheck "Ease to ground" and set pitch to -45 to -90 to prevent stalling and lack of control since you unfortunately can't specify a starting speed.
 +
 
 +
===Object Thrower===
 +
[[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.
 +
 
 +
===Difficulty===
 +
This subscreen has seven true/false options which are set to true upon startup of a new savegame with the default difficulty settings, but can be set to false to increase difficulty. Some of these can also be changed from the main Settings menu while loaded into a game, as well as others.
 +
#  Allow stock vessels in career mode
 +
#  Lost crews respawn
 +
#  Allow revert to launch
 +
#  Allow revert to editor
 +
#  Allow quick saving
 +
#  Allow quick loading
 +
#  Ignore agency mindset(False on default)
 +
 
 +
==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
 +
 
 +
==Contracts==
 +
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.
 +
 
 +
[[Category: Game interface]]

Latest revision as of 06:58, 25 March 2023

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”. The toolbar can be opened with Control+Alt+F12 or Alt+Shift+F12 on windows, or RShift+F12 on Linux. It can also be opened on the console versions by pausing the game and pressing this sequence of buttons on the controller (See Konami Code):

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 -- Note that for unknown reasons, this cheat can cause modded engines to overheat and explode (an example being the cryogenic engines in Bluedog Design Bureau)
  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:

  1. Technology -- Researches all researchable techs with no Resource cost.
  2. Facility -- Upgrades all facilities to the maximum level.
  3. Experience -- Trains all your Kerbals to maximum experience.
  4. 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. For a circular orbit, Semi-Major Axis is the distance from the center of the body. Add the radius of the body to your desired altitude to get the value you should enter there. You can also set it to 0 and let the safety check enter the lowest safe orbit for you.
  2. Rendezvous -- From here you can teleport to within 150 meters of any vessel, asteroid, or comet.

Set Position

Allows you to teleport to a body at zero speed, rather than at an orbital speed.

Check "Use Middle Mouse Click to set Position", then do so from the map screen to specify the latitude and longitude automatically.

If you're using it to test an aircraft at altitude, uncheck "Ease to ground" and set pitch to -45 to -90 to prevent stalling and lack of control since you unfortunately can't specify a starting speed.

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.

Difficulty

This subscreen has seven true/false options which are set to true upon startup of a new savegame with the default difficulty settings, but can be set to false to increase difficulty. Some of these can also be changed from the main Settings menu while loaded into a game, as well as others.

  1. Allow stock vessels in career mode
  2. Lost crews respawn
  3. Allow revert to launch
  4. Allow revert to editor
  5. Allow quick saving
  6. Allow quick loading
  7. Ignore agency mindset(False on default)

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:

  1. Display Aero Data in action menus
  2. Display Aero Data GUI
  3. Display Aero Forces in Flight
  4. 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.