O que é o formato de ficheiro TSCN?
Um arquivo .tscn é uma cena de texto criada pela Godot Engine, o motor gratuito e de código aberto para a criação de jogos 2D e 3D. TSCN significa «text scene» (cena de texto), e cada arquivo descreve uma única árvore de cena: os nós que compõem um nível, personagem, tela de interface de usuário ou componente reutilizável, junto com suas propriedades e conexões.
O formato é do estilo INI e legível. Um arquivo começa com uma linha descritora como [gd_scene format=3 uid="uid://cecaux1sm7mo0"], seguida por entradas [ext_resource] que ligam a ativos externos, entradas [sub_resource] que incorporam dados como materiais e formas de colisão, entradas [node] que constroem a árvore e entradas [connection] que conectam os sinais. A Godot 3.x salva como format=2; a Godot 4.x salva como format=3 e adiciona UIDs baseados em strings para que uma cena possa ser rastreada mesmo após ser movida. Como o formato é texto simples, ele permite diffs e mesclagens limpas no Git, que é uma das razões pelas quais as equipes o preferem em vez da variante binária .scn.
Segurança e proteção
RISCO: 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.
Detalhes do formato
em resumoProgramas que abrem arquivos TSCN
Windows3 apps
Notepad
Código aberto Open the .tscn file as plain text to inspect or manually edit node properties and resource paths. 
Godot Engine
Código aberto Launch Godot, open the project, then double-click the scene in the FileSystem dock or use Scene > Open Scene to edit it visually.
Visual Studio Code + godot-tools
Gratuito Install the godot-tools extension, then open the .tscn file for syntax highlighting and jump-to-Godot editing. 
macOS2 apps
Godot Engine
Código aberto Open the project in Godot and load the scene from the FileSystem dock to edit it in the scene editor.
Visual Studio Code + godot-tools
Gratuito Open the .tscn with the godot-tools extension installed to get scene syntax highlighting and Godot integration. 
Linux2 apps
Godot Engine
Código aberto Run the Godot binary, open your project, and select the scene to edit it visually or run it.
Visual Studio Code + godot-tools
Gratuito Edit the .tscn as text with syntax highlighting and open it back in Godot from the editor. 
Android1 app
Godot Editor for Android
Código aberto Open the project in the Android build of the Godot 4 editor and load the scene to edit it on a tablet.
Godot Web Editor
Código aberto Upload or import a project in the browser-based Godot editor and open the scene to edit it without installing anything. Detalhes técnicos
especificação profunda| 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 |
| Lançado | 2016 (Godot 2.x era; format=2 in Godot 3.x, format=3 in Godot 4.x) |
| Versão mais recente | format=3 (Godot 4.x) |
| Especificação | docs.godotengine.org |
Conversões de TSCN
Perguntas e Respostas da Comunidade
perguntado por usuáriosAinda não há perguntas - seja o primeiro a perguntar sobre arquivos TSCN.
Perguntas frequentes
Como faço para abrir um arquivo .tscn?
Posso editar um arquivo .tscn manualmente?
Qual é a diferença entre .tscn e .scn?
.tscn é texto e funciona bem com controle de versão (diffs), enquanto o .scn é a forma binária compilada que carrega mais rápido e é menor. A Godot gera uma versão binária na importação.Por que meu .tscn começa com [gd_scene format=3]?
format=3 significa que foi salvo pela Godot 4.x; format=2 significa Godot 3.x.
