Mutagen is a C# library for analyzing, modifying, and creating Bethesda mods. One of its main features is offering interfaces and classes for the records that exist at compile time and are first class citizens in C#. With actual members for each field they get the benefits of type safety, simple live debugging, Intellisense features such as autocomplete. The interfaces offer clean API to the user and abstract away much of the binary record specifics and oddities of how they are stored on disk, while the actual implementation remains very closely tied to the data offering as much speed as it can by leveraging some of the latest C# features. Most of the public facing API is created by code generation, with small manual snippets of code for the one-off special cases. This means the library is able to provide consistent API with very little manual work when adding new record definitions or features.
What is Mutagen trying to provide?
- Ability to analyze, create, or manipulate esp/esm mod files for Bethesda games in C#.
- Strongly typed objects and fields for all records, which naturally offer Intellisense and type safety.
- User abstraction from complex binary record structures/patterns, when appropriate and beneficial.
- Frameworks for accomplishing common tasks, such as Patchers
- Performance via minimal internal layers between API and underlying work.
- Heavy use of generated code to provide the above goals without requiring verbose manual development or maintenance.
- Powerful but gritty low level tools for those that want to forgo the autogenerated classes for special tasks.
- Other tooling related to Bethesda modding in C#
using var mod = OblivionMod.CreateFromBinaryOverlay(pathToMod);
foreach (var editorId in mod.Potions.Records
.Select(potion => potion.EditorID)
.Distinct()
.Where(s => !string.IsNullOrWhiteSpace(s)))
{
System.Console.WriteLine(editorId);
}This example snippet would print a mod's unique Potion EditorIDs to the console.
Check out the Wiki for more detailed explainations of Mutagen's API, and more typical use cases and examples.
Mutagen can be added to your C# project via NuGet, under the package name Mutagen.Bethesda. Search for it in Visual Studio, or find it here.
Please check out Setting Up Your First Project to get you started.