Visual Studio Setup Guide - Robocat999/AtlyssModLoader GitHub Wiki

This loader is deprecated! Please use BepInEx v5.4.23.2

See the README on the homepage for more information.

Guide Overview

This guide seeks to aid users in setting up a coding environment through step-by-step instructions. In particular, users with little prior experience in coding should find this helpful.

Prerequisite Downloads

  1. Visual Studio 2022 Community (Or any higher edition)
  2. Atlyss

Setting Up Visual Studio 2022

  1. Create a new C# Class Library project. If you do not see the option to create this type of project, you will need to download the .NET Framework package. To do this, go to the bottom of the available project types, click on "Install more tools and features," and then select the .NET Framework option. Hit modify to install the package.
  2. Name your project as you wish.
  3. Select .NET Framework 4.6 for the .NET version. If this is not an option, simply proceed with the default.
  4. If you selected .NET Framework 4.6 in step 3, skip to the step 9. In order to switch your project to .NET Framework 4.6, right-click on your project in the Solution Explorer on the right side of your screen. Select the "properties" option.
  5. Click on the "Install other Frameworks" button found under the "Target Framework" section in the General tab of the Application Tab.
  6. On the webpage opened, navigate to the "Supported Versions" tab, and install the Developer Pack for any ".NET Framework 4.6" version. As of writing this guide, the only supported version of 4.6 is ".NET Framework 4.6.2"
  7. Run the .exe you obtained from the earlier steps, and proceed through the installer. This will install the new framework to your Visual Studio.
  8. Return to the "Target Framework" section of the project properties (see step 4). Set the "Target Framework" to any 4.6 version. This guide recommends ".NET Framework 4.6.2" and will proceed presuming you have also chosen this option. However, all versions of .NET Framework 4.6.2 should work with this guide, should a different one be chosen. If you can not find the framework version to select then double-click on your project in the Solution Explorer to open the project file. Change the text within the "TargetFramework" brackets to say "net462". If you return to the "Target Framework" section, you should now see more options to select for a framework. If this still fails, try "net46" as the TargetFramework.
  9. Navigate to the Nuget Package Manager. Use the toolbar at the top of the screen: Tools > NuGet Package Manager > Manage NuGet Packages for Solution
  10. Select the "Browse" tab and search "Harmony". "Lib.Harmony" should appear. Install this library to the project
  11. Right click on your project, select add, then select project reference.
  12. In the project refrence screen, browse to the file "Assembly-CSharp.dll" located in the folder ATLYSS/ATLYSS_Data/Managed. Double-click the file and then confirm your selection. If you do not know where the ATLYSS folder is, go to Atlyss in Steam, click on the gear icon, click on Properties, click on Installed Filese, and finally, click Browse. This will open the ATLYSS folder in a new file explorer.
  13. If you wish to work with UnityEngine classes and functions, repeat step 12 but with the file "UnityEngine.CoreModule.dll". It is found in the same folder as indicated in step 12.

You now have a Visual Studio 2022 solution cappable of making mods compatiable with the Atlyss Mod Loader! Please see the Creating Mods page for an explanation on basic modding.