¿Qué es el formato de archivo TSCN?
Un archivo .tscn es una escena de texto creada por Godot Engine, el motor gratuito y de código abierto para crear juegos 2D y 3D. TSCN significa «text scene» (escena de texto), y cada archivo describe un único árbol de escenas: los nodos que componen un nivel, personaje, pantalla de interfaz de usuario o componente reutilizable, junto con sus propiedades y conexiones.
El formato es de estilo INI y legible. Un archivo comienza con una línea descriptora como [gd_scene format=3 uid="uid://cecaux1sm7mo0"], seguida de entradas [ext_resource] que enlazan con activos externos, entradas [sub_resource] que incrustan datos como materiales y formas de colisión, entradas [node] que construyen el árbol y entradas [connection] que conectan las señales. Godot 3.x guarda con format=2; Godot 4.x guarda con format=3 y añade UIDs basados en cadenas para que una escena pueda ser rastreada incluso después de ser movida. Debido a que el formato es texto plano, permite realizar comparaciones (diffs) y fusiones (merges) limpias en Git, que es una de las razones por las que los equipos lo prefieren sobre la variante binaria .scn.
Seguridad y protección
RIESGO: 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.
Detalles del formato
en pocas palabrasProgramas que abren archivos TSCN
Detalles técnicos
especificación 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 |
| Lanzado | 2016 (Godot 2.x era; format=2 in Godot 3.x, format=3 in Godot 4.x) |
| Última versión | format=3 (Godot 4.x) |
| Especificación | docs.godotengine.org |
Conversiones de TSCN
Preguntas y respuestas de la comunidad
preguntado por usuariosAún no hay preguntas; sea el primero en preguntar sobre los archivos TSCN.
Preguntas frecuentes
¿Cómo abro un archivo .tscn?
¿Puedo editar un archivo .tscn a mano?
¿Cuál es la diferencia entre .tscn y .scn?
.tscn es texto y se compara bien en el control de versiones, mientras que .scn es la forma binaria compilada que se carga más rápido y es más pequeña. Godot genera una versión binaria al importar.¿Por qué mi .tscn comienza con [gd_scene format=3]?
format=3 significa que fue guardado por Godot 4.x; format=2 significa Godot 3.x.