Bibliothèque et collections

Les collections contiennent les ressources que tu réutilises d'un niveau à l'autre. Un niveau ne renvoie jamais à une collection : l'import copie la ressource à l'intérieur, et le niveau se joue partout

Ce qu'est une collection

Une collection est un dossier de ressources réutilisables. Elle peut contenir des ressources de sept types :

Une collection n'est pas liée à un niveau. Elle se trouve sur ton appareil et est disponible dans n'importe quel niveau que tu ouvres

Sources

La bibliothèque montre des ressources de trois sources. Chacune est une pastille de filtre au-dessus de la liste :

Une collection en lecture seule se modifie ainsi : ses entrées sont copiées dans une de tes collections

L'onglet "Bibliothèque"

Bibliothèque est le dernier onglet de l'écran d'accueil de l'éditeur, après Communauté

Une étroite colonne de boutons choisit le type :

• Collections
• Prefabs, Thèmes, Formes, Effets
• Textures, Polices, Audio

À sa droite, le titre de la page (à gauche) et ses boutons (à droite) se tiennent sur une seule rangée. La liste est en dessous. Une liste vide le dit en son milieu

Sur les pages des sept types, de Prefabs à Audio, Collection cible occupe une rangée à part, sur toute la largeur, sous le titre. Les pastilles des sources se tiennent dans la rangée en dessous

Une fenêtre de la bibliothèque (la fiche d'une collection, l'image d'une texture, la fenêtre de partage) se ferme avec la croix dans son coin. Il n'y a pas de bouton Fermer

Chaque ligne est un bouton. Appuyer dessus fait l'action principale de son type :

Les petits boutons à droite d'une ligne sont les autres actions, et l'icône de corbeille supprime ou retire

Ouvrir le dossier montre le dossier de la page actuelle dans le gestionnaire de fichiers du système. Disponible seulement sur Windows, macOS et Linux

Collections

Ouvrir le dossier et Actualiser se tiennent à droite du titre de la page. Nouvelle collection et Importer une archive sont dans une rangée à part en dessous, alignés à droite

• Nouvelle collection crée une collection vide et ouvre sa fiche
• Importer une archive ajoute une collection depuis un fichier .zip ou .tar.gz, ou depuis une archive protégée par mot de passe : un .zip avec son propre mot de passe, .zip.gpg ou .tar.gz.gpg. Si cette collection est déjà sur l'appareil, le jeu demande s'il faut la remplacer

Une archive protégée par mot de passe ouvre la fenêtre Mot de passe requis : Cette archive est chiffrée. Saisis son mot de passe pour l'ouvrir. Saisis le mot de passe et appuie sur Ouvrir. Un mauvais mot de passe affiche Ce mot de passe n'ouvre pas cette archive. Réessaie

• Ouvrir le dossier ouvre resources/collections
• Actualiser relit les dossiers

Tes propres collections ont Modifier et l'icône de corbeille. La corbeille demande d'abord, puis supprime la collection avec tous ses fichiers

Fiche d'une collection

Modifier ouvre une fenêtre avec la fiche de la collection :

• Nom, Description
• Auteurs, séparés par des virgules
• Licence : Non indiquée ou l'une des licences courantes
• Couverture choisit une image png. La ligne à côté indique s'il y a une couverture

Enregistrer écrit la fiche. Annuler, la croix ou un clic hors de la fenêtre abandonne les changements

Page d'une collection

En dessous se trouve le contenu. Une ligne ouvre l'entrée de la même façon que la page de son type, et l'icône de corbeille retire l'entrée de la collection

Une collection en lecture seule affiche Lecture seule. Copie ses entrées dans ta propre collection pour les modifier

Plus sur Partager - Publication

Prefabs, thèmes, formes, effets

Chacune de ces pages montre chaque entrée de chaque source. Les pastilles restreignent la liste

Collection cible choisit une de tes collections. Par défaut, c'est Non choisie. Une fois une cible choisie, chaque ligne venue d'ailleurs reçoit Copier

Un thème, une forme ou un effet s'ouvre dans le même éditeur que dans les paramètres du niveau. Enregistrer écrit la modification là où vit l'entrée : dans Ma bibliothèque ou dans ta collection. Une entrée du Workshop s'ouvre en lecture seule, et Enregistrer est désactivé. Pour la modifier, copie-la dans une de tes collections

Créer crée un nouveau thème, une nouvelle forme ou un nouvel effet dans l'éditeur. L'entrée est enregistrée dans la collection cible, ou dans Ma bibliothèque si aucune cible n'est choisie. Les prefabs se créent dans un niveau, et ils n'ont pas de Créer

Les entrées que tu peux modifier ont l'icône de corbeille, et elle demande d'abord

Chaque ligne a Partager. Le bouton emballe l'entrée avec tout ce dont elle a besoin (par exemple les formes, les textures et les prefabs imbriqués d'un prefab) dans un .zip ou un .tar.gz, avec ou sans mot de passe, sous forme de collection d'une seule entrée. Le destinataire importe ce fichier par Importer une archive, comme n'importe quelle collection

