Übergabe an die Bestandsbibliothek

Einführung

Diese Anleitung soll als Leitfaden dienen, wie Sie Ihre eigenen Assets bei der Godot Bestandsbibliothek einreichen und mit der Godot-Gemeinschaft teilen können.

Wie im Dokument Using the Asset Library erwähnt, müssen Sie über ein registriertes Konto verfügen und angemeldet sein, um Inhalte an die Bestandsbibliothek senden zu können.

Übergaberichtlinien

Stellen Sie vor dem Einreichen Ihres Assets sicher, dass alle Anforderungen erfüllt sind, und beachten Sie auch die Empfehlungen.

Voraussetzungen

Im Allgemeinen werden die meisten Assets akzeptiert, die von Personen an die Bestandsbibliothek gesendet werden. Damit Ihr Asset akzeptiert werden kann, müssen jedoch einige Anforderungen erfüllt sein, damit es genehmigt werden kann.

  • Das Asset muss funktionieren. Wenn das Asset in der angegebenen Godot-Version nicht ausgeführt wird oder anderweitig nicht funktioniert, wird es abgelehnt.
  • Das Asset muss über eine ordnungsgemäße .gitignore-Datei verfügen. Es ist wichtig, redundante Daten aus dem Repository fernzuhalten. `Hier ist eine Vorlage. <https://github.com/github/gitignore/blob/master/Godot.gitignore> `_
  • No submodules, or any submodules must be non-essential. GitHub does not include submodules in the downloaded ZIP file, so if the asset needs the contents of the submodule, your asset won't work.
  • Die Lizenz muss korrekt sein. Die in der Bestandsbibliothek aufgeführte Lizenz muss mit der Lizenz im Repository übereinstimmen.
  • Verwenden Sie korrektes Englisch für den Namen und die Beschreibung Ihres Assets. Dies beinhaltet die Verwendung der korrekten Großschreibung und die Verwendung vollständiger Sätze in der Beschreibung.
  • Der Symbollink muss ein direkter Link sein. Für auf GitHub gehostete Symbole muss der Link mit "raw.githubusercontent.com" beginnen, nicht mit "github.com".

Empfehlungen

Diese Dinge sind nicht erforderlich, damit Ihr Asset genehmigt wird. Wenn Sie jedoch diese Empfehlungen befolgen, können Sie dazu beitragen, die Bestandsbibliothek für alle Benutzer zu einem besseren Ort zu machen.

  • Korrigieren oder unterdrücken Sie alle Skriptwarnungen. Das Warnsystem hilft dabei, Probleme mit Ihrem Code zu identifizieren, aber Benutzer Ihres Assets müssen sie nicht sehen.
  • Stellen Sie sicher, dass Ihr Code den offiziellen Styleguides entspricht. Ein einheitlicher Stil hilft anderen Menschen Ihren Code zu lesen und es hilft auch, wenn andere Menschen zu Ihrem Asset etwas beitragen möchten. Siehe den GDScript Style Guide oder :ref:` doc_c_sharp_styleguide`.
  • Wenn Sie Screenshots in Ihrer Sammlung haben, platzieren Sie diese in einem eigenen Unterordner und fügen Sie eine .gdignore-Datei im selben Ordner hinzu (Hinweis: gd, nicht git). Dies verhindert, dass Godot Ihre Screenshots importiert. Öffnen Sie unter Windows eine Eingabeaufforderung im Projektordner und führen Sie type nul> .gdignore aus, um eine Datei zu erstellen, deren Name mit einem Punkt beginnt.
  • Wenn Ihr Asset eine Bibliothek für die Arbeit mit anderen Dateien ist, sollten Sie Beispieldateien in das Asset aufnehmen.
  • Das Symbol sollte ein Quadrat mit einem Seitenverhältnis 1: 1 sein. Idealerweise sollte es auch eine Mindestauflösung von 64 x 64 Pixel haben.
  • Während die Bestandsbibliothek mehr als nur GitHub zulässt, sollten Sie den Quellcode Ihres Assets auf GitHub hosten. Andere Dienste funktionieren möglicherweise nicht zuverlässig, und mangelnde Vertrautheit kann ein Hindernis für die Mitwirkenden sein.

Einreichen

Sobald Sie angemeldet sind, können Sie zur Seite "Assets Submit" der AssetLib wechseln, die folgendermaßen aussieht:

image0

