<cat>Dev.Projects</cat> <title>Getting Started - Your First Project</title> <note> <key>WORK IN PROGRESS</key> This page is a work in progress - contributions are encouraged! See notes for details. This is supposed to be a beginner-friendly walkthrough, as a lot of the content here assumes prior knowledge. </note> #Welcome to S&box! #Welcome to s&box! Formalities over; it's time you started doing something with this opportunity! Roll up those sleeves and get knuckle deep in the mosh pit. ## Choosing the right IDE ###Visual Studio 2022 An IDE you're comfortable with is a must. We suggest [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) as the Community-Edition is free and you can open your Code-Base inside S&box right away. An IDE you're comfortable with is a must. We suggest [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) as the Community Edition is free and you can open your code base inside s&box right away. <upload src="b3cb9/8db0552a67b41fd.png" size="5967" name="image.png" /> Follow this [external guide](https://docs.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=vs-2022) to help you get set up for C# development. ### JetBrains Rider This is a commercial product, depending on your workflow this might be your preferred choice. See here, how to get started with [Jetbrains Rider](https://wiki.facepunch.com/sbox/Setting_up_Rider) ### Visual Studio Code ⤶ Another Code-Editor. This might your preference due it's performance or simplicity. ⤶ This might be your preference if you have a weaker system or if you want a simple editor. See here, how to get started with [Visual Studio Code](https://wiki.facepunch.com/sbox/Setting_up_VSCode) ⤶ #S&box Game Editor Next up, start the S&box **Game Editor** through Steam⤶ ⤶ #s&box Game Editor Next up, start the s&box **Game Editor** through Steam.⤶ <upload src="b3249/8daf3c5996c1760.png" size="34192" name="image.png" /> <upload src="b3249/8daf3c5c4ff7cc1.png" size="10113" name="image.png" /> <upload src="4a1b3/8db6d91884acdc7.png" size="76308" name="sbox_launch.png" /> ## Adjusting the Launch Settings Chances are, you'll be opening this most of the time. If you wish, you can enforce to start the **Game Editor** by default. 1. View the properties of S&box <upload src="b3cb9/8db0555a5b1d569.png" size="21013" name="steam_5LSW87SWxe.png" /> 2. Set the Options <upload src="b3cb9/8db05544b2a64d4.png" size="118762" name="image.png" /> ⤶ Alternatively, select "Always use this option" when starting the Editor for the next time.⤶ ##Creating a Project Don't get overwhelmed. There's lots to look at here, but we can work our way through it. You can check out the <page>Editor</page> overview for more information about the different sections of the editor. First things first, create a project. <upload src="b3249/8daf3c7131e0dd5.png" size="25922" name="image.png" /> <upload src="b3249/8daf3c734b69ac9.png" size="16604" name="image.png" /> Leave the **Project Type** for this one as **Game**. Fill in the **Project Title** and then hit **OK**. ##Opening your project in Visual Studio Head back to Steam, and open S&box's local files. <upload src="b3249/8daf48067e017f0.png" size="40415" name="image.png" /> Then, open up **s&box.sln** <upload src="b3249/8daf48089817f43.png" size="9818" name="image.png" /> Any projects loaded in the S&box **Game Editor** will appear in this solution. Just find **your_fantastic_gamemode** inside of the **Games** folder. This will appear under the **Solution Explorer** panel, on the right side of your screen by default. <upload src="b3249/8daf480d93f4181.png" size="6537" name="image.png" /> If you don't see this panel, try clicking on this tab on the right: <upload src="b3249/8daf3ca28e67db7.png" size="3387" name="image.png" /> ##Editing the Code If you don't know what you're looking at now, you're in for a ride and a half. <upload src="b3249/8daf48134240e73.png" size="172908" name="image.png" /> Get creative! Check out our picks of <page>CSharp Learning Resources</page> to help get you started. S&box will automatically compile your gamemode whenever you **Save** (<key>CTRL</key> + <key>S</key>). <note> <key>TODO: TESTING YOUR GAMEMODE</key> Here would be a great place to demonstrate how to playtest your code edits ingame through the Game Editor </note> ##Uploading your new Gamemode Check out the <page>CreatingProjects</page> page. <note> <key>WORK IN PROGRESS</key> This page is a work in progress - contributions are encouraged! See notes for details. This is supposed to be a beginner-friendly walkthrough, as a lot of the content here assumes prior knowledge. </note>