Setting up Visual Studio Code
Installation and setup
Enable Roslyn analyzers
You need to enable Roslyn analyzers if they are not already, without this you will get reference errors.
The simplest way is File -> Preferences -> Settings, from there search for "roslyn" and tick the setting "Enable Roslyn Analyzers".
Be sure to save your settings.
Opening projects
After creating your addon folder structure and running your game to generate the .csproj files you can open your addon folder in VSCode via File -> Open Folder...
.
Adding debugger configuration
We need to add a debugging configuration to debug addons. Create the following file in your addon directory .vscode\launch.json
:
You can now start debugging your addons by setting breakpoints and pressing F5:
Keep in mind that you need to manually start s&box first before debugging.
Recommended extensions
Visual Studio Keymap: Adds Visual Studio keymaps in case you are used to Visual Studio shortcuts.
JetBrains Keymap: Adds JetBrains keymaps in case you are used to JetBrains shortcuts.
EditorConfig for VS Code: Automatically format your code with the s&box coding style
SCSS Formatter: Automatically format your scss files.
vscode-solution-explorer: Visual Studio-like solution explorer for Visual Studio Code.
C# Snippets: C# code snippets.
Auto-Using for C#: Auto import namespaces.
C# Extensions: Quickly create new classes and generate constructors.
C# Namespace Autocompletion: IntelliSense for writing namespaces.
C# XML Documentation Comments: Easier code documentation.
GitLens: A useful extension when working with Git.