diff --git a/articles/getting_started/2_choosing_your_ide_visual_studio.md b/articles/getting_started/2_choosing_your_ide_visual_studio.md index 78e1f3ba..17e42c57 100644 --- a/articles/getting_started/2_choosing_your_ide_visual_studio.md +++ b/articles/getting_started/2_choosing_your_ide_visual_studio.md @@ -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): @@ -31,16 +31,16 @@ 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) @@ -48,9 +48,9 @@ To create new MonoGame projects from within Visual Studio 2022, you will need to ![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) @@ -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) diff --git a/articles/getting_started/4_adding_content.md b/articles/getting_started/4_adding_content.md index 034d07d6..67d29393 100644 --- a/articles/getting_started/4_adding_content.md +++ b/articles/getting_started/4_adding_content.md @@ -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. diff --git a/articles/getting_started/content_pipeline/using_mgcb_editor.md b/articles/getting_started/content_pipeline/using_mgcb_editor.md index b57bce41..ad6c0fb8 100644 --- a/articles/getting_started/content_pipeline/using_mgcb_editor.md +++ b/articles/getting_started/content_pipeline/using_mgcb_editor.md @@ -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. diff --git a/articles/getting_started/images/1_continue_without_code.png b/articles/getting_started/images/1_continue_without_code.png index 62afd079..71c6f570 100644 Binary files a/articles/getting_started/images/1_continue_without_code.png and b/articles/getting_started/images/1_continue_without_code.png differ diff --git a/articles/getting_started/images/1_installer_vs_components.png b/articles/getting_started/images/1_installer_vs_components.png index 61849e27..c51470d5 100644 Binary files a/articles/getting_started/images/1_installer_vs_components.png and b/articles/getting_started/images/1_installer_vs_components.png differ diff --git a/articles/getting_started/images/1_visual_studio_extension_manager.png b/articles/getting_started/images/1_visual_studio_extension_manager.png index 3403fb25..e042059d 100644 Binary files a/articles/getting_started/images/1_visual_studio_extension_manager.png and b/articles/getting_started/images/1_visual_studio_extension_manager.png differ diff --git a/articles/getting_started/images/1_visual_studio_extension_menu.png b/articles/getting_started/images/1_visual_studio_extension_menu.png index 0ac3fb86..381c8c3f 100644 Binary files a/articles/getting_started/images/1_visual_studio_extension_menu.png and b/articles/getting_started/images/1_visual_studio_extension_menu.png differ diff --git a/articles/getting_started/images/1_vsix_installer_window.png b/articles/getting_started/images/1_vsix_installer_window.png index 0a74b5aa..0d15360a 100644 Binary files a/articles/getting_started/images/1_vsix_installer_window.png and b/articles/getting_started/images/1_vsix_installer_window.png differ diff --git a/articles/getting_started/images/vswin_mg_new_1.png b/articles/getting_started/images/vswin_mg_new_1.png index ae67dc44..88764756 100644 Binary files a/articles/getting_started/images/vswin_mg_new_1.png and b/articles/getting_started/images/vswin_mg_new_1.png differ diff --git a/articles/getting_started/images/vswin_mg_new_2.png b/articles/getting_started/images/vswin_mg_new_2.png index 94bc861a..ffc060bd 100644 Binary files a/articles/getting_started/images/vswin_mg_new_2.png and b/articles/getting_started/images/vswin_mg_new_2.png differ diff --git a/articles/getting_started/images/vswin_mg_new_3.png b/articles/getting_started/images/vswin_mg_new_3.png index 2d8300b7..7590d3ef 100644 Binary files a/articles/getting_started/images/vswin_mg_new_3.png and b/articles/getting_started/images/vswin_mg_new_3.png differ diff --git a/articles/getting_started/images/vswin_mg_new_4.png b/articles/getting_started/images/vswin_mg_new_4.png index 7362011e..74c6078f 100644 Binary files a/articles/getting_started/images/vswin_mg_new_4.png and b/articles/getting_started/images/vswin_mg_new_4.png differ