Es sieht zwar nach viel aus (und es gibt noch mehr, wenn Sie nach unten scrollen), aber zu jedem Feld wird beschrieben, was Sie eingeben sollten. Wir werden jedoch auch hier auf das eingehen, was im Einreichungsformular erforderlich ist.

  • Asset Name:
    Der Name Ihres Assets, es sollte ein eindeutiger, beschreibender Titel sein.
  • Category:
    Die Kategorie, zu der Ihr Inhalt gehört und die in den Suchergebnissen angezeigt wird. Die Kategorie ist in Addons und Projekte unterteilt. Im Editor werden Assets des Projekttyps (Vorlagen, Demos, Projekte) nur angezeigt, wenn die AssetLib im Projektmanager angezeigt wird, während Assets des Addon-Typs nur innerhalb eines Projekts sichtbar sind.
  • Godot version:
    Die Version der Engine, mit der das Asset arbeitet. Derzeit ist es nicht möglich, dass ein einzelner Asset-Eintrag Downloads für mehrere Engine-Versionen enthält. Daher müssen Sie das Asset möglicherweise mehrmals mit einem Eintrag für jede unterstützte Godot-Version erneut senden. Dies ist besonders wichtig, wenn Sie sich mit Hauptversionen der Engine wie Godot 2.x und Godot 3.x befassen.
  • Version:
    Die Versionsnummer des Assets. Sie können zwar ein beliebiges Versionsschema auswählen und verwenden, sollten jedoch möglicherweise etwas wie SemVer verwenden, damit das Versionsschema Ihres Assets klar und konsistent sein soll. Beachten Sie, dass es auch eine interne Versionsnummer gibt, die jedes Mal erhöht wird, wenn die URL zum Herunterladen von Assets geändert oder aktualisiert wird.
  • Repository host:
    In die AssetLib hochgeladene Assets werden nicht direkt darauf gehostet. Stattdessen verweisen sie auf Repositorys, die auf Git-Anbietern von Drittanbietern wie GitHub, GitLab oder Bitbucket gehostet werden. Hier wählen Sie aus, welchen Anbieter Ihr Asset verwendet, damit die Site den endgültigen Download-Link berechnen kann.
  • Repository URL:
    Die URL zu den Dateien/Webseiten Ihres Assets. Dies hängt von Ihrer Wahl des Anbieters ab, sollte jedoch ähnlich wie https://github.com/<user>/<project> aussehen.
  • Issues URL:
    Die URL zum Problem-Tracker Ihres Assets. Dies unterscheidet sich wiederum von Repository-Host zu Repository-Host, sieht jedoch wahrscheinlich ähnlich aus wie https://github.com/<user>/<project>/issues. Sie können dieses Feld leer lassen, wenn Sie den Problem-Tracker Ihres Providers verwenden und er Teil desselben Repositorys ist.
  • Download bestätigen:
    Das Commit des Assets, zum Beispiel b1d3172f89b86e52465a74f63a74ac84c491d3e1. Die Webseite berechnet daraus die tatsächliche Download-URL.
  • Icon URL:
    Die URL zum Symbol Ihres Assets (das als Miniaturbild in den AssetLib-Suchergebnissen und auf der Seite des Assets verwendet wird) sollte ein Bild im PNG oder JPG Format sein.
  • License:
    Die Lizenz unter der Sie den Asset vertreiben. Die Liste enthält eine Vielzahl von kostenlosen und Open-Source-Softwarelizenzen wie GPL (v2 und v3), MIT, BSD und Boost Software License. Sie können OpenSource.org besuchen, um eine detaillierte Beschreibung jeder der aufgelisteten Lizenzen zu erhalten.
  • Beschreibung (Description):
    Schließlich können Sie das Feld Beschreibung für eine Textübersicht Ihres Assets, seiner Funktionen und seines Verhaltens, eines Änderungsprotokolls usw. verwenden. In Zukunft wird die Formatierung mit Markdown unterstützt. Derzeit ist Ihre einzige Option nur Klartext.

Sie können auch bis zu drei Video- und/oder Bildvorschauen einfügen, die unten auf der Asset-Seite angezeigt werden. Verwenden Sie das Kontrollkästchen "Aktivieren" in jedem der Vorschau-Übermittlungsfelder, um sie zu aktivieren.

  • Type:
    Entweder ein Bild oder ein Video.
  • Bild/YouTube URL:
    Entweder ein Verweis auf ein Bild oder ein Video, gehostet auf YouTube.
  • Miniaturbild (Thumbnail) URL:
    Eine URL zu einem Bild, das als Miniaturbild für die Vorschau verwendet wird. Diese Option wird eventuell entfernt und stattdessen werden automatisch Miniaturansichten berechnet.

Wenn Sie fertig sind, klicken Sie auf Senden. Ihr Asset wird in die ausstehende Warteschlange eingetragen, die Sie in der Bestandsbibliothek hier . aufrufen können. Der Genehmigungsprozess ist manuell und es kann bis zu einigen Tagen dauern, bis Ihr Addon akzeptiert (oder abgelehnt) wird. Bitte haben Sie etwas Geduld! Sie werden informiert, wenn Ihr Asset überprüft wurde. Wenn es abgelehnt wurde, wird Ihnen mitgeteilt, warum dies möglicherweise der Fall war, und Sie können es mit den entsprechenden Änderungen erneut einreichen. Möglicherweise haben Sie etwas Glück und können den Genehmigungsprozess beschleunigen, indem Sie den Moderatoren/Assetlib-Überprüfern im IRC (dem Kanal #godotengine-atelier "auf Freenode) oder dem offiziellen Discord-Server eine Nachricht senden.