Edit of asset "RepairScene" Accepted

Old/Current New/Edit
Title RepairScene RepairScene
Description 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.
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.
Category Scripts Scripts
License MIT MIT
Repository Provider GitHub GitHub
Repository Url https://github.com/NullState-Assets/RepairScene https://github.com/NullState-Assets/RepairScene
Issues Url https://github.com/NullState-Assets/RepairScene/issues https://github.com/NullState-Assets/RepairScene/issues
Godot version Godot 4.0 Godot 4.0
Version String 1.0 1.0
Download Commit 6c63c9c8b4dd4e5bdeffa9e3bc17eb160a8aac15 6c63c9c8b4dd4e5bdeffa9e3bc17eb160a8aac15
Download Url (Computed) https://github.com/NullState-Assets/RepairScene/archive/6c63c9c8b4dd4e5bdeffa9e3bc17eb160a8aac15.zip https://github.com/NullState-Assets/RepairScene/archive/6c63c9c8b4dd4e5bdeffa9e3bc17eb160a8aac15.zip
Icon Url https://raw.githubusercontent.com/NullState-Assets/RepairScene/main/repair%20scene%20icon.png
https://raw.githubusercontent.com/NullState-Assets/RepairScene/main/repair%20scene%20icon.png