Setup
Einmalige Installation für alle Einheiten dieses Kurses. Führe dies vor Unit 0 durch.
Du kannst den Kurs online lesen
Der Kurs ist unter
godot-rl.onlinekurs.training
veröffentlicht und braucht zum Lesen keine Installation. Alles Folgende dient
dem Ausführen des Codes: die Einheiten starten Python- und Godot-Szenen aus
dem Repository, du klonst es also weiterhin und legst weiterhin die Umgebung
godot_env an.
Kurs-Repository — zuerst klonen
Alles in diesem Kurs — requirements-course.txt, der examples/-Code der Neuronalen Grundlagen, Hilfsskripte — liegt im Kurs-Repository. Klone es und arbeite aus seinem Stammverzeichnis:
Kein git? Nutze stattdessen Code → Download ZIP auf github.com/minigraphx/godot-rl-course, entpacke das Archiv und wechsle mit cd in den entpackten Ordner.
Alle Kursbefehle im Repo-Stammverzeichnis ausführen
Sofern eine Einheit nichts anderes sagt, setzt jeder pip-, python -m examples.…- und godot --headless-Befehl in diesem Kurs voraus, dass dein Terminal sich im Stammverzeichnis des Kurs-Repos befindet — dem Ordner mit requirements-course.txt.
Godot 4 — .NET-Edition
Lade die .NET / Mono-Version von Godot 4 von godotengine.org herunter (nicht die Standard-Version). Getestet mit Godot 4.3+.
Verwende die .NET-Edition — nicht die Standard-Version
Das godot-rl-Plugin kompiliert native C#-Tasks (NuGet-Referenzen), die Godot mit der ONNX-Laufzeit verbinden. Die Standard-Version kann diese nicht laden. Du musst außerdem das .NET SDK installieren.
Godot auf der Kommandozeile
Mehrere Einheiten starten Godot aus dem Terminal (godot --headless …). Der Editor-Download legt keinen godot-Befehl auf deinen PATH — richte das einmalig ein:
macOS — die Binärdatei liegt im App-Bundle. Füge deinem Shell-Profil (~/.zshrc) einen Alias hinzu:
Windows — füge den Ordner mit Godot_*.exe zu deinem PATH hinzu (Einstellungen → System → Info → Erweiterte Systemeinstellungen → Umgebungsvariablen) oder rufe die Datei über ihren vollständigen Pfad auf. Forward Slashes funktionieren in jeder Shell:
Linux — mache die heruntergeladene Binärdatei ausführbar und verlinke sie auf deinen PATH:
chmod +x Godot_v4.3-stable_mono_linux.x86_64
sudo ln -s "$PWD/Godot_v4.3-stable_mono_linux.x86_64" /usr/local/bin/godot
Überprüfen
Öffne ein neues Terminal und führe godot --version aus — es sollte eine 4.x-Versionsnummer ausgeben.
Python — Conda-Umgebung (environment)
Warum Conda? Es erlaubt dir, Python 3.10 in einem isolierten Ordner zu fixieren, sodass die ML-Pakete nicht mit anderen Projekten kollidieren. godot-rl und Stable-Baselines3 funktionieren am zuverlässigsten mit Python 3.10; neuere Versionen führen häufig zu Problemen mit Paket-Wheels.
Miniconda installieren (überspringen, falls conda bereits vorhanden):
Lade von docs.conda.io/en/latest/miniconda.html für dein Betriebssystem herunter. Nach der Installation öffne ein neues Terminal und prüfe:
Umgebung erstellen (einmalig):
In jedem neuen Terminal — vor jedem Trainingsbefehl aktivieren:
requirements-course.txt befindet sich im Stammverzeichnis des Kurs-Repos, das du oben geklont hast — führe den Befehl von dort aus. Es fixiert alle Pakete auf bekannte, funktionierende Versionen — siehe die Kompatibilitätstabelle unten.
Was installiert wird
godot-rl— Python ↔ Godot Socket-Bridge, Stable-Baselines3-Wrapper und diegdrl-CLIstable-baselines3— PPO, SAC und andere Algorithmentorch— PyTorch-Backend für das Trainingtensorboard— Visualisierung der Trainingskurvenmatplotlib,onnx,onnxruntime,ncnn,opencv-python— Plots, Modell-Export und Paritätsprüfungen in Neuronalen Grundlagen
Überprüfen: python -c "import godot_rl; print('ok')"
Neuronale Grundlagen 3 — Game-Pfad (nur macOS arm64)
Der PPO-Racer in Neuronale Grundlagen 3 nutzt einen gebündelten godot-native-rl-ncnn-Runner, der derzeit nur für macOS Apple Silicon mitgeliefert wird. Der Research-Pfad (Python-REINFORCE-Punktroboter) funktioniert auf allen Plattformen in der Kompatibilitätstabelle unten.
macOS / Linux — erster Start
Der Installer fordert dich möglicherweise auf, conda init auszuführen — folge der Anweisung und öffne dann ein neues Terminal.
Windows — erster Start
Siehe Windows — erster Start unten für Hinweise zur PowerShell / cmd / Git Bash Aktivierung und Windows-spezifische Besonderheiten.
Kompatibilitätstabelle
Die folgende Tabelle zeigt die Paketversionen aus requirements-course.txt und die Godot-Version, mit der sie getestet wurden.
| Kurs-Tag | Godot | godot-rl | stable-baselines3 | PyTorch | Python |
|---|---|---|---|---|---|
| 2026-05 | 4.3.x | 0.5.0 | 2.3.2 | 2.6.0 | 3.10 |
Pakete während des Kurses nicht aktualisieren
godot-rl, SB3 und PyTorch haben inkompatible API-Änderungen zwischen Releases. Bleibe für die Dauer des Kurses bei den fixierten Versionen in requirements-course.txt. Nach dem Kurs kannst du gerne neuere Versionen ausprobieren — erstelle dafür einfach eine neue Conda-Umgebung.
Windows — erster Start
Die obigen Schritte funktionieren auf Windows mit kleinen Unterschieden. Lies diesen Abschnitt, bevor du das erste Mal conda activate ausführst.
Shell-Wahl
| Shell | Hinweise |
|---|---|
| Anaconda Prompt | Am einfachsten — conda activate godot_env funktioniert sofort. |
| PowerShell | Führe einmalig conda init powershell aus (als Administrator), starte PowerShell neu, dann conda activate godot_env. |
| cmd | Führe einmalig conda init cmd.exe aus, starte cmd neu, dann conda activate godot_env. |
| Git Bash | Führe einmalig conda init bash (aus dem Anaconda Prompt) aus, starte Git Bash neu, dann conda activate godot_env. |
--env_path mit Windows-Pfaden
godot-rl akzeptiert Schrägstriche (Forward Slashes) unter Windows — bevorzuge diese gegenüber Backslashes, um Shell-Escape-Probleme zu vermeiden:
# Empfohlen — Forward Slashes funktionieren überall, auch in PowerShell und cmd
gdrl --env_path=C:/Users/DeinName/Projekte/mein_spiel/mein_spiel.exe
# Auch gültig — Backslashes, müssen aber escaped oder in Anführungszeichen gesetzt werden
gdrl --env_path="C:\Users\DeinName\Projekte\mein_spiel\mein_spiel.exe"
Windows Defender / Antivirusproblem mit Sockets
Windows Defender (und viele Antivirusprogramme von Drittanbietern) blockieren manchmal still und heimlich den lokalen TCP-Port, den godot-rl für die Kommunikation zwischen Python und Godot verwendet (Standard: Port 11008). Symptome: Das Training scheint zu starten, aber Godot stellt keine Verbindung her; Python wartet auf die erste Beobachtung.
Lösung:
- Öffne Windows-Sicherheit → Firewall & Netzwerkschutz → App durch Firewall zulassen.
- Füge eine Ausnahme für
python.exe(das Python deiner Conda-Umgebung) und für die Godot-Anwendung hinzu. - Alternativ: Verwende einen anderen Port:
gdrl --port=12000(und setze denselben Port im AIController von Godot).
Wenn du ein Antivirusprogramm eines Drittanbieters verwendest, füge den Conda-Umgebungsordner (z. B. C:\Users\DeinName\miniconda3\envs\godot_env\) und deinen Godot-Projektordner zur Ausschlussliste hinzu.
chmod +x ist unter Windows nicht erforderlich
Die macOS/Linux-Befehle chmod +x godot_binary gelten nicht für Windows. Godot .exe-Dateien sind vom Betriebssystem bereits ausführbar.
WSL2 vs. natives Windows
| Ansatz | Vorteile | Nachteile |
|---|---|---|
| Natives Windows | Einfachste Einrichtung, keine Übersetzungsschicht, Direct3D GPU | Antivirus-/Firewall-Reibung; Pfade verwenden Backslashes |
| WSL2 (Ubuntu) | Vollständige Linux-Toolchain, einfachere GPU-Einrichtung via CUDA | GPU-Durchleitung (CUDA in WSL2) erfordert Windows 11 + WSL2-Kernel ≥ 5.15; Godot-GUI kann in WSL2 ohne X-Server oder WSLg nicht rendern |
Empfehlung für diesen Kurs: Verwende natives Windows, es sei denn, du hast bereits ein funktionierendes WSL2 + GPU-Setup. Godot muss ohnehin auf der Windows-Host-Seite (oder WSLg) laufen; die Kombination von Godot unter Windows und Python in WSL2 erfordert zusätzliche Port-Weiterleitungsschritte, die in diesem Kurs nicht behandelt werden.
Godot-Plugin — godot-rl-agents
Das Godot-seitige Plugin ist vom Python-Paket getrennt.
Nicht in der Asset-Bibliothek
Das Plugin ist nicht in Godots AssetLib verfügbar — du musst es manuell von GitHub installieren.
- Klone oder lade github.com/edbeeching/godot_rl_agents_plugin herunter
- Kopiere den Ordner
addons/godot_rl_agentsin denaddons/-Ordner deines Projekts
Zwei verschiedene Repositories
godot_rl_agents ist das Python-Paket (pip install). Das Godot-Plugin befindet sich im separaten Repository godot_rl_agents_plugin.
Plugin aktivieren
Projekt → Projekteinstellungen → Plugins → Godot RL Agents → Aktiviert. Warte, bis MSBuild fertig ist.
C#-Fehler beim ersten Import
Falls Godot beim ersten Öffnen einen Build-Fehler meldet, schließe das Projekt und öffne es erneut — die C#-Assemblies werden beim zweiten Öffnen korrekt erstellt.
Überprüfen
Node hinzufügen → suche nach Sync und AIController2D. Wenn diese erscheinen, funktioniert das Plugin.