Erster Commit

Ein Commit ist ein gespeicherter Zwischenstand des Projekts, mit einer kurzen Beschreibung. Push lädt die Commits zu GitHub hoch. In dieser Anleitung kommt beides einmal vor – dazu der wichtigste Handgriff des Kurses: eine Änderung rückgängig machen.

Schritt 1: Etwas in der Szene ändern

1. In Unity unten im Project-Fenster: Assets > Scenes > Doppelklick auf die Szene (z. B. SampleScene).
2. Im Hierarchy-Fenster: Rechtsklick > 3D Object > Cube.
3. Speichern: File > Save (Strg+S / Cmd+S).

✅ Checkpoint: In der Scene-Ansicht ist ein Würfel zu sehen. In der Hierarchy steht ganz oben der Szenenname (z. B. SampleScene) ohne Sternchen (*) – das heißt: gespeichert.

Schritt 2: Die Änderung in GitHub Desktop ansehen

1. Zu GitHub Desktop wechseln, Reiter Changes.
2. Links steht die Szenendatei, z. B. Assets/Scenes/SampleScene.unity. Darauf klicken.
3. Rechts ist zu sehen, was sich geändert hat: grüne Zeilen sind neu. Unity speichert Szenen als Text – darin steht jetzt der Würfel (Cube, seine Position, seine Components).

Diese Ansicht heißt Diff. Sie wird ständig gebraucht: Wenn der KI-Agent etwas geändert hat, zeigt sie, was er geändert hat.

✅ Checkpoint: Links steht mindestens die Szenendatei. Nirgends steht Library/.

Schritt 3: Committen

1. Unten links bei Summary eine kurze Beschreibung: Würfel in die Szene gestellt.
2. Auf Commit to main klicken.

✅ Checkpoint: Links steht No local changes. Im Reiter History steht der Commit ganz oben.

Schritt 4: Hochladen (Push)

1. Oben auf Push origin klicken.
2. Danach auf Repository > View on GitHub klicken.

✅ Checkpoint: Auf github.com steht über der Dateiliste der Commit Würfel in die Szene gestellt.

Schritt 5: Rückgängig machen

Jetzt das Wichtigste: zurück zum letzten Commit.

1. In Unity den Würfel löschen (auswählen, Entf bzw. Cmd+Backspace) und speichern.
2. In GitHub Desktop erscheint die Szenendatei wieder unter Changes – diesmal mit roten Zeilen (gelöscht).
3. Rechtsklick auf die Datei > Discard changes… > bestätigen.
4. Zurück in Unity: Unity merkt, dass sich die Szene geändert hat, und lädt sie neu. Fragt Unity nach: auf Reload klicken.

✅ Checkpoint: Der Würfel ist wieder da. GitHub Desktop zeigt No local changes.

Das ist der Rückgängig-Knopf. Er funktioniert für alles, was seit dem letzten Commit passiert ist – auch für Änderungen, die der KI-Agent gemacht hat.

Die Arbeitsregel für den Kurs

Von jetzt an gilt diese Schleife:

1. Committen, bevor der Agent eine Aufgabe bekommt. (Nichts unter Changes.)
2. Dem Agenten genau beschreiben, was passieren soll.
3. Im Spiel ausprobieren (Play).
4. In GitHub Desktop den Diff lesen: Welche Dateien hat er angefasst? Ist klar, was passiert?
5. Passt es: committen. Passt es nicht: Discard changes und neu beschreiben.
6. Pushen selbst übernehmen, wenn das Ergebnis passt – auch wenn der Agent Git bedienen kann. Er pusht nur, wenn man ihn ausdrücklich darum bittet. Man bleibt selbst in der Schleife, bis man versteht, wann es klug ist, einem Agenten das Steuer zu überlassen: Zustimmen kann man nur einer Zusammenarbeit, die man versteht.

Zum Schluss Kurs > Setup prüfen: alles OK, auch Commits und Mit GitHub verbunden.

Wenn es nicht klappt

Unter Changes steht nichts, obwohl etwas geändert wurde. Nicht gespeichert. Im Szenen-Reiter in Unity nach dem Sternchen schauen und mit Strg+S / Cmd+S speichern.

Unter Changes stehen hunderte Dateien oder etwas mit Library/. Nicht committen. Kurs > Setup prüfen öffnen und den Fehler bei .gitignore beheben.

Neben der eigenen Datei stehen .meta-Dateien. Richtig so. Jede Datei in Assets hat eine .meta-Datei, in der Unity sich ihre Verknüpfungen merkt. Immer mit committen.

Statt "Push origin" steht dort "Publish repository". Das Repository ist noch nicht auf GitHub. Darauf klicken, Keep this code private angehakt lassen.

Push: "Authentication failed" oder "rejected". In GitHub Desktop ab- und wieder anmelden (File > Options > Accounts). Steht da "rejected … fetch first": erst Fetch origin, dann Pull origin, dann nochmal Push.

Push: "file … exceeds GitHub's file size limit of 100 MB". Eine Datei ist zu groß für GitHub. Kurs > Setup prüfen zeigt sie unter Große Dateien. Jonas fragen, bevor etwas gelöscht wird – der Commit muss dann neu gemacht werden.

Nach Discard changes ist der Würfel nicht wieder da. Unity hat die Szene nicht neu geladen. Doppelklick auf die Szene im Project-Fenster und Don't Save wählen, falls Unity fragt.