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 :
- Le renommer, le dupliquer ou le déplacer dans l’app Fichiers
- Le stocker dans iCloud et y accéder depuis plusieurs appareils
- Le partager par AirDrop, email ou tout autre moyen de partage de fichiers
- Le sauvegarder en copiant simplement le fichier
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.
- Sur Mac, Fichier › Ouvrir un dossier… ouvre un dossier de projet (un dossier contenant un
settings.pyxenproj) là où il est. Sous Windows, l’accueil liste les projets en dossier du dossier de Pyxen : ouvrez-en un depuis l’accueil. - Convertir en dossier crée un projet en dossier à partir du
.pyxenouvert, à côté de lui ; Convertir en fichier .pyxen fait un seul fichier d’un projet en dossier. Les deux sont dans le menu Fichier, dans le menu qui s’ouvre quand vous cliquez sur le nom du projet dans la barre de titre, et dans le menu d’un projet sur l’accueil. Ce que vous avez converti reste tel quel ; si son nom est déjà pris, le nouveau s’appelle « Cave Jump 2 ». Un projet en dossier affiche Dossier à côté de son nom dans la barre de titre. - Enregistrer… demande comment garder un nouveau projet : Fichier .pyxen ou Dossier.
- Pyxen écrit vos modifications dans les fichiers du dossier au fur et à mesure. Sur Mac, quand un fichier change hors de Pyxen, il apparaît aussitôt dans Pyxen ; Annuler rétablit ce qui était là. Si vous avez aussi modifié ce fichier dans Pyxen et que ces modifications ne sont pas encore écrites, Pyxen demande laquelle garder, et la version que vous ne gardez pas va dans la Corbeille. Sous Windows, Pyxen n’écrit que les fichiers que vous avez modifiés, et laisse tel quel un fichier modifié hors de Pyxen : fermez le projet et rouvrez-le pour voir le changement. Un fichier que vous supprimez va dans la Corbeille.
- Un dossier de projet dans iCloud Drive dont les fichiers ne sont pas encore sur ce Mac affiche Téléchargement… ; Pyxen les demande à iCloud et ouvre le projet dès qu’ils sont tous là.
- Un projet en dossier compte pour un projet, comme un
.pyxen.
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 :
- Images — fichiers PNG utilisés pour les sprites et les feuilles de tiles
- Sons — fichiers WAV pour les effets sonores
- Musique — fichiers OGG Vorbis, MIDI et modules tracker (MOD, XM, IT, S3M) pour la musique de fond
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 :
- Avec une image du projet ou d’un pack, la carte l’utilise telle quelle. Rien d’autre n’est ajouté.
- Avec les Tuiles de Pyxen, Créer ajoute aussi
tiles.pngau projet (tiles2.pngsi ce nom est pris), et la carte est prête à peindre. L’image est à vous, à redessiner comme vous voulez, et Annuler reprend la carte et les tuiles en une seule étape.
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 :
- Déplacement : Déplacement de plateforme, Déplacement vu de dessus, Pas sur la grille, Rebonds
- Combat : Vie et dégâts, Ennemis, Coup d’épée, Vagues d’ennemis
- Collecte : Objets à ramasser, Améliorations
- Interface : Contrôles, Écrans, Score et meilleurs scores, Minuteur, Boîte de dialogue, Montée de niveau, Explosion de particules
- Caméra : Caméra qui suit
- Monde : Niveau en lettres, Plateformes mobiles, Défilement
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.