# cyojkoy/neo-godot-tools architecture

> Architecture diagram of the GitHub repository cyojkoy/neo-godot-tools, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cyojkoy/neo-godot-tools
- Repository: https://github.com/cyojkoy/neo-godot-tools

## Overview

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: [`src/extension.ts`](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/extension.ts) (Extension activation), [`src/language/service.ts`](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/language/service.ts) (Language service), [`src/debugger/godot3/debug_session.ts`](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot3/debug_session.ts) (Godot 3 debug session), [`src/debugger/godot4/debug_session.ts`](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot4/debug_session.ts) (Godot 4 debug session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_language["GDScript intelligence"]
  node_language_service["Language service<br/>[service.ts]"]
  node_semantic_queries["Semantic queries<br/>[query_engine.ts]"]
  node_project_index["Project index<br/>[bindings.ts]"]
  node_parser["GDScript parser<br/>[parser.ts]"]
  node_fallback["Fallback language features<br/>[definition.ts]"]
end

subgraph group_editor["Editor features"]
  node_extension["Extension activation<br/>[extension.ts]"]
  node_providers["Language providers<br/>[index.ts]"]
  node_formatter["GDScript formatter<br/>[textmate.ts]"]
end

subgraph group_resources["Resource and scene tools"]
  node_scene_tools["Scene preview and tools<br/>[preview.ts]"]
  node_resource_inspector["Resource inspector<br/>[provider.ts]"]
  node_resource_document["Resource document parser<br/>[document.ts]"]
end

subgraph group_debug["Debugging"]
  node_debug_controller3["Godot 3 debug controller"]
  node_debug_session3["Godot 3 debug session<br/>[debug_session.ts]"]
  node_debug_controller4["Godot 4 debug controller"]
  node_debug_session4["Godot 4 debug session<br/>[debug_session.ts]"]
  node_debug_adapter["Debugger integration<br/>[debugger.ts]"]
  node_debug_runtime["Debug runtime state<br/>[debug_runtime.ts]"]
end

subgraph group_integration["Godot integration"]
  node_godot_lsp["Godot language server"]
  node_lsp_connection["LSP connection manager"]
end

node_vscode(("VS Code user"))
node_godot(("Godot engine"))

node_vscode -->|"activates"| node_extension
node_extension -->|"registers"| node_providers
node_extension -->|"starts"| node_language_service
node_extension -->|"registers"| node_resource_inspector
node_extension -->|"registers"| node_scene_tools
node_extension -->|"registers"| node_debug_adapter
node_extension -->|"registers"| node_formatter
node_extension -->|"uses"| node_fallback
node_language_service -->|"queries"| node_semantic_queries
node_language_service -->|"updates"| node_project_index
node_semantic_queries -->|"resolves from"| node_project_index
node_project_index -->|"analyzes with"| node_parser
node_extension -->|"starts"| node_godot_lsp
node_lsp_connection -->|"configures"| node_godot_lsp
node_resource_inspector -->|"parses with"| node_resource_document
node_debug_adapter -->|"selects"| node_debug_session3
node_debug_adapter -->|"selects"| node_debug_session4
node_debug_session3 -->|"dispatches to"| node_debug_controller3
node_debug_session4 -.->|"dispatches to"| node_debug_controller4
node_debug_controller3 -->|"debug protocol"| node_godot
node_debug_controller4 -->|"debug protocol"| node_godot
node_debug_session3 -->|"uses state"| node_debug_runtime
node_debug_session4 -->|"uses state"| node_debug_runtime
node_vscode -->|"requests language features"| node_godot_lsp
node_vscode -->|"opens previews"| node_scene_tools
node_vscode -->|"edits resources"| node_resource_inspector
node_vscode -->|"formats scripts"| node_formatter

click node_extension "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/extension.ts"
click node_providers "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/providers/index.ts"
click node_language_service "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/language/service.ts"
click node_semantic_queries "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/language/semantic/query_engine.ts"
click node_project_index "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/index/bindings.ts"
click node_parser "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/analyzer/parser.ts"
click node_fallback "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/fallback/definition.ts"
click node_formatter "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/formatter/textmate.ts"
click node_godot_lsp "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/lsp/GDScriptLanguageClient.ts"
click node_lsp_connection "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/lsp/ClientConnectionManager.ts"
click node_scene_tools "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/scene_tools/preview.ts"
click node_resource_inspector "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/resource_inspector/provider.ts"
click node_resource_document "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/resource_inspector/document.ts"
click node_debug_controller3 "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot3/server_controller.ts"
click node_debug_session3 "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot3/debug_session.ts"
click node_debug_controller4 "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot4/server_controller.ts"
click node_debug_session4 "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot4/debug_session.ts"
click node_debug_adapter "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/debugger.ts"
click node_debug_runtime "https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/debug_runtime.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_language_service,node_semantic_queries,node_project_index,node_parser,node_fallback,node_vscode toneBlue
class node_extension,node_providers,node_formatter toneAmber
class node_scene_tools,node_resource_inspector,node_resource_document toneMint
class node_debug_controller3,node_debug_session3,node_debug_controller4,node_debug_session4,node_debug_adapter,node_debug_runtime toneRose
class node_godot_lsp,node_lsp_connection,node_godot toneIndigo
```

## Components

### GDScript intelligence

- [Language service](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/language/service.ts): `src/language/service.ts`
- [Semantic queries](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/language/semantic/query_engine.ts): `src/language/semantic/query_engine.ts`
- [Project index](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/index/bindings.ts): `src/index/bindings.ts`
- [GDScript parser](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/analyzer/parser.ts): `src/analyzer/parser.ts`
- [Fallback language features](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/fallback/definition.ts): `src/fallback/definition.ts`

### Editor features

- [Extension activation](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/extension.ts): `src/extension.ts`
- [Language providers](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/providers/index.ts): `src/providers/index.ts`
- [GDScript formatter](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/formatter/textmate.ts): `src/formatter/textmate.ts`

### Resource and scene tools

- [Scene preview and tools](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/scene_tools/preview.ts): `src/scene_tools/preview.ts`
- [Resource inspector](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/resource_inspector/provider.ts): `src/resource_inspector/provider.ts`
- [Resource document parser](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/resource_inspector/document.ts): `src/resource_inspector/document.ts`

### Debugging

- [Godot 3 debug controller](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot3/server_controller.ts): `src/debugger/godot3/server_controller.ts`
- [Godot 3 debug session](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot3/debug_session.ts): `src/debugger/godot3/debug_session.ts`
- [Godot 4 debug controller](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot4/server_controller.ts): `src/debugger/godot4/server_controller.ts`
- [Godot 4 debug session](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/godot4/debug_session.ts): `src/debugger/godot4/debug_session.ts`
- [Debugger integration](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/debugger.ts): `src/debugger/debugger.ts`
- [Debug runtime state](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/debugger/debug_runtime.ts): `src/debugger/debug_runtime.ts`

### Godot integration

- [Godot language server](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/lsp/GDScriptLanguageClient.ts): `src/lsp/GDScriptLanguageClient.ts`
- [LSP connection manager](https://github.com/cyojkoy/neo-godot-tools/blob/master/src/lsp/ClientConnectionManager.ts): `src/lsp/ClientConnectionManager.ts`

### Other components

- **VS Code user**
- **Godot engine**

## Connections

- VS Code user → Extension activation: activates (evidence: `README.md`)
- Extension activation → Language providers: registers (evidence: `src/extension.ts`)
- Extension activation → Language service: starts (evidence: `src/extension.ts`)
- Extension activation → Resource inspector: registers (evidence: `src/extension.ts`)
- Extension activation → Scene preview and tools: registers (evidence: `src/extension.ts`)
- Extension activation → Debugger integration: registers (evidence: `src/extension.ts`)
- Extension activation → GDScript formatter: registers (evidence: `src/extension.ts`)
- Extension activation → Fallback language features: uses (evidence: `src/extension.ts`)
- Language service → Semantic queries: queries (evidence: `src/language/service.ts`)
- Language service → Project index: updates (evidence: `src/language/service.ts`)
- Semantic queries → Project index: resolves from (evidence: `src/language/semantic/query_engine.ts`)
- Project index → GDScript parser: analyzes with
- Extension activation → Godot language server: starts (evidence: `src/extension.ts`)
- LSP connection manager → Godot language server: configures (evidence: `src/lsp/ClientConnectionManager.ts`)
- Resource inspector → Resource document parser: parses with (evidence: `src/resource_inspector/provider.ts`)
- Debugger integration → Godot 3 debug session: selects (evidence: `src/debugger/debugger.ts`)
- Debugger integration → Godot 4 debug session: selects (evidence: `src/debugger/debugger.ts`)
- Godot 3 debug session → Godot 3 debug controller: dispatches to (evidence: `src/debugger/godot3/debug_session.ts`)
- Godot 4 debug session → Godot 4 debug controller: dispatches to (evidence: `src/debugger/godot4/server_controller.ts`)
- Godot 3 debug controller → Godot engine: debug protocol (evidence: `README.md`)
- Godot 4 debug controller → Godot engine: debug protocol (evidence: `README.md`)
- Godot 3 debug session → Debug runtime state: uses state (evidence: `src/debugger/godot3/debug_session.ts`)
- Godot 4 debug session → Debug runtime state: uses state (evidence: `src/debugger/godot4/server_controller.ts`)
- VS Code user → Godot language server: requests language features (evidence: `README.md`)
- VS Code user → Scene preview and tools: opens previews (evidence: `README.md`)
- VS Code user → Resource inspector: edits resources (evidence: `README.md`)
- VS Code user → GDScript formatter: formats scripts (evidence: `README.md`)
