Windows Setup (WSL)

Diese Anleitung beschreibt die Installation und Ausführung von RetroRPG unter Windows mit dem Windows Subsystem for Linux (WSL).

1. WSL + Ubuntu 24.04 installieren

In Windows PowerShell als Administrator ausführen:

wsl --install -d Ubuntu-24.04
wsl --set-default-version 2

Danach Ubuntu 24.04 aus dem Startmenü starten und einen Linux-Benutzer erstellen.

2. Ubuntu aktualisieren & Dependencies installieren

sudo apt update
sudo apt upgrade -y
sudo apt install -y build-essential cmake pkg-config git \
libx11-dev libgl1-mesa-dev libpthread-stubs0-dev libxi-dev libxrandr-dev

3. Raylib installieren

cd ~
git clone https://github.com/raysan5/raylib.git
cd raylib
mkdir build
cd build
cmake -DBUILD_SHARED_LIBS=ON ..
make
sudo make install
sudo ldconfig

4. RetroRPG Repository klonen

cd ~
git clone https://github.com/UBA-PSI/retrorpg.git
cd retrorpg

5. Simple Version bauen

cd simple
make clean
make
./game_raylib   # oder ./game_ascii für die ASCII-Version

6. Full Version bauen

cd ../full
make clean
make raylib
./game_full

6.5. Full-fancy Version bauen

cd ~/retrorpg/full-fancy
make clean
make
./game_fancy

7. Troubleshooting

Math-Library-Fehler

Falls Fehler wie undefined reference to sinf, cosf auftreten: Die Linking-Zeile im Makefile muss mit folgenden Libraries enden:

-lraylib -lGL -lm -lpthread -ldl -lrt -lX11

Beispiel:

$(CC) $(CFLAGS) $(INCLUDES) $(RAYLIB_CFLAGS) -DUSE_RAYLIB_AUDIO -o $(OUTDIR)/game_full $^ -lraylib -lGL -lm -lpthread -ldl -lrt -lX11

WSL Graphics (falls Grafik nicht funktioniert)

Falls das Spiel nicht über den normalen wsl-Befehl gestartet wurde und keine Grafik angezeigt wird:

  1. VcXsrv installieren und vor dem Spiel starten
  2. In Ubuntu die DISPLAY-Variable setzen:
export DISPLAY=$(grep nameserver /etc/resolv.conf | awk '{print $2}'):0
ℹ️
Bei neueren WSL2-Versionen (Windows 11) ist WSLg bereits integriert und Grafik sollte ohne zusätzliche Konfiguration funktionieren.