Setup & Starten¶
- Table of contents
- 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 fetchist ungefährlich. Es lädt nur Infos vom Server und ändert keine Dateien.
Updated by Daniel Noah Hildebrandt 14 days ago · 3 revisions