Diese Seite wurde maschinell aus dem Englischen übersetzt. Englisches Original lesen.

Pakete veröffentlichen

Ein Paket in der AI Game Dev Community-Registry veröffentlichen: Publisher, Upload, Release Notes, Beta-Kanäle, Deprecation, Yanking.

Aktualisiert am 19. November 2026 Als Markdown anzeigen

Die Community-Registry ist der Ort, an dem Nutzer Pakete per id finden und installieren: gamedev pkg add acme.level-tools, oder Browse im Packages-Fenster, mit automatischen Updates und Bewertungen von 1 bis 5 Sternen. Jedes registrierte Konto auf ai-game.dev kann veröffentlichen, Pakete sind kostenlos, und jede Version durchläuft automatische Prüfungen statt einer manuellen Review. Diese Seite deckt den gesamten Weg ab: deinen Publisher, den ersten Upload, Release Notes, Pre-Release-Kanäle, Deprecation, Yanking und die anderen Wege, ein Paket zu teilen.

Der Paketkatalog auf ai-game.dev: ein hervorgehobenes Engine-Paket, Kategoriefilter und Reihen offizieller und Community-Pakete
Der Paketkatalog: offizielle Pakete und Community-Pakete, jeweils mit ihrem Installationsbefehl.

Einen Publisher beanspruchen

Deine Publisher-id ist die erste Hälfte jeder Paket-id, die du veröffentlichst (acme in acme.level-tools). Sie wird einmal beansprucht, und es gilt: wer zuerst kommt, mahlt zuerst:

gamedev login
gamedev pkg publisher claim acme --name "Acme Tools"

Eine Publisher-id besteht aus 2 bis 40 Kleinbuchstaben, Ziffern und einzelnen Bindestrichen. Die eigene id von AI Game Dev (aigd), Engine-Namen (unity, godot, unreal, brutal, bevy, threejs), Marken und Verwechslungsnamen wie un1ty oder unity-tools sind reserviert. Ein Konto braucht eine verifizierte E-Mail und darf bis zu 3 Publisher halten.

Das Konto, das einen Publisher beansprucht, ist sein Owner. Ein Owner kann Maintainer per E-Mail hinzufügen; Maintainer dürfen hochladen, yanken, deprecaten, Release Notes bearbeiten, Kanäle verschieben und Tokens erzeugen. Nur ein Owner verwaltet Mitglieder und vertrauenswürdige Publisher.

Eine Version veröffentlichen

Setze "publisher": "acme" in aigd-package.json, erhöhe version, baue, dann:

gamedev pkg publish level-tools

Die CLI packt den Ordner (dieselben Prüfungen und Bytes wie gamedev pkg pack), lädt ihn hoch und wartet auf die Prüfungen. Eine Version durchläuft diese Zustände:

ZustandBedeutung
uploaded, checkingWartet auf die automatischen Prüfungen oder führt sie aus
publishedHat alle Prüfungen bestanden; innerhalb von etwa einer Minute im signierten Index
rejectedEine Prüfung ist fehlgeschlagen; der Bericht nennt jeden Fehler. Behebe ihn und lade dieselbe Version erneut hoch
yankedVom Publisher zurückgezogen: Versionsbereiche überspringen sie, bestehende Installationen behalten sie
revokedVon AI Game Dev entfernt (Malware, ein gestohlenes Konto): jede App schaltet sie ab

Versionen sind unveränderlich. Eine veröffentlichte, gezogene (yanked) oder widerrufene (revoked) Versionsnummer kann nie wieder hochgeladen werden; nur eine abgelehnte kann es. Liefere einen Fix als neue Version.

Die Seite eines Pakets im Katalog: Name, Publisher, Version, Installationsbutton und -befehl, Starter-Vorschauen, ein About-Panel und das neueste Release
Die Seite eines Community-Pakets im Katalog. Nutzer installieren es mit einem Klick oder einem Befehl.

Release Notes

Jede Version kann Release Notes in Markdown enthalten. Nutzer sehen sie pro Version im Packages-Fenster (Versions) und im Publisher-Panel. Gib sie beim Upload mit:

gamedev pkg publish level-tools --notes RELEASE_NOTES.md

