godotdev.nvim

Batteries-included Neovim plugin for Godot game development (Godot 4.3+), using Neovim as an external editor. Provides LSP support for GDScript and Godot shaders, DAP debugging, and Treesitter syntax highlighting.

Features

Connect to Godot editor LSP over TCP (127.0.0.1:6005 by default)
Full GDScript language support
.gdshader syntax highlighting via Treesitter
Debug GDScript with nvim-dap (127.0.0.1:6006 by default)
Keymaps for common LSP actions
Batteries included: everything you need for Godot development in Neovim

Requirements

Neovim 0.9+
Godot 4.3+ with TCP LSP enabled
nvim-lspconfig
nvim-dap and nvim-dap-ui for debugging
nvim-treesitter
Windows users must have ncat in PATH

Installation (Lazy.nvim)

{
  'Mathijs-Bakker/godotdev.nvim',
  lazy = false,
  dependencies = { 'nvim-lspconfig', 'nvim-dap', 'nvim-dap-ui', 'nvim-treesitter' },
  config = function()
    require("godotdev").setup()
  end,
}

Quickstart

Open your Godot project in Neovim
Start Godot editor with TCP LSP enabled (Editor Settings → Network → Enable TCP LSP server)
Open a .gd or .gdshader file
LSP will automatically attach
Use rn to rename, gd to go to definition, gr for references, etc.
Start debugging with DAP (Launch scene configuration)

Configuration

require("godotdev").setup({
  editor_host = "127.0.0.1", -- Godot editor host
  editor_port = 6005,        -- LSP port
  debug_port = 6006,         -- DAP port
})

Keymaps

LSP

gd → Go to definition gD → Go to declaration gy → Type definition gi → Go to implementation gr → List references K → Hover <C-k> → Signature help <leader>rn → Rename symbol <leader>ca → Code action <leader>f → Format buffer gl → Show diagnostics [d / ]d → Previous/next diagnostic

DAP

F5 -> Continue/Start F10 -> Step over F11 -> Step into F12 -> Step out <leader>db -> Toggle Breakpoint <leader>dB -> Conditional breakpoint

DAP UI

<leader>du -> , Toggle UI <leader>dr -> , Open REPL

2.1 KiB Raw Blame History