Project

General

Profile

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.