Project

General

Profile

Actions

Setup & Starten

Voraussetzungen

  • Node.js (LTS-Version). Phaser und alle anderen Pakete installiert npm automatisch, ein separater Download ist nicht 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 erst wieder, 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, denn das kann das Projekt kaputt machen.
Port 8080 belegt Vite weicht automatisch auf einen anderen Port aus. Welcher es ist, 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 14 days ago · 3 revisions