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:

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.

En Windows, Pyxen los guarda en Documentos › Pyxen: Ajustes › General › Proyectos lo dice, y Mostrar en el Explorador de 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.

En Windows, es Mostrar en el Explorador de archivos, en los mismos sitios, o Archivo › Mostrar en el Explorador de archivos (Ctrl+Alt+R).

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.

Proyectos en carpeta

En el Mac y en Windows, un proyecto también puede ser una carpeta de archivos normales en lugar de un solo .pyxen: los mismos archivos que contiene un .pyxen, uno al lado del otro, para que un editor de texto, git o una app de IA trabajen con ellos directamente.

Pyxen 26.6 y anteriores, y Pyxen en iPad, solo abren archivos .pyxen: convierte un proyecto en carpeta en un archivo .pyxen para ellos o para compartirlo.

Añadir assets

Tu proyecto puede contener:

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:

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

Los Mosaicos de Pyxen se dibujan con el estilo de los gráficos del proyecto. Ajustes del proyecto › Gráficos › Cambiar estilo… vuelve a dibujar tiles.png mientras no lo hayas cambiado, y después lo deja como está.

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.

Mecánicas

Las mecánicas son piezas de juego listas para usar, escritas en Pyxen Script: movimiento de plataformas, salud y daño, objetos para recoger, una puntuación, una cámara que sigue al héroe y más. Ábrelas desde Ajustes del proyecto › Mecánicas, desde Mecánicas… en el menú ⋯, o con el + del grupo Mecánicas en Archivos.

Allí están ordenadas por lo que hacen:

Nivel con letras construye un nivel a partir de filas de letras en tu código, o de un mapa pintado en el editor de mapas de mosaicos, donde encuentra cada objeto por su nombre.

Cada mecánica tiene su página. Su escena de prueba se ejecuta allí como demo: haz clic en ella para jugar con las teclas y pulsa Esc para devolver las teclas. Los deslizadores de sus ajustes cambian la demo mientras arrastras, sin guardar nada. Cómo se usa muestra las líneas que hay que escribir, Código el archivo entero y Lo que ofrece sus funciones, como las muestra el autocompletado.

Añadir al proyecto copia el archivo de la mecánica en tu proyecto, con sus comentarios en tu idioma y con las mecánicas que necesita (el botón las nombra). Es un solo paso: Deshacer lo quita todo. El archivo es tuyo, para leerlo y cambiarlo. Archivos lo muestra en Mecánicas con su versión y dice Modificado en cuanto lo editas. Quitar… pregunta antes y nombra las mecánicas que la necesitan.

Los ajustes de una mecánica son números en su archivo, como JUMP: tune(2, 16) = 11. Ajustes del proyecto › Mecánicas los muestra como deslizadores, igual que la pestaña Mecánicas del inspector mientras el juego se ejecuta: arrastra uno y el juego en marcha cambia al instante; suéltalo y el número se escribe en el archivo, un solo paso para Deshacer. Restablecer todo devuelve los números de una mecánica. Con Ejecutar automáticamente desactivado, el motor ya no ejecuta la mecánica por ti, y la página muestra la línea para llamarla desde tu update(). Tus propios scripts también pueden tener ajustes: escribe NAME: tune(1, 10) = 5 # lo que hace y aparecerán bajo el nombre del archivo.

Cuando una mecánica encuentra algo mal en cómo se la llama, el error aparece en tu línea, con las palabras de la mecánica y su propia línea debajo.

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 son cortos: una idea cada uno, funcionando, casi siempre en diez líneas. Tres son pequeños programas completos para desmontar: Pong, Game of Life y Particles.

Un ejemplo que nació de un starter muestra Crear uno como este debajo: abre Nuevo proyecto con ese starter elegido. El de Crownwood abre el starter Adventure, y el de Platformer, el starter Platformer. Mientras no tengas ningún proyecto, Continuar muestra los starters que son un buen primer juego.

Platformer es la forma terminada del starter Platformer: cinco niveles pintados en el editor de mapas de mosaicos, una idea cada uno. Spring Meadow tiene muelles, Sky Bridge plataformas móviles, Locked Tower una llave y una puerta, Slime Caves slimes que aplastar y tres corazones, y The Belfry un murciélago gigante que aplastar tres veces.

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.

Crownwood es una aventura con espada por seis pantallas de prado, bosque y agua: encuentra la espada en el pueblo, ábrete paso entre los arbustos, lee los letreros y sigue la corona hacia el este. La cámara se desliza de una pantalla a otra, y la partida se guarda cada vez que entras en una. Su mundo está pintado en el editor de mapas de mosaicos, con el héroe, los enemigos y los corazones colocados en su capa Objetos. En el bosque del este, una cueva baja al Sótano de los Slimes, seis salas: una sala de las rejas que se cierran hasta que no quede ningún slime, una llave y una puerta cerrada con llave, las Bombas (X, o el botón de las bombas en una pantalla táctil), que abren para siempre los muros y rocas agrietados, y el Slime Gigante, cuya vida es la barra de abajo; vencido, deja un contenedor de corazón. El sótano también está pintado en el editor de mapas de mosaicos.

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. En Windows, los proyectos son archivos en el Explorador de archivos, como tus otros documentos.

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