Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions articles/getting_started/2_choosing_your_ide_visual_studio.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,16 @@ title: Setting up Visual Studio on Windows
description: This section provides a step-by-step guide for setting up your development IDE on Windows for Visual Studio.
---

MonoGame can work with most .NET compatible tools, but we recommend [Visual Studio 2022](https://visualstudio.microsoft.com/vs/)
MonoGame can work with most .NET compatible tools, but we recommend [Visual Studio 2026](https://visualstudio.microsoft.com/vs/)

> [!NOTE]
> Alternatively, you can use [JetBrains Rider](https://www.jetbrains.com/rider/) or [Visual Studio Code](https://code.visualstudio.com/).
>
> Check out the guides for [Setting up VSCode](./2_choosing_your_ide_vscode.md) / [Setting up Rider](./2_choosing_your_ide_rider.md) using these links.

## Install Visual Studio 2022
## Install Visual Studio 2026

Before using MonoGame with Visual Studio you need to ensure you have installed the latest [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) along with the required components.
Before using MonoGame with Visual Studio you need to ensure you have installed the latest [Visual Studio 2026](https://visualstudio.microsoft.com/vs/) along with the required components.

When installing Visual Studio, the following workloads are required depending on your desired [target platform(s)](./platforms.md):

Expand All @@ -31,26 +31,26 @@ When installing Visual Studio, the following workloads are required depending on
>
> Work is underway however to update to support DirectX 12 on Windows and Xbox very soon.

### Install MonoGame extension for Visual Studio 2022
### Install MonoGame extension for Visual Studio 2026

To create new MonoGame projects from within Visual Studio 2022, you will need to install the **MonoGame Framework C# project templates** extension. The following steps demonstrate how to install the extension.
To create new MonoGame projects from within Visual Studio 2026, you will need to install the **MonoGame Framework C# project templates** extension. The following steps demonstrate how to install the extension.

1. Launch Visual Studio 2022
1. Launch Visual Studio 2026
2. Select **Continue without code**. This will launch Visual Studio without any project or solution opened.

![Visual Studio Launcher Continue Without Code](images/1_continue_without_code.png)

3. Click "*Extensions -> Manage Extensions* in the Visual Studio 2022 menu bar. This will open the Manage Extensions dialog window.
3. Click "*Extensions -> Manage Extensions* in the Visual Studio 2026 menu bar. This will open the Manage Extensions dialog window.

![Extensions -> Manage Extensions Menu Selection](images/1_visual_studio_extension_menu.png)

4. Use the search box in the top-right corner of the Manage Extensions dialog window to search for **MonoGame**, then click the **MonoGame Framework C# project templates** extension as shown below and download it to install it.

![Visual Studio Extension Manager](images/1_visual_studio_extension_manager.png)

5. After it is downloaded, an alert will appear at the bottom of the Manage Extensions window that states "Your changes will be scheduled. The modifications will begin when all Microsoft Visual Studio windows are closed." Click the **Close** button, then close Visual Studio 2022.
5. After it is downloaded, an alert will appear at the bottom of the Manage Extensions window that states "Your changes will be scheduled. The modifications will begin when all Microsoft Visual Studio windows are closed." Click the **Close** button, then close Visual Studio 2026.

6. After closing Visual Studio 2022, a VSIX Installer window will open confirming that you want to install the **MonoGame Framework C# project templates** extension. Click the **Modify** button to accept the install.
6. After closing Visual Studio 2026, a VSIX Installer window will open confirming that you want to install the **MonoGame Framework C# project templates** extension. Click the **Modify** button to accept the install.

![VSIX Installer Window](images/1_vsix_installer_window.png)

Expand All @@ -65,15 +65,15 @@ You now have the MonoGame templates installed and are ready to create new projec

To get you started with Visual Studio, here are the steps for setting up a new MonoGame project.

1. Start Visual Studio 2022 and select **New Project...** in the upper left corner.
1. Start Visual Studio 2026 and select **Create a new project** in the upper left corner.

![New Solution](images/vswin_mg_new_1.png)

2. You should see the "Create a new project" dialog pop up. From here, select the **Templates > Visual C# > MonoGame** category, and then select **MonoGame Cross Platform Desktop Project**.
2. You should see the "Create a new project" dialog pop up. From here, select **MonoGame** from the **All Project Types** dropdown, then select the MonoGame project template you would like to use and click **Next**. The example below shows the MonoGame Cross-Platform DesktopGL Application project template selected.

![New Template](images/vswin_mg_new_2.png)

3. Next, type in a name for your project. For this tutorial, **Pong** will be used (note: project names cannot contain spaces). After you have entered the name, click on the **...** button next to the Location text field and choose the folder you want to save the project in. Finally, click **OK** to create the project.
3. Next, type in a name for your project. For this tutorial, **Pong** will be used (note: project names cannot contain spaces). After you have entered the name, click on the **...** button next to the Location text field and choose the folder you want to save the project in. Finally, click **Create** to create the project.

![Project Name](images/vswin_mg_new_3.png)

Expand Down
2 changes: 1 addition & 1 deletion articles/getting_started/4_adding_content.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: This tutorial will go over adding content such as images or sounds

The [MGCB Editor](./tools/mgcb_editor.md) is used to organize and build content for use with MonoGame. It is accessed by either:

- Double-clicking a "`.mgcb`" file from within the Visual Studio solution explorer (providing that you installed [MonoGame's Visual Studio extension](./2_choosing_your_ide_visual_studio.md#install-monogame-extension-for-visual-studio-2022)).
- Double-clicking a "`.mgcb`" file from within the Visual Studio solution explorer (providing that you installed [MonoGame's Visual Studio extension](./2_choosing_your_ide_visual_studio.md#install-monogame-extension-for-visual-studio-2026)).
- Right-clicking a "`.mgcb`" file from within the Visual Studio code and selecting "Open in MGCB Editor" (provided you have installed the [VSCode extension](./2_choosing_your_ide_vscode.md#optional-install-the-monogame-for-vscode-extension))
- Use 'dotnet mgcb-editor' to open Editor, than open "`.mgcb`" file from menu.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: Learn how to use the MGCB Editor to organize and build content for

The [MGCB Editor](../tools/mgcb_editor.md) is used to organize and build content for use with MonoGame. It is accessed by either:

* Double-clicking a "**.mgcb**" file from within the Visual Studio solution explorer (providing that you installed [MonoGame's Visual Studio extension](../2_choosing_your_ide_visual_studio.md#install-monogame-extension-for-visual-studio-2022)).
* Double-clicking a "**.mgcb**" file from within the Visual Studio solution explorer (providing that you installed [MonoGame's Visual Studio extension](../2_choosing_your_ide_visual_studio.md#install-monogame-extension-for-visual-studio-2026)).
* Right-clicking a "**.mgcb**" file from within the Visual Studio code and selecting "Open in MGCB Editor" (provided you have installed the [VSCode extension](../2_choosing_your_ide_vscode.md#install-visual-studio-code-c-extensions))

Alternatively, you can build it [directly from source](https://github.com/MonoGame/MonoGame/tree/develop/Tools/MonoGame.Content.Builder.Editor) if needed.
Expand Down
Binary file modified articles/getting_started/images/1_continue_without_code.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified articles/getting_started/images/1_installer_vs_components.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified articles/getting_started/images/1_vsix_installer_window.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified articles/getting_started/images/vswin_mg_new_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified articles/getting_started/images/vswin_mg_new_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified articles/getting_started/images/vswin_mg_new_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified articles/getting_started/images/vswin_mg_new_4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading