Actions
Setup und Starten » History » Revision 1
Revision 1/3
| Next »
Daniel Noah Hildebrandt, 10/30/2026 01:21 PM
Seite angelegt
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 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 fetchist ungefährlich – es lädt nur Infos vom Server und ändert keine Dateien.
Updated by Daniel Noah Hildebrandt 20 days ago · 1 revisions