Projets et assets

Pyxen utilise un modèle de projet simple, basé sur les fichiers : vos projets sont des fichiers sur votre appareil. Un compte est facultatif, et rien n’en a besoin.

Le format .pyxen

Un projet Pyxen est un fichier .pyxen. C’est une archive ZIP contenant votre code, vos images et vos sons. Vous pouvez :

Comme c’est un ZIP standard, vous pouvez même le décompresser sur un ordinateur pour inspecter son contenu.

Un projet se souvient du Pyxen qui l’a enregistré. Un projet créé avec un Pyxen plus récent s’ouvre et se lance quand même ; la première fois que vous l’ouvrez, Pyxen indique une fois que les nouveautés de cette version peuvent ne pas s’afficher ou ne pas fonctionner avant la mise à jour. Rien n’est refusé.

Où sont vos projets

Pyxen range les projets que vous enregistrez dans son dossier : iCloud Drive › Pyxen quand iCloud Drive est activé pour Pyxen, sinon le dossier de Pyxen sur l’appareil (Sur mon Mac › Pyxen sur Mac, Sur mon iPad › Pyxen dans l’app Fichiers sur iPad). Réglages › Général › Projets indique lequel, et Afficher dans le Finder (sur iPad, Afficher dans Fichiers) l’ouvre.

Sous Windows, Pyxen les range dans Documents › Pyxen : Réglages › Général › Projets l’indique, et Afficher dans l’Explorateur de fichiers l’ouvre.

Pour le projet ouvert, cliquez ou touchez son nom dans la barre de titre et choisissez Afficher dans le Finder (Afficher dans Fichiers sur iPad), ou choisissez Fichier › Afficher dans le Finder (⌥⌘R). Sur l’accueil, c’est dans le menu d’un projet. L’app Fichiers ne peut pas sélectionner un fichier : sur iPad, elle ouvre le dossier qui contient le projet. Un projet pas encore enregistré n’est dans aucun dossier : son menu propose Enregistrer… à la place.

Sous Windows, c’est Afficher dans l’Explorateur de fichiers, aux mêmes endroits, ou Fichier › Afficher dans l’Explorateur de fichiers (Ctrl+Alt+R).

Un projet enregistré ou ouvert ailleurs reste où il est : Pyxen l’affiche dans Continuer et ne le déplace jamais. Pendant que vous essayez Pyxen, ce sont les projets de son dossier qui comptent.

Projets en dossier

Sur Mac et sur Windows, un projet peut aussi être un dossier de fichiers ordinaires plutôt qu’un seul .pyxen : les mêmes fichiers qu’un .pyxen contient, côte à côte, pour qu’un éditeur de texte, git ou une app d’IA puissent les modifier directement.

Pyxen 26.6 et les versions précédentes, ainsi que Pyxen sur iPad, n’ouvrent que les fichiers .pyxen : convertissez un projet en dossier en fichier .pyxen pour eux ou pour le partager.

Ajouter des assets

Votre projet peut contenir :

Le README.md d’un projet et ses traductions, comme README.fr.md, forment une seule ligne Lisez-moi en haut de Fichiers, au-dessus de Scripts. Elle ouvre la page dans votre langue. Son menu propose les autres langues (Ouvrir dans une autre langue) et Modifier comme texte, qui ouvre le fichier lui-même.

Ajoutez des assets avec Fichier › Importer des images ou des sons…, ou créez-en un avec Fichier › Nouvel asset… (le + de Fichiers). Une fois ajoutés, vous les référencez par leur nom dans votre code :

Sprite("hero")       # référence une image nommée "hero"
Sound("jump")        # référence un son nommé "jump"
Music("overworld")   # référence une piste musicale nommée "overworld"

Une nouvelle carte de tuiles

Dans Fichier › Nouvel asset…, Carte de tuiles demande avec quelles tuiles peindre la carte. Elle montre les images du projet, chacune avec le nombre de tuiles qu’elle donne, puis les images des asset packs que le projet utilise, sous le nom de chaque pack, et pour finir les Tuiles de Pyxen : sol, murs, dalles, une porte, une cible, des collines, des nuages, des buissons et une caisse, 40 tuiles de 16 pixels dans la palette du projet.

