Proyectos y assets

Pyxen usa un modelo de proyecto sencillo basado en archivos: tus proyectos son archivos en tu dispositivo. Una cuenta es opcional, y nada la necesita.

El formato .pyxen

Un proyecto de Pyxen es un archivo .pyxen. Es un archivo ZIP que contiene tu código, imágenes y sonidos. Puedes:

• Renombrarlo, duplicarlo o moverlo en la app Archivos
• Almacenarlo en iCloud y acceder desde múltiples dispositivos
• Compartirlo por AirDrop, correo electrónico o cualquier método para compartir archivos
• Hacer copia de seguridad copiando el archivo

Como es un ZIP estándar, incluso podrías descomprimirlo en un ordenador para inspeccionar el contenido.

Un proyecto recuerda qué Pyxen lo guardó. Un proyecto creado con un Pyxen más reciente se abre y se ejecuta igualmente; la primera vez que lo abres, Pyxen avisa una vez de que lo que añadió la versión más reciente puede no mostrarse o no funcionar hasta que actualices. No se rechaza nada.

Dónde están tus proyectos

Pyxen guarda los proyectos que guardas en su carpeta: iCloud Drive › Pyxen cuando iCloud Drive está activado para Pyxen; si no, la carpeta propia de Pyxen en el dispositivo (En mi Mac › Pyxen en el Mac, En mi iPad › Pyxen en la app Archivos en el iPad). Ajustes › General › Proyectos dice cuál es, y Mostrar en Finder (en el iPad, Mostrar en Archivos) la abre.

Para el proyecto abierto, haz clic o toca su nombre en la barra de título y elige Mostrar en Finder (Mostrar en Archivos en el iPad), o elige Archivo › Mostrar en Finder (⌥⌘R). En el inicio, está en el menú de cada proyecto. La app Archivos no puede seleccionar un archivo, así que en el iPad abre la carpeta donde está el proyecto. Un proyecto que aún no has guardado no está en ninguna carpeta: su menú ofrece Guardar… en su lugar.

Un proyecto que guardaste o abriste en otro sitio se queda donde está: Pyxen lo muestra en Continuar y nunca lo mueve. Mientras pruebas Pyxen, cuentan los proyectos de su carpeta.

Añadir assets

Tu proyecto puede contener:

• Imágenes — archivos PNG usados para sprites y hojas de tiles
• Sonidos — archivos WAV para efectos de sonido
• Música — archivos OGG Vorbis, MIDI y módulos tracker (MOD, XM, IT, S3M) para la música de fondo

El README.md de un proyecto y sus traducciones, como README.es.md, son una sola fila Léame arriba en Archivos, encima de Scripts. Abre la página en tu idioma. Su menú tiene los demás idiomas (Abrir en otro idioma) y Editar como texto, que abre el propio archivo.

Añade assets con Archivo › Importar imágenes o sonidos…, o crea uno con Archivo › Nuevo asset… (el + de Archivos). Una vez añadidos, los referencias por nombre en tu código:

Sprite("hero")       # referencia una imagen llamada "hero"
Sound("jump")        # referencia un sonido llamado "jump"
Music("overworld")   # referencia una pista de música llamada "overworld"

Un mapa de mosaicos nuevo

En Archivo › Nuevo asset…, Mapa de mosaicos pregunta con qué mosaicos se pinta el mapa. Muestra las imágenes del proyecto, cada una con cuántos mosaicos da, luego las imágenes de los packs de assets que usa el proyecto, bajo el nombre de cada pack, y al final los Mosaicos de Pyxen: suelo, muros, baldosas, una puerta, una diana, colinas, nubes, arbustos y una caja, 40 mosaicos de 16 píxeles en la paleta del proyecto.

Un mapa nuevo empieza con los mosaicos que usa otro mapa del proyecto; si no, con una imagen cuyo nombre dice «tiles»; si no, con los Mosaicos de Pyxen. Tileset nombra la elección, y la línea de debajo dice lo que hace Crear:

• Con una imagen del proyecto o de un pack, el mapa la usa tal cual. No se añade nada más.
• Con los Mosaicos de Pyxen, Crear también añade tiles.png al proyecto (tiles2.png si ese nombre está ocupado), y el mapa queda listo para pintar. La imagen es tuya para redibujarla, y Deshacer quita el mapa y los mosaicos en un solo paso.

Tamaño de celda sigue la elección, y puedes cambiarlo igualmente. Ajustes del mapa › Tileset lo enlaza más tarde con otra imagen.

Packs de assets

Pyxen incluye packs de assets — colecciones de imágenes, sonidos y tiles que puedes usar en tus proyectos. Los packs de assets usan el formato .pyxenpack (también un archivo ZIP).

Algunos packs vienen con la app. Los demás se descargan cuando los eliges: su tarjeta dice Descargar y el tamaño del pack, y un proyecto que usa un pack que este dispositivo aún no tiene ofrece la descarga en su lista de Archivos. Si la descarga no es posible (sin conexión, por ejemplo), Pyxen lo dice y tu proyecto queda como estaba. Pueden aparecer packs nuevos sin actualizar Pyxen: revisa la lista de packs al abrirse y cuando abres Packs de assets, y sin conexión muestra la última lista que vio.

La página de cada pack dice quién lo hizo y cómo puedes usarlo. La mayoría de los packs son de dominio público (CC0): úsalos libremente, también en juegos exportados. Un pack marcado Crédito obligatorio pide que tu juego nombre a su autor. Al exportar, Pyxen escribe los créditos de cada pack que usa el juego en licenses.txt y CREDITS.txt; Copiar el crédito en la página te da la línea para cualquier otro lugar.

Los archivos de un pack los comparten todos los proyectos que lo usan, así que se abren en solo lectura, con una barra que dice de quién son. Para cambiar uno, elige Editar una copia en esa barra o en el menú del archivo en Archivos (dibujar encima abre la misma hoja): el archivo, o el fotograma elegido, pasa a ser de tu proyecto, y el código que lo nombra usa la copia, en un solo paso que Deshacer revierte. La copia conserva su crédito. Ajustes del proyecto › Créditos lista todo lo que otras personas hicieron en tu juego, dice Cambiado en cuanto cambias una copia y guarda tus propios agradecimientos; Vista previa de CREDITS.txt muestra lo que escribe una exportación.

Juegos de ejemplo

Pyxen incluye juegos terminados, con todo su código y sus assets: juegos de verdad, jugables, que puedes estudiar, cambiar y de los que puedes aprender. Encuéntralos en el inicio de Pyxen, en Jugar y leer. Se abren sin guardar, así que puedes cambiar lo que quieras; guarda uno para conservar tus cambios.

Los Fragmentos del inicio tienen diez líneas cada uno: una idea, funcionando.

Dungeon Survivors son diez minutos en el Moonlit Cellar: los enemigos llegan en oleadas por todos lados, tus armas apuntan solas y cada subida de nivel ofrece elegir entre tres. Sus cinco armas están en weapons.py, una función cada una, para leerlas y cambiarlas. Los Big Slimes dejan cofres: uno hace evolucionar un arma cuando está en el nivel 8 y conservas su pasiva. A los diez minutos llega el Slime King; derrótalo y la noche está ganada.

Archivos e iCloud

Pyxen usa el modelo de documentos estándar de iPadOS y macOS. Los proyectos aparecen en Archivos en el iPad y en el Finder en el Mac, junto a tus otros documentos. Si tienes iCloud activado, tus proyectos se sincronizan automáticamente.

Una cuenta es opcional, y Pyxen no recoge telemetría. Tus archivos se quedan donde los pones.