> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Les fichiers acceptés par Celestory, et comment les organiser

# 📁 Les fichiers acceptés par Celestory, et comment les organiser

Chaque projet a sa médiathèque, ouverte par le menu **Fichiers** (`Cmd/Ctrl + Maj + E`). Tout ce que vos blocs affichent ou jouent vient de là.

## 🖼️ Les images

| Format | Extension | À savoir |
| --- | --- | --- |
| PNG | `.png` | Transparence conservée. |
| JPEG | `.jpg`, `.jpeg` | Léger, pour les photos. |
| WEBP | `.webp` | Bon compromis poids / qualité. |
| GIF | `.gif` | Animé, lu tel quel. |
| SVG | `.svg` | Vectoriel, net à toutes les tailles. |
| ICO / ICNS | `.ico`, `.icns` | Icônes d'application. |

## 🔊 Les sons

| Format | Extension | À savoir |
| --- | --- | --- |
| MP3 | `.mp3` | Le format le plus sûr. |
| WAV | `.wav` | Non compressé, donc lourd. |
| OGG | `.ogg` | Compressé, bonne qualité. |
| WEBM | `.webm` | Piste audio seule. |

Vous pouvez aussi enregistrer au micro : le son arrive en MP3.

## 🎬 Les vidéos

| Format | Extension | À savoir |
| --- | --- | --- |
| MP4 | `.mp4` | Le choix par défaut. |
| WEBM | `.webm` | Alternative légère. |
| MOV | `.mov` | Format QuickTime. |
| MPEG | `.mpeg`, `.mpg` | Format ancien. |

## 📄 Les documents et les données

| Format | Extension | À savoir |
| --- | --- | --- |
| Texte | `.txt` | Lisible dans l'aperçu. |
| Markdown | `.md` | Idéal pour les textes longs. |
| HTML | `.html` | Affiché dans l'aperçu. |
| PDF | `.pdf` | Feuilletable dans l'aperçu. |
| JSON | `.json` | Pour vos données de jeu. |

🔺 Un JSON apparaît en **Type** « Fichier inconnu », sans aperçu. C'est normal : il est bien stocké et utilisable.

## 🔤 Les polices

| Format | Extension | À savoir |
| --- | --- | --- |
| OTF | `.otf` | Aperçu en quatre tailles. |
| TTF | `.ttf` | Idem. |

## 🦴 L'animation 2D avec Spine

Une animation Spine demande **trois fichiers**, téléversés séparément puis désignés un par un dans la ressource Spine : la texture en **PNG**, le squelette en **JSON**, l'atlas en **`.atlas`**.

🔺 Gardez l'extension `.atlas` telle quelle. Celestory reconnaît les fichiers par leur extension : renommé en `.txt`, votre atlas devient un fichier texte et disparaît du sélecteur d'atlas. Dans la liste, un `.atlas` s'affiche comme « Fichier inconnu » : c'est attendu.

## ⬆️ Ajouter des fichiers

Le bouton **+**, en bas de la colonne de gauche, ouvre quatre entrées : **Ajouter fichier(s)** (sélection multiple), **Ajouter un dossier**, **Enregistrer du son** et **Génération IA**.

🔺 On ne dépose pas un fichier depuis son bureau : le glisser-déposer sert uniquement à ranger les fichiers déjà présents. Passez par le bouton **+**. Sur une fenêtre étroite, la colonne de gauche est masquée et le bouton **+** avec elle : élargissez la fenêtre.

## 🗂️ Ranger sa médiathèque

- **Des dossiers, pas d'étiquettes.** Celestory ne propose ni tags ni libellés : votre rangement repose sur les dossiers et sur des noms clairs.
- **Déplacer** : faites glisser vos fichiers sur un dossier, ou sur la flèche de retour pour remonter d'un niveau.
- **Rechercher** : le champ de recherche balaye tout le projet, et non le seul dossier ouvert.
- **Trier** : cliquez sur les en-têtes Nom, Date, Taille ou Type.

## 📊 L'espace disponible

Une jauge en bas de la liste indique « X utilisés sur Y ». Ce quota est propre au projet et dépend de votre offre. Un téléversement qui le dépasserait est refusé, et rien n'est conservé.

🔺 Un fichier isolé ne peut pas dépasser environ 2 Go.

## 🔁 Remplacer un fichier sans casser vos liens

Sélectionnez **un seul** fichier, ouvrez le menu **⋯** puis **Réimporter**. Le fichier garde son identité, son nom et son emplacement : les blocs qui l'utilisent continuent de pointer dessus, sans reconnexion. Seuls le contenu, le poids et la date changent.

La fenêtre de sélection ne proposera que des fichiers du même format que l'original. Pour changer de format, téléversez un nouveau fichier et rebranchez vos blocs.

→ Prochaine étape : branchez ces fichiers sur vos blocs avec **La Gestion des Contenus**.