Project

General

Profile

Actions

Setup und Starten » History » Revision 1

Revision 1/3 | Next »
Daniel Noah Hildebrandt, 10/30/2026 01:21 PM
Seite angelegt


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 auch, sendet aber bei jedem Start anonyme Nutzungsdaten an Phaser – daher dev-nolog verwenden.

Fertigen Build erstellen

npm run build-nolog

Das fertige Spiel liegt anschließend im Ordner dist/.

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 fetch ist ungefährlich – es lädt nur Infos vom Server und ändert keine Dateien.

Updated by Daniel Noah Hildebrandt 20 days ago · 1 revisions