Install the tools
Labrador builds on Windows, with the Microsoft C++ compiler, the program that translates your C++ code into compiled parts of the game. Everything the Windows build needs comes with one install, Visual Studio. Git is a second, needed only if you take the Git route or later put your project in Git; the starter project does not need it. The browser build needs Emscripten, and Python 3 to install it with, but not Git; Build for the browser covers both when you get there, and nothing in Get Started needs them.
Setup words is a short lookup page for the tool names and build terms used here. You do not need to read it first.
Before you install
Section titled “Before you install”Visual Studio is a download of about 2.5 GB and takes 10 to 12 GB of disk with what these pages need, so check the machine first. Open Settings, then System, then About, and look at two lines there:
- System type, under Device specifications, should say x64-based processor. If it says ARM-based processor, the PC is a Windows on Arm laptop, such as one with a Snapdragon chip. Microsoft supports Visual Studio on Windows 11 on Arm, but these pages and the starter project build an x64 game and have not been tried on an Arm PC, so whether every step works there as written is not known.
- Edition, under Windows specifications, should name Windows 11. These pages were checked only on Windows 11. Microsoft’s requirements for Visual Studio 2026, which the download link below gives, and for Visual Studio 2022 list Windows 11 and Windows Server but not Windows 10, and what the installer does on Windows 10 has not been tried. If the edition ends in S mode, Windows runs only apps from the Microsoft Store, and Microsoft does not support Visual Studio there. Microsoft’s S mode questions say how to switch out of it, from Settings > System > Activation: it is free, but it is one-way, and you cannot turn S mode back on.
You also need to be able to approve an administrator prompt: Microsoft’s system requirements say administrator rights are needed to install or update Visual Studio. On a school or work PC where Windows asks for someone else’s password, ask whoever manages the PC.
A graphics card is not needed to follow these pages: the debug build they make falls back to Windows’ software renderer when there is none. No one has followed them on such a machine.
Typing the commands
Section titled “Typing the commands”Every command these pages ask you to run is in a box like the one below. Nothing in a box needs changing unless the text around it says so, and then the part to change is named.
echo This is a command.To run one, point at the box and click the copy button that appears at its top right, click in the command prompt window, paste with Ctrl+V or a right-click, and press Enter. A box with several lines can be pasted all at once: each line runs in turn. If the last line is still sitting after the prompt when the others have finished, press Enter once more. Boxes labelled as output are what you should see, not something to type.
On Windows 11 the command prompt usually opens in Windows Terminal, a window with tabs along its top. Pasting more than one line there first asks whether you really want to: a box says You are about to paste text that contains multiple lines. Click Paste anyway. It asks every time, and nothing is wrong.
When the text around a box says to change part of a line, the box has that line alone, and pasting it does not run it: it waits after the prompt for you to press Enter. Before you do, change it there. Press the Left arrow key to move back along the line to the part to change, delete it with Backspace, type the new text in its place, then press Enter. If the line went wrong, press Escape to clear it and paste it again.
If you already use Visual Studio, Git and a command prompt, skim the headings and the check and carry on.
-
Install Visual Studio 2022 or newer, with the Desktop development with C++ workload, a named group of related tools in the installer. The free Community edition is enough.
These are the manual steps. For a new Visual Studio Community 2026 installation, the optional configuration route selects the same prerequisites with a file and an installer command.
Open visualstudio.microsoft.com/downloads and, under Visual Studio Community, click Free download. Your browser saves
VisualStudioSetup.exe, about 6 MB, in your Downloads folder. Open it. Before the installer asks you anything about C++, you see these:- Windows asks Do you want to allow this app to make changes to your device? Click Yes. This is the administrator prompt Before you install mentions.
- A small Visual Studio Installer window says Before you get started, we need to set up a few things so that you can configure your installation. Click Continue, which agrees to Microsoft’s licence terms.
- The same window says Getting the Visual Studio Installer ready. above two bars, for a minute or less. Wait.
- The installer opens on its Workloads tab, with Individual components, Language packs and Installation locations beside it. The list starts with Web & Cloud, and the workload you need is not in the first view: scroll the list down to Desktop & Mobile.
Tick Desktop development with C++. The Installation details list on the right then shows what that workload includes. Check that these three are ticked there, and tick any that are not:
- C++ CMake tools for Windows
- vcpkg package manager
- a Windows 11 SDK (any version)
Current versions tick all three by default. That workload brings the compiler, CMake, Ninja, vcpkg and the Windows SDK, whose shader compiler the build needs.
CMake prepares the build instructions; Ninja runs the compile and link steps. vcpkg downloads and builds libraries the engine uses. The SDK, Microsoft’s Software Development Kit, supplies Windows headers, libraries and tools. Its shader compiler translates the engine’s drawing programs; you do not write one to make your first change.
Before you click Install, look at the bottom right of the installer’s window: Total space required is the space the selection needs. With Visual Studio Community 2026 on a clean Windows 11 it said 11.97 GB once this workload was ticked. Microsoft’s system requirements say a typical installation needs 20 to 50 GB free. An install of just the workload, the compiler and the three items above took 10.5 GB of drive
C:: 4.8 GB inC:\Program Files\Microsoft Visual Studio\18\Community, of which the C++ compiler is 1.7 GB; 1.8 GB for the Windows SDK inC:\Program Files (x86)\Windows Kits\10; and 1.9 GB of downloaded packages that the installer keeps inC:\ProgramData\Microsoft\VisualStudio\Packages. It downloaded 2.4 GB.Leave Install while downloading as it is, click Install, and wait. The window changes to the Installed tab, where Visual Studio Community 2026 shows a Downloaded bar and then Installing: package with a count, such as
package 32 of 458, and a percentage. Near the end it stays on one package,Win11SDK_10.0.26100, for a long time; that is the Windows SDK installing, and it has not stopped. On a test machine with a slow disk the download took under 4 minutes and the whole install 3 hours 26 minutes, more than 2 hours of it the Windows SDK. A PC with a faster disk should take less, but no ordinary PC was timed. You can use the computer meanwhile.When it has finished, the installer’s Installed tab lists your Visual Studio with Modify and Launch buttons beside it, and may first ask you to restart Windows. Restart if it asks; you do not need to click Launch, as these pages open Visual Studio only when they need it. If Visual Studio opens by itself and asks you to sign in, close it: signing in is not needed. Close the installer.
If Visual Studio is already installed, open Visual Studio Installer from the Start menu, click Modify beside your Visual Studio, and check the same workload and the same three items.
If the install fails, the installer says so and names the step that failed:
- Not enough space on a drive: the installer warns about that drive before it starts, or stops partway with a message about disk space. Free space on that drive, for example by emptying the Recycle Bin or uninstalling programs you no longer use in Settings > Apps > Installed apps, then open the installer again from the Start menu and click Modify or Install.
- A restart is needed, because Windows is still finishing an update or an earlier install: restart, then open Visual Studio Installer from the Start menu and click Modify, then Modify again at the bottom right, or Install if it is not listed yet. It carries on from where it stopped.
- A download or package failed: check your connection and click Retry if the installer offers it. If Visual Studio is listed but a later step fails, click More beside it and then Repair. Microsoft’s installation troubleshooting page has the further steps, from deleting the installer’s own folder to its live chat.
-
For the Git route: install Git for Windows, if you do not have it.
Skip this step if you are going to use the starter project. Its build does not need Git: if Git is not installed, vcpkg, which fetches the engine’s libraries, downloads a private copy of Git for itself the first time, and you never run it.
Download the 64-bit installer and run it. Its default answer to every question is fine, so click Next on each page and then Install.
Install Git before opening the command prompt in the next step. A prompt that was already open does not see a program installed after it started, so close it and open a new one if you install Git later.
-
Open the x64 Native Tools Command Prompt. Click Start, type
x64 Native Tools, and click the result whose name begins x64 Native Tools Command Prompt. It is installed with Visual Studio. Every command in this guide runs in it.Right after an install, Start’s search can take a while to find it. It is also in Start’s app list: click Start, then All (or All apps) at the top right of the pinned apps, scroll to Visual Studio 2026 (or Visual Studio 2022), open that folder and click x64 Native Tools Command Prompt for VS (with the version after it on Visual Studio 2022). On disk the shortcut is in
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio 2026\Visual Studio Tools\VC, and Explorer opens it from there too. Every later page opens this prompt, so pin it: right-click it and choose Pin to Start or Pin to taskbar.The window it opens starts with lines like these, and the last of them must say
'x64':Output ************************************************************************ Visual Studio 2026 Developer Command Prompt v18.0** Copyright (c) 2026 Microsoft Corporation**********************************************************************[vcvarsall.bat] Environment initialized for: 'x64'The version numbers differ with your Visual Studio. It has to be the x64 prompt. It puts the 64-bit compiler, CMake, Ninja and the shader compiler on your
PATHand pointsVCPKG_ROOTat the copy of vcpkg that Visual Studio installed.PATHis the list of folders searched when you type a tool’s name;VCPKG_ROOTis a setting holding vcpkg’s folder. The prompt prepares both for you. Other windows look similar and are wrong for this guide:- Developer Command Prompt and Developer PowerShell set up 32-bit tools. They print
no
Environment initialized for: 'x64'line. - x86 Native Tools, x64_x86 Cross Tools and x86_x64 Cross Tools build for, or run as, 32-bit Windows.
- An ordinary Command Prompt, PowerShell or Terminal window has none of the tools.
If you opened one of those, close it and open the x64 Native Tools Command Prompt instead. The wrong prompt in Troubleshooting lists what each one prints when you carry on regardless.
- Developer Command Prompt and Developer PowerShell set up 32-bit tools. They print
no
-
Check it. Run these in the prompt:
Terminal window cmake --versionninja --versionwhere cl fxcecho %VSCMD_ARG_TGT_ARCH%echo %VCPKG_ROOT%Each should print a version or a path rather than an error. On a machine with Visual Studio 2026 Community the output looks like this; the numbers and versions on yours will differ:
Output cmake version 4.3.1-msvc1CMake suite maintained and supported by Kitware (kitware.com/cmake).1.13.2C:\Program Files\Microsoft Visual Studio\18\Community\VC\Tools\MSVC\14.51.36231\bin\Hostx64\x64\cl.exeC:\Program Files (x86)\Windows Kits\10\bin\10.0.26100.0\x64\fxc.exex64C:\Program Files\Microsoft Visual Studio\18\Community\VC\vcpkgWhat to do if it does not:
'cmake' is not recognized as an internal or external commandmeans this is not the x64 Native Tools Command Prompt. Close it and go back to step 3.INFO: Could not find "fxc".means the Windows SDK is missing. Add it as in step 1.x86instead ofx64means a 32-bit prompt. Go back to step 3.%VCPKG_ROOT%printed back means vcpkg is not set up: follow If VCPKG_ROOT is not set below.
If you installed Git in step 2, check it too:
Terminal window where gitIt prints a path such as
C:\Program Files\Git\cmd\git.exe.INFO: Could not find "git".means Git is not installed, or was installed after this window opened: do step 2, then open a new prompt.If you are using the starter project, you are finished here. Go on to Get the starter project, which makes your projects folder itself. Step 5 and the rest of this page are for the Git route, or for when a check in this step went wrong.
-
For the Git route: tell Git who you are. Skip this step if you are going to use the starter project. Git writes a name and an email address into every commit, and refuses to make the first commit in Start your own project until it has them. You only do this once on a machine.
Paste this line, but before you press Enter, change
Your Nameto your own name, keeping the quotation marks, as Typing the commands shows:Terminal window git config --global user.name "Your Name"Then paste this one, and before you press Enter, change
you@example.comto your email address, again keeping the quotation marks:Terminal window git config --global user.email "you@example.com"They print nothing when they work. The address is recorded in your project’s history, and anyone you share the repository with can read it; it does not have to be one you use for anything else. Check what Git now has:
Terminal window git config --global --get user.namegit config --global --get user.email
Optional Visual Studio configuration
Section titled “Optional Visual Studio configuration”For a new Visual Studio Community 2026 installation, you can use Download labrador.vsconfig instead of ticking components in step 1. Save it in Downloads. It selects the C++ desktop workload, the x64/x86 compiler, CMake tools, vcpkg and the Windows 11 SDK. The file is input to Microsoft’s installer: saving it alone installs nothing, and it does not configure your game or replace the later CMake commands. The manual steps above remain available.
-
Download
VisualStudioSetup.exefrom Free download under Visual Studio Community on Microsoft’s downloads page, as step 1 describes. Keep it besidelabrador.vsconfigin Downloads; do not open it yet. -
Open Start, type
Command Prompt, right-click Command Prompt, choose Run as administrator, and approve Windows’ prompt. This is an ordinary administrator command prompt, used only for the installation; Visual Studio’s x64 prompt does not exist yet. Run these two lines:Terminal window cd /d "%USERPROFILE%\Downloads"start "" /wait VisualStudioSetup.exe --passive --wait --norestart --config labrador.vsconfigThe installer shows progress without asking which components to select.
start /waitkeeps this prompt waiting for the program, and the installer’s--waitkeeps the program waiting until installation finishes. A requested restart is delayed. When the prompt returns, run:Terminal window echo %errorlevel%0means it completed successfully.3010means it completed but needs a restart before use: save your work and restart Windows. Other numbers mean the install did not complete; use step 1’s failure advice and Microsoft’s installer exit codes. -
Close that prompt and continue at step 2, where Git is optional for the starter route, then open the x64 Native Tools Command Prompt and run step 4’s checks.
Already have Visual Studio? Keep step 1’s Modify route. Microsoft also documents More > Import configuration in the Visual Studio Installer, followed by reviewing the selection and choosing Modify. The command above was checked for a new installation, not for modifying an existing one.
What was measured: on 13 November 2026 that five-entry selection and installer arguments installed
Visual Studio Community 2026 18.12.0 on a clean Windows 11 Sandbox, with exit code 0.
It downloaded 2.45 GB, used 10.53 GB of disk and took 206 minutes on the sandbox’s
slow disk; the Windows SDK accounted for more than two hours of fixed waits. The v0.3.0
starter then built, passed both tests and ran in 93 seconds, with no Git or Python installed.
This qualifies that version and selection. The download link can supply a later version;
that run does not qualify a later installer or predict a real PC’s time. The administrator
prompt and a restart request were not observed in the sandbox.
Development starter ZIPs also contain labrador.vsconfig beside CMakePresets.json.
The released v0.3.0 starter does not; its readers can use the download above.
If VCPKG_ROOT is not set
Section titled “If VCPKG_ROOT is not set”Skip this section if echo %VCPKG_ROOT% printed a folder.
The x64 Native Tools Command Prompt sets VCPKG_ROOT itself, every time it opens, when Visual
Studio’s vcpkg package manager component is installed. If it printed %VCPKG_ROOT% back,
the component is usually missing. Find out with these two lines. The first finds where Visual
Studio is installed and keeps it as VS_DIR; the second looks for vcpkg inside it:
for /f "usebackq delims=" %i in (`"%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" -latest -property installationPath`) do set "VS_DIR=%i"dir /b "%VS_DIR%\VC\vcpkg\vcpkg.exe"If the last line prints File Not Found, add the component. Open Visual Studio
Installer from the Start menu, click Modify beside your Visual Studio, open the
Individual components tab, type vcpkg into its search box, tick vcpkg package
manager, and click Modify. When it finishes, close the command prompt, open a new x64
Native Tools Command Prompt, and run echo %VCPKG_ROOT% again. It should now print a folder.
If it prints vcpkg.exe, vcpkg is installed but your version of Visual Studio did not set
VCPKG_ROOT. Set it for this window, in the same window as the two lines above:
set "VCPKG_ROOT=%VS_DIR%\VC\vcpkg"echo %VCPKG_ROOT%A set lasts only until the window closes. To keep it for every window you open from now on,
and for Visual Studio itself, also run:
setx VCPKG_ROOT "%VS_DIR%\VC\vcpkg"It prints SUCCESS: Specified value was saved. setx changes only windows and programs started
after it, so it does not change the window you ran it in, which is why the set line comes
first. Close Visual Studio if it is open, so that it reads the new value when you start it
again. Visual Studio usually lives under C:\Program Files\Microsoft Visual Studio\<version>\<edition>,
where the version is 2022 for Visual Studio 2022 and 18 for Visual Studio 2026, and the
edition is Community, Professional or Enterprise; the for line above finds it so you need
not guess.
Choose a short folder
Section titled “Choose a short folder”Make a folder for your projects close to the root of a drive, and use it in the steps that
follow. These pages use C:\dev. Make it, and go into it:
mkdir C:\devcd /d C:\devIf C:\dev is already there, mkdir says A subdirectory or file C:\dev already exists., which
is harmless. The /d lets cd change drive as well as folder, so the line works whichever
drive the prompt started on. The prompt now ends C:\dev>.
Keep the path of your project’s folder under 100 characters; C:\dev\mygame is 13, and
C:\dev\Labrador, the Git route’s engine folder, is 15. The build
writes files up to about 150 characters below that folder, and the compiler cannot open a path
longer than 260 characters, even when long paths are enabled in Windows. A build in a deeper
folder warns about CMAKE_OBJECT_PATH_MAX when it configures, then stops with
fatal error C1083: Cannot open compiler generated file: '': Invalid argument. Folders under
Documents, Desktop, Downloads or OneDrive are usually too deep, and OneDrive also tries to
upload the gigabyte of build files.
git config --global core.longpaths true does not get round this. It lets Git clone into a
deep folder, where a clone would otherwise fail with Filename too long, but the build in that
folder still fails.
Keeping a deep folder
Section titled “Keeping a deep folder”This is for a project that has to stay in a deep folder, such as one that already stopped with
C1083 there. If you are starting with the starter project and have no such folder, skip it
and use C:\dev:
Get the starter project writes C:\dev in its boxes, inside
lines that are not meant to be changed.
Give the deep folder a drive letter of its own with subst and work from the drive. The
compiler then sees the short path. Paste this line, and before you press Enter, change the
folder after P: to your own:
subst P: C:\Users\you\source\repos\clients\studio\projectsIt prints nothing when it works. Then go to the new drive:
P:The drive letter lasts until you sign out, so run the subst line again after signing in, and
always open the project through the drive letter: a build folder belongs to the path it was
configured from. A project already built through the long path needs its out\build folder
deleted and configuring again from the drive.
If you use Git, it still sees the real path, so it needs core.longpaths as well:
git config --global core.longpaths trueOn the Git route, use P:\ wherever its pages use
C:\dev.
Do not extract a starter ZIP at the root of the drive. Windows’ tar cannot create files
there: it prints Can't create '\\?\P:\mygame\...': No such file or directory for every file
and extracts nothing. In a folder on the drive, such as P:\dev, it works.
What was checked
Section titled “What was checked”On 13 November 2026 Visual Studio Community 2026 18.12 was installed in Windows Sandbox, a
clean Windows 11 with no Visual Studio, Git or Python. The download and the installer’s screens
in step 1, up to the ticked workload and its 11.97 GB, were seen there; the installer was then
closed and the workload, the compiler and the three items step 1 names were installed unattended
from a configuration file, which measured the 10.5 GB, the 2.4 GB download and the time. The
sandbox’s disk is slow, and it ran each of the Windows SDK’s 66 packages in exactly two minutes,
so its time is an upper bound. The administrator prompt, which the sandbox does not show, the
end of an install started from the Workloads tab, whether Visual Studio then opens itself,
and the installer’s failures were not seen, and are written from Microsoft’s
system requirements
and installation troubleshooting
pages. The install put the x64 Native Tools Command Prompt for VS shortcut in the Start menu
folder step 3 names, and in that prompt step 4’s check printed what it shows and
Get the starter project built, tested and ran the v0.3.0 starter
in a minute and a half, with neither Git nor Python installed.
On 31 October 2026 the owner’s desktop, which has Visual Studio Community 2026 18.9 with the
Desktop development with C++, Game development with C++, Python development, .NET
desktop development and core editor workloads and two versions of the C++ compiler, was
measured at about 16 GB on drive C:. The x64 Native Tools Command Prompt for VS shortcut
was found in the Start menu folder step 3 names. A second agent measured the same three sizes, found the shortcut under
Visual Studio Tools\VC, and read the same 20 to 50 GB on Microsoft’s page; neither agent
clicked through the Start menu’s All list.
On 10 November 2026 Windows’ tar (bsdtar 3.8.9) was run on the v0.3.0 starter ZIP on a
temporary subst drive. At the drive’s root it printed 1,147 Can't create lines and extracted
nothing; in a folder on the same drive it extracted the whole mygame folder.
Documentation for Labrador v0.4.0. Built from Labrador f525bc6 of 2026-11-17.