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.
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.
- En el Mac, Archivo › Abrir carpeta… abre una carpeta de proyecto (una carpeta con un
settings.pyxenprojdentro) donde está. En Windows, el inicio muestra los proyectos en carpeta de la carpeta de Pyxen: abre uno desde ahí. - Convertir en carpeta crea un proyecto en carpeta a partir del
.pyxenabierto, a su lado; Convertir en archivo .pyxen hace un solo archivo de un proyecto en carpeta. Los dos están en el menú Archivo, en el menú que se abre al hacer clic en el nombre del proyecto en la barra de título y en el menú de un proyecto en el inicio. Lo que convertiste queda como estaba; si su nombre ya existe, el nuevo se llama «Cave Jump 2». Un proyecto en carpeta muestra Carpeta junto a su nombre en la barra de título. - Guardar… pregunta cómo guardar un proyecto nuevo: Archivo .pyxen o Carpeta.
- Pyxen escribe tus cambios en los archivos de la carpeta mientras trabajas. En el Mac, cuando un archivo cambia fuera de Pyxen, aparece enseguida en Pyxen; Deshacer recupera lo que había. Si también cambiaste ese archivo en Pyxen y esos cambios aún no están escritos, Pyxen pregunta cuál conservar, y la versión que no conservas va a la Papelera. En Windows, Pyxen escribe solo los archivos que cambiaste, y deja como está un archivo cambiado fuera de Pyxen: cierra el proyecto y ábrelo de nuevo para ver el cambio. Un archivo que eliminas va a la Papelera de reciclaje.
- Una carpeta de proyecto en iCloud Drive cuyos archivos aún no están en este Mac muestra Descargando…; Pyxen se los pide a iCloud y abre el proyecto cuando están todos.
- Un proyecto en carpeta cuenta como un proyecto, igual que un
.pyxen.
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:
- 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.pngal proyecto (tiles2.pngsi 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.
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:
- Movimiento: Movimiento de plataformas, Movimiento cenital, Pasos en cuadrícula, Rebote
- Combate: Vida y daño, Enemigos, Golpe, Oleadas
- Recolectar: Recogibles, Mejoras
- Interfaz: Controles, Pantallas, Puntuación y récords, Temporizador, Cuadro de diálogo, Subir de nivel, Explosión de partículas
- Cámara: Cámara que sigue
- Mundo: Nivel con letras, Plataformas móviles, Desplazamiento
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.