Hva er TSCN-filformatet?
En .tscn-fil er en tekstscene opprettet av Godot Engine, den gratis og åpne motoren for å bygge 2D- og 3D-spill. TSCN står for «text scene», og hver fil beskriver et enkelt scenetre: nodene som utgjør et nivå, en karakter, en UI-skjerm eller en gjenbrukbar komponent, sammen med deres egenskaper og tilkoblinger.
Formatet er i INI-stil og er lettlest. En fil åpnes med en beskrivelseslinje som [gd_scene format=3 uid="uid://cecaux1sm7mo0"], etterfulgt av [ext_resource]-oppføringer som lenker til eksterne ressurser, [sub_resource]-oppføringer som bygger inn data som materialer og kollisjonsformer, [node]-oppføringer som bygger treet, og [connection]-oppføringer som kobler opp signaler. Godot 3.x lagrer format=2; Godot 4.x lagrer format=3 og legger til strengbaserte UID-er slik at en scene kan spores selv etter at den er flyttet. Fordi formatet er ren tekst, er det enkelt å sammenligne (diff) og flette i Git, noe som er en grunn til at team foretrekker det fremfor den binære .scn-varianten.
Sikkerhet og trygghet
RISIKO: 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.
Formatdetaljer
i et nøtteskallProgrammer som åpner TSCN-filer
Tekniske detaljer
dyp spesifikasjon| 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 |
| Utgitt | 2016 (Godot 2.x era; format=2 in Godot 3.x, format=3 in Godot 4.x) |
| Siste versjon | format=3 (Godot 4.x) |
| Spesifikasjon | docs.godotengine.org |
TSCN-konverteringer
Spørsmål og svar fra fellesskapet
spurt av brukereIngen spørsmål ennå - vær den første til å spørre om TSCN-filer.
Ofte stilte spørsmål
Hvordan åpner jeg en .tscn-fil?
Kan jeg redigere en .tscn-fil manuelt?
Hva er forskjellen mellom .tscn og .scn?
.tscn er tekst og fungerer godt med versjonskontroll, mens .scn er den kompilerte binære formen som lastes raskere og er mindre. Godot genererer en binær versjon ved import.Hvorfor starter min .tscn med [gd_scene format=3]?
format=3 betyr at den ble lagret av Godot 4.x; format=2 betyr Godot 3.x.