Hvad er TSCN-filformatet?
En .tscn-fil er en tekstscene oprettet af Godot Engine, den gratis og open source-motor til at bygge 2D- og 3D-spil. TSCN står for «text scene», og hver fil beskriver et enkelt scenetræ: de noder, der udgør et niveau, en karakter, en UI-skærm eller en genanvendelig komponent, sammen med deres egenskaber og forbindelser.
Formatet er i INI-stil og læsbart. En fil starter med en beskrivelseslinje som f.eks. [gd_scene format=3 uid="uid://cecaux1sm7mo0"], efterfulgt af [ext_resource]-poster, der linker til eksterne aktiver, [sub_resource]-poster, der indlejrer data som materialer og kollisionsformer, [node]-poster, der bygger træet, og [connection]-poster, der forbinder signaler. Godot 3.x gemmer format=2; Godot 4.x gemmer format=3 og tilføjer strengbaserede UID'er, så en scene kan spores, selv efter den er flyttet. Da formatet er almindelig tekst, kan det nemt sammenlignes (diff) og flettes i Git, hvilket er en grund til, at teams foretrækker det frem for den binære .scn-variant.
Sikkerhed og tryghed
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
kort fortaltProgrammer der åbner TSCN-filer
Windows3 apps
Notepad
Open-source Open the .tscn file as plain text to inspect or manually edit node properties and resource paths. 
Godot Engine
Open-source 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
Gratis Install the godot-tools extension, then open the .tscn file for syntax highlighting and jump-to-Godot editing. 
macOS2 apps
Godot Engine
Open-source 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
Gratis Open the .tscn with the godot-tools extension installed to get scene syntax highlighting and Godot integration. 
Linux2 apps
Godot Engine
Open-source Run the Godot binary, open your project, and select the scene to edit it visually or run it.
Visual Studio Code + godot-tools
Gratis Edit the .tscn as text with syntax highlighting and open it back in Godot from the editor. 
Android1 app
Godot Editor for Android
Open-source 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
Open-source Upload or import a project in the browser-based Godot editor and open the scene to edit it without installing anything. Tekniske detaljer
dyb specifikation| 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 |
| Udgivet | 2016 (Godot 2.x era; format=2 in Godot 3.x, format=3 in Godot 4.x) |
| Seneste version | format=3 (Godot 4.x) |
| Specifikation | docs.godotengine.org |
TSCN-konverteringer
Fællesskabets Q&A
spurgt af brugereIngen spørgsmål endnu - vær den første til at spørge om TSCN-filer.
Ofte stillede spørgsmål
Hvordan åbner jeg en .tscn-fil?
Kan jeg redigere en .tscn-fil manuelt?
Hvad er forskellen på .tscn og .scn?
.tscn er tekst og fungerer godt med versionsstyring, mens .scn er den kompilerede binære form, der indlæses hurtigere og fylder mindre. Godot genererer en binær version ved import.Hvorfor starter min .tscn med [gd_scene format=3]?
format=3 betyder, at den blev gemt af Godot 4.x; format=2 betyder Godot 3.x.
