<cat>Code.Intro</cat> <title>Setting up Visual Studio</title> <note>If you already have Visual Studio installed, make sure you have the latest version (at minimum 16.8) as newer versions contain the required .NET 5 SDK and Roslyn analyzers used by s&box.</note> # Downloading and installing Visual Studio⤶ ⤶ 1. Download Visual Studio 2019 Community [here](https://visualstudio.microsoft.com/downloads/) 2. Run the installer⤶ 3. Select `.NET desktop development`. ⤶ 3a. Optionally you can untick unwanted features on the right side. The ones suggested in the picture below should be sufficient.⤶ ⤶ <upload src="3dc48/8d91deeb8920172.png" size="164967" name="image.png" />⤶ ⤶ After the installer has finished, you are now ready to work with S&box using Visual Studio!⤶ ⤶ If you're new to C#, check out the <page text="C# Learning Resources">CSharp learning resources</page> to find resources that work for you.⤶ ⤶ For information on how to create your first gamemode, follow the tutorial on <page text="making a gamemode">Making Gamemode</page>.⤶ ⤶ # Generating your solution⤶ <note>If you already have Visual Studio installed, make sure you have the latest version of Visual Studido 2022.</note> # Downloading and installing Visual Studio 2022⤶ ⤶ [Download Visual Studio 2022 Community](https://visualstudio.microsoft.com/downloads/) and install with the workload .NET desktop development. ⤶ If you need additional guidance refer to the [official guide](https://docs.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=vs-2022).⤶ ⤶ ⤶ # Generating your solution⤶ A solution file is automatically generated when you launch the game, you can find this solution next to your game directory. ``` C:/Steam/steamapps/common/sbox/s&box.sln ``` <upload src="a5727/8d9398753b3da50.png" size="8056" name="image.png" /> This is a solution file you can open in Visual Studio, this solution contains all your addons as projects. <upload src="a5727/8d939875bdc9091.png" size="10341" name="image.png" /> Each time you <page text="create a new addon">Making_Gamemode</page> you will need to restart your game to re-generate the solution. # Troubleshooting * If you get a lot of errors from dependencies not being able to load, make sure you have the latest version of Visual Studio installed. # Extensions ⤶ Visual Studio is an IDE with a lot of pre-installed tools, however if you find that you need something that it doesn't include, you can browse the extension manager.⤶ ⤶ 1. Click on `Extensions` on the toolbar and select `Manage Extensions`⤶ ⤶ <upload src="3dc48/8d91deb8f080128.png" size="17914" name="image.png" /> ⤶ ⤶ 2. The Extension Manager should now appear and you can search for extensions. If you want more information about a certain extension, click on the blue `More Information` text, and your browser will open a tab to the extension's page. ⤶ ⤶ <upload src="3dc48/8d91deba36fdf3f.png" size="81341" name="image.png" />⤶ ⤶ ## Community Extensions⤶ # Community Extensions * [s&box Tools](https://marketplace.visualstudio.com/items?itemName=rtm516.sboxtools) (Adds some of the features in the external console to the IDE) # Debugging For info on debugging check out the <page>Debugging</page> page.