Crusader_Decomp/tools/pyghidra_crusader

PyGhidra Crusader Toolkit

This toolkit drives the local PyGhidra fallback workflow for the Crusader Ghidra project.

Defaults

• Ghidra install dir: I:\Apps\ghidra_12.0.4_PUBLIC
• Python env: .venv-pyghidra311
• Python base interpreter: C:\Users\Maddo\.pyenv\pyenv-win\versions\3.11.6\python.exe
• CLI entrypoint: .\.venv-pyghidra311\Scripts\python.exe -m tools.pyghidra_crusader

Bootstrap Or Refresh

Run this from the repo root to create or refresh the local environment against the bundled Ghidra 12.0.4 offline packages:

powershell -ExecutionPolicy Bypass -File .\tools\pyghidra_crusader\bootstrap_env.ps1

The script recreates or refreshes .venv-pyghidra311, then installs these pinned packages from the local Ghidra tree:

• pyghidra==3.0.2 from Ghidra\Features\PyGhidra\pypkg\dist
• ghidra-stubs==12.0.4 from docs\ghidra_stubs

Override the defaults when needed:

powershell -ExecutionPolicy Bypass -File .\tools\pyghidra_crusader\bootstrap_env.ps1 `
  -PythonExe C:\Path\To\python.exe `
  -GhidraInstallDir I:\Apps\ghidra_12.0.4_PUBLIC `
  -VenvPath .\.venv-pyghidra311

Validation

After bootstrap, validate package versions and the project-open path:

.\.venv-pyghidra311\Scripts\python.exe -m tools.pyghidra_crusader project-files

If you need to target a different installed Ghidra tree temporarily, set GHIDRA_INSTALL_DIR or pass --install-dir to the CLI.