Ouvrir le dossier ouvre le dossier de la bibliothèque de l'appareil pour ce type, par exemple resources/themes

Textures, polices, audio

Ces pages montrent les fichiers de toutes les collections. Il n'y a pas de bibliothèque personnelle pour les fichiers, donc ces types ne vivent que dans des collections

• une ligne de texture montre l'image
• une ligne audio a un bouton de lecture. Une seule piste joue à la fois, et elle s'arrête quand tu quittes la page
• une ligne de police n'a pas d'aperçu

Ajouter un fichier place un fichier de l'appareil dans la collection cible, donc sans cible le bouton est désactivé. Une texture est en png ou jpg, une police en ttf ou otf, l'audio en mp3, wav ou ogg. Si la collection a déjà un fichier avec les mêmes octets, rien n'est ajouté, et le jeu le dit

Les lignes ont Copier et l'icône de corbeille

Ce qu'une copie emporte

Une copie emporte tout ce dont l'entrée a besoin : les formes, les textures, les polices et les prefabs imbriqués d'un prefab, la forme des particules d'un effet. Les informations d'auteur de ces ressources les accompagnent aussi

L'onglet "Collections"

Collections est un onglet des paramètres du niveau, juste après Prefabs. En haut, il y a deux modes : Importer et Assembler une collection

Import

1. L'onglet montre une liste de collections. Appuie sur celle qu'il te faut
2. Coche les entrées qu'il te faut. Tout et Rien cochent tout ou décochent tout
3. La ligne Selected: N, dependencies added: M montre ce qui entrera dans le niveau. Les dépendances s'ajoutent d'elles-mêmes
4. Appuie sur Importer

Tout l'import est une seule étape d'annulation

Les textures, les polices et l'audio reçoivent de nouveaux ID dans le niveau, et leurs fichiers sont copiés dans le dossier du niveau sous un nom unique. Un fichier que le niveau possède déjà octet pour octet n'est pas copié une seconde fois : l'import prend la texture, la police ou la piste propre au niveau

Construire une collection

1. Vers choisit Une nouvelle collection ou une des tiennes. Une nouvelle prend son nom dans le champ Nom
2. Coche les ressources du niveau, de n'importe lequel des sept types
3. Appuie sur Assembler

Une nouvelle collection reçoit les auteurs du niveau

Une collection ne peut pas être construite à partir d'un niveau protégé. Plus - Export et protection

Choix des ressources et recherche

La recherche et les fenêtres de choix de ressources ont un niveau Bibliothèque pour les prefabs, les thèmes, les formes et les effets. Il montre toutes les sources. Les fenêtres de choix sont les champs de forme, de collider, d'effet et de thème, ainsi que Placer un prefab…

Choisir une entrée de la bibliothèque l'importe dans le niveau avec ses dépendances et l'assigne. Un conflit pose la même question que dans l'onglet "Collections"

Les navigateurs de bibliothèque dans les onglets de ressources du niveau fonctionnent de la même façon et montrent les pastilles des sources. Plus - Ressources du niveau

Conflits

Une entrée importée peut déjà être dans le niveau avec le même ID :

• même contenu - rien à faire
• contenu différent - la fenêtre Déjà dans le niveau s'ouvre

La fenêtre liste chaque conflit, chacun avec un interrupteur Importer comme copie :

Tout garder et Tout copier règlent tous les interrupteurs d'un coup. Importer applique le choix, Annuler n'importe rien

Aucune version ne l'emporte en silence. Chaque conflit avec un contenu différent se tranche dans cette fenêtre

Paternité

Les fiches sur les ressources d'un niveau couvrent les thèmes, les effets, les formes et les prefabs, ainsi que les textures, les polices et l'audio. L'import copie les fiches nécessaires dans le niveau, donc la paternité arrive avec la ressource

Plus - La fiche de ressource

Sur le disque

Les collections vivent dans resources/collections/<collection-guid>/ dans le dossier de données du jeu. C'est le même dossier resources à côté de levels où vit la bibliothèque de l'appareil. Plus - Le dossier du niveau et les sauvegardes

Une collection se transmet sous forme d'archive : Partager sur sa page, Importer une archive dans la liste. Une archive qui n'est pas une collection est refusée

À lire ensuite : Publication, Réutiliser : prefabs, copie, générateurs, La fiche de ressource