Setup und Starten » History » Revision 2
« Previous |
Revision 2/3
(diff)
| Next »
Daniel Noah Hildebrandt, 11/05/2026 12:46 PM
Startbefehle an aktuellen Projektstand angepasst
Setup & Starten¶
- Table of contents
- Setup & Starten
Voraussetzungen¶
- Node.js (LTS-Version) – Phaser und alle anderen Pakete installiert npm automatisch, kein separater Download nötig
- Git
- Editor: Visual Studio Code (empfohlen, optional mit der Erweiterung ESLint)
Nach der Installation von Node.js in einem neuen Terminal prüfen:
node -v npm -v
Projekt einrichten¶
git clone https://gitlab.hof-university.de/Vi/gamedesign_ws2627.git cd gamedesign_ws2627 npm install
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).
Spiel starten¶
npm run dev-nolog
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“ sendet das Projekt keine Nutzungsdaten mehr an Phaser (die Datei log.js wurde entfernt), beide Befehle sind also gleichwertig.
Fertigen Build erstellen¶
npm run build-nolog
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).
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. |
Git-Grundlagen¶
- Vor jeder Arbeit den aktuellen Stand holen:
git pull - Neue Features in einem eigenen Branch entwickeln:
git switch -c feature/name git fetchist ungefährlich – es lädt nur Infos vom Server und ändert keine Dateien.
Updated by Daniel Noah Hildebrandt 14 days ago · 2 revisions