Qu'est-ce que le format de fichier TSCN ?
Un fichier .tscn est une scène texte créée par le Godot Engine, le moteur gratuit et open-source pour la création de jeux 2D et 3D. TSCN signifie « text scene » (scène texte), et chaque fichier décrit une arborescence de scène unique : les nœuds qui composent un niveau, un personnage, un écran d'interface utilisateur ou un composant réutilisable, ainsi que leurs propriétés et connexions.
Le format est de style INI et lisible. Un fichier s'ouvre par une ligne de descripteur telle que [gd_scene format=3 uid="uid://cecaux1sm7mo0"], suivie d'entrées [ext_resource] qui pointent vers des ressources externes, d'entrées [sub_resource] qui intègrent des données comme des matériaux et des formes de collision, d'entrées [node] qui construisent l'arborescence, et d'entrées [connection] qui câblent les signaux. Godot 3.x enregistre en format=2 ; Godot 4.x enregistre en format=3 et ajoute des UID basés sur des chaînes de caractères afin qu'une scène puisse être suivie même après avoir été déplacée. Comme le format est en texte brut, il permet des comparaisons (diffs) et des fusions propres dans Git, ce qui est l'une des raisons pour lesquelles les équipes le préfèrent à la variante binaire .scn.
Sécurité et sûreté
RISQUE : LOWA .tscn is plain UTF-8 text, so it cannot execute on its own. Scenes can reference GDScript (.gd) files that do run inside Godot, so treat scenes from untrusted projects with the same caution as any downloaded source code. Opening a .tscn in a text editor is harmless.
Détails du format
en brefProgrammes qui ouvrent les fichiers TSCN
Détails techniques
spécifications approfondies| Encoding | UTF-8 plain text |
| Byte order | Not applicable (text format) |
| Container | INI-style sections with bracketed headings and key = value property lines |
| Compression | None; the text file is uncompressed. Godot compiles it to a binary form on import for faster loading. |
| Encryption | None by default |
| Typical size | A few hundred bytes to several hundred KB depending on node count and embedded sub-resources |
| Structure | Five ordered parts: a single [gd_scene] descriptor line, [ext_resource] entries pointing to external files, [sub_resource] entries holding embedded data, [node] entries describing the scene tree, and [connection] entries for signal wiring. An optional [editable] section marks instanced sub-scenes as editable. |
| Integrity | None built in |
| Platforms | Windows, macOS, Linux, Android, Web |
| Notes | The descriptor carries format=2 for Godot 3.x and format=3 for Godot 4.x. Godot 4 replaced incremental integer resource IDs with string-based uid values (uid://...). References inside the file use ExtResource("id") and SubResource("id"). Single-line comments start with a semicolon and are stripped when the editor re-saves the file. The .escn export variant uses the identical format but signals that the file came from another program and should not be hand-edited in Godot. |
| Human Readable | Yes, this is a design goal of the format for version control diffing and merging |
| Publié | 2016 (Godot 2.x era; format=2 in Godot 3.x, format=3 in Godot 4.x) |
| Dernière version | format=3 (Godot 4.x) |
| Spécification | docs.godotengine.org |
Conversions TSCN
Q&R de la communauté
posées par les utilisateursPas encore de questions - soyez le premier à poser une question sur les fichiers TSCN.
Foire aux questions
Comment ouvrir un fichier .tscn ?
Puis-je modifier un fichier .tscn à la main ?
Quelle est la différence entre .tscn et .scn ?
.tscn est du texte et se prête bien au contrôle de version, tandis que .scn est la forme binaire compilée qui se charge plus rapidement et est plus petite. Godot génère une version binaire lors de l'importation.Pourquoi mon .tscn commence-t-il par [gd_scene format=3] ?
format=3 signifie qu'il a été enregistré par Godot 4.x ; format=2 signifie Godot 3.x.