DragonScript Language Support

This extension provides language server support for the DragonScript Script Language.

The DragonScript repository can be found here:

• https://github.com/LordOfDragons/dragonscript

Latest API documentation can be found here:

• https://developer.dragondreams.ch/docs/dragonscript/langapi/latest

Main use is for creating games using the Drag[en]gine Game Engine:

• https://github.com/LordOfDragons/dragengine
• https://dragondreams.ch/?page_id=152

Module API documentation and Usage pages on the Wiki can be found here:

• https://lordofdragons.github.io/dragengine/apidoc/dragonscript
• https://developer.dragondreams.ch/wiki/doku.php/tag:dragonscript?do=showtag&tag=dragonscript

The DragonScript Script Language can be used standalone (using the "dsi" binary) or as embedded language using a C++ Binding. Embedding DragonScript is rather simple and allows mixing script with native code easily without using unsafe C-Call hacks.

The Language is strong typed, object oriented and uses a forward parsing only grammar.

The language server supports:

• Provide Diagnostics
• Show Code Completion Proposals
• Show Hovers
• Help With Function and Method Signatures
• Show Definitions of a Symbol
• Find All References to a Symbol
• Highlight All Occurrences of a Symbol in a Document
• Show all Symbol Definitions Within a Document
• Show all Symbol Definitions in Folder
• Possible Actions on Errors or Warnings
• Rename Symbols

Drag[en]gine Game Engine DragonScript Module

This extension supports the Drag[en]gine Game Engine. The installed DragonScript Modules are automatically detected and the latest module version used if the workspace requires Drag[en]gine. To enable this support see the extension parameter dragonscriptLanguage.requiresPackageDragengine.

Preview Images

Requirements

To edit DragonScript no additional requirements are required.

To edit Drag[en]gine projects using the DragonScript Script Module the Drag[en]gine Game Engine is required to be installed for this extension to find and load the Drag[en]gine packages.

Extension Settings

dragonscriptLanguage.pathDragengine:

String type value containing the path to Drag[en]gine installation. Use empty string to auto-detect (default). Set this path if the Drag[en]gine Game Engine is not installed in the default path.

It is recommended to set this value on global level.

dragonscriptLanguage.requiresPackageDragengine:

Boolean type value indicating if the workspace requires Drag[en]gine DragonScript Module Package. By default this is disabled.

Enable this parameter on workspace level for scripts using the Drag[en]gine Game Engine.

dragonscriptLanguage.scriptDirectories:

List of directories (strings) to scan for source files. Typically scripts are located in one directory (default workspace root). Use empty list to disabled DragonScript support for workspace or specific directory. The default value is ['.'] scanning the entire workspace directory for source files.

Set this parameter on workspace or directory level. If set on directory level you can disable source file scanning on a per directory basis, for example for data directories containing no source code.

dragonscriptLanguage.basePackages:

List of base packages. If an entry is a directory it is scanned for .ds files. If the entry is a DELGA file (.delga) it is scanned for .ds files. The default value is [].

Base packages allow creating projects based on other projects. The requiresPackageDragengine is such a base package which has a separate parameter. Typically this list contains the .delga file of the base game or application project.

Set this parameter on workspace or directory level. If set on directory level you can disable base packages on a per directory basis, for example for data directories containing no source code.

Support

Report issues to https://github.com/LordOfDragons/vscode-langext-dragonscript/issues or join the Discord channel to ask for help.

Release Notes

2.1.0

Various bug fixes, hardenings and these improvements:

• Added support for defining base packages. Base packages allow referencing installed game or application projects. This is useful to write modifications or extensions for applications. Base packages can be either an directory with source code or a .delga file. Delga files is the typical use case. See the new setting dragonscript.basePackages. For Delga files only the documentation is shown. Source code is not shown to protect copyrights of installed applications.
• Added support for functions without documentation to inherit the base class function documentation. Travels up the inheritance chain until a function with documentation is found.
• Added support for functions to show their inheritance chain in the hover information panel. Includes all parent functions overwriting base class functions, the base class function itself and the interface function if applicable. Class and function are hyperlinked individually for easy navigation.
• Improved the "\ref tag" documentation parsing to support more situations.
• Added icon for .ds files.

2.0.0

Release with language server support:

• Provide Diagnostics
• Show Code Completion Proposals
• Show Hovers
• Help With Function and Method Signatures
• Show Definitions of a Symbol
• Find All References to a Symbol
• Highlight All Occurrences of a Symbol in a Document
• Show all Symbol Definitions Within a Document
• Show all Symbol Definitions in Folder
• Possible Actions on Errors or Warnings
• Rename Symbols

Added support to detect and use installed Drag[en]gine Game Engine DragonScript modules

1.0.0

Initial release with support for syntax highlighting without language server.