Setup und Starten » History » Revision 2
Revision 1 (Daniel Noah Hildebrandt, 10/30/2026 01:21 PM) → Revision 2/3 (Daniel Noah Hildebrandt, 11/05/2026 12:46 PM)
h1. Setup & Starten
{{toc}}
h2. Voraussetzungen
* "Node.js":https://nodejs.org (LTS-Version) – Phaser und alle anderen Pakete installiert npm automatisch, *kein* separater Download nötig
* "Git":https://git-scm.com
* Editor: "Visual Studio Code":https://code.visualstudio.com (empfohlen, optional mit der Erweiterung _ESLint_)
Nach der Installation von Node.js in einem *neuen* Terminal prüfen:
<pre>
node -v
npm -v
</pre>
h2. Projekt einrichten
<pre>
git clone https://gitlab.hof-university.de/Vi/gamedesign_ws2627.git
cd gamedesign_ws2627
npm install
</pre>
@npm install@ ist nur einmal nötig – und erneut, wenn jemand neue Pakete hinzufügt. Der Ordner @node_modules@ wird *nie* committet (steht in der @.gitignore@).
h2. Spiel starten
<pre>
npm run dev-nolog
</pre>
Danach im Browser *http://localhost:8080* öffnen. Änderungen am Code werden beim Speichern automatisch neu geladen. Server beenden mit @Strg + C@.
@npm run dev@ funktioniert genauso. Seit dem Umbau zum Prototyp „Küstenfahrt“ auch, sendet das Projekt keine aber bei jedem Start anonyme Nutzungsdaten mehr an Phaser (die Datei @log.js@ wurde entfernt), beide Befehle sind also gleichwertig. – daher @dev-nolog@ verwenden.
h2. Fertigen Build erstellen
<pre>
npm run build-nolog
</pre>
Vor dem Build läuft automatisch die TypeScript-Prüfung. Das fertige Spiel liegt anschließend im Ordner @dist/@.
Weitere Befehle: @npm run typecheck@ (TypeScript prüfen) und @npm run lint@ (Code-Stil prüfen).
h2. Häufige Probleme
|_. Problem |_. Lösung |
|PowerShell: _„Die Ausführung von Skripts ist auf diesem System deaktiviert“_ |Einmalig @Set-ExecutionPolicy -Scope CurrentUser RemoteSigned@ ausführen und mit @J@ bestätigen. Alternativ @npm.cmd@ statt @npm@ verwenden oder in VS Code das Terminal auf „Command Prompt“ umstellen. |
|_„npm wird nicht erkannt“_ |Terminal bzw. VS Code nach der Node.js-Installation neu öffnen. |
|Warnung @install-scripts … esbuild@ |Meist harmlos. Falls ein esbuild-Fehler auftritt: @npm install-scripts approve esbuild@ und danach @npm install@. |
|Warnung @1 moderate severity vulnerability@ |Ignorieren. *Nicht* @npm audit fix --force@ ausführen – das kann das Projekt kaputt machen. |
|Port 8080 belegt |Vite weicht automatisch auf einen anderen Port aus – welcher, steht im Terminal. |
h2. Git-Grundlagen
* Vor jeder Arbeit den aktuellen Stand holen: @git pull@
* Neue Features in einem eigenen Branch entwickeln: @git switch -c feature/name@
* @git fetch@ ist ungefährlich – es lädt nur Infos vom Server und ändert keine Dateien.