From 8fc7d8d918142a85e6d02fb52b33ed984cfcd874 Mon Sep 17 00:00:00 2001 From: KeybadeBlox Date: Sat, 21 Mar 2026 15:23:03 -0400 Subject: [PATCH] Add recommended tool versions to Getting Started --- documentation/gettingstarted.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/documentation/gettingstarted.md b/documentation/gettingstarted.md index 626f25e..695d8b3 100644 --- a/documentation/gettingstarted.md +++ b/documentation/gettingstarted.md @@ -24,12 +24,22 @@ You'll need a few things to get a decompilation workflow ready: can find it - The [Git](https://git-scm.com/) version control tool to clone and work on this repository +- [Java](https://jdk.java.net/archive/) 21 or later, as required by Ghidra. + You may already have it; Minecraft apparently provides Java 21, for instance. + Later versions should also work; 21 and 25 specifically have been confirmed + to work fine. - The [Ghidra](https://github.com/NationalSecurityAgency/ghidra) reverse - engineering tool to analyze and browse the executable + engineering tool to analyze and browse the executable (version 12.0.3 is + strongly recommended, as the extensions have releases for this exact version) - The [XBE extension](https://github.com/XboxDev/ghidra-xbe) for Ghidra to - import and analyze the JSRF executable + import and analyze the JSRF executable (version will depend on your Ghidra + version; ideally it will match your Ghidra version, like + [12.0.3](https://github.com/XboxDev/ghidra-xbe/releases/tag/build-202602250354)) - The [delinker extension](https://github.com/boricj/ghidra-delinker-extension) - for Ghidra to export object files from the executable + for Ghidra to export object files from the executable (version again depends + on Ghidra version; + [v0.8.0](https://github.com/boricj/ghidra-delinker-extension/releases/tag/v0.8.0) + provides a download for Ghidra 12.0.3 specifically) - The [objdiff](https://github.com/encounter/objdiff) code diffing tool to compare your C++ code's compiled output to the delinked object files