How cyojkoy/neo-godot-tools works
Neo Godot Tools is a VS Code extension for Godot projects, combining local GDScript intelligence with Godot-backed tools. The main language workflow routes editor requests through the language service to semantic queries and the incremental project index; registered providers expose results in the editor. Separate branches cover resource and scene tooling, formatting, native Godot LSP integration, and debugging for both Godot generations. The README documents the feature set; several subsystem links below are documented there because their implementation was not sampled, so those links should be read as capability-level relationships.
Main entry points: extension.ts Extension activation · service.ts Language service · godot3/debug_session.ts Godot 3 debug session · godot4/debug_session.ts Godot 4 debug session
Components 21
GDScript intelligence
- Language service
src/language/service.ts - Semantic queries
src/language/semantic/query_engine.ts - Project index
src/index/bindings.ts - GDScript parser
src/analyzer/parser.ts - Fallback language features
src/fallback/definition.ts
Editor features
- Extension activation
src/extension.ts - Language providers
src/providers/index.ts - GDScript formatter
src/formatter/textmate.ts
Resource and scene tools
- Scene preview and tools
src/scene_tools/preview.ts - Resource inspector
src/resource_inspector/provider.ts - Resource document parser
src/resource_inspector/document.ts
Debugging
- Godot 3 debug controller
src/debugger/godot3/server_controller.ts - Godot 3 debug session
src/debugger/godot3/debug_session.ts - Godot 4 debug controller
src/debugger/godot4/server_controller.ts - Godot 4 debug session
src/debugger/godot4/debug_session.ts - Debugger integration
src/debugger/debugger.ts - Debug runtime state
src/debugger/debug_runtime.ts
Godot integration
- Godot language server
src/lsp/GDScriptLanguageClient.ts - LSP connection manager
src/lsp/ClientConnectionManager.ts
Other components
- VS Code user
- Godot engine
Connections 27
- VS Code user → Extension activation: activates
README.md - Extension activation → Language providers: registers
src/extension.ts - Extension activation → Language service: starts
src/extension.ts - Extension activation → Resource inspector: registers
src/extension.ts - Extension activation → Scene preview and tools: registers
src/extension.ts - Extension activation → Debugger integration: registers
src/extension.ts - Extension activation → GDScript formatter: registers
src/extension.ts - Extension activation → Fallback language features: uses
src/extension.ts - Language service → Semantic queries: queries
src/language/service.ts - Language service → Project index: updates
src/language/service.ts - Semantic queries → Project index: resolves from
src/language/semantic/query_engine.ts - Project index → GDScript parser: analyzes with
- Extension activation → Godot language server: starts
src/extension.ts - LSP connection manager → Godot language server: configures
src/lsp/ClientConnectionManager.ts - Resource inspector → Resource document parser: parses with
src/resource_inspector/provider.ts - Debugger integration → Godot 3 debug session: selects
src/debugger/debugger.ts - Debugger integration → Godot 4 debug session: selects
src/debugger/debugger.ts - Godot 3 debug session → Godot 3 debug controller: dispatches to
src/debugger/godot3/debug_session.ts - Godot 4 debug session → Godot 4 debug controller: dispatches to
src/debugger/godot4/server_controller.ts - Godot 3 debug controller → Godot engine: debug protocol
README.md - Godot 4 debug controller → Godot engine: debug protocol
README.md - Godot 3 debug session → Debug runtime state: uses state
src/debugger/godot3/debug_session.ts - Godot 4 debug session → Debug runtime state: uses state
src/debugger/godot4/server_controller.ts - VS Code user → Godot language server: requests language features
README.md - VS Code user → Scene preview and tools: opens previews
README.md - VS Code user → Resource inspector: edits resources
README.md - VS Code user → GDScript formatter: formats scripts
README.md