Project

General

Profile

Guide » History » Version 24

Squelch, 08/24/2017 10:41 AM
More link repairs

1 2 TriggerAu
h1. Information on Support and Bug Reporting
2 1 Squelch
3 20 TriggerAu
The Kerbal Space Program Bugtracker is the place where bugs can be reported for the attention of Squad. 
4 1 Squelch
5 20 TriggerAu
There is a team of testers and other interested people, hard working volunteers, who look through these bugs and to assist people who have issues, as well as helping to identify when bugs need to be raised to the attention of developers. These volunteers are experienced KSP players who give their valuable personal time to assist other players of the game. Please be respectful of these peoples commitment and keep in mind that the better and more complete any submitted reports are the faster these can be processed, investigated and escalated. 
6 20 TriggerAu
7 20 TriggerAu
Please keep in mind that while best endeavors are made to prevent bugs from slipping into released code they are a part of software development that is a reality. While they can be immensely frustrating when they manifest at the wrong time, do try and investigate/report them in a methodical and complete manner. The better the input in a bug report the better the chance that someone can help identify it/fix it and improve the experience for all, so if it looks like nothing has happened to your report, please review it and see if it can be improved?
8 2 TriggerAu
9 21 TriggerAu
h2. A note on Modded Installs (for PC Users)
10 2 TriggerAu
11 19 Squelch
As it is the place for raising issues to the Core Developers, the bugtracker is only targeted at Unmodded installations of KSP. The developers don't run modded installs and are focused on providing the most stable core experience that they can. Modders can then build on this stable foundation. Furthermore, Mods can introduce unwanted influences that are sometimes hard to track, even if they outwardly deal with something else unrelated. Please consider the testers and ultimately developers time in getting to the heart of the bug as quickly as possible. *We therefore kindly ask that any suspected bugs are reproduced and verified in a clean game before reporting.*
12 2 TriggerAu
13 22 hermes47
If you are experiencing issues with KSP and cannot replicate them in a stock install then there is a really good group on the Forum where many of the testers and modders hang out and try and help with issues on Modded Installs. Here is a link to the "Modded Support Forum":http://forum.kerbalspaceprogram.com/index.php?/forum/70-technical-support-pc-modded-installs/
14 2 TriggerAu
15 2 TriggerAu
Issues logged for modded installs that cannot be replicated will be looked at, but will likely be closed if there is not enough compelling information for a non mod induced bug to pass them to the devs for attention. A good example of this exception might be; a fault in the plugin API that can only be demonstrated by mod installation. Please do involve the mod author(s) in this if you are not one of them out of courtesy.
16 2 TriggerAu
17 4 TriggerAu
h2. So whats important when looking at a bug?
18 1 Squelch
19 21 TriggerAu
When investigating strange behavior and reporting a bug there are some key pieces of information that can help pinpoint where a bug may be occurring and also help others to try and replicate the behavior. Try and ensure that you have as much of the following information as you can:
20 21 TriggerAu
* *KSP version* including Windows, Mac, Linux, PS4 or XBox;
21 21 TriggerAu
* On PC versions whether its 32 or 64-bit, and if it's Steam;
22 21 TriggerAu
* A *detailed explanation* of what happened and what you were trying to accomplish;
23 21 TriggerAu
* A *screenshot* of your craft or any relevant screens (or even a *video* if you are feeling demonstrative or its difficult to describe in text);
24 21 TriggerAu
25 21 TriggerAu
On PC Versions there are addition files and info that can be provided to improve the resolution of bugs:
26 1 Squelch
* A *.craft file or save files* if relevant
27 1 Squelch
* The *ouput_log.txt or player.log* file KSP creates when it launches and, if applicable, the *crash log* KSP has generated when the program crashed (note that this is not the KSP.log file)
28 1 Squelch
* A detailed list of *system specifications*
29 1 Squelch
* Are you running a *clean installation*, or have you updated and some of your persistence or craft files might be older versions, *if so which version(s)*
30 1 Squelch
31 2 TriggerAu
To find out how to obtain this information, please see below:
32 1 Squelch
33 2 TriggerAu
{{collapse(KSP Version)
34 21 TriggerAu
p((. To obtain your version, use the following:
35 21 TriggerAu
* Easiest is to look in the lower right corner of the main menu screen.
36 21 TriggerAu
* On PC there are two files that you can look in as well
37 21 TriggerAu
** Open the "buildID.txt" file located in your installation folder. The version is listed in the first line of the file.
38 21 TriggerAu
** Open the "readme.txt" file located in your installation folder. The version is listed just below the ASCII art in the top of the file.
39 2 TriggerAu
40 21 TriggerAu
p((. The KSP version will look something like "0.24.2.559". Specifying the platform and version in any reports allows us to avoid recommending things that are not applicable to your platform or operating system. Also, there are some issues which only turn up in specific platforms, operating systems or specific versions of KSP.
41 2 TriggerAu
}}
42 1 Squelch
43 2 TriggerAu
{{collapse(Screenshots / Videos)
44 21 TriggerAu
p((. On the PC platforms KSP is capable of taking screenshots in-game by pressing F1. The screenshots are stored in the KSP installation folder under a folder called [SCREENSHOTS]. On Consoles you can use the built in screen capture tools, then download the file using a number of sharing methods.
45 2 TriggerAu
46 21 TriggerAu
You can upload screenshots directly to the issue using the files button, or using any image sharing site. 
47 21 TriggerAu
48 2 TriggerAu
p((. Screenshots usually illustrate the problem better than trying to explain with several paragraphs. Feel free to mark up your screenshots with a noticeable colour to highlight important points. Also, avoid excessive drawing since it may end up making your problem less clear.
49 2 TriggerAu
50 2 TriggerAu
p((. Please attach these files directly or as a link.
51 2 TriggerAu
52 2 TriggerAu
p((. Video's can be very useful when trying to describe visual challenges or hard to describe situations, and sometimes you might be asked to provide one of these if people are having trouble "seeing" it for themselves. Videos can be recorded and uploaded to Youtube or a similar video sharing site, and the link added in an update. Don't worry, you don't have to speak if you don't feel you can. Annotations are generally much easier to do and see.
53 2 TriggerAu
}}
54 1 Squelch
55 21 TriggerAu
{{collapse(Craft & Save Files - PC platforms only)
56 17 Squelch
p((. In the KSP installation folder, you should be able to find a folder called [SAVES]. Open this folder and select the save folder name that applies. Inside you will find three things: one or more files (usually two) with a .sfs extension and a folder called [SHIPS].
57 17 Squelch
* Craft Files: Any ships that you created will be stored in the [SHIPS] directory under [SPH] for Space Plane Hangar vehicles or [VAB] for Vehicle Assembly Building vehicles. Craft files are named the same as you have titled your ship in KSP and have a .craft extension.
58 2 TriggerAu
* Save Files: To attach a save file, you need the file called persistent.sfs (or any file ending in .sfs in the [SAVES] folder - generally quicksaves, but also named saves).
59 2 TriggerAu
60 2 TriggerAu
p((. CRAFT NOTE: When attaching craft files, please ensure that no mods or parts are used in the creation of the craft. we won't be able to open them - see "Modded Installs":http://bugs.kerbalspaceprogram.com/projects/kspdevelop/wiki/SupportInformation#A-note-on-Modded-Installs
61 2 TriggerAu
SAVE NOTE: Using ALT+F5 to quicksave will allow you to give the save file a specific name, which can make it easier to find for uploading.
62 2 TriggerAu
63 2 TriggerAu
p((. Please attach these files directly or as a link.
64 2 TriggerAu
65 2 TriggerAu
p((. Craft files should be provided whenever you are having an issue with a specific craft, or have found a potential bug that you find easiest to reproduce with that specific craft. Having the craft file to work with will make it much quicker and simpler for us to diagnose and attempt to replicate the issue, and hopefully get it resolved much quicker.
66 2 TriggerAu
}}
67 2 TriggerAu
68 21 TriggerAu
{{collapse(Crash/Output Logs - PC platforms only)
69 17 Squelch
p((. When KSP crashes it will generate a folder with files with details surrounding the crash. Usually a window will pop up ingame asking you to send this information to the developers, along with the name of the folder. You can find this folder in the KSP install directory.
70 2 TriggerAu
71 2 TriggerAu
p((. If KSP doesn't crash, start KSP and cause the problem. Quit KSP and find the output_log.txt (not the KSP.log) at the location below:
72 2 TriggerAu
* Windows: KSP_win\KSP_Data\output_log.txt -OR- KSP_win64\KSP_x64_DATA\output_log.txt (depending on which used)
73 2 TriggerAu
- In case you installed KSP into a Windows protected directory (C:\Users, C:\Program Files or C:\Windows\ and their subfolders) the output log file may be stored in the folder called C:\Users\[Username]\Appdata, this folder is usually hidden so you should enable the view hidden folders option (more information). Note that for the demo you should find the output_log.txt file located in the KSP_Data folder.
74 2 TriggerAu
- Steam users should right click KSP in Steam, click on Properties, then in the Properties box, click Local Files, then Browse Local Files.
75 2 TriggerAu
* Mac OSX: Open Console, on the left side of the window there is a menu that says 'files'. Scroll down the list and find the Unity drop down, under Unity there will be Player.log Aka Files>~/Library/Logs>Unity>Player.log
76 2 TriggerAu
* Linux: The log is written to /home/user/.config/unity3d/Squad/Kerbal Space Program/Player.log
77 2 TriggerAu
78 2 TriggerAu
p((. Please attach these files directly or as a link
79 2 TriggerAu
80 2 TriggerAu
p((. The output and crash logs are useful because they help us understand exactly what you were doing when the issue happened by providing a "play-by-play reenactment" (in text form) of your KSP session. Anything out of the ordinary will often show up in the log files, and it gives us a good idea of where to start looking for solutions.
81 2 TriggerAu
}}
82 2 TriggerAu
83 21 TriggerAu
{{collapse(System Specifications - PC platforms only)
84 2 TriggerAu
p((. The method to gathering system specifications will vary over different operating systems, choose which one applies to you.
85 2 TriggerAu
* Windows: open the start menu and select (or type) 'run'. Type in 'dxdiag' and press the [ok] button. A new program will pop up called the DirectX Diagnostic Tool. On the bottom of this screen a [Save All Information] button is located. Press it and save the text file to a location you will remember.
86 2 TriggerAu
* Mac OSX: use the "System Report" app from the 'About This Mac' menu and hit cmd+s to save the file in .rtf format in a location you will remember.
87 2 TriggerAu
* Linux: for linux an application called 'hardinfo' will gather all required information. Save the information to a location you will remember.
88 2 TriggerAu
89 2 TriggerAu
p((. Please attach these files directly or as a link.
90 2 TriggerAu
91 2 TriggerAu
p((. Having detailed system specifications is useful in more ways than one. At a glance, we can tell if your system should be experiencing any performance issues, and whether the system is correctly registering and utilizing an installed video card, sound card, and so forth. All the hardware information for your system is contained within these files (and is extensive). As such, it's a must-have for those of us trying to diagnose and solve certain issues.
92 2 TriggerAu
}}
93 2 TriggerAu
94 2 TriggerAu
95 2 TriggerAu
h2. Reporting that bug
96 2 TriggerAu
97 2 TriggerAu
The key thing about reporting a bug is being able to include enough detail in the report so that the behavior can be replicated by someone else - especially by a dev when they are looking at your submission. Anything we can do to improve the turn around on bugs is a great help in the efficiency of coding the fixes.
98 2 TriggerAu
99 2 TriggerAu
Below you will find an example of the format used by the QA and Exp teams to log issues during testing. We've found it a quite effective way to include all the relevant info. You'll see how the report clearly states how the bug was encountered and how it can be reproduced with as few moves as possible. It is as helpful as a bug report can be, and this helps Squad narrow down the problem.
100 2 TriggerAu
101 2 TriggerAu
102 2 TriggerAu
h3. An Ideal Example
103 2 TriggerAu
104 1 Squelch
{{collapse(Ideal Example image)
105 14 Squelch
!Ideal_report.PNG!
106 1 Squelch
}}
107 11 Squelch
{{collapse(Ideal Example Notes)
108 11 Squelch
> *Subject* Controlling all Craft in Physics Range %{color:red}- A short descriptive title works best%
109 11 Squelch
> %{color:red}Set the fields at the top accordingly - some are mandatory. see below for details%
110 2 TriggerAu
> *Description:* All craft within physics range respond to control inputs. %{color:red}- A brief summary of the issue, This will be seen in the issues list.%
111 2 TriggerAu
> 
112 2 TriggerAu
> *Steps to Replicate:*
113 2 TriggerAu
> 1) Make a Mk1 pod and hold it down with a TT-18A Launch Stability Enhancer (yes, just the two parts), and launch the craft with a kerbal on board.
114 2 TriggerAu
> 2) Hold ALT-W to push the pitch trim all the way to 7 notches nose down. (Just short of max.)
115 2 TriggerAu
> 3) Turn on SAS (important)
116 2 TriggerAu
> 4) Stage to release the pod to the ground, then go EVA
117 2 TriggerAu
> 5) Walk forward with your EVA kerbal
118 2 TriggerAu
> 
119 2 TriggerAu
> *Expected:* Only the Kerbal should be controlled. %{color:red}- this is optional, so no need to include obvious statements.%
120 2 TriggerAu
>
121 2 TriggerAu
> *Result/Observed:* Pod will flip over while controlling kerbal. Pod stops when kerbal stops walking.
122 2 TriggerAu
> 
123 2 TriggerAu
> *Fixes/Workarounds:*
124 2 TriggerAu
> - Zero out trim (ALT+X) on each craft within physics range.
125 2 TriggerAu
> 
126 2 TriggerAu
> *Notes:*
127 2 TriggerAu
>  This behaviour may be related to issue number xxx
128 2 TriggerAu
>  Keys for controlling each vessel must be mapped the same (i.e. Walking forward for a kerbal & pitching a pod must both be ‘W’).
129 1 Squelch
>
130 2 TriggerAu
> - %{color:red}Files added%
131 2 TriggerAu
> - Images Link: http://imgur.com/a/LEeCB
132 2 TriggerAu
> - Craft File %{color:red}if required%
133 2 TriggerAu
> - Log File %{color:red}if required%
134 2 TriggerAu
}}
135 11 Squelch
136 2 TriggerAu
If you wish to format your report to make it easier to read, please refer to the "Redmine formatting page":http://www.redmine.org/projects/redmine/wiki/RedmineTextFormatting
137 2 TriggerAu
138 2 TriggerAu
h3. Extra Classification
139 2 TriggerAu
140 2 TriggerAu
Further to the content in the body of the issue there is some extra information you can provide by categorizing the issue using some of the fields in the bug tracker. Don't be put off if you don't know what to choose, there are always helpful people around who can help triage the issue too
141 2 TriggerAu
142 2 TriggerAu
143 2 TriggerAu
There are two types of Issues for reporting on the tracker that are available to use:
144 2 TriggerAu
145 2 TriggerAu
* *Bug*: There is something wrong with the game that you'd like to report.
146 2 TriggerAu
* *Feedback*: Where we find opinions and balance. 
147 2 TriggerAu
148 2 TriggerAu
{{collapse(Bug)
149 2 TriggerAu
p)). Pretty self-explanatory; this issue type is for behaviour you encounter that appears to be unexpected or not intended by design. If you suspect that the issue is based upon opinion it is more than likely not a bug, but feedback instead. Excessive consumption rates would be feedback, not a bug. But lack of resource consumption or incorrect displaying of consumption would be a bug.
150 2 TriggerAu
}}
151 2 TriggerAu
152 2 TriggerAu
{{collapse(Feedback)
153 2 TriggerAu
p)). When you encounter behavior that you feel is unexpected, but perhaps not unintended, this is the issue type you would use. Generally, you should try to suggest alternate behavior that you feel would be more suitable or balanced. Well reasoned suggestions on improvements and comments on how the game plays overall are welcome here.
154 2 TriggerAu
}}
155 2 TriggerAu
156 2 TriggerAu
h3. How Priority Helps
157 2 TriggerAu
158 2 TriggerAu
Priorities help us to figure out which issues need inspecting, reviewing and fixing first and foremost. Thus, the priority assigned to an issue needs to be as objective as possible; not a result of how much it affected your mission or current gameplay goals, but how much it affected the game itself. If youre unsure the following table should assist you in deciding what priority to assign an issue.
159 2 TriggerAu
160 2 TriggerAu
{{collapse(Priority Table)
161 2 TriggerAu
|_.Priority|_.Description|_.Example Case|
162 2 TriggerAu
|*%{color:red}Critical%*|A large portion of the game is unplayable.|SPH is non-functional.|
163 2 TriggerAu
|*%{color:orange}High%*|Game Breaking|Game crashes when transitioning SoI|
164 2 TriggerAu
|*Normal*|Game Affecting, but not Game Breaking.|SAS is draining electricCharge incorrectly.|
165 2 TriggerAu
|*Low*|Visual issue that occurs often, or Gameplay issue that can be avoided.|Landing Strip has texture artifacts.|
166 2 TriggerAu
|*Very Low*|A visual issue that appears rarely and doesn’t affect gameplay.|Audio-related error appears in log on occasion.|
167 2 TriggerAu
|*Unworthy*|An issue that is slightly bothersome, occurs rarely, is not easily discovered, or is a matter of preference.|Collision mesh of some parts are slightly off.|
168 2 TriggerAu
}}
169 2 TriggerAu
170 2 TriggerAu
h3. Categorizing Issues
171 2 TriggerAu
172 2 TriggerAu
Setting a category helps us get things to the right developer when they get to that stage. You can see the list and details on the [[TrackerCategories| Tracker Categories]] page
173 2 TriggerAu
174 2 TriggerAu
h2. Some Guidelines on Bug Reporting
175 2 TriggerAu
176 2 TriggerAu
Some helpful information and ideas to keep in mind as you are writing things up. feel free to use the headings here as reminders and come back to these for more detail if you need it:
177 2 TriggerAu
178 2 TriggerAu
{{collapse(One Bug = One Ticket)
179 2 TriggerAu
p)). Each bug should have its own Issue ticket. Please try and break down your issue into smaller chunks where possible. Compound issues do arise, but each element may lay in different parts of the game. We much prefer reports for each section so they can be dealt with in isolation, but with knowledge of the connections. We are able to set relationships between issues, so please indicate in your report if you believe those connections exist.
180 2 TriggerAu
}}
181 2 TriggerAu
182 2 TriggerAu
{{collapse(Search)
183 10 Squelch
p)). Please be sure to search for existing reports before submitting your own. Using the search button (top right) you can enter keywords separated by a space. This will return all issues that contain all or combinations of those keywords as a list. Please review these to see if they describe your particular issue. If one exists, please feel free to add extra information to it. 
184 1 Squelch
185 10 Squelch
Many issues are related to each other, and we are constantly adding links to these so they are easier to find. Any related issues that might also describe what you see can also have pertinent information added if you feel it is missing. We welcome any suggestions on relationships you feel are missing.
186 10 Squelch
187 10 Squelch
If an existing report describes exactly what you see and you have nothing to add, please do add a comment about some aspect so we know how widespread the issue might be. Also check against the platform to see if it matches your own.
188 10 Squelch
189 1 Squelch
Advanced search allows for much finer grained results. 
190 2 TriggerAu
191 10 Squelch
Any duplicate reports will be marked as such, and a link to the original added. Please also feel free to point out any duplicates. 
192 9 Squelch
}}
193 1 Squelch
194 9 Squelch
{{collapse(Clean Installations)
195 9 Squelch
p)). It's highly desirable that you can recreate the issue with a Stock Install. We appreciate that there are many game enhancing mods out there, and that you may be using them, so please also consider using a KSP install that has never had mods installed in it (as opposed to deleting mod directories). 
196 9 Squelch
197 9 Squelch
We recommend having two KSP installations: 
198 9 Squelch
# Completely stock, with no mods ever installed
199 9 Squelch
# Your "main" playing version of KSP with any modifications you desire. 
200 9 Squelch
201 9 Squelch
Please note: savegames may not be interchangeable between a stock install and a modded install. Even if there are no extra parts, some game parameters may have been changed that have consequences for a stock game.
202 9 Squelch
203 9 Squelch
This ensures a solid report while preventing accidental damage to your main save games when replicating bugs. 
204 2 TriggerAu
}}
205 2 TriggerAu
206 2 TriggerAu
{{collapse(Steps to Replicate)
207 2 TriggerAu
p)). Try to keep it simple, stating facts in as clean and concise a manner as possible.
208 2 TriggerAu
209 2 TriggerAu
p)). For Squad to find a bug, they need a way to consistently cause it to happen in a mod-free, clean install of the game, and using a completely new spacecraft (when possible). If at all possible, try to find the minimal set of actions that will cause a bug to happen. That can be extremely helpful to narrow down the source of the problem. If the bug can only be reproduced with a specific spacecraft design, please include a .craft file of the simplest design where the issue still happens in your report.
210 2 TriggerAu
211 16 sal_vager
p)). Remember, steps to reproduce the issue help the most. Bug reports like "'I've seen this happen, and it ruined my mission attempt" don't help replicate the issue. They just state it happened, but it doesn't help find the source of the problem. On the other hand, extremely detailed reports of what was happening when the bug took place are also a bad idea because it's difficult to dig through a wall of text to figure out what happened. 
212 2 TriggerAu
}}
213 1 Squelch
214 1 Squelch
{{collapse(Fixes / Workarounds)
215 1 Squelch
p)). If you found a way to fix the problem in the short term, please post how. This can help out other people who are having the problem, and also allows the bug squashers to focus their efforts.
216 15 Squelch
}}
217 15 Squelch
218 2 TriggerAu
{{collapse(File attachments)
219 5 TriggerAu
p((. You can upload files directly to the issue tracker subject to a maximum file size of 5Mb. If your files (say the crash report folder) exceeds this size, please use any file sharing site (such as Dropbox, Mediafire or File2web). Images can be hosted on imgur which is free to use and allows albums to be built. These sites will give you a link you can include in your posts to share your files.
220 6 TriggerAu
}}
221 1 Squelch
222 1 Squelch
 
223 1 Squelch
224 7 TriggerAu
h2. What Happens Next?
225 7 TriggerAu
226 7 TriggerAu
To read a little bit more about what happens after a bug is submitted you can check out the [[WhatHappensNext|How Bug Reports are Managed - i.e. What Happens Next]] page
227 7 TriggerAu
228 7 TriggerAu
*Follow ups:* Please check your report for replies as very often you may be asked for more information or clarification. Any new discoveries you make after posting are always welcome.
229 12 Squelch
230 12 Squelch
231 7 TriggerAu
232 7 TriggerAu
 
233 7 TriggerAu
 
234 6 TriggerAu
235 6 TriggerAu
h1. Other Support Resources
236 5 TriggerAu
237 1 Squelch
You will also find a lot of good support resources on the Official forum in the sub forums below:
238 24 Squelch
* "PC, Unmodded Support Forum":https://forum.kerbalspaceprogram.com/index.php?/forum/69-technical-support-pc-unmodded-installs/ - interact with other KSP PC users to work on questions or get help with bugs
239 24 Squelch
* "PC, Modded Support Forum":https://forum.kerbalspaceprogram.com/index.php?/forum/70-technical-support-pc-modded-installs/ - a really good group on the Forum where many of the testers and modders hang out and try and help with issues on Modded Installs
240 23 Squelch
* "Console Support Forum":https://forum.kerbalspaceprogram.com/index.php?/forum/81-technical-support-playstation-4-xbox-one/ - interact with other KSP PC users to work on questions or get help with bugs
241 8 TriggerAu
* "Known Issues and Self Help":http://forum.kerbalspaceprogram.com/threads/92228-Known-Issues-Self-Help - Forum thread of known items that can save you a lot of time