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.

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.

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.

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.

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.

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 font dix lignes chacun : une idée, qui tourne.

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.

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.

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