Files
godot-vscode-plugin/README.md
2017-10-28 11:53:27 +08:00

3.1 KiB

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
  • Full documentation supported with API of godot engine

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

If you like this plugin you can set VSCode as your default script editor with following steps:

  1. Open editor settings
  2. Select Text Editor / External
  3. Check the Use External Editor box with mouse click
  4. Fill Exec Path to the path of your Visual Studio Code
  5. Fill Exec Flags with {project} --goto {file}:{line}:{col}

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

  • GodotTools.godotVersion: The godot version of your project
  • 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
  • GodotTools.parseTextScene: Parse scene files with extension ends with tscn
  • GodotTools.completeNodePath: Show node paths of of workspace in the code completion
  • GodotTools.godotProjectRoot: The godot project directory wich contains project.godot or engine.cfg

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.

FAQ

Intelisense isn't showing up for me

Make sure you save your .gd file, then run "GodotTools: Update Workspace Symbols" from the command palate

Release Notes

0.3.4

  • Fix bug with builtin symbols parsing for godot 2.1
  • Improved hover documentation
  • Show window progress when parsing workspace symbol

0.3.3

  • Fix some syntax checking errors.
  • Fix problems with hover documentation with latest VSCode.
  • Improved builtin class documentation page.
  • Update the documentation data with latest godot version.

0.3.2

  • Fix syntax checking error with match statement.
  • Improved documentation for builtin code blocks.
  • Start using MarkdonwString to keep links valid.

Full change log

TODOS:

  • Convert official BBCode documentation into Markdown and render it to HTML with documentation previewer pages
  • Add mermaid support with documentation
  • Undefined variable checking