wyvern-lsp 0.1.0

An LSP for Draconic, providing diagnostics, hover docs, and code completion for Avrae alias scripting.

Wyvern

Wyvern is a Language Server Protocol (LSP) implementation for Draconic, the scripting language used by the Avrae Discord bot. It brings real IDE features to your editor: errors underlined as you type, hover documentation for Avrae's API, and autocomplete for the functions you actually use.

Features

• Diagnostics - syntax errors and forbidden constructs (like import or class) are flagged before you ever run the alias
• Hover documentation - hover over vroll(), character(), or any Avrae built-in to see its signature and description inline
• Code completion - autocomplete Avrae's API, Draconic built-ins, and your own variables as you type
• Document outline - jump between functions and variables in the sidebar
• Syntax highlighting - visually distinguishes dice expressions {1d20+5}, inline code {{expr}}, and variable substitutions <target>

Installation

VSCode - install the Wyvern LSP extension from the marketplace. It will detect your Python interpreter and install the language server automatically.

Other editors (Neovim, Emacs, Helix, etc.) - install the language server directly:

pip install wyvern-lsp

Then configure your editor to use wyvern-lsp as the language server for .alias, .snippet, and .gvar files.

Works great with Avrae Utilities

Wyvern pairs naturally with Croebh's Avrae Utilities extension, which handles GVAR push/pull and collection management. The two extensions cover different ground and are designed to be used together.

Contributing

Wyvern is open source under the MIT license. Issues and pull requests are welcome - see CONTRIBUTING.md.

Credits

Wyvern icon by Lorc via game-icons.net, used under CC BY 3.0.