Godot development tools for VSCode

geequlim 82f4765bcc add method index list in documentation previewer vor 8 Jahren
.vscode c953f7773d Fixes for gdscript syntax checking (#7) vor 8 Jahren
configurations edb733130e Add configuration to ignore indented vairables vor 8 Jahren
doc 893ae24438 stop crash when open single gdscriot vor 8 Jahren
img 267a65a325 Updated readme vor 8 Jahren
src 82f4765bcc add method index list in documentation previewer vor 8 Jahren
.gitignore c953f7773d Fixes for gdscript syntax checking (#7) vor 8 Jahren
.vscodeignore 7285be21d2 Setup VSCode plugin vor 8 Jahren
CHANGELOG.md 1c30c8bd9a release 2.2.3 vor 8 Jahren
LICENSE 55c06edd61 add MIT license vor 8 Jahren
README.md 1c30c8bd9a release 2.2.3 vor 8 Jahren
icon.png 50b81b115f Replace syntax highlight from sublime to atom vor 8 Jahren
package.json 1c30c8bd9a release 2.2.3 vor 8 Jahren
tsconfig.json 7285be21d2 Setup VSCode plugin vor 8 Jahren

README.md

A complete set of tools to code games with the Godot game engine in Visual Studio Code.

Features

The plug-in comes with a wealth of features to make your programming experience as comfortable as possible

  • Syntax highlighting for the GDscript language
  • Syntax highlighting for the tscn and tres scene formats
  • Function definitions and documentation on hover
  • Rich auto completion
  • Static code validation
  • Open projects and scenes in Godot from VScode
  • Ctrl click on a variable or method call to jump to its definition
  • Run/debug the godot game with VSCode with F5(coming soon)

Showing the documentation on hover feature

Available commands

The plug-ins adds a few entries to the command palette

  • Update Workspace Symbols
  • Run workspace as godot project
  • Open workspace with godot editor
  • Run current scene

Settings

You can use the following settings to setup the Godot Tools:

  • GodotTools.editorServerPort: The http server port used by the EditorServer Godot module (see Extra Functionality below)
  • GodotTools.maxNumberOfProblems: Sets the limit for the issues reported by the static code validator
  • GodotTools.editorPath: An absolute path pointing at the Godot Editor executable file. Required to run the project and test scenes from VScode
  • GodotTools.workspaceDocumentWithMarkdown: Control the documentations of workspace symbols should be rendered as plain text or html from markdown
  • GodotTools.ignoreIndentedVars: Parse variables defined after indent of not

Extra functionality

If you want to get an even better experience with this plug-in, you can extend its functionality using the following modules and VScode extensions:

Godot modules

These are modules for the goats editor itself, programmed in C++. In order to use them, you have to create a custom build of the engine. Only do that if you know what you're doing.

  • EditorServer: Using HTTP requests, this module gets extra information from Godot to improve autocompletion.
  • VSCode: The VS code module generates a setting file that Visual Studio code can use to generate Tasks automatically.

VScode extensions

  • TOML language: Godot uses this minimal language to store settings. For example in your project config file. If you want to get syntax highlighting for these files, you will have to install the TOML language extension.

Issues and contributions

The Godot Tools and the go to engine modules are all hosted on GitHub. Feel free to open issues there and create pull requests anytime.

Release Notes

0.2.3

  • Fix known errors with code syntax checking
  • Add configuration GodotTools.ignoreIndentedVars to allow ignore indented variables in scripts
  • Enhanced hover tip documentation rendering with code examples
  • Add launch configurations to launch game with F5(expiremental)
  • The plugin is open source under MIT license

0.2.2

  • Better Syntax validating for code blocks
  • More waring for non-python liked expression

0.2.1

  • Support markdown render in hover tips for documentations in workspace symbols
  • Add configuration GodotTools.workspaceDocumentWithMarkdown to control workspace documentation rendering

Read more from the full change log

TODOS:

  • Print game output log into VSCode console while game launched from the plugin
  • Convert official BBCode documentation into Markdown and render it to HTML with documentation previewer pages
  • Add mermaid support with documentation