GDScript Refactoring — Godot 4 Plugin

A scope-aware rename refactoring plugin for the Godot 4 script editor, powered by Godot's built-in GDScript Language Server (LSP) — the same engine that drives autocompletion and go-to-definition.

Unlike naive find-and-replace, the rename understands GDScript semantics: renaming a member variable will not touch an unrelated local variable that happens to share the same name, and vice versa.

✨Features

• Shift+F2 (or right-click → Rename...) directly in the script editor, on any user-defined symbol (variable, function, parameter, class, enum member…)
• Scope-aware: powered by textDocument/rename from Godot's own language server — shadowed or unrelated symbols are left untouched
• Project-wide: all .gd files are analyzed and updated in one action
• Preview before applying: every affected file, line number, and line content is listed (with the symbol highlighted) before anything is written
• Multi-file undo/redo: a single Ctrl+Z reverts the rename across all modified files; Ctrl+Shift+Z (or Ctrl+Y) re-applies it. Your own local edits are still undone first, like in any IDE
• Silent editor refresh: open script tabs reload automatically — no "files are newer on disk" popup, caret and scroll position preserved
• Smart context menu: the Rename... entry only appears when the cursor is on a renameable symbol — never on keywords, built-in types (Vector2, String…), native engine classes (Node, Sprite2D…), numbers, strings, or comments

📦Installation

1. Copy the addons/gdscript_refactoring/ folder into your project's addons/ directory.
2. Open Project → Project Settings → Plugins.
3. Enable GDScript Refactoring.

Requirement: the GDScript language server must be running (it is enabled by default in the Godot editor, on port 6005 — see Editor Settings → Network → Language Server).

🚀Usage

1. In the script editor, place the caret on the symbol you want to rename.
2. Press Shift+F2 — or right-click → Rename.... The shortcut and the menu entry only activate on renameable symbols.
3. Type the new name.
4. Click Preview — all occurrences across the project are listed with file, line number, and highlighted line content.
5. Click Rename to apply.

To revert: press Ctrl+Z in the script editor. All modified files are restored in one step. Ctrl+Shift+Z / Ctrl+Y re-applies the rename.

🔍How it works

📂File structure

addons/gdscript_refactoring/
├── plugin.cfg               # Plugin manifest
├── qb_gdscript_rename.gd    # EditorPlugin — context menu, undo stack, shortcuts
├── qb_rename_dialog.gd      # Rename dialog — preview, apply, editor refresh
├── qb_lsp_client.gd         # Minimal LSP client (JSON-RPC 2.0 over TCP)
├── qb_file_scanner.gd       # Recursive .gd file collector
└── qb_symbol_replacer.gd    # Legacy regex engine (kept for reference)

⚙️Limitations

• GDScript only (not C#).
• The rename relies on Godot's language server: symbols it cannot resolve (e.g. purely dynamic access via strings, get()/set() calls) will not be found.
• References inside .tscn scene files (connected signals, exported node paths) are not updated — use Godot's built-in tools for those.

Compatibility

• Godot 4.x (developed and tested on 4.6)

📄 Licence

MIT — free to use, modify and distribute.