Click here to Skip to main content
15,867,870 members
Articles / Containers / Docker

Debugging Unity 3D with VSCode

Rate me:
Please Sign up or sign in to vote.
4.00/5 (1 vote)
23 Jan 2016CPOL7 min read 14.8K   4   2
Debugging Unity 3D with VSCode

Image 1

**Updated for Version 1.0.0 - be aware there are some new "Getting Started" extra points, like installing C#, which is no longer installed by default.

I’ve written several articles on the use of VSCode with Unity through its evolution but time and tide wait for no man as the behemoth of technology marches on.

If you’ve not heard of Microsoft’s new multi-platform lightweight code editor before, go and check out its homepage (https://code.visualstudio.com), it’s chock full of fantastic stuff to make you drop MonoDevelop or any other lightweight editor. You can also check out my previous articles here and here.

Microsoft VSCode has taken many great strides since I last donned my writing hat, most notably:

  • It’s now completely opensourced! – Check it out on GitHub here (https://github.com/Microsoft/vscode)
  • A new extension system has been added, allowing community devs to write plug-ins and language extensions to the editor without rebuilding it
  • The number of languages supported has exploded (also thanks to the extension system), it now supports not only C#, HTML, JSON, Markdown and JavaScript but also python, ruby, actionscript, bower and even docker templates plus many many more (so many that even I’ve not heard of some of them)
  • Debugging support for web apps has improved greatly
  • Git and Source control support has been improved

There is a lot more but these are my favorite highlights. If you have read my previous articles on the subject (here and here), you will also know that it has some great support for Unity, which has only gotten better now that Unity themselves have pulled in to the race.


The Story So Far

Since the early beta releases, we’ve been able to configure VSCode manually as a code editor within Unity, slowly but surely through the beta phases this integration has been improved to add file and line support when calling VSCode.

Back in VSCode Version 0.8.0, this took another bold leap forward with its first Unity asset (well, the only really) aimed at providing increased integration between these two products.

Image 2

Made by a community developer with some assistance from teams at Unity and Microsoft, they automated a lot of the menial setup required to make the most out of the integration, namely:

  • Support for Windows, Mac and eventually Linux
  • Streamlining Editor preferences setup
  • Setting the necessary command-line arguments when starting VSCode, which improved as VSCode did
  • Creating the necessary workspace settings to improve the VSCode UI when launched from Unity
  • Updating the project files to be more Unity/VSCode compatible
  • Debugging support for MacOS
  • **New for Version 2.6 - Ability to configure a path for VSCode, enables use of the separate insider build for the brave

Image 3

VSCode Editor Screen

Plus a host of other little tidy up / backend tweaks needed to ensure it all worked seamlessly.

Image 4

Before and After Workspace configuration in VSCode

The only real limitation in its use was that debugging was only supported on a Mac (granted Mac owners didn’t see this as an issue Image 5), UNTIL NOW!!


Let Me Stop You There

The train never stops when it comes to technology (even Cobol still lives!, granted Flash and Silverlight are headed to the graveyard), especially when a project becomes open source but is still heavily contributed by the project originators, which in this case is Microsoft. They are certainly on a mission to make the fastest and most powerful cross platform editor out there.

Recently Unity Technologies themselves also wrote an extension for VSCode to allow debugging of Unity projects from more platforms:

Image 6

With this extension installed, you can now simply attach your VSCode project to Unity in a very similar way to what is possible already with the Visual Studio Tools for Unity with Microsoft Visual Studio (which also replaced the default code editor on Windows and is now bundled with Unity), this includes such support as:

  • Better intellisense
  • More code completion and language support for MonoBehaviours
  • Editor attaching
  • Breakpoint support for the Editor and platforms

Unity have also made the extension itself opensource on Github (like so many of their other new initiatives, the UI and 2D updates to name a few), so if there is something you feel is missing or could be done better, you can either build your own or submit a pull request and send it to Unity to add.

**There is also an additional community VSCode addon which gives you both Unity and VSCode document lookup support and a few other nice features, worth checking out.


Getting Setup

Enough talk, let’s get this up and running in a few short steps, it’s easy enough but the information is slightly scattered throughout the interwebs and pages.

The short path to get this running is as follows:

  • Install Unity (but let’s assume you have done this already)
  • Install VSCode – download it from http://code.visualstudio.com for your OS
  • Open your Unity project
  • Download the VSCode asset from dotBunny from the Asset Window (or import the asset if you have downloaded it manually)
  • Open the Editor preferences using the Edit –> Preferences option in the Unity editor menu
  • Click on the VSCode tab on the left and check “Enable Integration

    Image 7

  • Click the “Write Workspace Settings” button (only needs to be done once per project), this will create the VSCode default workspace configuration for Unity.
  • Open VSCode for your project by opening a code file (you can do this manually but you will then have to manually select the unity project folder).
  • When VSCode is open, hit the F1 key (this opens the VSCode Command window shown below)
    *Note, you will need an internet connection for this part!

    Image 8

  • Type the command “ext install” in to the command window and select the option “Extensions: Install Extension”.
  • This will display all the available extensions on the VSCode marketplace (there are a lot aren’t there!), to filter the list, simply append filter criteria to the command so that it reads “ext install unity”.

    Image 9

  • Now simply click on this extension and it will be installed in the background. When it’s done, you will receive a notification to restart VS Code.
  • **New As of VSCode Version 1.0.0, you also now have to install C# support for VSCode, it no longer ships by default (most likely so they can update it separately).
    To install this, repeat the instructions above for the Unity Debugger, but install the "C#" package instead (it's actually the first in the list :D).
    Once installed, you will have an option to restart VSCode to complete the install.
  • In the "Unity" extension search, you will also find Tobiah Zarlez new Unity Tools extension, which enables both Unity and VSCode documentation lookup support by selecting a class / property and hitting "Ctrl and #" (CMD and # for Mac's). Pretty useful.

Almost there, we now have all the necessary components installed, however to enable debugging, there is one final step.

  • Click on the Debugging icon in the toolbar on the left hand side of the editor (this shockingly brings up the debugging view)
  • Then click on the cog icon to bring up the debugger selection
  • Finally select “Unity Debugger” from the list to enable it

Image 10

If all goes well, you should see a new “Launch.json” configuration file in the viewer showing you the current debugging options available.

If anything goes wrong or it doesn’t look right, then simply return to the folder/files view (top left folder icon) and delete the Launch.json file, then repeat the above steps which will recreate it.

You should be able to determine from looking at the default launch configuration that it only supports the Editor by default, however you can extend this to support projects too if you wish, just check the marketplace support page for more detail – https://marketplace.visualstudio.com/items/Unity.unity-debug

All done, if you return to the Folder/File view, you can set breakpoints as you would do in any other code debugger and have VSCode break on that line when it’s hit.

Let’s see it in action:

Image 11

I don’t think this is the end for VSCode’s integration with Unity, especially not with everything being open source, so the future is looking very bright for Unity developers!

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect ZenithMoon Studios
United Kingdom United Kingdom
Long-time game developer / IT maniac.
By day I architect, design, build and deliver enriching Mixed Reality solutions to clients, bringing the work of AR/VR to light in new and interesting ways, by night I Masquerade as the Master Chief of ZenithMoon Studios, my own game development studio.

At heart, I am a community developer breaking down lots of fun and curious technologies and bringing them to the masses.

I'm also a contributor to several open-source projects, most notably, the Reality Toolkit and all the services provided by the Reality Collective, The Unity-UI-Extensions project, as well as in the past the AdRotator advertising rotator project for Windows and Windows Phone.

Currently, I spend my time fulfilling contracts in the Mixed Reality space (primarily for an XR experience firm called Ethar), writing books, technically reviewing tons of material and continuing my long tradition of contributing to open-source development, as well as delivering talks, but that goes without saying Big Grin | :-D

Mixed Reality MVP, Xbox Ambassador, MS GameDevelopment Ambassador & Best selling author:

[Accelerating Unity Through Automation](https://www.amazon.co.uk/Accelerating-Unity-Through-Automation-Offloading/dp/1484295072/ref=rvi_sccl_3/262-0817396-1418043)
[Mastering Unity 2D Game Development] (https://www.packtpub.com/game-development/mastering-unity-2d-game-development)
[Unity 3D UI Essentials] (https://www.packtpub.com/game-development/unity-3d-gui-essentials)

Comments and Discussions

 
QuestionCreating a mini Minecraft game Pin
strikeform26-Apr-22 1:34
strikeform26-Apr-22 1:34 
AnswerRe: Creating a mini Minecraft game Pin
Simon Jackson23-Jun-22 11:38
Simon Jackson23-Jun-22 11:38 
As the tutorial is for Unity, then yes. This will enable you to use VScode while you are building in Unity

Simon (darkside) Jackson
ID&Xbox MVP & Best selling author
[Mastering Unity 2D Game Development] (https://www.packtpub.com/game-development/mastering-unity-2d-game-development)
[Unity 3D UI Essentials] (https://www.packtpub.com/game-development/unity-3d-gui-essentials)

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.