cyrusfirheir/twee3-language-tools ↗
Created Mar 3, 2022 · View the cyrusfirheir/twee3-language-tools repository page
[ VSCode extension ] Syntax highlighting and programmatic language tools for Twee 3, and Twine 2 storyformats.
Want this for your repo?
Render a free sample of any GitHub repo in seconds.
Contributors
7
Lines of Code
1,182
From
Aug 8, 2020
To
Feb 22, 2022
About cyrusfirheir/twee3-language-tools
This Visual Studio Code extension provides comprehensive language support for Twee 3, a scripting format used to create interactive fiction and games with Twine 2. It adds syntax highlighting, code analysis, and editing tools for Twee 3 and multiple storyformats including SugarCube, Harlowe, and Chapbook.
The extension offers substantial features across different storyformats. For general Twee development, it includes syntax highlighting, snippet generation for the StoryData passage, IFID generation tools, a passage navigator with grouping options, and a visual story-map editor within VSCode that allows users to position passages on a grid, draw connections between linked passages, and edit passage properties in bulk. For SugarCube specifically, it provides hover documentation for macros, visual highlighting of matching container macro pairs, code snippets with placeholder values, and diagnostic warnings for unclosed macros, deprecated syntax, unrecognized macros, and invalid macro arguments. Users can define custom macros through YAML or JSON configuration files to extend diagnostics beyond the core SugarCube library.
The project targets interactive fiction authors using Twine and related tools, with particular depth for SugarCube users who need detailed code validation. The extension is actively developed with experimental features like passage auto-packing and batch macro definition generation, and it supports user-defined macro libraries through configuration files, making it flexible for both standard and customized development workflows.