GEC1
Anleitung 6 · ca. 5 Min

Kurs-Paket aktualisieren

Das Kurs-Paket (de.macromedia.gec1) bringt das Menü Kurs > Setup prüfen und im Lauf des Semesters weitere Werkzeuge: den Spieler-Controller und das Kit. Es liegt nicht im eigenen Projekt, sondern in einem eigenen Repository auf GitHub. Das Projekt merkt sich nur, welche Version es verwendet – eine einzige Zeile in Packages/manifest.json:

"de.macromedia.gec1": "https://github.com/BabyToad/macromedia-gec1-kit.git#v0.1.0",

Das #v0.1.0 am Ende ist die Version. Aktualisieren heißt: diese Zeile auf die neue Version setzen. Unity lädt den Rest selbst (dafür braucht es Git).

Vorher committen: Dann lässt sich die Aktualisierung mit einem Klick rückgängig machen.

VersionAbNeu
v0.1.009.10. (in der Kursvorlage)Menü Kurs > Setup prüfen
v0.2.023.10.Spieler-Controller: Prefab Spieler (laufen, springen, umsehen; Ich- und Dritte-Person-Ansicht)
v0.3.013.11.Kit: Interaktionen als Graph

Schritt 1: Neue Version eintragen

  1. In GitHub Desktop prüfen: No local changes. Wenn nicht, erst committen.

  2. In Unity: Window > Package Manager.

  3. Oben links auf + > Install package from git URL… klicken.

  4. Die Adresse mit der neuen Version einfügen, z. B. für Version 0.2.0:

    https://github.com/BabyToad/macromedia-gec1-kit.git#v0.2.0

    Die genaue Versionsnummer nennt Jonas.

  5. Install klicken. Unity lädt die neue Version und kompiliert kurz.

Screenshot folgt: package-manager-update.png
Zeigt den Package Manager mit dem Feld "Install package from git URL" und der Adresse mit #v0.2.0.

✅ Checkpoint: Im Package Manager steht unter In Project das GEC1 Kurs-Paket mit der neuen Versionsnummer. Kurs > Setup prüfen zeigt bei Kurs-Paket dieselbe Version. Ab v0.2.0 liegt im Project-Fenster unter Packages > GEC1 Kurs-Paket > Player das Prefab Spieler; es lässt sich von dort in die Szene ziehen.

Schritt 2: Die Änderung ansehen und committen

  1. In GitHub Desktop, Reiter Changes: Geändert sind Packages/manifest.json und Packages/packages-lock.json.
  2. Auf manifest.json klicken. Rechts zeigt der Diff genau eine geänderte Zeile: rot die alte Version, grün die neue.
  3. Unten bei Summary z. B. Kurs-Paket auf 0.2.0 eintragen > Commit to main > Push origin.

✅ Checkpoint: GitHub Desktop zeigt No local changes, der Commit steht oben in History.

Das ist der ganze Mechanismus: Die Version eines Pakets ist eine Zeile Text im Projekt, und Git bewahrt jede Version auf. Ging bei der Aktualisierung etwas schief, macht History > Rechtsklick auf den Commit > Revert changes in commit sie wieder rückgängig.

Mit einem KI-Agenten

Mit Claude Code oder Codex im Projektordner geht es auch so:

Ändere in Packages/manifest.json die Version von de.macromedia.gec1 auf v0.2.0. Ändere sonst
nichts. Zeig mir danach den Diff. Nicht committen.

Danach Unity in den Vordergrund holen (Unity lädt das Paket dann neu) und weiter mit Schritt 2.

Wenn es nicht klappt

„No 'git' executable was found“ oder „Unable to add package“. Git fehlt oder der Unity Hub lief schon vor der Git-Installation. Siehe Git installieren.

„Could not find … v0.2.0“ / die Version wird nicht gefunden. Tippfehler in der Adresse oder die Version gibt es (noch) nicht. Die Adresse genau so einfügen, mit #v vor der Nummer und ohne Leerzeichen.

Nach der Aktualisierung zeigt Unity rote Fehler in der Console. In GitHub Desktop beide geänderten Dateien mit Discard changes zurücksetzen (vor dem Commit) bzw. den Commit mit Revert changes in commit rückgängig machen. Dann Jonas Bescheid sagen und den Text aus der Console mitschicken.

Im Package Manager steht noch die alte Version. Unity neu starten. Steht in Packages/manifest.json die neue Version, lädt Unity sie beim Öffnen.