Beginners guide to setting up UndertaleModTool using Visual Studio - UnderminersTeam/UndertaleModTool GitHub Wiki

  1. Ensure that any version of Visual Studio is installed on your computer. Make sure you also install .NET or it won’t work!
  2. Download the source as a ZIP and and extract it to a convenient location. (or clone the https://github.com/krzys-h/UndertaleModTool.git repo using Git, then checkout the master branch.)
  3. Open UndertaleModTool.sln from the location in which you extracted it. Note: If it needs to install more then let it install more and then, once completed, repeat steps 2-3.
  4. In the new window that appears make sure the boxes at the top are “Debug” and “UndertaleModTool” and then click the big green triangle labeled “Start”. Note: If Visual Studio says "We're preparing for first use. This may take a few minutes" then you may have to wait 15-20 minutes to complete setup depending on your computer.
  5. If all steps are completed correctly UndertaleModTool should now open without issue. If you are encountering errors, please contact us on Discord to help troubleshoot the issue.

Troubleshooting section

  • .NET dependencies are not installed error

If you have encountered errors like the ones shown below and/or if you are prompted for .NET Framework 4.6.1 upon startup please "Modify" the Visual Studio Installer and then download the .NET when prompted. Alternatively, you may download and install the required dependencies on .NET's website directly, which may be faster.

.NET Error

  • "UndertaleModTool.exe is missing"

This error usually occurs if .NET is not installed. However, if it occurs afterwards, then try the following: Keep selecting "Run" in Visual Studio and then, when "UndertaleModTool.exe is missing" is the only error remaining, close Visual Studio, reopen the project, and then select "Run" again.

UndertaleModTool.exe is missing