Une nouvelle carte part des tuiles qu’une autre carte du projet utilise, sinon d’une image dont le nom dit « tiles », sinon des Tuiles de Pyxen. Tileset nomme le choix, et la ligne en dessous dit ce que fait Créer :

Taille de cellule suit le choix, et vous pouvez toujours la changer. Réglages de la carte › Tileset la relie plus tard à une autre image.

Les Tuiles de Pyxen sont dessinées dans le style graphique du projet. Réglages du projet › Graphismes › Changer de style… redessine tiles.png tant que vous ne l’avez pas modifié, et le laisse tel quel ensuite.

Asset packs

Pyxen inclut des asset packs — des collections d’images, de sons et de tiles que vous pouvez utiliser dans vos projets. Les asset packs utilisent le format .pyxenpack (également une archive ZIP).

Quelques packs sont fournis avec l’app. Les autres se téléchargent quand vous les choisissez : leur carte indique Télécharger et la taille du pack, et un projet qui utilise un pack absent de cet appareil propose le téléchargement dans sa liste Fichiers. Si le téléchargement est impossible (hors ligne, par exemple), Pyxen le dit et votre projet reste tel quel. De nouveaux packs peuvent apparaître sans mise à jour de Pyxen : il consulte la liste des packs à son ouverture et quand vous ouvrez Packs d’assets, et hors ligne il montre la dernière liste vue.

La page de chaque pack indique qui l’a créé et comment l’utiliser. La plupart des packs sont dans le domaine public (CC0) : utilisez-les librement, y compris dans les jeux exportés. Un pack marqué Crédit obligatoire demande que votre jeu nomme son auteur. À l’export, Pyxen écrit les crédits de chaque pack utilisé par le jeu dans licenses.txt et CREDITS.txt ; le bouton Copier le crédit de la page vous donne la ligne pour tout autre usage.

Les fichiers d’un pack sont partagés par tous les projets qui l’utilisent : ils s’ouvrent donc en lecture seule, avec une barre qui dit à qui ils appartiennent. Pour en changer un, choisissez Modifier une copie dans cette barre ou dans le menu du fichier dans Fichiers (dessiner dessus ouvre la même feuille) : le fichier, ou l’image choisie, devient celui de votre projet, et le code qui le nomme utilise la copie, en une seule étape qu’Annuler reprend. La copie garde son crédit. Réglages du projet › Crédits liste tout ce que d’autres ont fait dans votre jeu, indique Modifié dès que vous changez une copie et garde vos propres remerciements ; Aperçu de CREDITS.txt montre ce qu’un export écrit.

Mécaniques

Les mécaniques sont des pièces de jeu toutes prêtes, écrites en Pyxen Script : le déplacement de plateforme, la santé et les dégâts, les objets à ramasser, un score, une caméra qui suit le héros, et d’autres. Ouvrez-les depuis Réglages du projet › Mécaniques, depuis Mécaniques… dans le menu ⋯, ou avec le + du groupe Mécaniques dans Fichiers.

Elles y sont classées par ce qu’elles font :

Niveau en lettres construit un niveau à partir de lignes de lettres dans votre code, ou d’une carte peinte dans l’éditeur de cartes de tuiles, où il trouve chaque objet par son nom.

Chaque mécanique a sa page. Sa scène de test y tourne en démo : cliquez dessus pour y jouer avec les touches, et appuyez sur Échap pour rendre les touches. Les curseurs de ses réglages changent la démo pendant que vous les faites glisser, sans rien enregistrer. Mode d’emploi montre les lignes à écrire, Code le fichier entier, et Ce qu’elle offre ses fonctions, comme la complétion les montre.

Ajouter au projet copie le fichier de la mécanique dans votre projet, ses commentaires dans votre langue, avec les mécaniques dont elle a besoin (le bouton les nomme). C’est une seule étape : Annuler retire tout. Le fichier est à vous, à lire et à changer. Fichiers le range sous Mécaniques avec sa version, et indique Modifié dès que vous le changez. Retirer… demande d’abord, et nomme les mécaniques qui en ont besoin.

