RepairScene
An asset by [email protected]
Install Asset
Install via Godot
To maintain one source of truth, Godot Asset Library is just a mirror of the old asset library so you can download directly on Godot via the integrated asset library browser
Quick Information
RepairScene
Repairs broken resource paths in Godot 4.x scene files after renaming or moving assets.You renamed a folder. Now half your scenes show "Scene file appears to be invalid/corrupt" and Godot refuses to open them. The .tscn files contain hard-coded resource paths that no longer exist on disk. Fixing them manually means opening each file in a text editor and rewriting every broken ext_resource path by hand.This EditorScript scans your .tscn files as raw text — bypassing Godot's resource loader entirely, because the whole point is to fix files Godot cannot open — finds every broken path= reference, and resolves it by matching the filename stem against your current project filesystem. Stale uid= tokens are stripped and regenerated on the next import.Always run with write_changes set to false first. The dry-run mode logs every change it would make without touching any file.Features:- Scans entire project or a specific subfolder- Resolves broken paths by filename stem match — handles moved files with the same name- Strips stale uid= tokens so Godot regenerates them cleanly- Backup system creates .bak files before overwriting anything- Dry-run mode: logs all proposed changes without writing to disk- Summary table: files scanned, refs broken, refs resolved, refs unresolved- Configurable backup directory and backup-skip logic- Zero dependencies — works in a blank projectCreate a new script with EditorScript as the base class. Paste RepairScene.gd contents. Set scan_root. Run with Ctrl+Shift+X. Review the Output panel. Set write_changes to true to apply.Godot 4.x only. GDScript 2.0.Extended version with fuzzy path resolution for renamed files and closest-directory disambiguation available at nullstateassets.itch.io.
Supported Engine Version
4.0
Version String
1.0
License Version
MIT
Support Level
community
Modified Date
2 days ago
Git URL
Issue URL
RepairScene — Lite
Stop fighting your engine. Ship faster.
The Problem
You renamed a folder. Now half your scenes show "Scene file appears to be invalid/corrupt" and Godot refuses to open them. The .tscn files contain hard-coded resource paths that no longer exist. Fixing them manually means opening each file in a text editor and rewriting every broken ext_resource path by hand.
The Solution
script.gd is an EditorScript that scans your .tscn files as raw text (bypassing Godot's resource loader entirely — the whole point is to fix files Godot can't open), finds every broken path= reference, and resolves it by matching the filename stem against your current project filesystem. Run it once. Your scenes open again.
Always run in dry-run mode first (write_changes = false) to review what it would change before touching any file.
What's in the Lite Version
- Scans your entire project (or a subfolder) for broken
.tscnreferences - Resolves broken paths by exact filename stem match — handles the most common case: file moved to a different folder with the same name
- Strips stale
uid=tokens so Godot regenerates them cleanly on next import - Backup system: creates
.bakfiles before overwriting anything - Dry-run mode: logs all changes without writing to disk
- Summary table: files scanned, refs broken, refs resolved, refs unresolved
What's in the Full Version
The full version adds fuzzy path resolution: when a file has been both renamed and moved, the exact stem match will fail. The full version uses a segment-ratio scoring algorithm that compares path segments right-to-left, scoring each candidate in your filesystem and accepting the best match above a configurable threshold. It also adds prefer_closest_directory to automatically disambiguate multiple files with the same name by picking the one in the closest matching folder. These two features handle the hard cases the lite version cannot.
Full version on itch.io: https://nullstateassets.itch.io
Quick Start
- Copy
script.gdinto your Godot project. - In Godot: File > New Script, set base class to
EditorScript, paste the script contents. - Configure
scan_rootand ensurewrite_changesisfalsefor the first run. - File > Run (or Ctrl+Shift+X) to execute.
- Review the Output panel. Set
write_changes = trueto apply.
Compatibility
| Engine | Language | Tested On |
|---|---|---|
| Godot 4.x | GDScript | 4.2, 4.3 |
License
MIT License. Free for personal and commercial use. Attribution appreciated but not required.
Repairs broken resource paths in Godot 4.x scene files after renaming or moving assets.
You renamed a folder. Now half your scenes show "Scene file appears to be invalid/corrupt" and Godot refuses to open them. The .tscn files contain hard-coded resource paths that no longer exist on disk. Fixing them manually means opening each file in a text editor and rewriting every broken ext_resource path by hand.
This EditorScript scans your .tscn files as raw text — bypassing Godot's resource loader entirely, because the whole point is to fix files Godot cannot open — finds every broken path= reference, and resolves it by matching the filename stem against your current project filesystem. Stale uid= tokens are stripped and regenerated on the next import.
Always run with write_changes set to false first. The dry-run mode logs every change it would make without touching any file.
Features:
- Scans entire project or a specific subfolder
- Resolves broken paths by filename stem match — handles moved files with the same name
- Strips stale uid= tokens so Godot regenerates them cleanly
- Backup system creates .bak files before overwriting anything
- Dry-run mode: logs all proposed changes without writing to disk
- Summary table: files scanned, refs broken, refs resolved, refs unresolved
- Configurable backup directory and backup-skip logic
- Zero dependencies — works in a blank project
Create a new script with EditorScript as the base class. Paste RepairScene.gd contents. Set scan_root. Run with Ctrl+Shift+X. Review the Output panel. Set write_changes to true to apply.
Godot 4.x only. GDScript 2.0.
Extended version with fuzzy path resolution for renamed files and closest-directory disambiguation available at nullstateassets.itch.io.
Reviews
Quick Information
RepairScene
Repairs broken resource paths in Godot 4.x scene files after renaming or moving assets.You renamed a folder. Now half your scenes show "Scene file appears to be invalid/corrupt" and Godot refuses to open them. The .tscn files contain hard-coded resource paths that no longer exist on disk. Fixing them manually means opening each file in a text editor and rewriting every broken ext_resource path by hand.This EditorScript scans your .tscn files as raw text — bypassing Godot's resource loader entirely, because the whole point is to fix files Godot cannot open — finds every broken path= reference, and resolves it by matching the filename stem against your current project filesystem. Stale uid= tokens are stripped and regenerated on the next import.Always run with write_changes set to false first. The dry-run mode logs every change it would make without touching any file.Features:- Scans entire project or a specific subfolder- Resolves broken paths by filename stem match — handles moved files with the same name- Strips stale uid= tokens so Godot regenerates them cleanly- Backup system creates .bak files before overwriting anything- Dry-run mode: logs all proposed changes without writing to disk- Summary table: files scanned, refs broken, refs resolved, refs unresolved- Configurable backup directory and backup-skip logic- Zero dependencies — works in a blank projectCreate a new script with EditorScript as the base class. Paste RepairScene.gd contents. Set scan_root. Run with Ctrl+Shift+X. Review the Output panel. Set write_changes to true to apply.Godot 4.x only. GDScript 2.0.Extended version with fuzzy path resolution for renamed files and closest-directory disambiguation available at nullstateassets.itch.io.
Supported Engine Version
4.0
Version String
1.0
License Version
MIT
Support Level
community
Modified Date
2 days ago
Git URL
Issue URL