Cómo enviar un pet

Antes de empezar

Todo ocurre dentro de la app de PicoPixel. Para llegar a la pantalla de envío:

1. Abre la app en app.picopixel.io.
2. 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.
3. Haz clic en tu cuenta en la parte inferior de la barra lateral izquierda.
4. Elige "Tu cuenta".
5. Abre "Enviar Sprite".

La pantalla Enviar Sprite ofrece los dos métodos descritos a continuación.

Enviar a través de Petdex

Este es el método recomendado y más rápido. Petdex es un directorio externo de pets en petdex.crafter.run donde puedes explorar, crear y alojar pets. Cada pet tiene una URL compartible con el formato https://petdex.crafter.run/pets/<pet-id>.

Para enviar:

1. Encuentra o crea el pet en Petdex y copia su URL.
2. En la pantalla Enviar Sprite, elige "Enviar a través de Petdex".
3. Pega la URL del pet en el campo "Petdex URL".
4. Añade lo que sea útil en el campo opcional "Notas".
5. Envíalo.

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.

1. Coloca tu imagen de hoja de sprites y un sprite.json coincidente en un repositorio público de GitHub.
2. En la pantalla Enviar Sprite, elige "Enviar a través de GitHub".
3. Pega la URL del repositorio (https://github.com/...).
4. Rellena "Créditos / Autor" para que tu trabajo sea atribuido.
5. Añade lo que sea útil en el campo opcional "Notas" y envía.

La hoja de sprites y el sprite.json deben seguir un formato específico. La siguiente sección lo explica.

Crear tu propio pet único

En lugar de reutilizar un pet destacado de Petdex, puedes crear uno 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.

Un sprite.json describe la hoja. Tiene dos partes principales:

• atlas: el diseño de la cuadrícula: columns, rows, frameWidth y frameHeight.
• states: un array de animaciones. Cada estado tiene un id, un label, la row en la que se encuentra, el número de frames, un durationMs opcional, un group y un caption.

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.

Qué sucede después

Una vez que envíes, el equipo de PicoPixel revisa tu pet y puede contactarte si algo necesita aclaración. Los pets aprobados aparecen en la galería de Pets, con tu crédito. 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 un pet o plantilla que infrinja las normas.
• Galería de Pets: explora los pets de la comunidad.