Descripción general
Una mascota de PicoPixel es un sprite animado: un personaje que cobra vida mediante una secuencia de imágenes. Cuando envías una, puede aparecer en la galería de mascotas de la comunidad para que toda la comunidad pueda usarla.
Hay dos formas de enviar una mascota. La más rápida es Petdex: solo necesitas pegar el enlace de la mascota. La otra es a través de GitHub, para sprites que alojas tú mismo como una hoja de sprites y un sprite.json. Puedes enviar una mascota de Petdex existente o crear una completamente original.
Ambos métodos están dentro de la app de PicoPixel, así que primero debes iniciar sesión.
Antes de empezar
Todo ocurre dentro de la app de PicoPixel. Para llegar a la pantalla de envío:
- Abre la app en app.picopixel.io.
- Inicia sesión si aún no lo has hecho; el inicio de sesión es OAuth con Google o GitHub. Si lo omites, se te pedirá antes de poder enviar.
- Haz clic en tu cuenta en la parte inferior de la barra lateral izquierda.
- Elige "Your account".
- Abre "Submit Sprite".
La pantalla Submit Sprite ofrece los dos métodos descritos a continuación.
Debes haber iniciado sesión para enviar cualquier cosa. Si no has iniciado sesión, la app te lo pedirá antes de dejarte continuar.
Enviar a través de Petdex
Este es el método recomendado y más rápido. Petdex es un directorio externo de mascotas en petdex.crafter.run donde puedes explorar, crear y alojar mascotas. Cada mascota tiene una URL compartible con el formato https://petdex.crafter.run/pets/<pet-id>.
Para enviar:
- Encuentra o crea la mascota en Petdex y copia su URL.
- En la pantalla Submit Sprite, elige "Submit via Petdex".
- Pega la URL de la mascota en el campo "Petdex URL".
- Añade lo que sea útil en el campo opcional "Notes".
- Envíalo.
Enviar a través de Petdex solo requiere una URL. Por eso el formulario lo marca como el método recomendado y más rápido.
Enviar a través de GitHub
Usa este método cuando alojas el sprite tú mismo. Proporcionarás los archivos directamente en lugar de un enlace de Petdex.
- Coloca tu imagen de hoja de sprites y un
sprite.jsonque describa esa hoja en un repositorio público de GitHub. - En la pantalla Submit Sprite, elige "Submit via GitHub".
- Pega la URL del repositorio (
https://github.com/...). - Rellena "Credits / Author" para que se reconozca tu autoría.
- Añade lo que sea útil en el campo opcional "Notes" y envía.
La hoja de sprites y el sprite.json deben seguir un formato específico. La siguiente sección lo explica.
Crear una mascota original
En lugar de reutilizar una mascota de Petdex, puedes crear una original. Herramientas de IA como OpenAI Codex o generadores de imágenes con IA son una forma práctica de producir una hoja de sprites de personaje desde cero.
Una hoja de sprites es una sola imagen (PNG o WebP) dispuesta como una cuadrícula uniforme, un "atlas". Organízala con una animación por fila y mantén cada fotograma con el mismo tamaño.
Cada fotograma debe tener exactamente el mismo ancho y alto. Una cuadrícula con celdas de tamaños distintos no permitirá separar bien los fotogramas y la animación puede dar saltos o fallar.
Un sprite.json describe la hoja. Tiene dos partes principales:
- atlas: el diseño de la cuadrícula:
columns,rows,frameWidthyframeHeight. - states: un array de animaciones. Cada estado tiene un
id, unlabel, larowen la que se encuentra, el número deframes, undurationMsopcional, ungroupy uncaption.
Los estados típicos incluyen idle, wave, jump, run-right, run-left, running, waiting, failed y review. Un sprite necesita al menos dos estados, así que genera los comunes, como mínimo idle más uno de movimiento.
Un buen flujo de trabajo: genera los fotogramas con un tamaño consistente, organízalos en una cuadrícula regular con una animación por fila, luego describe la cuadrícula y los estados en sprite.json y envía a través de Petdex o GitHub.
El concepto de sprites, estados, fases y reutilización, se explica con más profundidad en LVGL Sprites.
Qué sucede después
Una vez que envíes tu mascota, el equipo de PicoPixel revisa tu mascota y puede contactarte si algo necesita aclaración. Las mascotas aprobadas aparecen en la galería de mascotas, con el nombre de su autor. Desde allí, cualquier persona de la comunidad puede encontrar y usar tu creación.
A dónde ir después
- LVGL Sprites: cómo funcionan los estados y fotogramas de los sprites.
- Editor de Eventos: añade interactividad a tus diseños.
- Enviar una Plantilla: comparte un diseño de PicoPixel del que otros puedan partir.
- Reportar Contenido: señala una mascota o plantilla que infrinja las normas.
- Galería de mascotas: explora las mascotas de la comunidad.