Ohne --notes nimmt die Registry den Abschnitt deiner CHANGELOG.md (im Paketordner, im Archiv ausgeliefert) ab der Überschrift der Version (## 1.2.0, ## [1.2.0] oder ## v1.2.0) bis zur nächsten Überschrift gleicher oder höherer Ebene, begrenzt auf 20 KB:

# Changelog

## [1.2.0]

- Export levels as glTF.
- Fix the collectible count in nested scenes.

Notizen umfassen höchstens 20 KB Markdown, werden wie eine README bereinigt und wie jeder andere Text in einem Paket auf Prompt-Injection geprüft. Ein Mitglied kann sie später im Publisher-Panel bearbeiten. Der signierte Index enthält die ersten 4 KB mit einem Link zum Rest.

Kanäle: latest, beta und andere

Ein Kanal (ein dist-tag) benennt die Version, die Nutzer erhalten, wenn sie ihn per Namen anfragen:

gamedev pkg add acme.level-tools          # the latest channel
gamedev pkg add acme.level-tools@beta     # whatever beta points to
  • Ein Pre-Release (1.3.0-beta.1) wird nie standardmäßig installiert: latest ist die höchste veröffentlichte stabile Version, sofern du sie nicht selbst setzt, und kann nie auf ein Pre-Release zeigen.
  • Andere Kanäle benennst du selbst (beta, next, nightly): Kleinbuchstaben, beginnend mit einem Buchstaben, bis zu 16 Zeichen. Ein Paket hat höchstens 5 Kanäle, latest eingeschlossen.
  • Eine gezogene oder widerrufene Version kann nicht getaggt werden; ein Kanal, der auf eine Version zeigt, die gezogen wird, wird entfernt.
  • Veröffentliche ein Pre-Release als Semver-Pre-Release (1.3.0-beta.2). Ein Pre-Release namens alpha, beta, rc, next, preview, canary, nightly, dev oder experimental verschiebt diesen Kanal automatisch auf sich selbst, es sei denn, ein Mitglied hat den Kanal von Hand gesetzt; jeder Kanal kann auch im Publisher-Panel (Channels) verschoben werden.
  • gamedev pkg add acme.level-tools@beta schreibt den Channel in packages.json, { "source": "^1.3.0-beta.1", "channel": "beta" }. Tester erhalten die Version des Channels, solange sie neuer ist als die neueste stabile, und wechseln bei ihrem nächsten Update auf das stabile Release, sobald es erschienen ist.

Ein Paket oder eine Version als veraltet markieren

Eine Deprecation sagt Nutzern, dass sie weiterziehen sollen, ohne dass etwas Installiertes kaputtgeht:

  • Ein Paket: eine Nachricht (bis zu 300 Zeichen) und optional die ID eines Ersatzpakets. Die App und die CLI zeigen die Nachricht und das Ersatzpaket an; installierte Kopien funktionieren weiter, und das Paket kann weiterhin hinzugefügt werden.
  • Eine Version: eine Nachricht wie "Datenverlust beim Exportieren verschachtelter Szenen, bitte auf 1.2.1 aktualisieren".

Bei der Auswahl einer Version bevorzugt die App eine, die nicht als veraltet markiert ist. Beide Arten sind umkehrbar und werden im Audit-Log der Registry protokolliert. Legen Sie sie im Publisher-Panel fest.

Zurückziehen und widerrufen

Ziehen Sie eine Version zurück, die Sie versehentlich veröffentlicht haben: Versionsbereiche überspringen sie ab dann, und Installationen, die sie bereits haben, behalten sie. Das Zurückziehen ist umkehrbar, und ein Publisher-Token darf zurückziehen. Der Widerruf ist der Kill Switch von AI Game Dev für eine bösartige oder gestohlene Version: Sie verschwindet aus dem Index, und jede App, die sie hat, schaltet sie beim nächsten Lesen des Index ab.

Aus der CI veröffentlichen

Zwei Wege, beide beschrieben in Trusted Publishing:

  • Trusted Publishing (empfohlen): GitHub Actions oder GitLab CI weisen nach, welches Repository und welcher Workflow veröffentlicht; nirgends wird ein Secret gespeichert, und jede Version zeichnet ihre Herkunft auf. Eine fertige GitHub Action und eine GitLab-CI-Vorlage, IvanMurzak/gamedev-publish-action, werden dort beschrieben.
  • Ein Publisher-Token: gamedev pkg publisher token create acme --label ci --days 90, als CI-Secret gespeichert und als AI_GAME_DEV_PUBLISHER_TOKEN übergeben.

Das Publisher-Panel

Alles, was ein Publisher nach dem ersten Upload verwaltet, findet sich im Publisher-Panel unter ai-game.dev/publisher, für angemeldete Owner und Maintainer: Ihre Publisher und Pakete, jede Version mit ihrem Status und Prüfbericht, Release Notes, Channels, Deprecation und Yanking, Mitglieder und Rollen, Publisher-Tokens sowie Trusted Publisher mit kopierbaren Workflow-Snippets. Siehe Regeln und Prüfungen der Registry.

Andere Quellen: GitHub, npm und Ordner

Die Registry ist nicht der einzige Weg, ein Paket zu teilen. Diese Quellen installieren ohne die Prüfungen der Registry, führen Sie also gamedev pkg validate selbst aus, und sie sind der Weg, ein Paket zu teilen, das Proposed API verwendet:

gamedev pkg add github:acme/level-tools           # the default branch: moves with each push
gamedev pkg add github:acme/level-tools@v1.2.0    # a tag: pinned, never auto-updated
gamedev pkg add npm:acme-level-tools@^1.2.0       # an npm package and range
gamedev pkg add file:../level-tools               # a folder
  • GitHub: Mit einem Tag lädt die App ein Release-Asset herunter, dessen Name auf .aigd.tgz endet (hängen Sie die Datei an, die gamedev pkg pack geschrieben hat); andernfalls das Repository an diesem Commit, daher muss aigd-package.json im Wurzelverzeichnis liegen und dist/ eingecheckt sein.
  • npm: Führen Sie npm publish für den Paketordner aus. Das npm-Archiv muss aigd-package.json und dist/ enthalten; fügen Sie außerdem "engines": { "aigd": "<range>" } zu package.json hinzu, damit die App Versionen überspringt, die sie nicht ausführen kann, ohne sie herunterzuladen.
  • Teams: Fügen Sie das Paket auf Projektebene hinzu, damit es in .ai-game-dev/packages.json eingecheckt wird und jedes Teammitglied dieselbe Version erhält, festgeschrieben durch die Lock-Datei des Projekts.