So reichst du ein Pet ein

Bevor du beginnst

Alles passiert innerhalb der PicoPixel-App. So gelangst du zum Einreichungsbildschirm:

1. Öffne die App unter app.picopixel.io.
2. Melde dich an, falls du es noch nicht bist – die Anmeldung erfolgt über OAuth mit Google oder GitHub. Wenn du das überspringst, wirst du dazu aufgefordert, bevor du einreichen kannst.
3. Klicke auf dein Konto am unteren Rand der linken Seitenleiste.
4. Wähle „Dein Konto".
5. Öffne „Sprite einreichen".

Der Sprite-einreichen-Bildschirm bietet die beiden unten beschriebenen Methoden.

Einreichen über Petdex

Dies ist die empfohlene und schnellste Methode. Petdex ist ein externes Pet-Verzeichnis unter petdex.crafter.run, wo du Pets durchsuchen, erstellen und hosten kannst. Jedes Pet dort hat eine teilbare URL im Format https://petdex.crafter.run/pets/<pet-id>.

So reichst du ein Pet ein:

1. Finde oder erstelle das Pet auf Petdex und kopiere seine URL.
2. Wähle auf dem Sprite-einreichen-Bildschirm „Via Petdex einreichen".
3. Füge die Pet-URL in das Feld „Petdex URL" ein.
4. Füge im optionalen Feld „Hinweise" alles Hilfreiche hinzu.
5. Sende ab.

Einreichen über GitHub

Verwende diese Methode, wenn du den Sprite selbst hostest. Du stellst die Rohdateien anstelle eines Petdex-Links bereit.

1. Lege dein Spritesheet-Bild und eine passende sprite.json in einem öffentlichen GitHub-Repository ab.
2. Wähle auf dem Sprite-einreichen-Bildschirm „Via GitHub einreichen".
3. Füge die Repository-URL (https://github.com/...) ein.
4. Trage unter „Danksagungen / Autor“ deinen Namen und gegebenenfalls weitere Urheber ein, damit die Arbeit richtig zugeordnet wird.
5. Füge alles Nützliche im optionalen Feld „Hinweise" hinzu und sende dann ab.

Das Spritesheet und die sprite.json müssen einem bestimmten Format folgen. Der nächste Abschnitt erklärt es.

Dein eigenes Pet erstellen

Du kannst ein vorhandenes Pet von Petdex verwenden oder eine eigene Figur gestalten. KI-Tools wie OpenAI Codex oder KI-Bildgeneratoren sind ein praktischer Weg, um von Grund auf ein Spritesheet für deine Figur zu erstellen.

Ein Spritesheet ist ein einzelnes Bild (PNG oder WebP), das als gleichmäßiges Raster – ein „Atlas" – angeordnet ist. Lege es mit einer Animation pro Reihe an und halte jeden Frame in der Größe identisch.

Die Datei sprite.json beschreibt das Spritesheet. Sie besteht aus zwei Hauptteilen:

• atlas – das Rasterlayout: columns, rows, frameWidth und frameHeight.
• states – ein Array von Animationen. Jeder Zustand hat eine id, ein label, die row, auf der er sich befindet, die Anzahl der frames, ein optionales durationMs, eine group und eine caption.

Typische Zustände sind idle, wave, jump, run-right, run-left, running, waiting, failed und review. Ein Sprite benötigt mindestens zwei Zustände, erstelle also die gängigen – mindestens idle plus eine Bewegung.

Ein guter Arbeitsablauf: Generiere die Frames in einer einheitlichen Größe, ordne sie in einem gleichmäßigen Raster mit einer Animation pro Reihe an, beschreibe dann das Raster und die Zustände in der sprite.json und reiche über Petdex oder GitHub ein.

Was danach passiert

Sobald du einreichst, überprüft das PicoPixel-Team dein Pet und meldet sich möglicherweise, wenn etwas geklärt werden muss. Genehmigte Pets erscheinen in der Pets-Galerie, mit dir als Urheber. Von dort aus kann jeder in der Community deine Kreation finden und verwenden.

Nächste Schritte

• LVGL Sprites – wie Sprite-Zustände und Frames funktionieren.
• Event-Editor – füge Interaktivität zu deinen Designs hinzu.
• Vorlage einreichen – teile ein PicoPixel-Design, das andere als Ausgangspunkt nutzen können.
• Inhalte melden – melde ein Pet oder eine Vorlage mit regelwidrigen Inhalten.
• Pets-Galerie – stöbere durch die Community-Pets.