So reichst du einen 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. Jeder Pet dort hat eine teilbare URL im Format https://petdex.crafter.run/pets/<pet-id>.

So reichst du ein:

1. Finde oder erstelle den 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. Gib unter „Danksagungen / Autor" an, damit deine Arbeit zugeschrieben 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.

Deinen eigenen einzigartigen Pet erstellen

Anstatt einen vorgestellten Petdex-Pet wiederzuverwenden, kannst du einen originellen erstellen. KI-Tools wie OpenAI Codex oder KI-Bildgeneratoren sind ein praktischer Weg, um von Grund auf ein Charakter-Spritesheet 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.

Eine sprite.json beschreibt das Sheet. Es hat zwei Hauptteile:

• 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 als nächstes passiert

Sobald du einreichst, überprüft das PicoPixel-Team deinen 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.

Wohin als nächstes

• LVGL Sprites – wie Sprite-Zustände und Frames funktionieren.
• Event Editor – füge Interaktivität zu deinen Designs hinzu.
• Template einreichen – teile ein PicoPixel-Design, von dem andere starten können.
• Inhalte melden – melde einen Pet oder ein Template, das gegen die Regeln verstößt.
• Pets-Galerie – stöbere durch die Community-Pets.