DragonScript Language Support
This extension provides language server support for the DragonScript Script Language.
The DragonScript repository can be found here:
Latest API documentation can be found here:
Main use is for creating games using the Drag[en]gine Game Engine:
Module API documentation and Usage pages on the Wiki can be found here:
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.3.0
- All XML Schemas used by Drag[en]gine added.
2.2.5
- Added support to register various XML Schemas used by Drag[en]gine.
2.2.0
- Potential fix for code scanning alert no. 2: Inefficient regular expression
- Added support to find game engine scripts in deal files. Required for
Drag[en]gine 1.26.1 and never
- Fixed override function completion not qualifying arguments if colliding with type
of same name. For example if overriding a function "void onEvent(Instance instance)"
in a class where in a parent class something is named "Instance" now qualifying the
"Instance" type would use the wrong type and no overriding would happen. This fix
avoids this subtle kind of mistake that could otherwise be only noticed by looking
at the hover information (override information would be missing)
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.
