# What you will need today:
- Ghidra (get [here](https://github.com/NationalSecurityAgency/ghidra/releases/download/Ghidra_11.4.2_build/ghidra_11.4.2_PUBLIC_20250826.zip))
- jdk-21 is needed, if you have debian based linux:

    sudo apt install openjdk-21-jdk

- PwnAdventure (get [here](https://www.pwnadventure.com/#downloads))

# Troubleshooting
## Linux
### The following error pops up when i try to run the game: `./PwnAdventure3-Linux-Shipping: error while loading shared libraries: libssl.so.1.0.0`:
- #### Arch Linux

Run the following in a terminal:

    git clone https://aur.archlinux.org/openssl-1.0.git
    cd openssl-1.0
    makepkg -s
    mv pkg/openssl-1.0/usr/lib/libcrypto.so.1.0.0 pkg/openssl-1.0/usr/lib/libssl.so.1.0.0 YOUR_PWNADVENTURE_INSTALLATION_FOLDER/PwnAdventure3/Binaries/Linux/

> [!CAUTION]
> If you get a public key error, add the missing PGP signature by running:
> ```
> gpg --recv-key XXXXXXXXXXXXXXXX
> ```

- #### Ubuntu

Download `libssl1.0.0_1.0.2g-1ubuntu4.20_YOUR_ARCHITECTURE.deb` from [this](https://archive.ubuntu.com/ubuntu/pool/main/o/openssl) site.

Install the package by running:

    sudo dpkg -i libssl1.0.0_1.0.2g-1ubuntu4.20_YOUR_ARCHITECTURE.deb

For Ubuntu 64bit

    wget http://snapshot.debian.org/archive/debian/20170705T160707Z/pool/main/o/openssl/libssl1.0.0_1.0.2l-1~bpo8%2B1_amd64.deb
    sudo dpkg -i libssl1.0.0.deb

If you need multiarch

    wget http://snapshot.debian.org/archive/debian/20190501T215844Z/pool/main/g/glibc/multiarch-support_2.28-10_amd64.deb
    sudo dpkg -i multiarch-support.de

### The game lags/takes a long time to load in a Linux VM:

- Give the Virtual Machine more RAM/CPU cores.
- Increase the video memory in your VM settings (Basic Settings > Display > Screen).
- Enable `3D Acceleration` in your VM settings (Expert Settings > Display > Screen).

### Mouse input does not work
- Disable mouse integration.
- Press `RIGHT CTRL + C` to enable full screen mode

## Windows

Everything should work as expected :)

## macOS

> [!WARNING]
> macOS is not supported.