MuseDash.Mod.Template 1.0.1

MuseDash.Mod.Template

A template for making Muse Dash Mods

Pre-requisites

• Muse Dash with MelonLoader 0.6.1
• .Net SDK 6.0
• Any C# IDE (Visual Studio, Rider, etc.)

Getting Started (Windows Only)

• Download SetPath.cmd from this repository and run it as administrator, follow the instructions to set Muse Dash path into your computer's environment variable.
• Open command prompt or powershell, run

dotnet new install MuseDash.Mod.Template

This will install the template on your computer.

Usage

• If you are using Visual Studio, you should be able to find the template in Create a new project -> MuseDash Mod

  Then you can create a new project with the following options:

• If you are using Rider, you should be able to find the template in New Solution -> Custom Templates -> MuseDash Mod

  Then you can create a new project with the following advanced settings:

Parameters

• --Patching: Whether to generate a patching class for the mod. (Defaults to true)
• --Setting: Options for generating a setting class for the mod. (Defaults to None)
  • None: Do not generate a setting class
  • MelonLoader: Use MelonPreferences for setting
  • Tomlet: Use Tomlet directly for setting, this will also generate a Data class for setting
• --UsefulLibs: Options for including useful libraries for the mod. (Defaults to MuseDashMirror)
  • MuseDashMirror: Offers more smooth and efficient modding experience for Muse Dash.
  • ILRepack: Able to merge dependencies and mod into a single dll file.
  • UniTask: Provides an efficient allocation free async/await integration for Unity.
  • ZString: Zero Allocation StringBuilder for better performance.

Update Template

Run the following command

dotnet new update