-
Notifications
You must be signed in to change notification settings - Fork 32
Bug Reporting
Read this page before reporting a bug. If you ignore these directions, your report may be ignored.
Has it already been reported?
Check both the issue tracker and the forum thread (last 10-20 pages) to see if your issue has already been reported. If so, see if you can contribute additional information, but do not file an additional report. If you're not sure if your issue is related, comment on the existing issue first.
Is it intended behavior? / Are you doing it right?
Make sure you're encountering a bug and not just an intended aspect of the mod. If a part isn't working, make sure you have enough electrical power. Check the version history to see if what you're experiencing was added as a feature. As always, check the forum thread.
Is it actually a Kethane problem?
See if the problem occurs if you uninstall Kethane, and also see if it occurs when Kethane is the only mod installed. Conflicts between Kethane and other mods are rare. The most common cause of false conflict reports is running out of memory, so make sure that's not the case. There are also a handful of [known issues](Known Non–Kethane Issues) that are not caused by Kethane.
Are you up-to-date?
Only the latest version of Kethane and the latest version of KSP are supported. Make sure both are completely up-to-date before filing a report.
Bug reports and feature requests should be filed on the issue tracker here on Github. Please read the following guidelines for filing reports; it's very difficult for me to help otherwise.
- Be specific. The title and description of your report should describe exactly what isn't working. Provide reproduction steps if you can, and explain in detail the symptoms of the issue and what causes it.
-
Provide your output log. This file can be found at
KSP/KSP_Data/output_log.txt. This contains debug information about your last KSP session. Without this, I cannot diagnose most issues. If your report has precise reproduction steps and the cause is obvious, the log is optional. When in doubt, please include it. - List other mods. While mod compatibility issues are rare, you should list all the other mods you have installed.
- System specifications. Include your hardware specifications (CPU, GPU, RAM) and your operating system. Also include whether you're using Steam or the manual download of KSP and the folder where KSP is installed.
- One issue per report. If you have multiple issues, submit multiple reports. Don't lump everything together; it becomes difficult to track disparate issues that way.
If you don't have enough information to file a bug report, you may ask questions on the forum thread. Do not send me private messages about bugs unless you believe the bug is an exploitable security issue.