39 lines
2.7 KiB
Text
39 lines
2.7 KiB
Text
{{exclusive|java}}
|
|
This tutorial is to help you obtain crash reports generated by ''Minecraft''. Crash reports can help developers confirm and diagnose issues and should be included in bugs on the [[Bug tracker]] whenever possible.
|
|
|
|
== Obtaining the crash report file ==
|
|
* Navigate to your game directory as specified in your installation in the [[Launcher]].
|
|
:* On Windows, it is <code>%appdata%\.minecraft\</code> by default
|
|
:* On MacOS, it is <code>~/Library/Application Support/minecraft</code> by default
|
|
:* On Linux, it is <code>~/.minecraft</code> by default
|
|
* Navigate into the <code>crash-reports</code> directory in the game directory.
|
|
:* If the crash reports directory does not exist, the game may have crashed of a JVM failure, and one or multiple <code>hs_err_pid#####.log</code> file may be present in the game directory instead. Upload this file.
|
|
* There should be files named like <code>crash-yyyy-mm-dd_hh.mm.ss-(client/server).txt</code>. The crash reports are named by the time of crash, with which you can decide which file is your crash report.
|
|
|
|
== Deobfuscating the crash report file ==
|
|
{{see also|Obfuscation map}}
|
|
Deobfuscating the crash report file with [[obfuscation map]]s and uploading the deobfuscated version to the [[Bug tracker]] may make it easier for [[Mojang]] developers to track down the cause of the crash.
|
|
|
|
Retrace is the tool to parse obfuscation maps.<ref>{{link|url=https://www.guardsquare.com/en/products/proguard/manual/retrace|title=ProGuard manual | Retrace|website=Guardsquare}}</ref> To run retrace, you need to have [[Tutorials/Update Java|Java 8 or above]] installed on your device.
|
|
|
|
You can download proguard from [https://github.com/Guardsquare/proguard/releases/ their GitHub releases]. Decompress the downloaded archive, such as [https://github.com/Guardsquare/proguard/releases/download/v7.4.2/proguard-7.4.2.zip proguard-7.4.2.zip], into a directory. Enter its {{code|bin}} directory. There will be {{code|proguardgui.bat}} and {{code|proguardgui.sh}} executable files available.
|
|
* On Windows, run the {{code|proguardgui.bat}} file.
|
|
* On Unix systems, run the {{code|proguardgui.sh}} file.
|
|
A Java application will launch.
|
|
<gallery>
|
|
Proguard_7.0.1_User_Interface.png|Proguard User Interface
|
|
Proguard_7.0.1_User_Interface_Retrace.png|ReTrace Section
|
|
</gallery>
|
|
On the left side of the User Interface, there is a section, "ReTrace". Enter that section.
|
|
|
|
Download the [[obfuscation map]] you need for "Mapping file". Paste the crash report. You can then obtain the deobfuscated crash report for sharing.
|
|
|
|
== References ==
|
|
{{reflist}}
|
|
|
|
== Navigation ==
|
|
{{Navbox tutorials|technical}}
|
|
{{Navbox Java Edition}}
|
|
|
|
[[de:Anleitungen/Einen Bug melden]]
|
|
[[zh:Tutorial:获取崩溃报告]]
|