Skip to content

Latest commit

 

History

History
51 lines (33 loc) · 3.64 KB

README.md

File metadata and controls

51 lines (33 loc) · 3.64 KB

LBoL-ModdingTools

Modding tools for Lost Branch of Legend

Example project/template by rmrfmaxxc. The intended way to organize Sidloader templates for larger projects, i.e., new characters.

Alpha branch is available with code THRDBG20220728

It offers most up to date debug menus.

Press F5 in main menu to start a debug run!

F4 while in battle to opens combat log.

image


LBoL Plugin.zip is BepInEx plugin template for Visual Studio. Includes assembly publicizer. Adjust <GameFolder> property in .csproj file.

Visual Studio templates should probably be placed at <User>/Documents/Visual Studio 20xx/Templates/ProjectTemplates

Tool superlist

Injectors:

  • BePinEx. Code injector and plugin loader providing a starting point for any mod.

Code patchers

  • Harmony. The essential modding library allowing to manipulate source code at runtime. While technically BePinEx is using custom fork of Harmony, HarmonyX, the regular Harmony documentation still applies. It's both a great beginner's guide and explanation of more advanced features.

Development plugins:

  • Unity Explorer. GUI for exploring scene hierarchy, inspecting game objects, C# REPL console and more. Very powerful.
  • BePinEx debug tools. Collection of dev tools. DemystifyExceptions and Scriptengine are particularly useful ones. Although, scriptengine requires a slight modification to work with LBoL 100% correctly
  • Sharplab. Not a plugin but a tool to check how C# transforms to Intermediary Language (advanced, don't worry about it if you're starting out).

Decompilation:

  • dnSpyEx. Probably the most important modding tool. Super convenient source code explorer and debugger.
  • Patched mono. Patched mono for LBoL for attaching dnSpyEx debugger. Enables many debugging features during runtime. Apparently, the exposed 127.0.0.1:55555 port can be used to connect other debuggers, such as Ryder, as well. More info on that.
  • ILSpy. The OG C# decompiler. Not as shiny as dnSpy but sometimes offers better decompiled code quality.

Asset extraction:

  • AssetRipper. Actively developed and probably one of the best asset extractors out there
  • AssetStudio. No longer maintained and not as reliable as AssetRipper but a nicer gui for quick for exploring/extraction.

Performance profilers:

  • <to be added> Although the game isn't very performance critical so profiling your mod might be an overkill.