Les réglages d’une mécanique sont des nombres dans son fichier, comme JUMP: tune(2, 16) = 11. Réglages du projet › Mécaniques les montre en curseurs, tout comme l’onglet Mécaniques de l’inspecteur pendant que le jeu tourne : faites glisser un curseur et le jeu en cours change aussitôt ; lâchez-le et le nombre est écrit dans le fichier, une seule étape pour Annuler. Tout réinitialiser remet les nombres d’une mécanique. Avec Lancer automatiquement désactivé, le moteur ne lance plus la mécanique pour vous, et la page montre la ligne pour l’appeler depuis votre update(). Vos propres scripts peuvent aussi avoir des réglages : écrivez NAME: tune(1, 10) = 5 # ce que ça fait, et ils s’affichent sous le nom du fichier.

Quand une mécanique trouve une erreur dans la façon dont elle est appelée, l’erreur s’affiche à votre ligne, dans les mots de la mécanique, avec la ligne de la mécanique en dessous.

Jeux exemples

Pyxen est fourni avec des jeux terminés, avec tout leur code et leurs assets : de vrais jeux jouables que vous pouvez étudier, modifier et dont vous pouvez apprendre. Retrouvez-les dans l’accueil de Pyxen, sous Jouer et lire. Ils s’ouvrent sans être enregistrés, vous pouvez donc tout changer ; enregistrez-en un pour garder vos modifications.

Les Extraits de l’accueil sont courts : une idée chacun, qui tourne, le plus souvent en dix lignes. Trois sont de petits programmes entiers à démonter : Pong, Game of Life et Particles.

Un exemple né d’un starter affiche En créer un comme celui-ci sous sa vignette : Nouveau projet s’ouvre avec ce starter choisi. Celui de Crownwood ouvre le starter Adventure, celui de Platformer le starter Platformer. Tant que vous n’avez aucun projet, Continuer montre les starters qui font un bon premier jeu.

Platformer est la forme terminée du starter Platformer : cinq niveaux peints dans l’éditeur de cartes de tuiles, une idée chacun. Spring Meadow a des ressorts, Sky Bridge des plateformes mobiles, Locked Tower une clé et une porte, Slime Caves des slimes à écraser et trois cœurs, et The Belfry une grande chauve-souris à écraser trois fois.

Dungeon Survivors, ce sont dix minutes dans le Moonlit Cellar : les ennemis arrivent par vagues de tous côtés, vos armes visent toutes seules, et chaque montée de niveau propose un choix parmi trois. Ses cinq armes sont dans weapons.py, une fonction chacune, à lire et à modifier. Les Big Slimes laissent des coffres : l’un d’eux fait évoluer une arme quand elle est au niveau 8 et que vous gardez son passif. À dix minutes vient le Slime King ; faites-le disparaître et la nuit est gagnée.

Crownwood est une aventure à l’épée sur six écrans de prés, de bois et d’eau : trouvez l’épée au village, taillez-vous un chemin dans les buissons, lisez les panneaux et suivez la couronne vers l’est. La caméra glisse d’un écran à l’autre, et la partie est sauvegardée chaque fois que vous entrez dans un écran. Son monde est peint dans l’éditeur de cartes de tuiles, le héros, les ennemis et les cœurs posés sur son calque Objets. Dans le bois de l’est, une grotte descend à la Cave aux slimes, six salles : une salle aux grilles qui se ferment jusqu’à ce que son dernier slime soit parti, une clé et une porte fermée à clé, les Bombes (X, ou le bouton des bombes sur un écran tactile), qui ouvrent pour de bon les murs et rochers fissurés, et le Gros Slime, dont la vie est la barre en bas de l’écran ; battu, il laisse un réceptacle de cœur. La cave est peinte elle aussi dans l’éditeur de cartes de tuiles.

Fichiers et iCloud

Pyxen utilise le modèle de documents standard d’iPadOS et de macOS. Les projets apparaissent dans Fichiers sur iPad et dans le Finder sur Mac, à côté de vos autres documents. Si iCloud est activé, vos projets se synchronisent automatiquement. Sous Windows, les projets sont des fichiers dans l’Explorateur de fichiers, comme vos autres documents.

Un compte est facultatif, et Pyxen ne collecte aucune télémétrie. Vos fichiers restent là où vous les mettez.