WIP Anim API

AmongUs.props

@@ -2,7 +2,7 @@
     <ItemGroup>
         <PackageReference Include="Reactor" Version="2.3.1" />
         <PackageReference Include="BepInEx.Unity.IL2CPP" Version="6.0.0-be.697" Private="false" ExcludeAssets="runtime;native" />
-        <PackageReference Include="AmongUs.GameLibs.Steam" Version="2024.9.4" PrivateAssets="all" />
+        <PackageReference Include="AmongUs.GameLibs.Steam" Version="2024.8.13" PrivateAssets="all" />
 
         <PackageReference Include="BepInEx.AutoPlugin" Version="1.1.0" PrivateAssets="all" />
         <PackageReference Include="BepInEx.IL2CPP.MSBuild" Version="2.0.1" PrivateAssets="all" ExcludeAssets="runtime" />

Directory.Build.props

@@ -8,7 +8,7 @@
 
         <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
 
-        <VersionPrefix>0.1.9</VersionPrefix>
+        <VersionPrefix>0.1.4</VersionPrefix>
         <VersionSuffix>dev</VersionSuffix>
 
         <Authors>All Of Us, XtraCube, Angxl</Authors>

MiraAPI.Example/Buttons/MeetingButton.cs

@@ -21,7 +21,7 @@ public class MeetingButton : CustomActionButton
 
     public override bool Enabled(RoleBehaviour? role)
     {
-        return PlayerControl.LocalPlayer != null && PlayerControl.LocalPlayer.HasModifier<CaptainModifier>();
+        return PlayerControl.LocalPlayer.HasModifier<CaptainModifier>();
     }
 
     protected override void OnClick()

MiraAPI.Example/Buttons/Teleporter/TeleportButton.cs

@@ -1,10 +1,10 @@
-using System.Collections;
-using MiraAPI.Example.Options.Roles;
+using MiraAPI.Example.Options.Roles;
 using MiraAPI.Example.Roles;
 using MiraAPI.GameOptions;
 using MiraAPI.Hud;
 using MiraAPI.Utilities.Assets;
 using Reactor.Utilities;
+using System.Collections;
 using UnityEngine;
 
 namespace MiraAPI.Example.Buttons.Teleporter;
@@ -40,10 +40,7 @@ public class TeleportButton : CustomActionButton
     {
         base.FixedUpdate(playerControl);
 
-        if (!EffectActive)
-        {
-            return;
-        }
+        if (!EffectActive) return;
 
         if (Input.GetKey(KeyCode.Mouse0))
         {

MiraAPI.Example/Cosmetics/ExampleCosmeticGroup.cs

@@ -1,17 +0,0 @@
-using System.Collections.Generic;
-using MiraAPI.Cosmetics;
-
-namespace MiraAPI.Example.Cosmetics;
-public class ExampleCosmeticGroup : AbstractCosmeticsGroup
-{
-    public override string GroupName => "Example";
-
-    [RegisterCustomCosmetic()]
-    public List<HatData> hats { get; set;  } = new();
-    [RegisterCustomCosmetic()]
-    public List<NamePlateData> namePlates { get; set;} = new();
-    [RegisterCustomCosmetic()]
-    public List<SkinData> skins { get; set; } = new();
-    [RegisterCustomCosmetic()]
-    public List<VisorData> visors { get; set; } = new();
-}

MiraAPI.Example/ExamplePlugin.cs

@@ -2,11 +2,7 @@
 using BepInEx.Configuration;
 using BepInEx.Unity.IL2CPP;
 using HarmonyLib;
-using MiraAPI.Cosmetics;
-using MiraAPI.Example.Cosmetics;
 using MiraAPI.PluginLoading;
-using MiraAPI.Utilities.Assets;
-using MiraAPI.Utilities.Assets.Addressable;
 using Reactor;
 using Reactor.Networking;
 using Reactor.Networking.Attributes;
@@ -26,12 +22,5 @@ public partial class ExamplePlugin : BasePlugin, IMiraPlugin
     public override void Load()
     {
         Harmony.PatchAll();
-        AddComponent<MiraDebugWindow>();
-
-        new Catalog("Output".ToLocalPath()).LoadCatalog();
-        CosmeticGroupSingleton<ExampleCosmeticGroup>.Instance.hats = new LoadableAddressableGroupAsset<HatData>(CatalogTools.GetResourceLocation("hatdata")).LoadAsset();
-        CosmeticGroupSingleton<ExampleCosmeticGroup>.Instance.namePlates = new LoadableAddressableGroupAsset<NamePlateData>(CatalogTools.GetResourceLocation("nameplatedata")).LoadAsset();
-        CosmeticGroupSingleton<ExampleCosmeticGroup>.Instance.skins = new LoadableAddressableGroupAsset<SkinData>(CatalogTools.GetResourceLocation("skindata")).LoadAsset();
-        CosmeticGroupSingleton<ExampleCosmeticGroup>.Instance.visors = new LoadableAddressableGroupAsset<VisorData>(CatalogTools.GetResourceLocation("visordata")).LoadAsset();
     }
 }

MiraAPI.Example/Options/Roles/FreezerRoleSettings.cs

@@ -1,7 +1,7 @@
-using System;
-using MiraAPI.Example.Roles;
+using MiraAPI.Example.Roles;
 using MiraAPI.GameOptions;
 using MiraAPI.GameOptions.Attributes;
+using System;
 using MiraAPI.Utilities;
 
 namespace MiraAPI.Example.Options.Roles;

MiraAPI.Example/Roles/ChameleonRole.cs

@@ -1,4 +1,6 @@
 using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
+using TMPro;
 using UnityEngine;
 
 namespace MiraAPI.Example.Roles;
@@ -11,18 +13,15 @@ public class ChameloenRole : CrewmateRole, ICustomRole
     public string RoleDescription => RoleLongDescription;
     public Color RoleColor => Palette.AcceptedGreen;
     public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
-
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
-    {
-        OptionsScreenshot = ExampleAssets.Banner,
-    };
+    public LoadableAsset<Sprite> OptionsScreenshot => ExampleAssets.Banner;
+    public int MaxPlayers => 2;
 
     public void PlayerControlFixedUpdate(PlayerControl playerControl)
     {
         if (playerControl.MyPhysics.Velocity.magnitude > 0)
         {
-            var rend = playerControl.cosmetics.currentBodySprite.BodySprite;
-            var tmp = playerControl.cosmetics.nameText;
+            SpriteRenderer rend = playerControl.cosmetics.currentBodySprite.BodySprite;
+            TextMeshPro tmp = playerControl.cosmetics.nameText;
             tmp.color = Color.Lerp(tmp.color, new Color(tmp.color.r, tmp.color.g, tmp.color.b, 1), Time.deltaTime * 4f);
             rend.color = Color.Lerp(rend.color, new Color(1, 1, 1, 1), Time.deltaTime * 4f);
 
@@ -33,8 +32,8 @@ public class ChameloenRole : CrewmateRole, ICustomRole
         }
         else
         {
-            var rend = playerControl.cosmetics.currentBodySprite.BodySprite;
-            var tmp = playerControl.cosmetics.nameText;
+            SpriteRenderer rend = playerControl.cosmetics.currentBodySprite.BodySprite;
+            TextMeshPro tmp = playerControl.cosmetics.nameText;
             tmp.color = Color.Lerp(tmp.color, new Color(tmp.color.r, tmp.color.g, tmp.color.b, playerControl.AmOwner ? 0.3f : 0), Time.deltaTime * 4f);
             rend.color = Color.Lerp(rend.color, new Color(1, 1, 1, playerControl.AmOwner ? 0.3f : 0), Time.deltaTime * 4f);
 
@@ -44,4 +43,4 @@ public class ChameloenRole : CrewmateRole, ICustomRole
             }
         }
     }
-}
+}

MiraAPI.Example/Roles/FreezerRole.cs

@@ -1,4 +1,6 @@
-using MiraAPI.Roles;
+using Il2CppInterop.Runtime.Attributes;
+using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
 using UnityEngine;
 
 namespace MiraAPI.Example.Roles;
@@ -11,10 +13,7 @@ public class FreezerRole : ImpostorRole, ICustomRole
     public string RoleDescription => RoleLongDescription;
     public Color RoleColor => Palette.Blue;
     public ModdedRoleTeams Team => ModdedRoleTeams.Impostor;
-
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
-    {
-        OptionsScreenshot = ExampleAssets.Banner,
-        MaxRoleCount = 2,
-    };
+    [HideFromIl2Cpp]
+    public LoadableAsset<Sprite> OptionsScreenshot => ExampleAssets.Banner;
+    public int MaxPlayers => 2;
 }

MiraAPI.Example/Roles/NeutralKillerRole.cs

@@ -11,13 +11,9 @@ public class NeutralKillerRole : ImpostorRole, ICustomRole
     public string RoleLongDescription => RoleDescription;
     public Color RoleColor => Color.magenta;
     public ModdedRoleTeams Team => ModdedRoleTeams.Neutral;
-
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
-    {
-        UseVanillaKillButton = true,
-        CanGetKilled = true,
-        CanUseVent = true,
-    };
+    public bool UseVanillaKillButton => true;
+    public bool CanGetKilled => true;
+    public bool CanUseVent => true;
 
     public override void SpawnTaskHeader(PlayerControl playerControl)
     {

MiraAPI.Example/Roles/TeleporterRole.cs

@@ -1,4 +1,6 @@
-using MiraAPI.Roles;
+using Il2CppInterop.Runtime.Attributes;
+using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
 using UnityEngine;
 
 namespace MiraAPI.Example.Roles;
@@ -11,12 +13,6 @@ public class TeleporterRole : CrewmateRole, ICustomRole
     public string RoleDescription => RoleLongDescription;
     public Color RoleColor => new Color32(221, 176, 152, 255);
     public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
-
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
-    {
-        OptionsScreenshot = ExampleAssets.Banner,
-        CanModifyChance = false,
-        DefaultChance = 73,
-        DefaultRoleCount = 4,
-    };
+    [HideFromIl2Cpp]
+    public LoadableAsset<Sprite> OptionsScreenshot => ExampleAssets.Banner;
 }

MiraAPI/Animations/AnimationPresetManager.cs

@@ -0,0 +1,46 @@
+using MiraAPI.Animations;
+using System;
+using System.Collections.Generic;
+
+namespace MiraAPI.Modifiers;
+
+/// <summary>
+/// The manager for handling modifiers.
+/// </summary>
+public static class AnimationPresetManager
+{
+    private static uint _nextId;
+
+    /// <summary>
+    /// Gets registered Animation Presets.
+    /// </summary>
+    public static List<CustomAnimationPreset> Presets { get; internal set; } = new List<CustomAnimationPreset>();
+
+    private static uint GetNextId()
+    {
+        _nextId++;
+        return _nextId;
+    }
+
+    /// <summary>
+    /// Get Animation Preset by ID.
+    /// </summary>
+    /// <param name="id">The id of the preset you want to find.</param>
+    /// <returns>The animation preset.</returns>
+    public static CustomAnimationPreset? GetPresetById(uint id)
+    {
+        return Presets.Find(p => p.Id == id);
+    }
+
+    internal static void RegisterPreset(Type modifierType)
+    {
+        if (!typeof(CustomAnimationPreset).IsAssignableFrom(modifierType))
+        {
+            return;
+        }
+
+        CustomAnimationPreset preset = (CustomAnimationPreset)Activator.CreateInstance(modifierType);
+        preset.Id = GetNextId();
+        Presets.Add(preset);
+    }
+}

MiraAPI/Animations/CustomAnimationPreset.cs

@@ -0,0 +1,24 @@
+using UnityEngine;
+
+namespace MiraAPI.Animations;
+
+/// <summary>
+/// Configure an animation's settings using presets.
+/// </summary>
+/// <param name="clip">The animation clip the preset will use.</param>
+public abstract class CustomAnimationPreset(AnimationClip clip)
+{
+    internal uint Id;
+
+    internal void PlayAnimation(PlayerControl source)
+    {
+
+    }
+
+    /// <summary>
+    /// Check whether the local player should be able to see this animation.
+    /// </summary>
+    /// <param name="source">The player who the animation is being triggered upon.</param>
+    /// <returns>Whether the local player can see the animation or not.</returns>
+    public abstract bool AnimationVisible(PlayerControl source);
+}

MiraAPI/Animations/CustomAnimator.cs

@@ -0,0 +1,38 @@
+using MiraAPI.Animations.Presets;
+using MiraAPI.Modifiers;
+using MiraAPI.Networking;
+using MiraAPI.Utilities;
+using Reactor.Networking.Attributes;
+using Reactor.Utilities.Attributes;
+using System;
+using UnityEngine;
+
+namespace MiraAPI.Animations;
+
+[RegisterInIl2Cpp]
+public class CustomAnimator(IntPtr cppPtr) : MonoBehaviour(cppPtr)
+{
+    private PlayerControl _player;
+
+    private void Start()
+    {
+        _player = gameObject.GetComponent<PlayerControl>();
+
+        _player.GetCustomAnimator()?.TriggerCustomAnimation(new LocalAnimationPreset(new AnimationClip()));
+    }
+
+    public void TriggerCustomAnimation(CustomAnimationPreset preset) => RpcTriggerCustomAnimation(_player, preset.Id);
+
+
+    [MethodRpc((uint)MiraRpc.TriggerAnimation)]
+    internal static void RpcTriggerCustomAnimation(PlayerControl source, uint presetId)
+    {
+        CustomAnimationPreset preset = AnimationPresetManager.GetPresetById(presetId);
+        if (preset is null) return;
+
+        if (preset.AnimationVisible(source))
+        {
+            preset.PlayAnimation(source);
+        }
+    }
+}

MiraAPI/Animations/Presets/LocalAnimationPreset.cs

@@ -0,0 +1,11 @@
+using UnityEngine;
+
+namespace MiraAPI.Animations.Presets;
+public class LocalAnimationPreset(AnimationClip clip) : CustomAnimationPreset(clip)
+{
+    /// <inheritdoc/>
+    public override bool AnimationVisible(PlayerControl source)
+    {
+        return source.AmOwner;
+    }
+}

MiraAPI/Animations/RegisterAnimationPresetAttribute.cs

@@ -0,0 +1,6 @@
+using System;
+
+namespace MiraAPI.Animations;
+
+[AttributeUsage(AttributeTargets.Class)]
+public class RegisterAnimationPresetAttribute : Attribute;

MiraAPI/Cosmetics/AbstractCosmeticsGroup.cs

@@ -1,39 +0,0 @@
-using System;
-using System.Collections.Generic;
-
-namespace MiraAPI.Cosmetics;
-public abstract class AbstractCosmeticsGroup
-{
-    public List<HatData> Hats { get; } = [];
-    public List<SkinData> Skins { get; } = [];
-    public List<VisorData> Visors { get; } = [];
-    public List<NamePlateData> Nameplates { get; } = [];
-
-    /// <summary>
-    /// Gets the name of the group. Visible in options menu.
-    /// </summary>
-    public abstract string GroupName { get; }
-
-    /// <summary>
-    /// Gets a function that determines whether the group should be visible or not.
-    /// </summary>
-    public virtual Func<bool> GroupVisible => () => true;
-
-    /// <summary>
-    /// Gets the sorting mode of individual hats within this group.
-    /// </summary>
-    public virtual SortingMode SortingMode => SortingMode.AlphabeticName;
-
-    /// <summary>
-    /// Gets the priority of a group for sorting groups.
-    /// </summary>
-    public virtual int SortingPriority { get; }
-}
-
-public enum SortingMode
-{
-    Priority,
-    AlphabeticProductId,
-    AlphabeticStoreName,
-    AlphabeticName,
-}

MiraAPI/Cosmetics/AbstractCosmeticsGroupComparer.cs

@@ -1,22 +0,0 @@
-using System;
-using System.Collections.Generic;
-
-namespace MiraAPI.Cosmetics;
-internal sealed class AbstractCosmeticsGroupComparer : Comparer<AbstractCosmeticsGroup>
-{
-    public override int Compare(AbstractCosmeticsGroup? x, AbstractCosmeticsGroup? y)
-    {
-        switch (x)
-        {
-            case not null when y is null:
-                return 1;
-            case null when y is null:
-                return 0;
-            case null:
-                return -1;
-        }
-
-        var p = x.SortingPriority - y.SortingPriority;
-        return p == 0 ? StringComparer.InvariantCultureIgnoreCase.Compare(x.GroupName, y.GroupName) : p;
-    }
-}

MiraAPI/Cosmetics/CosmeticComparer.cs

@@ -1,38 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-
-namespace MiraAPI.Cosmetics;
-internal sealed class CosmeticComparer(AbstractCosmeticsGroup group) : Comparer<CosmeticData>
-{
-    internal static readonly string[] NoCosmetics = ["hat_NoHat", "skin_None", "nameplate_NoPlate", "visor_EmptyVisor"];
-    public override int Compare(CosmeticData? x, CosmeticData? y)
-    {
-        if (NoCosmetics.Contains(x?.ProdId))
-        {
-            return -1;
-        }
-
-        if (NoCosmetics.Contains(y?.ProdId))
-        {
-            return 1;
-        }
-
-        return group.SortingMode switch
-        {
-            SortingMode.AlphabeticProductId => StringComparer.InvariantCultureIgnoreCase.Compare(x?.ProductId, y?.ProductId),
-            SortingMode.Priority => CustomCosmeticManager.CosmeticToPriority[x!] - CustomCosmeticManager.CosmeticToPriority[y!],
-            SortingMode.AlphabeticStoreName => x switch
-            {
-                HatData h1 when y is HatData h2 => StringComparer.InvariantCultureIgnoreCase.Compare(
-                    h1.StoreName,
-                    h2.StoreName),
-                SkinData s1 when y is SkinData s2 => StringComparer.InvariantCultureIgnoreCase.Compare(
-                    s1.StoreName,
-                    s2.StoreName),
-                _ => StringComparer.InvariantCultureIgnoreCase.Compare(x?.GetItemName(), y?.GetItemName()),
-            },
-            _ => StringComparer.InvariantCultureIgnoreCase.Compare(x?.GetItemName(), y?.GetItemName()),
-        };
-    }
-}

MiraAPI/Cosmetics/CosmeticGroupSingleton.cs

@@ -1,19 +0,0 @@
-using System.Linq;
-
-namespace MiraAPI.Cosmetics;
-
-/// <summary>
-/// Used to get access to a CosmeticGroup.
-/// </summary>
-/// <typeparam name="T">The type.</typeparam>
-public static class CosmeticGroupSingleton<T> where T : AbstractCosmeticsGroup
-{
-    private static T? _instance;
-
-    /// <summary>
-    /// Gets instance of the cosmetic group.
-    /// </summary>
-#pragma warning disable CA1000
-    public static T Instance => _instance ??= CustomCosmeticManager.Groups.OfType<T>().Single();
-#pragma warning restore CA1000
-}

MiraAPI/Cosmetics/CustomCosmeticManager.cs

@@ -1,127 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Reflection;
-using HarmonyLib;
-using MiraAPI.PluginLoading;
-using MonoMod.Utils;
-using Reactor.Utilities;
-
-namespace MiraAPI.Cosmetics;
-public static class CustomCosmeticManager
-{
-    private static readonly Dictionary<PropertyInfo, RegisterCustomCosmeticAttribute> OptionAttributes = [];
-    private static readonly Dictionary<Type, AbstractCosmeticsGroup> TypeToGroup = [];
-    internal static readonly Dictionary<CosmeticData, int> CosmeticToPriority = [];
-    internal static readonly Dictionary<CosmeticData, AbstractCosmeticsGroup> CosmeticToGroup = [];
-
-    internal static readonly List<AbstractCosmeticsGroup> Groups = [];
-
-    internal static void RegisterVanilla()
-    {
-        if (Activator.CreateInstance(typeof(VanillaCosmeticsGroup)) is not AbstractCosmeticsGroup group)
-        {
-            Logger<MiraApiPlugin>.Error($"Failed to create group from Vanilla");
-            return;
-        }
-        if (TypeToGroup.ContainsKey(typeof(VanillaCosmeticsGroup)))
-        {
-            Logger<MiraApiPlugin>.Error($"Vanilla group already exists.");
-            return;
-        }
-
-        Groups.Add(group);
-        TypeToGroup.Add(typeof(VanillaCosmeticsGroup), group);
-    }
-
-    internal static bool RegisterGroup(Type type, MiraPluginInfo pluginInfo)
-    {
-        if (Activator.CreateInstance(type) is not AbstractCosmeticsGroup group)
-        {
-            Logger<MiraApiPlugin>.Error($"Failed to create group from {type.Name}");
-            return false;
-        }
-
-        if (TypeToGroup.ContainsKey(type))
-        {
-            Logger<MiraApiPlugin>.Error($"Group {type.Name} already exists.");
-            return false;
-        }
-
-        Groups.Add(group);
-        TypeToGroup.Add(type, group);
-        pluginInfo.CosmeticGroups.Add(group);
-
-        return true;
-    }
-
-    internal static void RegisterAttributeOption(Type type, RegisterCustomCosmeticAttribute attribute, PropertyInfo property, MiraPluginInfo pluginInfo)
-    {
-        if (OptionAttributes.ContainsKey(property))
-        {
-            Logger<MiraApiPlugin>.Error($"Property {property.Name} already has an attribute registered.");
-            return;
-        }
-
-        if (!TypeToGroup.TryGetValue(type, out var group))
-        {
-            Logger<MiraApiPlugin>.Error($"Failed to get group for {type.Name}");
-            return;
-        }
-
-        OptionAttributes.Add(property, attribute);
-    }
-
-    internal static void LoadCosmetic(PropertyInfo property, RegisterCustomCosmeticAttribute attribute)
-    {
-        if (!TypeToGroup.TryGetValue(property.DeclaringType, out var group))
-        {
-            Logger<MiraApiPlugin>.Error($"Failed to get group for {property.DeclaringType.Name}");
-            return;
-        }
-
-        if (property.PropertyType.IsAssignableTo(typeof(IEnumerable<HatData>)))
-        {
-            group.Hats.AddRange((IEnumerable<HatData>)property.GetValue(group));
-        }
-        else if (property.PropertyType.IsAssignableTo(typeof(IEnumerable<SkinData>)))
-        {
-            group.Skins.AddRange((IEnumerable<SkinData>)property.GetValue(group));
-        }
-        else if (property.PropertyType.IsAssignableTo(typeof(IEnumerable<VisorData>)))
-        {
-            group.Visors.AddRange((IEnumerable<VisorData>)property.GetValue(group));
-        }
-        else if (property.PropertyType.IsAssignableTo(typeof(IEnumerable<NamePlateData>)))
-        {
-            group.Nameplates.AddRange((IEnumerable<NamePlateData>)property.GetValue(group));
-        }
-        else
-        {
-            Logger<MiraApiPlugin>.Error($"Failed to get enumerable for {property.Name}");
-            return;
-        }
-
-        CosmeticToPriority.AddRange(((IEnumerable<CosmeticData>)property.GetValue(group)).ToDictionary(y => y, x => attribute.Priority));
-        CosmeticToGroup.AddRange(((IEnumerable<CosmeticData>)property.GetValue(group)).ToDictionary(y => y, x => group));
-    }
-
-    internal static bool Registered { get; set; }
-    internal static void LoadAll()
-    {
-        CosmeticGroupSingleton<VanillaCosmeticsGroup>.Instance.runtimeRegister();
-        if (Registered || !CosmeticGroupSingleton<VanillaCosmeticsGroup>.Instance.registered)
-        {
-            return;
-        }
-
-        Registered = true;
-        CosmeticToPriority.AddRange(CosmeticGroupSingleton<VanillaCosmeticsGroup>.Instance.Cosmetics.ToDictionary(y => y, x => 0));
-        CosmeticToGroup.AddRange(CosmeticGroupSingleton<VanillaCosmeticsGroup>.Instance.Cosmetics.ToDictionary(y => y, x => CosmeticGroupSingleton<VanillaCosmeticsGroup>.Instance));
-        OptionAttributes.Do(x => LoadCosmetic(x.Key, x.Value));
-        DestroyableSingleton<HatManager>.Instance.allHats = CosmeticToGroup.Keys.OfType<HatData>().ToArray();
-        DestroyableSingleton<HatManager>.Instance.allVisors = CosmeticToGroup.Keys.OfType<VisorData>().ToArray();
-        DestroyableSingleton<HatManager>.Instance.allSkins = CosmeticToGroup.Keys.OfType<SkinData>().ToArray();
-        DestroyableSingleton<HatManager>.Instance.allNamePlates = CosmeticToGroup.Keys.OfType<NamePlateData>().ToArray();
-    }
-}

MiraAPI/Cosmetics/RegisterCustomCosmeticAttribute.cs

@@ -1,9 +0,0 @@
-using System;
-
-namespace MiraAPI.Cosmetics;
-
-[AttributeUsage(AttributeTargets.Property)]
-public class RegisterCustomCosmeticAttribute(int priority = 0) : Attribute
-{
-    public int Priority { get; } = priority;
-}

MiraAPI/Cosmetics/VanillaCosmeticsGroup.cs

@@ -1,40 +0,0 @@
-using System.Collections.Generic;
-
-namespace MiraAPI.Cosmetics;
-public class VanillaCosmeticsGroup : AbstractCosmeticsGroup
-{
-    public override string GroupName => "Vanilla";
-    internal static HatData[] VanillaHats => DestroyableSingleton<HatManager>.Instance.allHats;
-    internal static VisorData[] VanillaVisors => DestroyableSingleton<HatManager>.Instance.allVisors;
-    internal static SkinData[] VanillaSkins => DestroyableSingleton<HatManager>.Instance.allSkins;
-    internal static NamePlateData[] VanillaNameplates => DestroyableSingleton<HatManager>.Instance.allNamePlates;
-
-    internal List<CosmeticData> Cosmetics { get; } = [];
-
-    internal bool registered { get; set; }
-    internal bool runtimeRegister()
-    {
-        if (registered)
-        {
-            return true;
-        }
-
-        if (!DestroyableSingleton<HatManager>.InstanceExists || VanillaHats.Length == 0
-                                                             || VanillaVisors.Length == 0 || VanillaSkins.Length == 0
-                                                             || VanillaNameplates.Length == 0)
-        {
-            return false;
-        }
-
-        registered = true;
-        Hats.AddRange(VanillaHats);
-        Visors.AddRange(VanillaVisors);
-        Skins.AddRange(VanillaSkins);
-        Nameplates.AddRange(VanillaNameplates);
-        Cosmetics.AddRange(Hats);
-        Cosmetics.AddRange(Visors);
-        Cosmetics.AddRange(Skins);
-        Cosmetics.AddRange(Nameplates);
-        return true;
-    }
-}

MiraAPI/GameModes/CustomGameModeManager.cs

@@ -1,7 +1,7 @@
-using System;
+using Reactor.Utilities;
+using System;
 using System.Collections.Generic;
 using System.Linq;
-using Reactor.Utilities;
 
 namespace MiraAPI.GameModes;
 
@@ -21,7 +21,7 @@ public static class CustomGameModeManager
     }
 
     /// <summary>
-    /// Gets current gamemode.
+    /// Current gamemode.
     /// </summary>
     public static CustomGameMode? ActiveMode { get; internal set; } = new DefaultMode();
 
@@ -29,7 +29,7 @@ public static class CustomGameModeManager
     /// Set current gamemode.
     /// </summary>
     /// <param name="id">gamemode ID.</param>
-    internal static void SetGameMode(int id)
+    public static void SetGameMode(int id)
     {
         if (GameModes.TryGetValue(id, out var gameMode))
         {

MiraAPI/GameOptions/Attributes/ModdedEnumOptionAttribute.cs

@@ -1,6 +1,6 @@
-using System;
+using MiraAPI.GameOptions.OptionTypes;
+using System;
 using System.Reflection;
-using MiraAPI.GameOptions.OptionTypes;
 
 namespace MiraAPI.GameOptions.Attributes;
 

MiraAPI/GameOptions/Attributes/ModdedNumberOptionAttribute.cs

@@ -1,7 +1,7 @@
-using System;
-using System.Reflection;
-using MiraAPI.GameOptions.OptionTypes;
+using MiraAPI.GameOptions.OptionTypes;
 using MiraAPI.Utilities;
+using System;
+using System.Reflection;
 
 namespace MiraAPI.GameOptions.Attributes;
 

MiraAPI/GameOptions/Attributes/ModdedToggleOptionAttribute.cs

@@ -1,6 +1,6 @@
-using System;
+using MiraAPI.GameOptions.OptionTypes;
+using System;
 using System.Reflection;
-using MiraAPI.GameOptions.OptionTypes;
 
 namespace MiraAPI.GameOptions.Attributes;
 

MiraAPI/GameOptions/IModdedOption.cs

@@ -6,13 +6,13 @@ using UnityEngine;
 
 namespace MiraAPI.GameOptions;
 
-public interface IModdedOption
+internal interface IModdedOption
 {
     uint Id { get; }
     string Title { get; }
     StringNames StringName { get; }
     IMiraPlugin? ParentMod { get; set; }
-    BaseGameSetting Data { get; }
+    BaseGameSetting? Data { get; }
     Type? AdvancedRole { get; set; }
     OptionBehaviour? OptionBehaviour { get; }
     Func<bool> Visible { get; set; }
@@ -21,5 +21,4 @@ public interface IModdedOption
     float GetFloatData();
     NetData GetNetData();
     void HandleNetData(byte[] data);
-    void ResetToConfig();
 }

MiraAPI/GameOptions/ModdedOptionsManager.cs

@@ -45,10 +45,6 @@ public static class ModdedOptionsManager
         TypeToGroup.Add(type, group);
         pluginInfo.OptionGroups.Add(group);
 
-        typeof(OptionGroupSingleton<>).MakeGenericType(type)
-            .GetField("_instance", BindingFlags.Static | BindingFlags.NonPublic)!
-            .SetValue(null, group);
-
         return true;
     }
 
@@ -142,6 +138,7 @@ public static class ModdedOptionsManager
     {
         // necessary to disable then re-enable this setting
         // we dont know how other plugins handle their configs
+        // this way, all the options are saved at once, instead of one by one
         var oldConfigSetting = new Dictionary<MiraPluginInfo, bool>();
         foreach (var plugin in MiraPluginManager.Instance.RegisteredPlugins())
         {
@@ -161,6 +158,7 @@ public static class ModdedOptionsManager
 
         foreach (var plugin in MiraPluginManager.Instance.RegisteredPlugins())
         {
+            plugin.PluginConfig.Save();
             plugin.PluginConfig.SaveOnConfigSet = oldConfigSetting[plugin];
         }
 

MiraAPI/GameOptions/OptionTypes/ModdedEnumOption.cs

@@ -86,10 +86,7 @@ public class ModdedEnumOption : ModdedOption<int>
     /// <inheritdoc />
     protected override void OnValueChanged(int newValue)
     {
-        if (HudManager.InstanceExists)
-        {
-            HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, Data.GetValueString(newValue), false);
-        }
+        DestroyableSingleton<HudManager>.Instance.Notifier.AddSettingsChangeMessage(StringName, Data?.GetValueString(newValue), false);
         if (!OptionBehaviour)
         {
             return;

MiraAPI/GameOptions/OptionTypes/ModdedNumberOption.cs

@@ -1,7 +1,7 @@
-using System;
-using AmongUs.GameOptions;
+using AmongUs.GameOptions;
 using MiraAPI.Networking;
 using MiraAPI.Utilities;
+using System;
 using UnityEngine;
 using Object = UnityEngine.Object;
 
@@ -134,13 +134,10 @@ public class ModdedNumberOption : ModdedOption<float>
     protected override void OnValueChanged(float newValue)
     {
         Value = Mathf.Clamp(newValue, Min, Max);
-        if (HudManager.InstanceExists)
-        {
-            HudManager.Instance.Notifier.AddSettingsChangeMessage(
-                StringName,
-                Data.GetValueString(Value),
-                false);
-        }
+        DestroyableSingleton<HudManager>.Instance.Notifier.AddSettingsChangeMessage(
+            StringName,
+            Data?.GetValueString(Value),
+            false);
 
         if (OptionBehaviour is NumberOption opt)
         {

MiraAPI/GameOptions/OptionTypes/ModdedOption.cs

@@ -1,10 +1,10 @@
-using System;
-using BepInEx.Configuration;
+using BepInEx.Configuration;
 using MiraAPI.Networking;
 using MiraAPI.PluginLoading;
 using MiraAPI.Roles;
 using Reactor.Localization.Utilities;
 using Reactor.Networking.Rpc;
+using System;
 using UnityEngine;
 
 namespace MiraAPI.GameOptions.OptionTypes;
@@ -35,7 +35,7 @@ public abstract class ModdedOption<T> : IModdedOption
     /// <summary>
     /// Gets the BaseGameSetting data of the option.
     /// </summary>
-    public BaseGameSetting Data { get; protected init; }
+    public BaseGameSetting? Data { get; protected init; }
 
     /// <summary>
     /// Gets or sets the parent mod of the option.
@@ -45,11 +45,7 @@ public abstract class ModdedOption<T> : IModdedOption
         get => _parentMod;
         set
         {
-            if (_parentMod != null || value == null)
-            {
-                return;
-            }
-
+            if (_parentMod != null || value == null) return;
             _parentMod = value;
             var entry = _parentMod.GetConfigFile().Bind(ConfigDefinition, DefaultValue);
             Value = entry.Value;
@@ -89,7 +85,17 @@ public abstract class ModdedOption<T> : IModdedOption
     /// <summary>
     /// Gets or sets the config definition of the option.
     /// </summary>
-    public ConfigDefinition? ConfigDefinition { get; set; }
+    public ConfigDefinition? ConfigDefinition
+    {
+        get => _configDefinition;
+        set
+        {
+            if (_configDefinition is not null) return;
+            _configDefinition = value;
+        }
+    }
+
+    private ConfigDefinition? _configDefinition;
 
     /// <summary>
     /// Initializes a new instance of the <see cref="ModdedOption{T}"/> class.
@@ -162,14 +168,6 @@ public abstract class ModdedOption<T> : IModdedOption
     /// <param name="data">The NetData's byte array.</param>
     public abstract void HandleNetData(byte[] data);
 
-    public void ResetToConfig()
-    {
-        if (ParentMod?.GetConfigFile().TryGetEntry<T>(ConfigDefinition, out var entry) == true)
-        {
-            SetValue(entry.Value);
-        }
-    }
-
     /// <summary>
     /// Handles the value changed event.
     /// </summary>

MiraAPI/GameOptions/OptionTypes/ModdedToggleOption.cs

@@ -1,5 +1,5 @@
-using System;
-using MiraAPI.Networking;
+using MiraAPI.Networking;
+using System;
 using UnityEngine;
 using Object = UnityEngine.Object;
 
@@ -69,10 +69,7 @@ public class ModdedToggleOption : ModdedOption<bool>
     /// <inheritdoc />
     protected override void OnValueChanged(bool newValue)
     {
-        if (HudManager.InstanceExists)
-        {
-            HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, newValue ? "On" : "Off", false);
-        }
+        DestroyableSingleton<HudManager>.Instance.Notifier.AddSettingsChangeMessage(StringName, newValue ? "On" : "Off", false);
         if (!OptionBehaviour)
         {
             return;

MiraAPI/Hud/CustomActionButton.cs

@@ -167,7 +167,6 @@ public abstract class CustomActionButton
     public void SetUses(int amount)
     {
         UsesLeft = Mathf.Clamp(amount, 0, int.MaxValue);
-        Button?.SetUsesRemaining(MaxUses);
     }
 
     /// <summary>
@@ -328,7 +327,7 @@ public abstract class CustomActionButton<T> : CustomActionButton where T : MonoB
     /// <returns>True if the target object is valid, false otherwise.</returns>
     public virtual bool IsTargetValid(T? target)
     {
-        return target != null;
+        return target;
     }
 
     /// <summary>
@@ -355,6 +354,6 @@ public abstract class CustomActionButton<T> : CustomActionButton where T : MonoB
         Target = IsTargetValid(newTarget) ? newTarget : null;
         SetOutline(true);
 
-        return base.CanUse() && Target != null;
+        return base.CanUse() && Target;
     }
 }

MiraAPI/Hud/CustomButtonManager.cs

@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Reflection;
-using MiraAPI.PluginLoading;
 using Reactor.Utilities;
 
 namespace MiraAPI.Hud;
@@ -10,7 +9,7 @@ internal static class CustomButtonManager
 {
     internal static readonly List<CustomActionButton> CustomButtons = [];
 
-    internal static void RegisterButton(Type buttonType, MiraPluginInfo pluginInfo)
+    internal static void RegisterButton(Type buttonType)
     {
         if (!typeof(CustomActionButton).IsAssignableFrom(buttonType))
         {
@@ -25,7 +24,6 @@ internal static class CustomButtonManager
         }
 
         CustomButtons.Add(button);
-        pluginInfo.Buttons.Add(button);
         typeof(CustomButtonSingleton<>).MakeGenericType(buttonType)
             .GetField("_instance", BindingFlags.Static | BindingFlags.NonPublic)!
             .SetValue(null, button);

MiraAPI/Hud/CustomPlayerMenu.cs

@@ -1,111 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.GameOptions;
-using MiraAPI.Patches.Stubs;
-using Reactor.Utilities.Attributes;
-using Reactor.Utilities.Extensions;
-using UnityEngine;
-using UnityEngine.Events;
-
-namespace MiraAPI.Hud;
-
-/// <summary>
-/// Custom Player Menu using the ShapeshifterPanel as a base.
-/// </summary>
-/// <param name="il2CppPtr">Used by Il2Cpp. Do not use constructor, this is a MonoBehaviour.</param>
-[RegisterInIl2Cpp]
-public class CustomPlayerMenu(IntPtr il2CppPtr) : Minigame(il2CppPtr)
-{
-    public ShapeshifterPanel PanelPrefab;
-
-    public float XStart = -0.8f;
-
-    public float YStart = 2.15f;
-
-    public float XOffset = 1.95f;
-
-    public float YOffset = -0.65f;
-
-    public UiElement BackButton;
-
-    public UiElement DefaultButtonSelected;
-
-    public List<ShapeshifterPanel> potentialVictims;
-
-    /// <summary>
-    /// Creates a CustomPlayerMenu.
-    /// </summary>
-    /// <returns>New CustomPlayerMenu object.</returns>
-    public static CustomPlayerMenu Create()
-    {
-        var shapeShifterRole = RoleManager.Instance.GetRole(RoleTypes.Shapeshifter);
-
-        var ogMenu = shapeShifterRole.TryCast<ShapeshifterRole>().ShapeshifterMenu;
-        var newMenu = Instantiate(ogMenu);
-        var customMenu = newMenu.gameObject.AddComponent<CustomPlayerMenu>();
-
-        customMenu.PanelPrefab = newMenu.PanelPrefab;
-        customMenu.XStart = newMenu.XStart;
-        customMenu.YStart = newMenu.YStart;
-        customMenu.XOffset = newMenu.XOffset;
-        customMenu.YOffset = newMenu.YOffset;
-        customMenu.BackButton = newMenu.BackButton;
-        var back = customMenu.BackButton.GetComponent<PassiveButton>();
-        back.OnClick.RemoveAllListeners();
-        back.OnClick.AddListener((UnityAction)(() =>
-        {
-            Instance.Close();
-        }));
-
-        customMenu.CloseSound = newMenu.CloseSound;
-        customMenu.logger = newMenu.logger;
-        customMenu.OpenSound = newMenu.OpenSound;
-
-        newMenu.DestroyImmediate();
-
-        customMenu.transform.SetParent(Camera.main.transform, false);
-        customMenu.transform.localPosition = new Vector3(0f, 0f, -50f);
-        return customMenu;
-    }
-
-    private void OnDisable()
-    {
-        ControllerManager.Instance.CloseOverlayMenu(name);
-    }
-
-    public override void Begin(PlayerTask task)
-    {
-        throw new NotImplementedException("Use the other Begin method.");
-    }
-
-    /// <summary>
-    /// Begins/opens the custom player menu.
-    /// </summary>
-    /// <param name="playerMatch">Function to determine if player should show in the custom menu.</param>
-    /// <param name="onClick">Onclick action for player.</param>
-    public void Begin(Func<PlayerControl, bool> playerMatch, Action<PlayerControl> onClick)
-    {
-        MinigameStubs.Begin(this, null);
-
-        DestroyableSingleton<DebugAnalytics>.Instance.Analytics.MinigameOpened(PlayerControl.LocalPlayer.Data, TaskType);
-        var list = PlayerControl.AllPlayerControls.ToArray().Where(playerMatch).ToList();
-        potentialVictims = [];
-        var list2 = new Il2CppSystem.Collections.Generic.List<UiElement>();
-
-        for (var i = 0; i < list.Count; i++)
-        {
-            var player = list[i];
-            var num = i % 3;
-            var num2 = i / 3;
-            var flag = PlayerControl.LocalPlayer.Data.Role.NameColor == player.Data.Role.NameColor;
-            var shapeshifterPanel = Instantiate(PanelPrefab, transform);
-            shapeshifterPanel.transform.localPosition = new Vector3(XStart + num * XOffset, YStart + num2 * YOffset, -1f);
-            shapeshifterPanel.SetPlayer(i, player.Data, (Il2CppSystem.Action)(() => { onClick(player); }));
-            shapeshifterPanel.NameText.color = flag ? player.Data.Role.NameColor : Color.white;
-            potentialVictims.Add(shapeshifterPanel);
-            list2.Add(shapeshifterPanel.Button);
-        }
-        ControllerManager.Instance.OpenOverlayMenu(name, BackButton, DefaultButtonSelected, list2);
-    }
-}

MiraAPI/MiraAPI.csproj

@@ -10,10 +10,11 @@
     <ItemGroup>
         <None Include="..\README.md" Pack="true" PackagePath="\" />
     </ItemGroup>
-
+    
     <ItemGroup>
         <EmbeddedResource Include="Resources\**\*.*" />
     </ItemGroup>
+
+    <Import Project="../AmongUs.props" />   
     
-    <Import Project="../AmongUs.props" />
 </Project>

MiraAPI/Modifiers/BaseModifier.cs

@@ -75,6 +75,6 @@ public abstract class BaseModifier
     /// <summary>
     /// Determines whether the player can vent.
     /// </summary>
-    /// <returns>True if the player can vent, false otherwise. Null for no effect.</returns>
-    public virtual bool? CanVent() => null;
+    /// <returns>True if the player can vent, false otherwise.</returns>
+    public virtual bool CanVent() => Player?.Data.Role.CanVent == true;
 }

MiraAPI/Modifiers/ModifierComponent.cs

@@ -1,14 +1,14 @@
-using Il2CppInterop.Runtime.Attributes;
-using MiraAPI.Modifiers.Types;
-using MiraAPI.Utilities;
-using Reactor.Utilities;
-using Reactor.Utilities.Attributes;
-using System;
+using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Globalization;
 using System.Linq;
 using System.Text;
+using Il2CppInterop.Runtime.Attributes;
+using MiraAPI.Modifiers.Types;
+using MiraAPI.Utilities;
+using Reactor.Utilities;
+using Reactor.Utilities.Attributes;
 using TMPro;
 using UnityEngine;
 
@@ -39,6 +39,11 @@ public class ModifierComponent(IntPtr cppPtr) : MonoBehaviour(cppPtr)
 
     internal void ClearModifiers()
     {
+        foreach (var modifier in Modifiers)
+        {
+            modifier.OnDeactivate();
+        }
+
         _toRemove.AddRange(Modifiers);
     }
 
@@ -69,7 +74,7 @@ public class ModifierComponent(IntPtr cppPtr) : MonoBehaviour(cppPtr)
             Modifiers.Add(modifier);
             modifier.OnActivate();
 
-            if (modifier is TimedModifier { AutoStart: true } timer)
+            if (_player?.AmOwner == true && modifier is TimedModifier { AutoStart: true } timer)
             {
                 timer.StartTimer();
             }
@@ -79,7 +84,7 @@ public class ModifierComponent(IntPtr cppPtr) : MonoBehaviour(cppPtr)
         {
             if (_player?.AmOwner == true)
             {
-                HudManager.Instance?.SetHudActive(HudManager.Instance.TaskPanel.isActiveAndEnabled);
+                HudManager.Instance?.SetHudActive(true);
             }
             _toAdd.Clear();
             _toRemove.Clear();
@@ -107,10 +112,6 @@ public class ModifierComponent(IntPtr cppPtr) : MonoBehaviour(cppPtr)
 
         var baseModifiers = filteredModifiers as BaseModifier[] ?? filteredModifiers.ToArray();
 
-        var inMeeting = MeetingHud.Instance != null;
-
-        _modifierText!.gameObject.SetActive(!inMeeting);
-
         if (baseModifiers.Length != 0)
         {
             var stringBuild = new StringBuilder();

MiraAPI/Modifiers/Types/GameModifier.cs

@@ -23,10 +23,4 @@ public abstract class GameModifier : BaseModifier
     /// <param name="role">The role to be checked.</param>
     /// <returns>True if the modifier is valid on the role, otherwise false.</returns>
     public virtual bool IsModifierValidOn(RoleBehaviour role) => true;
-
-    /// <summary>
-    /// Determines whether the player won the game with this modifier.
-    /// </summary>
-    /// <returns>True if the player won, false if they lost. Return null to use the player's default win condition.</returns>
-    public virtual bool? DidWin(GameOverReason reason) => null;
 }

MiraAPI/Modifiers/Types/TimedModifier.cs

@@ -39,9 +39,6 @@ public abstract class TimedModifier : BaseModifier
     /// </summary>
     public float TimeRemaining { get; protected set; }
 
-    /// <inheritdoc />
-    public override bool HideOnUi => !TimerActive;
-
     /// <summary>
     /// Gets the HUD information for Timed Modifier, including the time remaining.
     /// </summary>
@@ -56,18 +53,25 @@ public abstract class TimedModifier : BaseModifier
     /// </summary>
     public override void FixedUpdate()
     {
-        if (!TimerActive)
+        if (Player?.AmOwner == false)
         {
             return;
         }
 
-        if (TimeRemaining > 0)
+        if (TimeRemaining > 0 && TimerActive)
         {
             TimeRemaining -= Time.fixedDeltaTime;
         }
         else
         {
-            StopTimer();
+            TimerActive = false;
+            TimeRemaining = Duration;
+            OnTimerComplete();
+
+            if (RemoveOnComplete)
+            {
+                ModifierComponent?.RemoveModifier(ModifierId);
+            }
         }
     }
 
@@ -82,52 +86,7 @@ public abstract class TimedModifier : BaseModifier
             return;
         }
 
-        TimeRemaining = Duration;
         TimerActive = true;
-    }
-
-    /// <summary>
-    /// Stops the timer and calls OnTimerComplete().
-    /// </summary>
-    public void StopTimer()
-    {
-        if (!TimerActive)
-        {
-            return;
-        }
-
-        TimerActive = false;
         TimeRemaining = Duration;
-        OnTimerComplete();
-
-        if (RemoveOnComplete)
-        {
-            ModifierComponent?.RemoveModifier(ModifierId);
-        }
-    }
-
-    /// <summary>
-    /// Resets the timer. Does not call OnTimerComplete().
-    /// </summary>
-    public void ResetTimer()
-    {
-        TimerActive = false;
-        TimeRemaining = Duration;
-    }
-
-    /// <summary>
-    /// Pauses the timer.
-    /// </summary>
-    public void PauseTimer()
-    {
-        TimerActive = false;
-    }
-
-    /// <summary>
-    /// Pauses the timer.
-    /// </summary>
-    public void ResumeTimer()
-    {
-        TimerActive = true;
     }
 }

MiraAPI/Networking/CustomMurderRpc.cs

@@ -4,7 +4,6 @@ using AmongUs.GameOptions;
 using Assets.CoreScripts;
 using BepInEx.Unity.IL2CPP.Utils;
 using Reactor.Networking.Attributes;
-using Reactor.Networking.Rpc;
 using Reactor.Utilities;
 using Reactor.Utilities.Extensions;
 using UnityEngine;
@@ -27,7 +26,7 @@ public static class CustomMurderRpc
     /// <param name="teleportMurderer">Should the killer be snapped to the dead player.</param>
     /// <param name="showKillAnim">Should the kill animation be shown.</param>
     /// <param name="playKillSound">Should the kill sound be played.</param>
-    [MethodRpc((uint)MiraRpc.CustomMurder, LocalHandling = RpcLocalHandling.Before, SendImmediately = true)]
+    [MethodRpc((uint)MiraRpc.CustomMurder)]
     public static void RpcCustomMurder(
         this PlayerControl source,
         PlayerControl target,
@@ -88,7 +87,7 @@ public static class CustomMurderRpc
             if (flag && PlayerControl.LocalPlayer.Data.PlayerId == target.protectedByGuardianId)
             {
                 StatsManager.Instance.IncrementStat(StringNames.StatsGuardianAngelCrewmatesProtected);
-                AchievementManager.Instance.OnProtectACrewmate();
+                DestroyableSingleton<AchievementManager>.Instance.OnProtectACrewmate();
             }
 
             if (source.AmOwner || flag)
@@ -116,7 +115,7 @@ public static class CustomMurderRpc
             return;
         }
 
-        DebugAnalytics.Instance.Analytics.Kill(target.Data, source.Data);
+        DestroyableSingleton<DebugAnalytics>.Instance.Analytics.Kill(target.Data, source.Data);
         if (source.AmOwner)
         {
             StatsManager.Instance.IncrementStat(
@@ -140,7 +139,7 @@ public static class CustomMurderRpc
             }
         }
 
-        UnityTelemetry.Instance.WriteMurder();
+        DestroyableSingleton<UnityTelemetry>.Instance.WriteMurder();
         target.gameObject.layer = LayerMask.NameToLayer("Ghost");
         if (target.AmOwner)
         {
@@ -160,14 +159,14 @@ public static class CustomMurderRpc
 
             if (showKillAnim)
             {
-                HudManager.Instance.KillOverlay.ShowKillAnimation(source.Data, data);
+                DestroyableSingleton<HudManager>.Instance.KillOverlay.ShowKillAnimation(source.Data, data);
             }
 
             target.cosmetics.SetNameMask(false);
             target.RpcSetScanner(false);
         }
 
-        AchievementManager.Instance.OnMurder(
+        DestroyableSingleton<AchievementManager>.Instance.OnMurder(
             source.AmOwner,
             target.AmOwner,
             source.CurrentOutfitType == PlayerOutfitType.Shapeshifted,

MiraAPI/Networking/MiraRpc.cs

@@ -34,4 +34,9 @@ public enum MiraRpc : uint
     /// Custom Murder RPC.
     /// </summary>
     CustomMurder,
+
+    /// <summary>
+    /// Trigger Animation using CustomAnimator.
+    /// </summary>
+    TriggerAnimation,
 }

MiraAPI/Patches/Colors/ScrollingColorsPatch.cs

@@ -11,7 +11,7 @@ public static class ScrollingColorsPatch
     private static BoxCollider2D? _collider;
 
     /// <summary>
-    /// Add scrolling to the colors tab.
+    /// Add scrolling to the colors tab
     /// </summary>
     [HarmonyPostfix, HarmonyPatch("OnEnable")]
     public static void AddScrollingToColorsTabPatch(PlayerTab __instance)

MiraAPI/Patches/Cosmetics/HatsTabPatch.cs

@@ -1,76 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.Data;
-using HarmonyLib;
-using MiraAPI.Cosmetics;
-using MonoMod.Utils;
-using Reactor.Utilities.Extensions;
-using TMPro;
-using UnityEngine;
-
-namespace MiraAPI.Patches.Cosmetics;
-
-[HarmonyPatch(typeof(HatsTab), nameof(HatsTab.OnEnable))]
-public static class HatsTabPatch
-{
-    public static bool Prefix(HatsTab __instance)
-    {
-        var hatGroups = new SortedList<AbstractCosmeticsGroup, List<HatData>>(
-            new AbstractCosmeticsGroupComparer()
-        );
-        CustomCosmeticManager.Groups.Do(x => x.Hats.Sort(new CosmeticComparer(x)));
-        var c = CustomCosmeticManager.Groups.Select(x => new KeyValuePair<AbstractCosmeticsGroup, List<HatData>>(x, x.Hats)).
-            ToDictionary(x => x.Key, x => x.Value.Where(x=>x.Free || DataManager.Player.Purchases.GetPurchase(x.ProductId, x.BundleId)).ToList());
-        hatGroups.AddRange<AbstractCosmeticsGroup, List<HatData>>(c);
-
-        foreach (var colorchip in __instance.ColorChips) colorchip.gameObject.Destroy();
-        __instance.ColorChips.Clear();
-        var groupNameText = __instance.GetComponentInChildren<TextMeshPro>(false);
-        var hatIdx = 0;
-
-        __instance.currentHat = DestroyableSingleton<HatManager>.Instance.GetHatById(DataManager.Player.Customization.Hat);
-
-        foreach (var (group, hats) in hatGroups.Where(x=>x.Key.GroupVisible() && x.Key.Hats.Count > 0))
-        {
-            var text = UnityEngine.Object.Instantiate(groupNameText, __instance.scroller.Inner);
-            text.gameObject.transform.localScale = Vector3.one;
-            text.GetComponent<TextTranslatorTMP>().Destroy();
-            text.text = group.GroupName;
-            text.alignment = TextAlignmentOptions.Center;
-            text.fontSize = 3f;
-            text.fontSizeMax = 3f;
-            text.fontSizeMin = 0f;
-
-            hatIdx = (hatIdx + 4) / 5 * 5;
-
-            var xLerp = __instance.XRange.Lerp(0.5f);
-            var yLerp = __instance.YStart - (hatIdx / __instance.NumPerRow) * __instance.YOffset;
-            text.transform.localPosition = new Vector3(xLerp, yLerp, -1f);
-            hatIdx += 5;
-
-            foreach (var hat in hats)
-            {
-                var num = __instance.XRange.Lerp(hatIdx % __instance.NumPerRow / (__instance.NumPerRow - 1f));
-                var num2 = __instance.YStart - hatIdx / __instance.NumPerRow * __instance.YOffset;
-                var colorChip = UnityEngine.Object.Instantiate(__instance.ColorTabPrefab, __instance.scroller.Inner);
-                colorChip.transform.localPosition = new Vector3(num, num2, -1f);
-                colorChip.Button.OnClick.AddListener((Action)(() => __instance.SelectHat(hat)));
-                colorChip.Button.ClickMask = __instance.scroller.Hitbox;
-                colorChip.Inner.SetMaskType(PlayerMaterial.MaskType.SimpleUI);
-                __instance.UpdateMaterials(colorChip.Inner.FrontLayer, hat);
-                colorChip.Inner.SetHat(hat, __instance.HasLocalPlayer() ? PlayerControl.LocalPlayer.Data.DefaultOutfit.ColorId : DataManager.Player.Customization.Color);
-                colorChip.Inner.transform.localPosition = hat.ChipOffset + new Vector2(0f, -0.3f);
-                colorChip.Tag = hat;
-                colorChip.SelectionHighlight.gameObject.SetActive(false);
-                __instance.ColorChips.Add(colorChip);
-                hatIdx += 1;
-            }
-        }
-
-        __instance.scroller.ContentYBounds.max = -(__instance.YStart - (hatIdx + 1) / __instance.NumPerRow * __instance.YOffset) - 3f;
-        __instance.currentHatIsEquipped = true;
-
-        return false;
-    }
-}

MiraAPI/Patches/Cosmetics/InventoryManagerPatch.cs

@@ -1,13 +0,0 @@
-using HarmonyLib;
-using MiraAPI.Cosmetics;
-
-namespace MiraAPI.Patches.Cosmetics;
-
-[HarmonyPatch(typeof(InventoryManager), nameof(InventoryManager.CheckUnlockedItems))]
-public static class InventoryManagerPatch
-{
-    public static void Prefix()
-    {
-        CustomCosmeticManager.LoadAll();
-    }
-}

MiraAPI/Patches/Cosmetics/NameplatesTabPatch.cs

@@ -1,91 +0,0 @@
-using System;
-using System.Collections;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.Data;
-using HarmonyLib;
-using MiraAPI.Cosmetics;
-using MiraAPI.Utilities.Assets.Addressable;
-using MonoMod.Utils;
-using Reactor.Utilities;
-using Reactor.Utilities.Extensions;
-using TMPro;
-using UnityEngine;
-using UnityEngine.AddressableAssets;
-using UnityEngine.ResourceManagement.AsyncOperations;
-
-namespace MiraAPI.Patches.Cosmetics;
-[HarmonyPatch(typeof(NameplatesTab), nameof(NameplatesTab.OnEnable))]
-public static class NameplatesTabPatch
-{
-    public static bool Prefix(NameplatesTab __instance)
-    {
-        var groups = new SortedList<AbstractCosmeticsGroup, List<NamePlateData>>(
-            new AbstractCosmeticsGroupComparer()
-        );
-        CustomCosmeticManager.Groups.Do(x => x.Nameplates.Sort(new CosmeticComparer(x)));
-        var c = CustomCosmeticManager.Groups.Select(x => new KeyValuePair<AbstractCosmeticsGroup, List<NamePlateData>>(x, x.Nameplates)).
-            ToDictionary(x => x.Key, x => x.Value.Where(x => x.Free || DataManager.Player.Purchases.GetPurchase(x.ProductId, x.BundleId)).ToList());
-        groups.AddRange<AbstractCosmeticsGroup, List<NamePlateData>>(c);
-        Logger<MiraApiPlugin>.Info($"{c.Count}");
-
-        foreach (var colorchip in __instance.ColorChips) colorchip.gameObject.Destroy();
-        __instance.ColorChips.Clear();
-        var groupNameText = __instance.GetComponentInChildren<TextMeshPro>(false);
-        var hatIdx = 0;
-
-        __instance.PlayerPreview.gameObject.SetActive(false);
-        __instance.StartCoroutine(__instance.CoLoadNameplatePreview());
-
-        foreach (var (group, hats) in groups.Where(x => x.Key.GroupVisible() && x.Key.Nameplates.Count > 0))
-        {
-            var text = UnityEngine.Object.Instantiate(groupNameText, __instance.scroller.Inner);
-            text.gameObject.transform.localScale = Vector3.one;
-            text.GetComponent<TextTranslatorTMP>().Destroy();
-            text.text = group.GroupName;
-            text.alignment = TextAlignmentOptions.Center;
-            text.fontSize = 3f;
-            text.fontSizeMax = 3f;
-            text.fontSizeMin = 0f;
-
-            hatIdx = (hatIdx + 1) / 2 * 2;
-
-            var xLerp = __instance.XRange.Lerp(0.5f);
-            var yLerp = __instance.YStart - (hatIdx / __instance.NumPerRow) * __instance.YOffset;
-            text.transform.localPosition = new Vector3(xLerp, yLerp, -1f);
-            hatIdx += 2;
-
-            foreach (var hat in hats)
-            {
-                var num = __instance.XRange.Lerp(hatIdx % __instance.NumPerRow / (__instance.NumPerRow - 1f));
-                var num2 = __instance.YStart - hatIdx / __instance.NumPerRow * __instance.YOffset;
-
-                var colorChip = UnityEngine.Object.Instantiate(__instance.ColorTabPrefab, __instance.scroller.Inner);
-                colorChip.transform.localPosition = new Vector3(num, num2, -1f);
-
-                colorChip.Button.OnClick.AddListener((Action)(() => __instance.SelectNameplate(hat)));
-                colorChip.Button.ClickMask = __instance.scroller.Hitbox;
-
-                colorChip.ProductId = hat.ProductId;
-
-                var handle = Addressables.LoadAssetAsync<NamePlateViewData>(hat.ViewDataRef);
-                Coroutines.Start(SetupColorChip(colorChip.TryCast<NameplateChip>(), handle));
-                __instance.ColorChips.Add(colorChip);
-                hatIdx += 1;
-            }
-        }
-
-        __instance.GetDefaultSelectable().PlayerEquippedForeground.SetActive(true);
-        __instance.plateId = DataManager.Player.Customization.NamePlate;
-        __instance.scroller.ContentYBounds.max = -(__instance.YStart - (hatIdx + 1) / __instance.NumPerRow * __instance.YOffset) - 3f;
-        __instance.currentNameplateIsEquipped = true;
-
-        return false;
-    }
-
-    private static IEnumerator SetupColorChip(NameplateChip colorChip, AsyncOperationHandle<NamePlateViewData> handle)
-    {
-        yield return new WaitForAsyncOperationHandleFinish(handle);
-        colorChip.image.sprite = handle.Result?.Image;
-    }
-}

MiraAPI/Patches/Cosmetics/SkinsTabPatch.cs

@@ -1,86 +0,0 @@
-using System;
-using System.Collections;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.Data;
-using HarmonyLib;
-using MiraAPI.Cosmetics;
-using MiraAPI.Utilities.Assets.Addressable;
-using MonoMod.Utils;
-using Reactor.Utilities;
-using Reactor.Utilities.Extensions;
-using TMPro;
-using UnityEngine;
-using UnityEngine.AddressableAssets;
-using UnityEngine.ResourceManagement.AsyncOperations;
-
-namespace MiraAPI.Patches.Cosmetics;
-[HarmonyPatch(typeof(SkinsTab), nameof(SkinsTab.OnEnable))]
-public static class SkinsTabPatch
-{
-    public static bool Prefix(SkinsTab __instance)
-    {
-        var groups = new SortedList<AbstractCosmeticsGroup, List<SkinData>>(
-            new AbstractCosmeticsGroupComparer()
-        );
-        CustomCosmeticManager.Groups.Do(x => x.Skins.Sort(new CosmeticComparer(x)));
-        var c = CustomCosmeticManager.Groups.Select(x => new KeyValuePair<AbstractCosmeticsGroup, List<SkinData>>(x, x.Skins)).
-            ToDictionary(x => x.Key, x => x.Value.Where(x => x.Free || DataManager.Player.Purchases.GetPurchase(x.ProductId, x.BundleId)).ToList());
-        groups.AddRange<AbstractCosmeticsGroup, List<SkinData>>(c);
-
-        foreach (var colorchip in __instance.ColorChips) colorchip.gameObject.Destroy();
-        __instance.ColorChips.Clear();
-        var groupNameText = __instance.GetComponentInChildren<TextMeshPro>(false);
-        var hatIdx = 0;
-
-        foreach (var (group, skins) in groups.Where(x => x.Key.GroupVisible() && x.Key.Skins.Count > 0))
-        {
-            var text = UnityEngine.Object.Instantiate(groupNameText, __instance.scroller.Inner);
-            text.gameObject.transform.localScale = Vector3.one;
-            text.GetComponent<TextTranslatorTMP>().Destroy();
-            text.text = group.GroupName;
-            text.alignment = TextAlignmentOptions.Center;
-            text.fontSize = 3f;
-            text.fontSizeMax = 3f;
-            text.fontSizeMin = 0f;
-
-            hatIdx = (hatIdx + 4) / 5 * 5;
-
-            var xLerp = __instance.XRange.Lerp(0.5f);
-            var yLerp = __instance.YStart - (hatIdx / __instance.NumPerRow) * __instance.YOffset;
-            text.transform.localPosition = new Vector3(xLerp, yLerp, -1f);
-            hatIdx += 5;
-
-            foreach (var skin in skins)
-            {
-                var num = __instance.XRange.Lerp(hatIdx % __instance.NumPerRow / (__instance.NumPerRow - 1f));
-                var num2 = __instance.YStart - hatIdx / __instance.NumPerRow * __instance.YOffset;
-                var colorChip = UnityEngine.Object.Instantiate(__instance.ColorTabPrefab, __instance.scroller.Inner);
-                colorChip.transform.localPosition = new Vector3(num, num2, -1f);
-                colorChip.Button.OnClick.AddListener((Action)(() => __instance.SelectSkin(skin)));
-                colorChip.Button.ClickMask = __instance.scroller.Hitbox;
-                colorChip.ProductId = skin.ProductId;
-                __instance.UpdateMaterials(colorChip.Inner.FrontLayer, skin);
-
-                var handle = Addressables.LoadAssetAsync<SkinViewData>(skin.ViewDataRef);
-                Coroutines.Start(SetupColorChip(handle, __instance.HasLocalPlayer() ? PlayerControl.LocalPlayer.Data.DefaultOutfit.ColorId : DataManager.Player.Customization.Color, colorChip));
-                colorChip.SelectionHighlight.gameObject.SetActive(false);
-                __instance.ColorChips.Add(colorChip);
-                hatIdx += 1;
-            }
-        }
-
-        __instance.skinId = DataManager.Player.Customization.Skin;
-        __instance.currentSkinIsEquipped = true;
-        __instance.scroller.ContentYBounds.max = -(__instance.YStart - (hatIdx + 1) / __instance.NumPerRow * __instance.YOffset) - 3f;
-
-        return false;
-    }
-
-    internal static IEnumerator SetupColorChip(AsyncOperationHandle<SkinViewData> handle, int colorId, ColorChip colorChip)
-    {
-        yield return new WaitForAsyncOperationHandleFinish(handle);
-        colorChip.Inner.FrontLayer.sprite = handle.Result?.IdleFrame;
-        PlayerMaterial.SetColors(colorId, colorChip.Inner.FrontLayer);
-    }
-}

MiraAPI/Patches/Cosmetics/VisorsTabPatch.cs

@@ -1,86 +0,0 @@
-using System;
-using System.Collections;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.Data;
-using HarmonyLib;
-using MiraAPI.Cosmetics;
-using MiraAPI.Utilities.Assets.Addressable;
-using MonoMod.Utils;
-using Reactor.Utilities;
-using Reactor.Utilities.Extensions;
-using TMPro;
-using UnityEngine;
-using UnityEngine.AddressableAssets;
-using UnityEngine.ResourceManagement.AsyncOperations;
-
-namespace MiraAPI.Patches.Cosmetics;
-[HarmonyPatch(typeof(VisorsTab), nameof(VisorsTab.OnEnable))]
-public static class VisorsTabPatch
-{
-    public static bool Prefix(VisorsTab __instance)
-    {
-        var groups = new SortedList<AbstractCosmeticsGroup, List<VisorData>>(
-            new AbstractCosmeticsGroupComparer()
-        );
-        CustomCosmeticManager.Groups.Do(x => x.Visors.Sort(new CosmeticComparer(x)));
-        var c = CustomCosmeticManager.Groups.Select(x => new KeyValuePair<AbstractCosmeticsGroup, List<VisorData>>(x, x.Visors)).
-            ToDictionary(x => x.Key, x => x.Value.Where(x => x.Free || DataManager.Player.Purchases.GetPurchase(x.ProductId, x.BundleId)).ToList());
-        groups.AddRange<AbstractCosmeticsGroup, List<VisorData>>(c);
-
-        foreach (var colorchip in __instance.ColorChips) colorchip.gameObject.Destroy();
-        __instance.ColorChips.Clear();
-        var groupNameText = __instance.GetComponentInChildren<TextMeshPro>(false);
-        var hatIdx = 0;
-
-        foreach (var (group, visors) in groups.Where(x => x.Key.GroupVisible() && x.Key.Visors.Count > 0))
-        {
-            var text = UnityEngine.Object.Instantiate(groupNameText, __instance.scroller.Inner);
-            text.gameObject.transform.localScale = Vector3.one;
-            text.GetComponent<TextTranslatorTMP>().Destroy();
-            text.text = group.GroupName;
-            text.alignment = TextAlignmentOptions.Center;
-            text.fontSize = 3f;
-            text.fontSizeMax = 3f;
-            text.fontSizeMin = 0f;
-
-            hatIdx = (hatIdx + 4) / 5 * 5;
-
-            var xLerp = __instance.XRange.Lerp(0.5f);
-            var yLerp = __instance.YStart - (hatIdx / __instance.NumPerRow) * __instance.YOffset;
-            text.transform.localPosition = new Vector3(xLerp, yLerp, -1f);
-            hatIdx += 5;
-
-            foreach (var visor in visors)
-            {
-                var num = __instance.XRange.Lerp(hatIdx % __instance.NumPerRow / (__instance.NumPerRow - 1f));
-                var num2 = __instance.YStart - hatIdx / __instance.NumPerRow * __instance.YOffset;
-                var colorChip = UnityEngine.Object.Instantiate(__instance.ColorTabPrefab, __instance.scroller.Inner);
-                colorChip.transform.localPosition = new Vector3(num, num2, -1f);
-                colorChip.Button.OnClick.AddListener((Action)(() => __instance.SelectVisor(visor)));
-                colorChip.Button.ClickMask = __instance.scroller.Hitbox;
-                colorChip.ProductId = visor.ProductId;
-                __instance.UpdateMaterials(colorChip.Inner.FrontLayer, visor);
-
-                var handle = Addressables.LoadAssetAsync<VisorViewData>(visor.ViewDataRef);
-                Coroutines.Start(SetupColorChip(handle, __instance.HasLocalPlayer() ? PlayerControl.LocalPlayer.Data.DefaultOutfit.ColorId : DataManager.Player.Customization.Color, colorChip));
-                colorChip.SelectionHighlight.gameObject.SetActive(false);
-                __instance.ColorChips.Add(colorChip);
-                hatIdx += 1;
-            }
-        }
-
-        __instance.visorId = DataManager.Player.Customization.Visor;
-        __instance.currentVisorIsEquipped = true;
-        __instance.scroller.ContentYBounds.max = -(__instance.YStart - (hatIdx + 1) / __instance.NumPerRow * __instance.YOffset) - 3f;
-
-        return false;
-    }
-
-    internal static IEnumerator SetupColorChip(AsyncOperationHandle<VisorViewData> handle, int colorId, ColorChip colorChip)
-    {
-        yield return new WaitForAsyncOperationHandleFinish(handle);
-        colorChip.Inner.FrontLayer.sprite = handle.Result?.IdleFrame;
-        PlayerMaterial.SetColors(colorId, colorChip.Inner.FrontLayer);
-    }
-}

MiraAPI/Patches/Hud/ButtonResetPatches.cs

@@ -4,7 +4,7 @@ using MiraAPI.Hud;
 namespace MiraAPI.Patches.Hud;
 
 /// <summary>
-/// Reset button patches.
+/// Reset button patches
 /// </summary>
 [HarmonyPatch]
 public static class ButtonResetPatches

MiraAPI/Patches/HudManagerPatches.cs

@@ -88,8 +88,7 @@ public static class HudManagerPatches
     [HarmonyPatch(nameof(HudManager.SetHudActive), typeof(PlayerControl), typeof(RoleBehaviour), typeof(bool))]
     public static void SetHudActivePostfix(HudManager __instance, PlayerControl localPlayer, RoleBehaviour role, bool isActive)
     {
-        __instance.AdminButton.ToggleVisible(isActive && role.IsImpostor && GameOptionsManager.Instance.CurrentGameOptions.GameMode == AmongUs.GameOptions.GameModes.HideNSeek);
-        if (localPlayer.Data == null)
+        if (!localPlayer.Data)
         {
             return;
         }

MiraAPI/Patches/Modifiers/EndGameDidWinPatch.cs

@@ -1,40 +0,0 @@
-using System.Linq;
-using HarmonyLib;
-using MiraAPI.Modifiers.Types;
-using MiraAPI.Utilities;
-
-namespace MiraAPI.Patches.Modifiers;
-
-[HarmonyPatch(typeof(AmongUsClient), nameof(AmongUsClient.CoEndGame))]
-public static class EndGameDidWinPatch
-{
-    public static void Prefix()
-    {
-        var gameOverReason = EndGameResult.CachedGameOverReason;
-        EndGameResult.CachedWinners.Clear();
-
-        var players = GameData.Instance.AllPlayers.ToArray();
-        for (var i = 0; i < GameData.Instance.PlayerCount; i++)
-        {
-            var networkedPlayerInfo = players[i];
-            if (networkedPlayerInfo == null)
-            {
-                continue;
-            }
-
-            var didWin = networkedPlayerInfo.Role.DidWin(gameOverReason);
-
-            var modifierWin = networkedPlayerInfo.Object?.GetModifierComponent()?.ActiveModifiers.OfType<GameModifier>()
-                .FirstOrDefault(x => x.DidWin(gameOverReason) != null)?.DidWin(gameOverReason);
-            if (modifierWin != null)
-            {
-                didWin = modifierWin.Value;
-            }
-
-            if (didWin)
-            {
-                EndGameResult.CachedWinners.Add(new CachedPlayerData(networkedPlayerInfo));
-            }
-        }
-    }
-}

MiraAPI/Patches/Modifiers/VentPatches.cs

@@ -0,0 +1,45 @@
+using HarmonyLib;
+using MiraAPI.Utilities;
+using UnityEngine;
+
+namespace MiraAPI.Patches.Modifiers;
+
+[HarmonyPatch(typeof(Vent))]
+public static class VentPatches
+{
+    [HarmonyPostfix]
+    [HarmonyPatch(nameof(Vent.CanUse))]
+    public static void CanUseVentPatch(Vent __instance, ref float __result, [HarmonyArgument(0)] NetworkedPlayerInfo pc, [HarmonyArgument(1)] ref bool canUse, [HarmonyArgument(2)] ref bool couldUse)
+    {
+        var @object = pc.Object;
+        var role = @object.Data.Role;
+
+        var modifiers = @object.GetModifierComponent()?.ActiveModifiers;
+        if (modifiers is null || modifiers.Count <= 0)
+        {
+            return;
+        }
+
+        switch (role.CanVent)
+        {
+            case true when modifiers.Exists(x => !x.CanVent()):
+                couldUse = canUse = false;
+                return;
+            case false when modifiers.Exists(x => x.CanVent()):
+                couldUse = true;
+                break;
+        }
+
+        var num = float.MaxValue;
+
+        canUse = couldUse;
+        if (canUse)
+        {
+            var center = @object.Collider.bounds.center;
+            var position = __instance.transform.position;
+            num = Vector2.Distance(center, position);
+            canUse &= num <= __instance.UsableDistance && !PhysicsHelpers.AnythingBetween(@object.Collider, center, position, Constants.ShipOnlyMask, false);
+        }
+        __result = num;
+    }
+}

MiraAPI/Patches/Options/CreateOptionsPatch.cs

@@ -1,16 +0,0 @@
-using HarmonyLib;
-using MiraAPI.GameOptions;
-
-namespace MiraAPI.Patches.Options;
-
-[HarmonyPatch(typeof(CreateOptionsPicker), nameof(CreateOptionsPicker.Start))]
-public static class CreateOptionsPatch
-{
-    public static void Postfix()
-    {
-        foreach (var (_, value) in ModdedOptionsManager.ModdedOptions)
-        {
-            value.ResetToConfig();
-        }
-    }
-}

MiraAPI/Patches/Options/GameOptionsMenuPatch.cs

@@ -1,9 +1,9 @@
-using System.Linq;
-using HarmonyLib;
+using HarmonyLib;
 using MiraAPI.Utilities;
 using MiraAPI.Utilities.Assets;
 using Reactor.Localization.Utilities;
 using Reactor.Utilities.Extensions;
+using System.Linq;
 using TMPro;
 using UnityEngine;
 using UnityEngine.Events;
@@ -32,25 +32,16 @@ public static class GameOptionsMenuPatch
         var num = 2.1f;
         var filteredGroups =
             GameSettingMenuPatches.SelectedMod?.OptionGroups.Where(
-                x => x.AdvancedRole is null) ?? [];
+                x => x.GroupVisible.Invoke() && x.AdvancedRole is null) ?? [];
 
         foreach (var group in filteredGroups)
         {
-            if (group.Options.Count == 0 || group.Header is null)
+            var filteredOpts = group.Options.Where(x => x.Visible.Invoke()).ToList();
+            if (filteredOpts.Count == 0 || group.Header is null)
             {
                 continue;
             }
 
-            if (!group.GroupVisible.Invoke())
-            {
-                group.Header.gameObject.SetActive(false);
-                foreach (var option in group.Options)
-                {
-                    option.OptionBehaviour?.gameObject.SetActive(false);
-                }
-                continue;
-            }
-
             group.Header.gameObject.SetActive(true);
             group.Header.transform.localScale = Vector3.one * 0.63f;
             group.Header.transform.localPosition = new Vector3(-0.903f, num, -2f);

MiraAPI/Patches/Options/GameSettingMenuPatches.cs

@@ -1,9 +1,9 @@
-using System;
-using System.Linq;
-using HarmonyLib;
+using HarmonyLib;
 using MiraAPI.PluginLoading;
 using MiraAPI.Utilities.Assets;
 using Reactor.Utilities.Extensions;
+using System;
+using System.Linq;
 using TMPro;
 using UnityEngine;
 using UnityEngine.Events;

MiraAPI/Patches/Options/LobbyViewPanePatches.cs

@@ -128,6 +128,11 @@ public static class LobbyViewPanePatches
 
         foreach (var group in filteredGroups)
         {
+            if (group.Options.Count == 0)
+            {
+                continue;
+            }
+
             var categoryHeaderMasked = Object.Instantiate(
                 instance.categoryHeaderOrigin,
                 instance.settingsContainer,
@@ -171,6 +176,11 @@ public static class LobbyViewPanePatches
 
                 var data = option.Data;
 
+                if (data == null)
+                {
+                    continue;
+                }
+
                 if (data.Type == OptionTypes.Checkbox)
                 {
                     viewSettingsInfoPanel.SetInfoCheckbox(
@@ -215,7 +225,7 @@ public static class LobbyViewPanePatches
         {
             var filteredRoles = SelectedMod.CustomRoles.Values
                 .OfType<ICustomRole>()
-                .Where(x => !x.Configuration.HideSettings && x.Team == team).ToList();
+                .Where(x => !x.HideSettings && x.Team == team).ToList();
 
             if (filteredRoles.Count == 0)
             {
@@ -284,7 +294,7 @@ public static class LobbyViewPanePatches
                     chancePerGame,
                     61,
                     customRole.RoleColor,
-                    customRole.Configuration.Icon.LoadAsset(),
+                    customRole.Icon.LoadAsset(),
                     true);
 
                 viewSettingsInfoPanelRoleVariant.titleText.color =
@@ -369,7 +379,7 @@ public static class LobbyViewPanePatches
             role.StringName,
             maskLayer,
             role.TeamType == RoleTeamTypes.Crewmate,
-            customRole.Configuration.Icon.LoadAsset());
+            customRole.Icon.LoadAsset());
         viewPanel.divider.material.SetInt(PlayerMaterial.MaskLayer, maskLayer);
 
         var num = viewPanel.yPosStart;
@@ -389,6 +399,11 @@ public static class LobbyViewPanePatches
 
             var value = option.GetFloatData();
 
+            if (baseGameSetting == null)
+            {
+                continue;
+            }
+
             if (baseGameSetting.Type == OptionTypes.Checkbox)
             {
                 viewSettingsInfoPanel.SetInfoCheckbox(baseGameSetting.Title, maskLayer, value > 0f);

MiraAPI/Patches/Options/NotificationPopperPatch.cs

@@ -1,9 +1,7 @@
-using System.Linq;
-using HarmonyLib;
+using HarmonyLib;
 using Il2CppSystem;
 using MiraAPI.Roles;
-using UnityEngine;
-using Object = Il2CppSystem.Object;
+using System.Linq;
 
 namespace MiraAPI.Patches.Options;
 
@@ -20,27 +18,21 @@ public static class NotificationPopperPatch
         [HarmonyArgument(3)] RoleTeamTypes teamType,
         [HarmonyArgument(4)] bool playSound)
     {
-        if (CustomRoleManager.CustomRoles.Values.FirstOrDefault(x=>x.StringName==key) is not ICustomRole customRole)
+        if (CustomRoleManager.CustomRoles.Values.All(role => role.StringName != key))
         {
             return true;
         }
 
-        var text = customRole.Team switch
-        {
-            ModdedRoleTeams.Crewmate => Palette.CrewmateSettingChangeText.ToTextColor(),
-            ModdedRoleTeams.Impostor => Palette.ImpostorRed.ToTextColor(),
-            ModdedRoleTeams.Neutral => Palette.DisabledGrey.ToTextColor(),
-            _ => Color.white.ToTextColor(),
-        };
+        var text = teamType == RoleTeamTypes.Crewmate
+            ? Palette.CrewmateSettingChangeText.ToTextColor()
+            : Palette.ImpostorRed.ToTextColor();
 
-        var item = TranslationController.Instance.GetString(
+        var item = DestroyableSingleton<TranslationController>.Instance.GetString(
             StringNames.LobbyChangeSettingNotificationRole,
-            string.Concat(
-                "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">",
-                text,
-                TranslationController.Instance.GetString(key, Array.Empty<Object>()),
-                "</color></font>"
-            ),
+            "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">",
+            text,
+            DestroyableSingleton<TranslationController>.Instance.GetString(key, Array.Empty<Object>()),
+            "</color></font>",
             "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">" + roleCount + "</font>",
             "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">" + roleChance + "%"
         );

MiraAPI/Patches/Options/OptionsPatches.cs

@@ -17,7 +17,7 @@ public static class OptionsPatches
         }
 
         __instance.TitleText.text =
-            TranslationController.Instance.GetString(__instance.Title, Array.Empty<Object>());
+            DestroyableSingleton<TranslationController>.Instance.GetString(__instance.Title, Array.Empty<Object>());
 
         return false;
     }
@@ -39,7 +39,7 @@ public static class OptionsPatches
         }
 
         __instance.TitleText.text =
-            TranslationController.Instance.GetString(__instance.Title, Array.Empty<Object>());
+            DestroyableSingleton<TranslationController>.Instance.GetString(__instance.Title, Array.Empty<Object>());
 
         return false;
     }
@@ -61,8 +61,8 @@ public static class OptionsPatches
         }
 
         __instance.TitleText.text =
-            TranslationController.Instance.GetString(__instance.Title, Array.Empty<Object>());
-        __instance.ValueText.text = TranslationController.Instance.GetString(
+            DestroyableSingleton<TranslationController>.Instance.GetString(__instance.Title, Array.Empty<Object>());
+        __instance.ValueText.text = DestroyableSingleton<TranslationController>.Instance.GetString(
             __instance.Values[__instance.Value],
             Array.Empty<Object>());
 

MiraAPI/Patches/Options/RoleSettingMenuPatches.cs

@@ -1,6 +1,4 @@
-using System;
-using System.Linq;
-using HarmonyLib;
+using HarmonyLib;
 using Il2CppInterop.Runtime.InteropTypes.Arrays;
 using MiraAPI.Networking;
 using MiraAPI.Roles;
@@ -9,6 +7,8 @@ using MiraAPI.Utilities.Assets;
 using Reactor.Networking.Rpc;
 using Reactor.Utilities;
 using Reactor.Utilities.Extensions;
+using System;
+using System.Linq;
 using TMPro;
 using UnityEngine;
 using UnityEngine.Events;
@@ -56,7 +56,7 @@ public static class RoleSettingMenuPatches
 
         var crewRoles = GameSettingMenuPatches.SelectedMod?.CustomRoles.Values
             .OfType<ICustomRole>()
-            .Where(role => role is { Team: ModdedRoleTeams.Crewmate, Configuration.HideSettings: false })
+            .Where(role => role is { Team: ModdedRoleTeams.Crewmate, HideSettings: false })
             .ToList() ?? [];
 
         if (crewRoles is { Count: > 0 })
@@ -82,7 +82,7 @@ public static class RoleSettingMenuPatches
 
         var impRoles = GameSettingMenuPatches.SelectedMod?.CustomRoles.Values
             .OfType<ICustomRole>()
-            .Where(role => role is { Team: ModdedRoleTeams.Impostor, Configuration.HideSettings: false })
+            .Where(role => role is { Team: ModdedRoleTeams.Impostor, HideSettings: false })
             .ToList() ?? [];
 
         if (impRoles is { Count: > 0 })
@@ -109,7 +109,7 @@ public static class RoleSettingMenuPatches
 
         var neutRoles = GameSettingMenuPatches.SelectedMod?.CustomRoles.Values
             .OfType<ICustomRole>()
-            .Where(role => role is { Team: ModdedRoleTeams.Neutral, Configuration.HideSettings: false })
+            .Where(role => role is { Team: ModdedRoleTeams.Neutral, HideSettings: false })
             .ToList() ?? [];
 
         if (neutRoles is { Count: > 0 })
@@ -159,22 +159,18 @@ public static class RoleSettingMenuPatches
     {
         var roleSetting = obj.Cast<RoleOptionSetting>();
         var role = roleSetting.Role as ICustomRole;
-        if (role is null or { Configuration.HideSettings: true })
+        if (role is null or { HideSettings: true })
         {
             return;
         }
 
         try
         {
-            if (role.Configuration.MaxRoleCount != 0)
-            {
-                role.SetCount(roleSetting.RoleMaxCount);
-            }
+            role.ParentMod.PluginConfig.TryGetEntry<int>(role.NumConfigDefinition, out var numEntry);
+            numEntry.Value = roleSetting.RoleMaxCount;
 
-            if (role.Configuration.CanModifyChance)
-            {
-                role.SetChance(roleSetting.RoleChance);
-            }
+            role.ParentMod.PluginConfig.TryGetEntry<int>(role.ChanceConfigDefinition, out var chanceEntry);
+            chanceEntry.Value = roleSetting.RoleChance;
         }
         catch (Exception e)
         {
@@ -182,7 +178,7 @@ public static class RoleSettingMenuPatches
         }
 
         roleSetting.UpdateValuesAndText(GameOptionsManager.Instance.CurrentGameOptions.RoleOptions);
-        HudManager.Instance.Notifier.AddRoleSettingsChangeMessage(
+        DestroyableSingleton<HudManager>.Instance.Notifier.AddRoleSettingsChangeMessage(
             roleSetting.Role.StringName,
             roleSetting.RoleMaxCount,
             roleSetting.RoleChance,
@@ -232,7 +228,7 @@ public static class RoleSettingMenuPatches
                 renderer.material.SetInt(PlayerMaterial.MaskLayer, 20);
             }
 
-            foreach (var fontMat in newOpt.GetComponentsInChildren<TextMeshPro>(true).Select(x => x.fontMaterial))
+            foreach (var fontMat in newOpt.GetComponentsInChildren<TextMeshPro>(true).Select(x=>x.fontMaterial))
             {
                 fontMat.SetFloat(ShaderID.StencilComp, 3f);
                 fontMat.SetFloat(ShaderID.Stencil, 20);
@@ -258,11 +254,11 @@ public static class RoleSettingMenuPatches
         }
 
         __instance.roleDescriptionText.text = customRole.RoleLongDescription;
-        __instance.roleTitleText.text = TranslationController.Instance.GetString(
+        __instance.roleTitleText.text = DestroyableSingleton<TranslationController>.Instance.GetString(
             role.StringName,
             new Il2CppReferenceArray<Il2CppSystem.Object>(0));
         __instance.roleScreenshot.sprite = Sprite.Create(
-            customRole.Configuration.OptionsScreenshot.LoadAsset().texture,
+            customRole.OptionsScreenshot.LoadAsset().texture,
             new Rect(0, 0, 370, 230),
             Vector2.one / 2,
             100);
@@ -309,7 +305,6 @@ public static class RoleSettingMenuPatches
             Quaternion.identity,
             __instance.RoleChancesSettings.transform);
         roleOptionSetting.transform.localPosition = new Vector3(-0.15f, yPos, -2f);
-
         roleOptionSetting.SetRole(GameOptionsManager.Instance.CurrentGameOptions.RoleOptions, role, 20);
         roleOptionSetting.labelSprite.color = customRole.RoleColor;
         roleOptionSetting.OnValueChanged = new Action<OptionBehaviour>(ValueChanged);
@@ -341,18 +336,6 @@ public static class RoleSettingMenuPatches
             passiveButton.OnClick.AddListener((UnityAction)(() => { ChangeTab(role, __instance); }));
         }
 
-        if (customRole.Configuration is { MaxRoleCount: 0 })
-        {
-            roleOptionSetting.CountMinusBtn.gameObject.SetActive(false);
-            roleOptionSetting.CountPlusBtn.gameObject.SetActive(false);
-        }
-
-        if (!customRole.Configuration.CanModifyChance)
-        {
-            roleOptionSetting.ChanceMinusBtn.gameObject.SetActive(false);
-            roleOptionSetting.ChancePlusBtn.gameObject.SetActive(false);
-        }
-
         if (index < GameSettingMenuPatches.SelectedMod?.CustomRoles.Count - 1)
         {
             yPos += -0.43f;

MiraAPI/Patches/Options/SettingPatches.cs

@@ -39,9 +39,9 @@ public static class SettingPatches
                 MiraNumberSuffixes.None => value.ToString(__instance.FormatString, NumberFormatInfo.InvariantInfo),
                 MiraNumberSuffixes.Multiplier => value.ToString(__instance.FormatString, NumberFormatInfo.InvariantInfo) + "x",
                 MiraNumberSuffixes.Percent => value.ToString(__instance.FormatString, NumberFormatInfo.InvariantInfo) + "%",
-                _ => TranslationController.Instance.GetString(
+                _ => DestroyableSingleton<TranslationController>.Instance.GetString(
                     StringNames.GameSecondsAbbrev,
-                    (Il2CppSystem.Object[])[value.ToString(__instance.FormatString, CultureInfo.InvariantCulture)]),
+                    (Il2CppSystem.Object[]) [value.ToString(__instance.FormatString, CultureInfo.InvariantCulture)]),
             };
         }
 

MiraAPI/Patches/PlayerControlPatches.cs

@@ -1,4 +1,5 @@
 using HarmonyLib;
+using MiraAPI.Animations;
 using MiraAPI.Hud;
 using MiraAPI.Modifiers;
 using MiraAPI.Roles;
@@ -13,9 +14,9 @@ namespace MiraAPI.Patches;
 public static class PlayerControlPatches
 {
     /// <summary>
-    /// Adds the modifier component to the player on start.
+    /// Adds the modifier and animator component to the player on start.
     /// </summary>
-    /// <param name="__instance">PlayerControl instance.</param>
+    /// <param name="__instance">The player which will be given the components.</param>
     [HarmonyPrefix]
     [HarmonyPatch(nameof(PlayerControl.Start))]
     public static void PlayerControlStartPostfix(PlayerControl __instance)
@@ -25,14 +26,20 @@ public static class PlayerControlPatches
             comp.DestroyImmediate();
         }
 
+        if (__instance.gameObject.TryGetComponent<CustomAnimator>(out var anim))
+        {
+            anim.DestroyImmediate();
+        }
+
+        __instance.gameObject.AddComponent<CustomAnimator>();
         __instance.gameObject.AddComponent<ModifierComponent>();
     }
 
     /// <summary>
     /// Calls the OnDeath method for all active modifiers.
     /// </summary>
-    /// <param name="__instance">PlayerControl instance.</param>
-    /// <param name="reason">The death reason.</param>
+    /// <param name="__instance">The player who died.</param>
+    /// <param name="reason">The reason of the death.</param>
     [HarmonyPostfix]
     [HarmonyPatch(nameof(PlayerControl.Die))]
     public static void PlayerControlDiePostfix(PlayerControl __instance, DeathReason reason)
@@ -41,14 +48,14 @@ public static class PlayerControlPatches
 
         if (modifiersComponent)
         {
-            modifiersComponent.ActiveModifiers.ForEach(x=>x.OnDeath(reason));
+            modifiersComponent.ActiveModifiers.ForEach(x => x.OnDeath(reason));
         }
     }
 
     /// <summary>
     /// FixedUpdate handler for custom roles and custom buttons.
     /// </summary>
-    /// <param name="__instance">PlayerControl instance.</param>
+    /// <param name="__instance">The player who's fixed update is being called.</param>
     [HarmonyPostfix]
     [HarmonyPatch(nameof(PlayerControl.FixedUpdate))]
     public static void PlayerControlFixedUpdatePostfix(PlayerControl __instance)
@@ -78,15 +85,4 @@ public static class PlayerControlPatches
             button.FixedUpdateHandler(__instance);
         }
     }
-
-    /// <summary>
-    /// Clear from modifier component cache.
-    /// </summary>
-    /// <param name="__instance">PlayerControl instance.</param>
-    [HarmonyPrefix]
-    [HarmonyPatch(nameof(PlayerControl.OnDestroy))]
-    public static void PlayerControlOnDestroyPrefix(PlayerControl __instance)
-    {
-        Utilities.Extensions.ModifierComponents.Remove(__instance);
-    }
 }

MiraAPI/Patches/Roles/GameStartupPatch.cs

@@ -9,7 +9,7 @@ public static class GameStartupPatch
     private static bool _runOnce;
 
     /// <summary>
-    /// This is used for registering roles when the game opens, might be a janky solution, but it works.
+    /// This is used for registering roles when the game opens, might be a janky solution, but it works
     /// </summary>
     [HarmonyPostfix]
     [HarmonyPatch(nameof(MainMenuManager.Start))]

MiraAPI/Patches/Roles/HudManagerPatches.cs

@@ -17,10 +17,6 @@ public static class HudManagerPatches
     /// <summary>
     /// Fixes Kill Button not showing for Neutral killing role.
     /// </summary>
-    /// <param name="__instance">HudManager instance.</param>
-    /// <param name="localPlayer">The local PlayerControl.</param>
-    /// <param name="role">The player's RoleBehaviour.</param>
-    /// <param name="isActive">Whether the Hud should be set active or not.</param>
     [HarmonyPostfix]
     [HarmonyPatch(nameof(HudManager.SetHudActive), typeof(PlayerControl), typeof(RoleBehaviour), typeof(bool))]
     public static void SetHudActivePostfix(
@@ -31,11 +27,10 @@ public static class HudManagerPatches
     {
         var flag = localPlayer.Data != null && localPlayer.Data.IsDead;
 
-        if (role is ICustomRole customRole)
+        if (role is ICustomRole)
         {
-            __instance.KillButton.ToggleVisible(isActive && customRole.Configuration.UseVanillaKillButton && !flag);
-            __instance.ImpostorVentButton.ToggleVisible(isActive && customRole.Configuration.CanUseVent && !flag);
-            __instance.SabotageButton.gameObject.SetActive(isActive && customRole.Configuration.CanUseSabotage);
+            __instance.KillButton.ToggleVisible(isActive && role.CanUseKillButton && !flag);
+            __instance.ImpostorVentButton.ToggleVisible(isActive && role.CanVent && !flag);
         }
 
         if (_roleTab)
@@ -60,7 +55,7 @@ public static class HudManagerPatches
 
         var role = local?.Data?.Role;
 
-        if (role is ICustomRole { Configuration.RoleHintType: RoleHintType.RoleTab } customRole)
+        if (role is ICustomRole { RoleHintType: RoleHintType.RoleTab } customRole)
         {
             customRole.HudUpdate(__instance);
 

MiraAPI/Patches/Roles/KillButtonPatches.cs

@@ -36,7 +36,7 @@ public static class KillButtonPatches
         __instance.currentTarget = target;
         if (__instance.currentTarget)
         {
-            __instance.currentTarget.cosmetics.SetOutline(true, new Nullable<Color>(customRole.Configuration.KillButtonOutlineColor));
+            __instance.currentTarget.cosmetics.SetOutline(true, new Nullable<Color>(customRole.KillButtonOutlineColor));
             __instance.SetEnabled();
             return false;
         }
@@ -52,6 +52,11 @@ public static class KillButtonPatches
     [HarmonyPatch(nameof(KillButton.DoClick))]
     public static bool DoClickPrefix(KillButton __instance)
     {
+        if (PlayerControl.LocalPlayer.Data.Role is not ICustomRole)
+        {
+            return true;
+        }
+
         if (!__instance.isActiveAndEnabled || !__instance.currentTarget || __instance.isCoolingDown ||
             PlayerControl.LocalPlayer.Data.IsDead || !PlayerControl.LocalPlayer.CanMove)
         {

MiraAPI/Patches/Roles/NameTagPatch.cs

@@ -4,7 +4,7 @@ using UnityEngine;
 namespace MiraAPI.Patches.Roles;
 
 /// <summary>
-/// Set nametag color depending on option.
+/// Set nametag color depending on option
 /// </summary>
 [HarmonyPatch(typeof(PlayerNameColor))]
 public static class NameTagPatch

MiraAPI/Patches/Roles/RoleBehaviourPatches.cs

@@ -8,7 +8,7 @@ namespace MiraAPI.Patches.Roles;
 public static class RoleBehaviourPatches
 {
     /// <summary>
-    /// Update TeamColor text for custom roles.
+    /// Update TeamColor text for Launchpad roles
     /// </summary>
     [HarmonyPrefix]
     [HarmonyPatch(nameof(RoleBehaviour.TeamColor), MethodType.Getter)]

MiraAPI/Patches/Roles/RoleManagerPatches.cs

@@ -1,8 +1,8 @@
-using System.Linq;
-using AmongUs.GameOptions;
+using AmongUs.GameOptions;
 using HarmonyLib;
 using MiraAPI.Modifiers;
 using MiraAPI.Roles;
+using System.Linq;
 
 namespace MiraAPI.Patches.Roles;
 
@@ -37,12 +37,12 @@ public static class RoleManagerPatches
             return true;
         }
 
-        if (role.Configuration.GhostRole is RoleTypes.CrewmateGhost or RoleTypes.ImpostorGhost)
+        if (role.GhostRole is RoleTypes.CrewmateGhost or RoleTypes.ImpostorGhost)
         {
             return true;
         }
 
-        plr.RpcSetRole(role.Configuration.GhostRole);
+        plr.RpcSetRole(role.GhostRole);
         return false;
     }
 }

MiraAPI/Patches/Roles/RoleOptionsCollectionPatch.cs

@@ -1,73 +1,55 @@
 using AmongUs.GameOptions;
 using HarmonyLib;
 using MiraAPI.Roles;
-using Reactor.Utilities;
 
 namespace MiraAPI.Patches.Roles;
 
-/// <summary>
-/// Patches to return the correct role counts.
-/// </summary>
 [HarmonyPatch(typeof(RoleOptionsCollectionV08))]
 public static class RoleOptionsCollectionPatch
 {
     /// <summary>
-    /// Set the role chance for custom Launchpad roles based on config.
+    /// Set the role chance for custom Launchpad roles based on config
     /// </summary>
-    /// <returns>Return false to skip original method, true to not.</returns>
     [HarmonyPrefix]
     [HarmonyPatch(nameof(RoleOptionsCollectionV08.GetChancePerGame))]
-    public static bool GetChancePrefix(RoleTypes role, ref int __result)
+    public static bool GetChancePrefix([HarmonyArgument(0)] RoleTypes roleType, ref int __result)
     {
-        if (!CustomRoleManager.GetCustomRoleBehaviour(role, out var customRole) || customRole == null)
+        if (!CustomRoleManager.GetCustomRoleBehaviour(roleType, out var customRole) || customRole == null)
         {
             return true;
         }
 
-        if (customRole.Configuration.HideSettings)
+        if (customRole.HideSettings)
         {
             __result = 0;
             return false;
         }
 
-        var chance = customRole.GetChance();
-        if (chance == null)
-        {
-            Logger<MiraApiPlugin>.Error($"Chance is null, defaulting to zero.");
-            chance = 0;
-        }
-
-        __result = chance.Value;
+        customRole.ParentMod.PluginConfig.TryGetEntry<int>(customRole.ChanceConfigDefinition, out var entry);
+        __result = entry.Value;
         return false;
     }
 
     /// <summary>
-    /// Set the amount for custom Launchpad roles based on config.
+    /// Set the amount for custom Launchpad roles based on config
     /// </summary>
-    /// <returns>Return false to skip original method, true to not.</returns>
     [HarmonyPrefix]
     [HarmonyPatch(nameof(RoleOptionsCollectionV08.GetNumPerGame))]
-    public static bool GetNumPrefix(RoleTypes role, ref int __result)
+    public static bool GetNumPrefix([HarmonyArgument(0)] RoleTypes roleType, ref int __result)
     {
-        if (!CustomRoleManager.GetCustomRoleBehaviour(role, out var customRole) || customRole == null)
+        if (!CustomRoleManager.GetCustomRoleBehaviour(roleType, out var customRole) || customRole == null)
         {
             return true;
         }
 
-        if (customRole.Configuration.HideSettings)
+        if (customRole.HideSettings)
         {
             __result = 0;
             return false;
         }
 
-        var count = customRole.GetCount();
-        if (count == null)
-        {
-            Logger<MiraApiPlugin>.Error($"Count is null, defaulting to zero.");
-            count = 0;
-        }
-
-        __result = count.Value;
+        customRole.ParentMod.PluginConfig.TryGetEntry<int>(customRole.NumConfigDefinition, out var entry);
+        __result = entry.Value;
         return false;
     }
 }

MiraAPI/Patches/Roles/SabotageButtonPatch.cs

@@ -1,62 +0,0 @@
-using HarmonyLib;
-using MiraAPI.Roles;
-
-namespace MiraAPI.Patches.Roles;
-
-[HarmonyPatch(typeof(SabotageButton))]
-public static class SabotageButtonPatch
-{
-    /// <summary>
-    /// Patches the Sabotage button to check if the player's custom role can use sabotage.
-    /// </summary>
-    [HarmonyPatch(nameof(SabotageButton.DoClick))]
-    [HarmonyPrefix]
-    public static bool DoClickPrefix(SabotageButton __instance)
-    {
-        var player = PlayerControl.LocalPlayer;
-
-        if (player.Data.Role is not ICustomRole customRole)
-        {
-            return true;
-        }
-
-        if (!customRole.Configuration.CanUseSabotage || PlayerControl.LocalPlayer.inVent || !GameManager.Instance.SabotagesEnabled())
-        {
-            return false;
-        }
-
-        HudManager.Instance.ToggleMapVisible(
-            new MapOptions
-            {
-                Mode = MapOptions.Modes.Sabotage,
-            });
-        return false;
-    }
-
-    [HarmonyPrefix]
-    [HarmonyPatch(nameof(SabotageButton.Refresh))]
-    public static bool RefreshPrefix(SabotageButton __instance)
-    {
-        var player = PlayerControl.LocalPlayer;
-        if (GameManager.Instance == null || player == null)
-        {
-            __instance.ToggleVisible(false);
-            __instance.SetDisabled();
-            return false;
-        }
-
-        if (player.Data.Role is not ICustomRole customRole)
-        {
-            return true;
-        }
-
-        if (player.inVent || !GameManager.Instance.SabotagesEnabled() || player.petting)
-        {
-            __instance.ToggleVisible(customRole.Configuration.CanUseSabotage && GameManager.Instance.SabotagesEnabled());
-            __instance.SetDisabled();
-            return false;
-        }
-        __instance.SetEnabled();
-        return false;
-    }
-}

MiraAPI/Patches/Roles/TaskAdderPatch.cs

@@ -1,24 +1,21 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.GameOptions;
+using AmongUs.GameOptions;
 using HarmonyLib;
+using Il2CppSystem;
+using Il2CppSystem.Collections.Generic;
 using MiraAPI.PluginLoading;
 using MiraAPI.Roles;
 using MiraAPI.Utilities.Assets;
+using System.Linq;
 using TMPro;
 using UnityEngine;
 using Object = UnityEngine.Object;
 
 namespace MiraAPI.Patches.Roles;
 
-/// <summary>
-/// Patch TaskAdder for organizing Roles and adding scroller.
-/// </summary>
 [HarmonyPatch]
 public static class TaskAdderPatch
 {
-    private static readonly Dictionary<string, string> ModsFolders = [];
+    private static readonly System.Collections.Generic.Dictionary<string, string> ModsFolders = [];
     private static Scroller? _scroller;
 
     [HarmonyPostfix]
@@ -170,14 +167,19 @@ public static class TaskAdderPatch
 
             ControllerManager.Instance.AddSelectableUiElement(taskFolder2.Button);
             if (!string.IsNullOrEmpty(__instance.restorePreviousSelectionByFolderName) &&
-                taskFolder2.FolderName.Equals(__instance.restorePreviousSelectionByFolderName, StringComparison.Ordinal))
+                taskFolder2.FolderName.Equals(__instance.restorePreviousSelectionByFolderName, System.StringComparison.Ordinal))
             {
                 __instance.restorePreviousSelectionFound = taskFolder2.Button;
             }
         }
 
         var flag = false;
-        var list = taskFolder.Children.ToArray().OrderBy(t => t.TaskType).ToList();
+        var list = new List<PlayerTask>();
+
+        foreach (var item in taskFolder.Children)
+        {
+            list.Add(item);
+        }
 
         for (var l = 0; l < list.Count; l++)
         {
@@ -188,24 +190,26 @@ public static class TaskAdderPatch
                 case TaskTypes.DivertPower:
                 {
                     var targetSystem = taskAddButton.MyTask.Cast<DivertPowerTask>().TargetSystem;
-                    taskAddButton.Text.text = TranslationController.Instance.GetString(
+                    taskAddButton.Text.text = DestroyableSingleton<TranslationController>.Instance.GetString(
                         StringNames.DivertPowerTo,
-                        TranslationController.Instance.GetString(targetSystem));
+                        DestroyableSingleton<TranslationController>.Instance.GetString(targetSystem));
                     break;
                 }
                 case TaskTypes.FixWeatherNode:
                 {
-                    var nodeId = taskAddButton.MyTask.Cast<WeatherNodeTask>().NodeId;
+                    var nodeId = ((WeatherNodeTask)taskAddButton.MyTask).NodeId;
                     taskAddButton.Text.text =
-                        TranslationController.Instance.GetString(
-                            StringNames.FixWeatherNode) + " " +
-                        TranslationController.Instance.GetString(
-                            WeatherSwitchGame.ControlNames[nodeId]);
+                        DestroyableSingleton<TranslationController>.Instance.GetString(
+                            StringNames.FixWeatherNode,
+                            Array.Empty<Il2CppSystem.Object>()) + " " +
+                        DestroyableSingleton<TranslationController>.Instance.GetString(
+                            WeatherSwitchGame.ControlNames[nodeId],
+                            Array.Empty<Il2CppSystem.Object>());
                     break;
                 }
                 default:
                     taskAddButton.Text.text =
-                        TranslationController.Instance.GetString(taskAddButton.MyTask.TaskType);
+                        DestroyableSingleton<TranslationController>.Instance.GetString(taskAddButton.MyTask.TaskType);
                     break;
             }
 
@@ -234,9 +238,9 @@ public static class TaskAdderPatch
 
         if (taskFolder.FolderName == "Roles")
         {
-            for (var m = 0; m < RoleManager.Instance.AllRoles.Length; m++)
+            for (var m = 0; m < DestroyableSingleton<RoleManager>.Instance.AllRoles.Length; m++)
             {
-                var roleBehaviour = RoleManager.Instance.AllRoles[m];
+                var roleBehaviour = DestroyableSingleton<RoleManager>.Instance.AllRoles[m];
                 if (roleBehaviour.Role == RoleTypes.ImpostorGhost || roleBehaviour.Role == RoleTypes.CrewmateGhost ||
                     CustomRoleManager.CustomRoles.ContainsKey((ushort)roleBehaviour.Role))
                 {
@@ -271,7 +275,7 @@ public static class TaskAdderPatch
 
         if (ModsFolders.TryGetValue(taskFolder.FolderName, out var guid))
         {
-            var plugin = MiraPluginManager.GetPluginByGuid(guid);
+            var plugin = MiraPluginManager.Instance.GetPluginByGuid(guid);
             for (var m = 0; m < plugin.CustomRoles.Count; m++)
             {
                 var roleBehaviour = plugin.CustomRoles.ElementAt(m).Value;

MiraAPI/Patches/Roles/VentOutlinePatch.cs

@@ -6,17 +6,12 @@ using UnityEngine;
 namespace MiraAPI.Patches.Roles;
 
 /// <summary>
-/// Vent patches for Roles.
+/// Set vent outline color based on the player's role.
 /// </summary>
-[HarmonyPatch(typeof(Vent))]
-public static class VentPatches
+[HarmonyPatch(typeof(Vent), nameof(Vent.SetOutline))]
+public static class VentOutlinePatch
 {
-    /// <summary>
-    /// Set outline to player's custom role color.
-    /// </summary>
-    [HarmonyPostfix]
-    [HarmonyPatch(nameof(Vent.SetOutline))]
-    public static void SetOutlinePostfix(Vent __instance, bool on, bool mainTarget)
+    public static void Postfix(Vent __instance, bool on, bool mainTarget)
     {
         if (PlayerControl.LocalPlayer.Data.Role is not ICustomRole customRole)
         {

MiraAPI/Patches/Stubs/MinigameStubs.cs

@@ -1,24 +0,0 @@
-using System.Runtime.CompilerServices;
-using HarmonyLib;
-
-namespace MiraAPI.Patches.Stubs;
-
-/// <summary>
-/// Reverse patches for Minigames.
-/// </summary>
-[HarmonyPatch]
-public static class MinigameStubs
-{
-    /// <summary>
-    /// Reverse patch for Minigame.Begin.
-    /// </summary>
-    /// <param name="instance">The Minigame instance.</param>
-    /// <param name="task">Associated PlayerTask.</param>
-    [HarmonyReversePatch]
-    [HarmonyPatch(typeof(Minigame), nameof(Minigame.Begin))]
-    [MethodImpl(MethodImplOptions.NoInlining)]
-    public static void Begin(Minigame instance, PlayerTask? task)
-    {
-        // nothing needed
-    }
-}

MiraAPI/Patches/VentPatches.cs

@@ -1,55 +0,0 @@
-using System.Linq;
-using HarmonyLib;
-using MiraAPI.Roles;
-using MiraAPI.Utilities;
-using Reactor.Utilities;
-using UnityEngine;
-
-namespace MiraAPI.Patches;
-
-/// <summary>
-/// Vent patches to make sure the player is able to use the vent.
-/// </summary>
-[HarmonyPatch(typeof(Vent))]
-public static class VentPatches
-{
-    /// <summary>
-    /// CanUse patch.
-    /// </summary>
-    [HarmonyPostfix]
-    [HarmonyPatch(nameof(Vent.CanUse))]
-    public static void VentCanUsePostfix(Vent __instance, ref float __result, [HarmonyArgument(0)] NetworkedPlayerInfo pc, [HarmonyArgument(1)] ref bool canUse, [HarmonyArgument(2)] ref bool couldUse)
-    {
-        var @object = pc.Object;
-        var role = @object.Data.Role;
-
-        var canVent = role is ICustomRole customRole ? customRole.Configuration.CanUseVent : role.CanVent;
-        couldUse = canVent;
-
-        var modifiers = @object.GetModifierComponent()?.ActiveModifiers;
-        if (modifiers is { Count: > 0 })
-        {
-            switch (canVent)
-            {
-                case true when modifiers.Exists(x => x.CanVent().HasValue && x.CanVent()==false):
-                    couldUse = canUse = false;
-                    return;
-                case false when modifiers.Exists(x => x.CanVent().HasValue && x.CanVent()==true):
-                    couldUse = true;
-                    break;
-            }
-        }
-
-        var num = float.MaxValue;
-
-        canUse = couldUse;
-        if (canUse)
-        {
-            var center = @object.Collider.bounds.center;
-            var position = __instance.transform.position;
-            num = Vector2.Distance(center, position);
-            canUse &= num <= __instance.UsableDistance && !PhysicsHelpers.AnythingBetween(@object.Collider, center, position, Constants.ShipOnlyMask, false);
-        }
-        __result = num;
-    }
-}

MiraAPI/PluginLoading/MiraPluginInfo.cs

@@ -1,10 +1,8 @@
-using System.Collections.Generic;
-using System.Collections.ObjectModel;
-using BepInEx;
+using BepInEx;
 using BepInEx.Configuration;
 using MiraAPI.GameModes;
 using MiraAPI.GameOptions;
-using MiraAPI.Hud;
+using System.Collections.Generic;
 
 namespace MiraAPI.PluginLoading;
 
@@ -21,63 +19,14 @@ public class MiraPluginInfo
         PluginId = info.Metadata.GUID;
     }
 
-    /// <summary>
-    /// Get a read only collection of this plugin's Option Groups.
-    /// </summary>
-    /// <returns>Readonly collection of option groups.</returns>
-    public IReadOnlyCollection<AbstractOptionGroup> GetOptionGroups()
-    {
-        return OptionGroups.AsReadOnly();
-    }
-
-    /// <summary>
-    /// Gets a read only collection of this plugin's options.
-    /// </summary>
-    /// <returns>Read only collection of options.</returns>
-    public IReadOnlyCollection<IModdedOption> GetOptions()
-    {
-        return Options.AsReadOnly();
-    }
-
-    /// <summary>
-    /// Gets a read only dictionary of Role IDs and the RoleBehaviour object they are associated with.
-    /// </summary>
-    /// <returns>Read only dictionary of IDs and Roles.</returns>
-    public ReadOnlyDictionary<ushort, RoleBehaviour> GetRoles()
-    {
-        return new ReadOnlyDictionary<ushort, RoleBehaviour>(CustomRoles);
-    }
-
-    /// <summary>
-    /// Gets a read only collection of this plugin's custom buttons.
-    /// </summary>
-    /// <returns>Read only collection of buttons.</returns>
-    public IReadOnlyCollection<CustomActionButton> GetButtons()
-    {
-        return Buttons.AsReadOnly();
-    }
-
-    /// <summary>
-    /// Gets a read only collection of this plugin's custom buttons.
-    /// </summary>
-    /// <returns>Read only collection of buttons.</returns>
-    public IReadOnlyCollection<Cosmetics.AbstractCosmeticsGroup> GetCosmetics()
-    {
-        return CosmeticGroups.AsReadOnly();
-    }
-
     internal List<AbstractOptionGroup> OptionGroups { get; } = [];
 
     internal List<IModdedOption> Options { get; } = [];
 
-    internal List<Cosmetics.AbstractCosmeticsGroup> CosmeticGroups { get; } = [];
-
     internal Dictionary<ushort, RoleBehaviour> CustomRoles { get; } = [];
 
     internal Dictionary<int, CustomGameMode> GameModes { get; } = [];
 
-    internal List<CustomActionButton> Buttons { get; } = [];
-
     /// <summary>
     /// Gets the plugin's ID, as defined in the plugin's BepInEx metadata.
     /// </summary>

MiraAPI/PluginLoading/MiraPluginManager.cs

@@ -1,36 +1,40 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Reflection;
-using BepInEx.Unity.IL2CPP;
+using BepInEx.Unity.IL2CPP;
+using MiraAPI.Animations;
 using MiraAPI.Colors;
-using MiraAPI.Cosmetics;
 using MiraAPI.GameOptions;
 using MiraAPI.GameOptions.Attributes;
 using MiraAPI.Hud;
 using MiraAPI.Modifiers;
 using MiraAPI.Roles;
 using MiraAPI.Utilities;
+using MiraAPI.Utilities.Assets;
 using Reactor.Networking;
 using Reactor.Utilities;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Reflection;
 
 namespace MiraAPI.PluginLoading;
 
-/// <summary>
-/// Mira Plugin manager.
-/// </summary>
-public sealed class MiraPluginManager
+internal sealed class MiraPluginManager
 {
     private readonly Dictionary<Assembly, MiraPluginInfo> _registeredPlugins = [];
-
     internal MiraPluginInfo[] RegisteredPlugins() => [.. _registeredPlugins.Values];
 
-    internal static MiraPluginManager Instance { get; private set; } = new();
+    public List<LoadableBundleAsset<UnityEngine.Object>> BundleAssets = new();
+    internal uint NextAssetId { get; private set; }
+    internal uint GetNextAssetId()
+    {
+        NextAssetId++;
+        return NextAssetId;
+    }
+
+    public static MiraPluginManager Instance { get; private set; } = new();
 
     internal void Initialize()
     {
         Instance = this;
-        CustomCosmeticManager.RegisterVanilla();
         IL2CPPChainloader.Instance.PluginLoad += (pluginInfo, assembly, plugin) =>
         {
             if (plugin is not IMiraPlugin miraPlugin)
@@ -41,11 +45,11 @@ public sealed class MiraPluginManager
             var info = new MiraPluginInfo(miraPlugin, pluginInfo);
 
             RegisterModifierAttribute(assembly);
+            RegisterAnimPresetAttribute(assembly);
             RegisterAllOptions(assembly, info);
-            RegisterAllCosmetics(assembly, info);
 
             RegisterRoleAttribute(assembly, info);
-            RegisterButtonAttribute(assembly, info);
+            RegisterButtonAttribute(assembly);
 
             RegisterColorClasses(assembly);
 
@@ -56,14 +60,9 @@ public sealed class MiraPluginManager
         IL2CPPChainloader.Instance.Finished += PaletteManager.RegisterAllColors;
     }
 
-    /// <summary>
-    /// Get a mira plugin by its GUID.
-    /// </summary>
-    /// <param name="uniqueId">The plugin GUID.</param>
-    /// <returns>A MiraPluginInfo.</returns>
-    public static MiraPluginInfo GetPluginByGuid(string uniqueId)
+    public MiraPluginInfo GetPluginByGuid(string guid)
     {
-        return Instance._registeredPlugins.Values.First(plugin => plugin.PluginId == uniqueId);
+        return _registeredPlugins.Values.First(plugin => plugin.PluginId == guid);
     }
 
     private static void RegisterAllOptions(Assembly assembly, MiraPluginInfo pluginInfo)
@@ -98,30 +97,6 @@ public sealed class MiraPluginManager
         pluginInfo.OptionGroups.Sort((x, y) => x.GroupPriority.CompareTo(y.GroupPriority));
     }
 
-    private static void RegisterAllCosmetics(Assembly assembly, MiraPluginInfo pluginInfo)
-    {
-        var filteredTypes = assembly.GetTypes().Where(type => type.IsAssignableTo(typeof(AbstractCosmeticsGroup)));
-
-        foreach (var type in filteredTypes)
-        {
-            if (!CustomCosmeticManager.RegisterGroup(type, pluginInfo))
-            {
-                continue;
-            }
-
-            foreach (var property in type.GetProperties())
-            {
-                var attribute = property.GetCustomAttribute<RegisterCustomCosmeticAttribute>();
-                if (attribute == null)
-                {
-                    continue;
-                }
-
-                CustomCosmeticManager.RegisterAttributeOption(type, attribute, property, pluginInfo);
-            }
-        }
-    }
-
     private static void RegisterRoleAttribute(Assembly assembly, MiraPluginInfo pluginInfo)
     {
         List<Type> roles = [];
@@ -196,14 +171,26 @@ public sealed class MiraPluginManager
         }
     }
 
-    private static void RegisterButtonAttribute(Assembly assembly, MiraPluginInfo pluginInfo)
+    private static void RegisterAnimPresetAttribute(Assembly assembly)
+    {
+        foreach (var type in assembly.GetTypes())
+        {
+            var attribute = type.GetCustomAttribute<RegisterAnimationPresetAttribute>();
+            if (attribute != null)
+            {
+                AnimationPresetManager.RegisterPreset(type);
+            }
+        }
+    }
+
+    private static void RegisterButtonAttribute(Assembly assembly)
     {
         foreach (var type in assembly.GetTypes())
         {
             var attribute = type.GetCustomAttribute<RegisterButtonAttribute>();
             if (attribute != null)
             {
-                CustomButtonManager.RegisterButton(type, pluginInfo);
+                CustomButtonManager.RegisterButton(type);
             }
         }
     }

MiraAPI/Roles/CustomRoleConfiguration.cs

@@ -1,130 +0,0 @@
-using AmongUs.GameOptions;
-using MiraAPI.Utilities.Assets;
-using UnityEngine;
-
-namespace MiraAPI.Roles;
-
-/// <summary>
-/// Used to configure the specific settings of a role.
-/// </summary>
-public struct CustomRoleConfiguration
-{
-    /// <summary>
-    /// Initializes a new instance of the <see cref="CustomRoleConfiguration"/> struct.
-    /// </summary>
-    /// <param name="role">The role in which you are configuring.</param>
-    public CustomRoleConfiguration(ICustomRole role)
-    {
-        MaxRoleCount = 15;
-        DefaultRoleCount = 0;
-        DefaultChance = 0;
-
-        OptionsScreenshot = Icon = MiraAssets.Empty;
-        AffectedByLightOnAirship = role.Team == ModdedRoleTeams.Crewmate;
-        KillButtonOutlineColor = role.Team switch
-        {
-            ModdedRoleTeams.Impostor => Palette.ImpostorRed,
-            ModdedRoleTeams.Crewmate => Palette.CrewmateBlue,
-            _ => role.RoleColor,
-        };
-        RoleHintType = RoleHintType.RoleTab;
-        GhostRole = role.Team is ModdedRoleTeams.Impostor ? RoleTypes.ImpostorGhost : RoleTypes.CrewmateGhost;
-        CanGetKilled = !IsGhostRole && role.Team is not ModdedRoleTeams.Impostor;
-        UseVanillaKillButton = role.Team is ModdedRoleTeams.Impostor;
-        CanUseVent = role.Team is ModdedRoleTeams.Impostor;
-        CanUseSabotage = role.Team is ModdedRoleTeams.Impostor;
-        TasksCountForProgress = role.Team is ModdedRoleTeams.Crewmate;
-        IsGhostRole = false;
-        HideSettings = IsGhostRole;
-        CanModifyChance = true;
-    }
-
-#pragma warning disable S1104
-#pragma warning disable CA1051
-    /// <summary>
-    /// Gets the hard limit of players that can have this role. This property is used to set a limit in the Role Options menu. If set to 0, the role will not be assigned at start.
-    /// </summary>
-    public int MaxRoleCount;
-
-    /// <summary>
-    /// Gets the default role count.
-    /// </summary>
-    public int DefaultRoleCount;
-
-    /// <summary>
-    /// Gets the default role chance.
-    /// </summary>
-    public int DefaultChance;
-
-    /// <summary>
-    /// Whether the chance option can be changed or not.
-    /// </summary>
-    public bool CanModifyChance;
-
-    /// <summary>
-    /// Gets the Sprite used for the Role Options menu screenshot.
-    /// </summary>
-    public LoadableAsset<Sprite> OptionsScreenshot;
-
-    /// <summary>
-    /// Gets the Sprite used for the Role Icon.
-    /// </summary>
-    public LoadableAsset<Sprite> Icon;
-
-    /// <summary>
-    /// Gets a value indicating whether the role is affected by light affectors on Airship.
-    /// </summary>
-    public bool AffectedByLightOnAirship;
-
-    /// <summary>
-    /// Gets a value indicating whether the role can be killed by vanilla murder system.
-    /// </summary>
-    public bool CanGetKilled;
-
-    /// <summary>
-    /// Gets a value indicating whether the role should use the vanilla kill button.
-    /// </summary>
-    public bool UseVanillaKillButton;
-
-    /// <summary>
-    /// Gets a value indicating whether the role can use vents.
-    /// </summary>
-    public bool CanUseVent;
-
-    /// <summary>
-    /// Gets a value indicating whether the role can use the sabotage button.
-    /// </summary>
-    public bool CanUseSabotage;
-
-    /// <summary>
-    /// Gets a value indicating whether the role's tasks count towards task progress.
-    /// </summary>
-    public bool TasksCountForProgress;
-
-    /// <summary>
-    /// Gets a value indicating whether the role is a Ghost.
-    /// </summary>
-    public bool IsGhostRole;
-
-    /// <summary>
-    /// Gets a value indicating whether the role should show up in the Role Options menu.
-    /// </summary>
-    public bool HideSettings;
-
-    /// <summary>
-    /// Gets the outline color for the KillButton if <see cref="UseVanillaKillButton"/> is true.
-    /// </summary>
-    public Color KillButtonOutlineColor;
-
-    /// <summary>
-    /// Gets the role hint style. See <see cref="RoleHintType"/> enum for all options.
-    /// </summary>
-    public RoleHintType RoleHintType;
-
-    /// <summary>
-    /// Gets the Ghost role that is applied when the player is killed.
-    /// </summary>
-    public RoleTypes GhostRole;
-#pragma warning restore S1104
-#pragma warning restore CA1051
-}

MiraAPI/Roles/CustomRoleManager.cs

@@ -1,7 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.GameOptions;
+using AmongUs.GameOptions;
 using Il2CppInterop.Runtime;
 using Il2CppInterop.Runtime.Injection;
 using MiraAPI.Networking;
@@ -11,6 +8,9 @@ using Reactor.Localization.Utilities;
 using Reactor.Networking.Rpc;
 using Reactor.Utilities;
 using Reactor.Utilities.Extensions;
+using System;
+using System.Collections.Generic;
+using System.Linq;
 using TMPro;
 using UnityEngine;
 using Object = UnityEngine.Object;
@@ -36,7 +36,7 @@ public static class CustomRoleManager
     {
         RoleManager.Instance.AllRoles = RoleManager.Instance.AllRoles.Concat(CustomRoles.Values).ToArray();
 
-        foreach (var role in CustomRoles.Values.Where(x => x.IsDead))
+        foreach (var role in CustomRoles.Values.Where(x=>x.IsDead))
         {
             RoleManager.GhostRoles.Add(role.Role);
         }
@@ -84,21 +84,21 @@ public static class CustomRoleManager
         roleBehaviour.StringName = CustomStringName.CreateAndRegister(customRole.RoleName);
         roleBehaviour.BlurbName = CustomStringName.CreateAndRegister(customRole.RoleDescription);
         roleBehaviour.BlurbNameLong = CustomStringName.CreateAndRegister(customRole.RoleLongDescription);
-        roleBehaviour.AffectedByLightAffectors = customRole.Configuration.AffectedByLightOnAirship;
-        roleBehaviour.CanBeKilled = customRole.Configuration.CanGetKilled;
-        roleBehaviour.CanUseKillButton = customRole.Configuration.UseVanillaKillButton;
-        roleBehaviour.TasksCountTowardProgress = customRole.Configuration.TasksCountForProgress;
-        roleBehaviour.CanVent = customRole.Configuration.CanUseVent;
-        roleBehaviour.DefaultGhostRole = customRole.Configuration.GhostRole;
-        roleBehaviour.MaxCount = customRole.Configuration.MaxRoleCount;
-        roleBehaviour.RoleScreenshot = customRole.Configuration.OptionsScreenshot.LoadAsset();
+        roleBehaviour.AffectedByLightAffectors = customRole.AffectedByLightOnAirship;
+        roleBehaviour.CanBeKilled = customRole.CanGetKilled;
+        roleBehaviour.CanUseKillButton = customRole.UseVanillaKillButton;
+        roleBehaviour.TasksCountTowardProgress = customRole.TasksCountForProgress;
+        roleBehaviour.CanVent = customRole.CanUseVent;
+        roleBehaviour.DefaultGhostRole = customRole.GhostRole;
+        roleBehaviour.MaxCount = customRole.MaxPlayers;
+        roleBehaviour.RoleScreenshot = customRole.OptionsScreenshot.LoadAsset();
 
-        if (customRole.Configuration.IsGhostRole)
+        if (customRole.IsGhostRole)
         {
             RoleManager.GhostRoles.Add(roleBehaviour.Role);
         }
 
-        var useTaskHint = customRole.Configuration.RoleHintType is RoleHintType.TaskHint;
+        var useTaskHint = customRole.RoleHintType is RoleHintType.TaskHint;
         var overridesTaskText = customRole.GetType().GetMethod("SpawnTaskHeader")?.DeclaringType == customRole.GetType();
 
         if (useTaskHint && !overridesTaskText)
@@ -108,14 +108,14 @@ public static class CustomRoleManager
 
         CustomRoles.Add(roleId, roleBehaviour);
 
-        if (customRole.Configuration.HideSettings)
+        if (customRole.HideSettings)
         {
             return roleBehaviour;
         }
 
         var config = parentMod.PluginConfig;
-        config.Bind(customRole.NumConfigDefinition, Mathf.Clamp(customRole.Configuration.DefaultRoleCount, 0, customRole.Configuration.MaxRoleCount));
-        config.Bind(customRole.ChanceConfigDefinition, Mathf.Clamp(customRole.Configuration.DefaultChance, 0, 100));
+        config.Bind(customRole.NumConfigDefinition, 1);
+        config.Bind(customRole.ChanceConfigDefinition, 100);
 
         return roleBehaviour;
     }
@@ -186,7 +186,7 @@ public static class CustomRoleManager
     internal static void SyncAllRoleSettings(int targetId = -1)
     {
         var data = CustomRoles.Values
-            .Where(x => x is ICustomRole { Configuration.HideSettings: false })
+            .Where(x => x is ICustomRole { HideSettings: false })
             .Select(x => ((ICustomRole)x).GetNetData())
             .ChunkNetData(1000);
 
@@ -216,7 +216,7 @@ public static class CustomRoleManager
             }
 
             var customRole = role as ICustomRole;
-            if (customRole is null or { Configuration.HideSettings: true })
+            if (customRole is null or { HideSettings: true })
             {
                 continue;
             }
@@ -224,12 +224,19 @@ public static class CustomRoleManager
             var num = BitConverter.ToInt32(netData.Data, 0);
             var chance = BitConverter.ToInt32(netData.Data, 4);
 
-            HudManager.Instance.Notifier.AddRoleSettingsChangeMessage(role.StringName, num, chance, role.TeamType, false);
+            DestroyableSingleton<HudManager>.Instance.Notifier.AddRoleSettingsChangeMessage(role.StringName, num, chance, role.TeamType, false);
 
             try
             {
-                customRole.SetCount(num);
-                customRole.SetChance(chance);
+                customRole.ParentMod.PluginConfig.TryGetEntry<int>(
+                    customRole.NumConfigDefinition,
+                    out var numEntry);
+                customRole.ParentMod.PluginConfig.TryGetEntry<int>(
+                    customRole.ChanceConfigDefinition,
+                    out var chanceEntry);
+
+                numEntry.Value = num;
+                chanceEntry.Value = chance;
             }
             catch (Exception e)
             {

MiraAPI/Roles/CustomRoleSingleton.cs

@@ -1,19 +0,0 @@
-using System.Linq;
-
-namespace MiraAPI.Roles;
-
-/// <summary>
-/// A utility class to get the instance of a custom role.
-/// </summary>
-/// <typeparam name="T">The role you are trying to access.</typeparam>
-public static class CustomRoleSingleton<T> where T : ICustomRole
-{
-    private static T? _instance;
-
-    /// <summary>
-    /// Gets the instance of the role.
-    /// </summary>
-#pragma warning disable CA1000
-    public static ICustomRole Instance => _instance ??= CustomRoleManager.CustomRoles.Values.OfType<T>().Single();
-#pragma warning restore CA1000
-}

MiraAPI/Roles/ICustomRole.cs

@@ -1,9 +1,11 @@
 using System.Text;
+using AmongUs.GameOptions;
 using BepInEx.Configuration;
+using Il2CppInterop.Runtime.Attributes;
 using MiraAPI.Modifiers;
 using MiraAPI.PluginLoading;
 using MiraAPI.Utilities;
-using Reactor.Utilities;
+using MiraAPI.Utilities.Assets;
 using UnityEngine;
 
 namespace MiraAPI.Roles;
@@ -39,9 +41,86 @@ public interface ICustomRole
     ModdedRoleTeams Team { get; }
 
     /// <summary>
-    /// Gets the advanced settings of the role.
+    /// Gets the hard limit of players that can have this role. This property is used to set a limit in the Role Options menu.
     /// </summary>
-    CustomRoleConfiguration Configuration { get; }
+    int MaxPlayers => 15;
+
+    /// <summary>
+    /// Gets the Sprite used for the Role Options menu screenshot.
+    /// </summary>
+    [HideFromIl2Cpp]
+    LoadableAsset<Sprite> OptionsScreenshot => MiraAssets.Empty;
+
+    /// <summary>
+    /// Gets the Sprite used for the Role Icon.
+    /// </summary>
+    [HideFromIl2Cpp]
+    LoadableAsset<Sprite> Icon => MiraAssets.Empty;
+
+    /// <summary>
+    /// Gets a value indicating whether the role is affected by light affectors on Airship.
+    /// </summary>
+    bool AffectedByLightOnAirship => Team == ModdedRoleTeams.Crewmate;
+
+    /// <summary>
+    /// Gets a value indicating whether the role can be killed by vanilla murder system.
+    /// </summary>
+    bool CanGetKilled => Team == ModdedRoleTeams.Crewmate;
+
+    /// <summary>
+    /// Gets a value indicating whether the role should use the vanilla kill button.
+    /// </summary>
+    bool UseVanillaKillButton => Team == ModdedRoleTeams.Impostor;
+
+    /// <summary>
+    /// Gets a value indicating whether the role can use vents.
+    /// </summary>
+    bool CanUseVent => Team == ModdedRoleTeams.Impostor;
+
+    /// <summary>
+    /// Gets a value indicating whether the role's tasks count towards task progress.
+    /// </summary>
+    bool TasksCountForProgress => Team == ModdedRoleTeams.Crewmate;
+
+    /// <summary>
+    /// Gets a value indicating whether the role is a Ghost.
+    /// </summary>
+    bool IsGhostRole => false;
+
+    /// <summary>
+    /// Gets a value indicating whether the role should show up in the Role Options menu.
+    /// </summary>
+    bool HideSettings => IsGhostRole;
+
+    /// <summary>
+    /// Gets the outline color for the KillButton if <see cref="UseVanillaKillButton"/> is true.
+    /// </summary>
+    Color KillButtonOutlineColor => Team switch
+    {
+        ModdedRoleTeams.Impostor => Palette.ImpostorRed,
+        ModdedRoleTeams.Crewmate => Palette.CrewmateBlue,
+        _ => RoleColor,
+    };
+
+    /// <summary>
+    /// Gets the role hint style. See <see cref="RoleHintType"/> enum for all options.
+    /// </summary>
+    RoleHintType RoleHintType => RoleHintType.RoleTab;
+
+    /// <summary>
+    /// Gets the Ghost role that is applied when the player is killed.
+    /// </summary>
+    RoleTypes GhostRole => Team == ModdedRoleTeams.Impostor ? RoleTypes.ImpostorGhost : RoleTypes.CrewmateGhost;
+
+    /// <summary>
+    /// Gets the BepInEx ConfigDefinition for the amount of players that can have this role.
+    /// </summary>
+    ConfigDefinition NumConfigDefinition => new("Roles", $"Num {GetType().FullName}");
+
+    /// <summary>
+    /// Gets the BepInEx ConfigDefinition for the chance of this role being selected.
+    /// </summary>
+    ConfigDefinition ChanceConfigDefinition => new("Roles", $"Chance {GetType().FullName}");
 
     /// <summary>
     /// Gets the parent mod of this role.
@@ -56,78 +135,6 @@ public interface ICustomRole
     {
     }
 
-    internal ConfigDefinition NumConfigDefinition => new("Roles", $"Num {GetType().FullName}");
-    internal ConfigDefinition ChanceConfigDefinition => new("Roles", $"Chance {GetType().FullName}");
-
-    /// <summary>
-    /// Gets the role chance option.
-    /// </summary>
-    /// <returns>The role chance option.</returns>
-    public int? GetChance()
-    {
-        if (!Configuration.CanModifyChance)
-        {
-            return Configuration.DefaultChance;
-        }
-
-        if (ParentMod.PluginConfig.TryGetEntry(ChanceConfigDefinition, out ConfigEntry<int> entry))
-        {
-            return Mathf.Clamp(entry.Value, 0, 100);
-        }
-
-        return null;
-    }
-
-    /// <summary>
-    /// Gets the role count option.
-    /// </summary>
-    /// <returns>The role count option.</returns>
-    public int? GetCount()
-    {
-        if (ParentMod.PluginConfig.TryGetEntry(NumConfigDefinition, out ConfigEntry<int> entry))
-        {
-            return Mathf.Clamp(entry.Value, 0, Configuration.MaxRoleCount);
-        }
-
-        return null;
-    }
-
-    /// <summary>
-    /// Sets the role chance option.
-    /// </summary>
-    /// <param name="chance">The chance between 0 and 100.</param>
-    public void SetChance(int chance)
-    {
-        if (!Configuration.CanModifyChance)
-        {
-            Logger<MiraApiPlugin>.Error($"Cannot modify chance for role: {RoleName}");
-            return;
-        }
-
-        if (ParentMod.PluginConfig.TryGetEntry(ChanceConfigDefinition, out ConfigEntry<int> entry))
-        {
-            entry.Value = Mathf.Clamp(chance, 0, 100);
-            return;
-        }
-
-        Logger<MiraApiPlugin>.Error($"Error getting chance configuration for role: {RoleName}");
-    }
-
-    /// <summary>
-    /// Sets the role count option.
-    /// </summary>
-    /// <param name="count">The amount of this role between zero and its MaxRoleCount in the Configuration.</param>
-    public void SetCount(int count)
-    {
-        if (ParentMod.PluginConfig.TryGetEntry(NumConfigDefinition, out ConfigEntry<int> entry))
-        {
-            entry.Value = Mathf.Clamp(count, 0, Configuration.MaxRoleCount);
-            return;
-        }
-
-        Logger<MiraApiPlugin>.Error($"Error getting count configuration for role: {RoleName}");
-    }
-
     /// <summary>
     /// This method runs on the HudManager.Update method ONLY when the LOCAL player has this role.
     /// </summary>

MiraAPI/Roles/RoleHintType.cs

@@ -16,7 +16,7 @@ public enum RoleHintType
     TaskHint,
 
     /// <summary>
-    /// Use Mira's custom role tab.
+    /// Use custom role tab.
     /// </summary>
     RoleTab,
 }

MiraAPI/Utilities/Assets/Addressable/Catalog.cs

@@ -1,52 +0,0 @@
-using System.Collections;
-using BepInEx.Unity.IL2CPP.Utils.Collections;
-using Reactor.Utilities;
-using UnityEngine.AddressableAssets;
-using UnityEngine.AddressableAssets.ResourceLocators;
-using UnityEngine.ResourceManagement.AsyncOperations;
-
-namespace MiraAPI.Utilities.Assets.Addressable;
-
-/// <summary>
-/// Catalogs are a representation of resource locators for the Unity Addressables api.
-/// </summary>
-public class Catalog(string CatalogPath)
-{
-    /// <summary>
-    /// Loads the catalog asynchronously.
-    /// </summary>
-    public void LoadCatalogAsync()
-    {
-        Coroutines.Start(LoadCatalogAsynchronously());
-    }
-
-    /// <summary>
-    /// Loads the catalog. This must be done before you can call any addressables.
-    /// </summary>
-    public void LoadCatalog()
-    {
-        Addressables.LoadContentCatalog(CatalogPath).WaitForCompletion();
-    }
-
-    /// <summary>
-    /// Updates the network catalogs.
-    /// </summary>
-    public void UpdateNetworkCatalog()
-    {
-        Coroutines.Start(UpdateCatalog());
-    }
-    protected IEnumerator LoadCatalogAsynchronously()
-    {
-        AsyncOperationHandle<IResourceLocator> handle = Addressables.LoadContentCatalogAsync(CatalogPath, true);
-        yield return handle;
-    }
-    protected IEnumerator UpdateCatalog()
-    {
-        string[] toUpdate = { CatalogPath };
-        var catalogs = toUpdate.WrapToIl2Cpp().Cast<Il2CppSystem.Collections.Generic.IEnumerable<string>>();
-        var updateHandle = Addressables.UpdateCatalogs(catalogs);
-
-        yield return updateHandle;
-        updateHandle.Release();
-    }
-}

MiraAPI/Utilities/Assets/Addressable/CatalogTools.cs

@@ -1,42 +0,0 @@
-using System.IO;
-using BepInEx.Unity.IL2CPP.Utils.Collections;
-using UnityEngine.AddressableAssets;
-
-namespace MiraAPI.Utilities.Assets.Addressable;
-
-/// <summary>
-/// A utility class for various catalog-related operations.
-/// </summary>
-public static class CatalogTools
-{
-    /// <summary>
-    /// Converts string filenames to catalog paths within the plugins folder.
-    /// </summary>
-    /// <param name="fileName">A string of the catalog file without the extension.</param>
-    /// <returns>The path to the catalog file.</returns>
-    public static string ToLocalPath(this string fileName)
-    {
-        return Path.GetDirectoryName(typeof(MiraApiPlugin).Assembly.Location) + $"\\{fileName}.catalog";
-    }
-
-    /// <summary>
-    /// Finds the resource locations of a specific label.
-    /// </summary>
-    /// <param name="label">The label of the addressables assets.</param>
-    /// <returns>An IList of IResourceLocation.</returns>
-    public static Il2CppSystem.Collections.Generic.IList<UnityEngine.ResourceManagement.ResourceLocations.IResourceLocation> GetResourceLocation(string label)
-    {
-        return Addressables.LoadResourceLocationsAsync(label).WaitForCompletion();
-    }
-
-    /// <summary>
-    /// Finds the resource locations of multiple specific labels.
-    /// </summary>
-    /// <param name="labels">The label of the addressables assets.</param>
-    /// <returns>An IList of IResourceLocation.</returns>
-    public static Il2CppSystem.Collections.Generic.IList<UnityEngine.ResourceManagement.ResourceLocations.IResourceLocation> GetResourceLocations(string[] labels)
-    {
-        var il2CPPLabels = new Il2CppSystem.Collections.Generic.IList<Il2CppSystem.Object>(labels.WrapToIl2Cpp().Pointer);
-        return Addressables.LoadResourceLocationsAsync(il2CPPLabels, Addressables.MergeMode.Union).WaitForCompletion();
-    }
-}

MiraAPI/Utilities/Assets/Addressable/WaitForAsyncOperationHandleFinish.cs

@@ -1,21 +0,0 @@
-using System.Collections;
-using UnityEngine;
-using UnityEngine.ResourceManagement.AsyncOperations;
-
-namespace MiraAPI.Utilities.Assets.Addressable;
-
-/// <summary>
-/// An IEnumerator for awaiting an AsyncOperationHandle.
-/// </summary>.
-/// <param name="handle">The AsyncOperationHandle being awaited.</param>
-public class WaitForAsyncOperationHandleFinish(AsyncOperationHandle handle) : IEnumerator
-{
-    public object Current => null;
-    public bool MoveNext()
-    {
-        return !Mathf.Approximately(handle.PercentComplete, 1.0f) && !handle.IsDone;
-    }
-    public void Reset()
-    {
-    }
-}

MiraAPI/Utilities/Assets/LoadableAddressableAsset.cs

@@ -1,34 +0,0 @@
-using System;
-using UnityEngine.AddressableAssets;
-
-namespace MiraAPI.Utilities.Assets;
-
-/// <summary>
-/// A utility class for loading assets from the addressables api.
-/// </summary>
-/// <param name="name">The name/identifier of the asset.</param>
-/// <typeparam name="T">The type of the asset to be loaded.</typeparam>
-public class LoadableAddressableAsset<T>(string name) : LoadableAsset<T> where T : UnityEngine.Object
-{
-    /// <summary>
-    /// Loads the asset from the addressables api.
-    /// </summary>
-    /// <returns>The asset.</returns>
-    /// <exception cref="Exception">The asset did not load properly.</exception>
-    public override T LoadAsset()
-    {
-        if (LoadedAsset != null)
-        {
-            return LoadedAsset;
-        }
-
-        LoadedAsset = Addressables.LoadAssetAsync<T>(name).WaitForCompletion();
-
-        if (LoadedAsset == null)
-        {
-            throw new InvalidOperationException($"INVALID ASSET: {name}");
-        }
-
-        return LoadedAsset;
-    }
-}

MiraAPI/Utilities/Assets/LoadableAddressablesGroupAsset.cs

@@ -1,42 +0,0 @@
-using System;
-using System.Collections.Generic;
-using UnityEngine.AddressableAssets;
-
-namespace MiraAPI.Utilities.Assets;
-
-/// <summary>
-/// A utility class for loading multiple assets from the addressables api.
-/// </summary>
-/// <param name="locations">A list of IResourceLocations that locate the assets.</param>
-/// <typeparam name="T">The type of the assets to be loaded.</typeparam>
-public class LoadableAddressableGroupAsset<T>(Il2CppSystem.Collections.Generic.IList<UnityEngine.ResourceManagement.ResourceLocations.IResourceLocation> locations) where T : UnityEngine.Object
-{
-    /// <summary>
-    /// Gets or sets a reference to the loaded assets. Intended to be used for caching purposes.
-    /// </summary>
-    protected List<T> LoadedAsset { get; set; } = [];
-
-    /// <summary>
-    /// Loads the assets from the addressables api.
-    /// </summary>
-    /// <returns>The assets.</returns>
-    /// <exception cref="Exception">The asset did not load properly.</exception>
-    public List<T> LoadAsset()
-    {
-        if (LoadedAsset.Count != 0)
-        {
-            return LoadedAsset;
-        }
-
-        var assets = Addressables.LoadAssetsAsync<T>(locations, null, false).WaitForCompletion();
-        var array = new Il2CppSystem.Collections.Generic.List<T>(assets.Pointer);
-        LoadedAsset = [..array.ToArray()];
-
-        if (LoadedAsset is null || LoadedAsset.Count == 0)
-        {
-            throw new InvalidOperationException("INVALID ASSET LOCATION/s");
-        }
-
-        return LoadedAsset;
-    }
-}

MiraAPI/Utilities/Assets/LoadableBundleAsset.cs

@@ -1,5 +1,6 @@
-using System;
+using MiraAPI.PluginLoading;
 using Reactor.Utilities.Extensions;
+using System;
 using UnityEngine;
 
 namespace MiraAPI.Utilities.Assets;
@@ -10,8 +11,30 @@ namespace MiraAPI.Utilities.Assets;
 /// <param name="name">The name of the asset.</param>
 /// <param name="bundle">The AssetBundle that contains the asset.</param>
 /// <typeparam name="T">The type of the asset to be loaded.</typeparam>
-public class LoadableBundleAsset<T>(string name, AssetBundle bundle) : LoadableAsset<T> where T : UnityEngine.Object
+public class LoadableBundleAsset<T> : LoadableAsset<T> where T : UnityEngine.Object
 {
+
+    /// <summary>
+    /// Gets the ID of this asset. Used for networking.
+    /// </summary>
+    public uint AssetId { get; internal set; }
+    private string _name { get; }
+    private AssetBundle _bundle { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="LoadableBundleAsset{T}"/> class.
+    /// </summary>
+    /// <param name="name">Name of the bundle.</param>
+    /// <param name="bundle">Asset bundle.</param>
+    public LoadableBundleAsset(string name, AssetBundle bundle)
+    {
+        AssetId = MiraPluginManager.Instance.GetNextAssetId();
+        //MiraPluginManager.Instance.BundleAssets.Add((LoadableBundleAsset<Object>)this);
+
+        _name = name;
+        _bundle = bundle;
+    }
+
     /// <summary>
     /// Loads the asset from the asset bundle.
     /// </summary>
@@ -24,11 +47,11 @@ public class LoadableBundleAsset<T>(string name, AssetBundle bundle) : LoadableA
             return LoadedAsset;
         }
 
-        LoadedAsset = bundle.LoadAsset<T>(name);
+        LoadedAsset = _bundle.LoadAsset<T>(_name);
 
         if (LoadedAsset == null)
         {
-            throw new InvalidOperationException($"INVALID ASSET: {name}");
+            throw new InvalidOperationException($"INVALID ASSET: {_name}");
         }
 
         return LoadedAsset;

MiraAPI/Utilities/Assets/LoadableResourceAsset.cs

@@ -7,7 +7,7 @@ namespace MiraAPI.Utilities.Assets;
 /// A utility class for loading assets from embedded resources.
 /// </summary>
 /// <param name="path">The path to the embedded resource.</param>
-public class LoadableResourceAsset(string path, float pixelsPerUnit=100f) : LoadableAsset<Sprite>
+public class LoadableResourceAsset(string path) : LoadableAsset<Sprite>
 {
     private readonly Assembly _assembly = Assembly.GetCallingAssembly();
 
@@ -19,6 +19,6 @@ public class LoadableResourceAsset(string path, float pixelsPerUnit=100f) : Load
             return LoadedAsset;
         }
 
-        return LoadedAsset = SpriteTools.LoadSpriteFromPath(path, _assembly, pixelsPerUnit);
+        return LoadedAsset = SpriteTools.LoadSpriteFromPath(path, _assembly);
     }
 }

MiraAPI/Utilities/Assets/SpriteTools.cs

@@ -39,7 +39,7 @@ public static class SpriteTools
     /// <param name="resourcePath">The path to the resource.</param>
     /// <returns>A sprite made from the resource.</returns>
     /// <exception cref="Exception">The resource cannot be found.</exception>
-    public static Sprite LoadSpriteFromPath(string resourcePath, Assembly assembly, float pixelsPerUnit)
+    public static Sprite LoadSpriteFromPath(string resourcePath, Assembly assembly)
     {
         var tex = new Texture2D(1, 1, TextureFormat.ARGB32, false);
         var myStream = assembly.GetManifestResourceStream(resourcePath);
@@ -53,6 +53,6 @@ public static class SpriteTools
             Logger<MiraApiPlugin>.Error($"Resource not found: {resourcePath}\nReturning empty sprite!");
         }
 
-        return Sprite.Create(tex, new Rect(0, 0, tex.width, tex.height), new Vector2(0.5f, 0.5f), pixelsPerUnit);
+        return Sprite.Create(tex, new Rect(0, 0, tex.width, tex.height), new Vector2(0.5f, 0.5f));
     }
 }

MiraAPI/Utilities/Extensions.cs

@@ -1,13 +1,14 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
 using HarmonyLib;
+using MiraAPI.Animations;
 using MiraAPI.GameOptions;
 using MiraAPI.Modifiers;
 using MiraAPI.Networking;
 using MiraAPI.Roles;
 using Reactor.Networking.Attributes;
 using Reactor.Utilities;
+using System;
+using System.Collections.Generic;
+using System.Linq;
 using UnityEngine;
 
 namespace MiraAPI.Utilities;
@@ -19,24 +20,10 @@ public static class Extensions
 {
     internal static NetData GetNetData(this ICustomRole role)
     {
-        var count = role.GetCount();
-        var chance = role.GetChance();
+        role.ParentMod.PluginConfig.TryGetEntry<int>(role.NumConfigDefinition, out var numEntry);
+        role.ParentMod.PluginConfig.TryGetEntry<int>(role.ChanceConfigDefinition, out var chanceEntry);
 
-        if (count == null)
-        {
-            Logger<MiraApiPlugin>.Error("Couldn't get role count for NetData, defaulting to zero.");
-            count = 0;
-        }
-
-        if (chance == null)
-        {
-            Logger<MiraApiPlugin>.Error("Couldn't get role chance for NetData, defaulting to zero.");
-            chance = 0;
-        }
-
-        return new NetData(
-            RoleId.Get(role.GetType()),
-            BitConverter.GetBytes(count.Value).AddRangeToArray(BitConverter.GetBytes(chance.Value)));
+        return new NetData(RoleId.Get(role.GetType()), BitConverter.GetBytes(numEntry.Value).AddRangeToArray(BitConverter.GetBytes(chanceEntry.Value)));
     }
 
     /// <summary>
@@ -126,11 +113,11 @@ public static class Extensions
     /// <returns>True if the OptionBehaviour is for a custom options, false otherwise.</returns>
     public static bool IsCustom(this OptionBehaviour optionBehaviour)
     {
-        return ModdedOptionsManager.ModdedOptions.Values.Any(
-            opt => opt.OptionBehaviour && opt.OptionBehaviour == optionBehaviour);
+        return ModdedOptionsManager.ModdedOptions.Values.Any(opt => opt.OptionBehaviour && opt.OptionBehaviour == optionBehaviour);
     }
 
-    internal static Dictionary<PlayerControl, ModifierComponent> ModifierComponents { get; } = [];
+    private static readonly Dictionary<PlayerControl, ModifierComponent> ModifierComponents = [];
+    private static readonly Dictionary<PlayerControl, CustomAnimator> AnimatorComponents = [];
 
     /// <summary>
     /// Gets the ModifierComponent for a player.
@@ -145,12 +132,32 @@ public static class Extensions
         }
 
         component = player.GetComponent<ModifierComponent>();
-        if (component == null)
+        if (component)
         {
-            return null;
+            ModifierComponents[player] = component;
+        }
+
+        return component;
+    }
+
+    /// <summary>
+    /// Gets the CustomAnimator for a player.
+    /// </summary>
+    /// <param name="player">The PlayerControl object.</param>
+    /// <returns>A CustomAnimator if there is one, null otherwise.</returns>
+    public static CustomAnimator? GetCustomAnimator(this PlayerControl player)
+    {
+        if (AnimatorComponents.TryGetValue(player, out var component))
+        {
+            return component;
+        }
+
+        component = player.GetComponent<CustomAnimator>();
+        if (component)
+        {
+            AnimatorComponents[player] = component;
         }
 
-        ModifierComponents[player] = component;
         return component;
     }
 
@@ -170,7 +177,6 @@ public static class Extensions
             randomizedList.Add(list[index]);
             list.RemoveAt(index);
         }
-
         return randomizedList;
     }
 
@@ -193,8 +199,7 @@ public static class Extensions
     /// <returns>True if the Modifier is present, false otherwise.</returns>
     public static bool HasModifier<T>(this PlayerControl? player) where T : BaseModifier
     {
-        return player?.GetModifierComponent() != null &&
-               player.GetModifierComponent()!.ActiveModifiers.Exists(x => x is T);
+        return player?.GetModifierComponent() != null && player.GetModifierComponent()!.ActiveModifiers.Exists(x => x is T);
     }
 
     /// <summary>
@@ -205,8 +210,7 @@ public static class Extensions
     /// <returns>True if the Modifier is present, false otherwise.</returns>
     public static bool HasModifier(this PlayerControl? player, uint id)
     {
-        return player?.GetModifierComponent() != null &&
-               player.GetModifierComponent()!.ActiveModifiers.Exists(x => x.ModifierId == id);
+        return player?.GetModifierComponent() != null && player.GetModifierComponent()!.ActiveModifiers.Exists(x => x.ModifierId == id);
     }
 
     /// <summary>
@@ -252,7 +256,6 @@ public static class Extensions
             Logger<MiraApiPlugin>.Error($"Cannot add modifier with id {modifierId} because it is not registered.");
             return;
         }
-
         target.GetModifierComponent()?.AddModifier(type);
     }
 
@@ -324,9 +327,7 @@ public static class Extensions
     /// <returns>The dead body if it is found, or null there is none within the radius.</returns>
     public static DeadBody? GetNearestDeadBody(this PlayerControl playerControl, float radius)
     {
-        return Helpers
-            .GetNearestDeadBodies(playerControl.GetTruePosition(), radius, Helpers.CreateFilter(Constants.NotShipMask))
-            .Find(component => component && !component.Reported);
+        return Helpers.GetNearestDeadBodies(playerControl.GetTruePosition(), radius).Find(component => component && !component.Reported);
     }
 
     /// <summary>
@@ -334,46 +335,29 @@ public static class Extensions
     /// </summary>
     /// <param name="playerControl">The player object.</param>
     /// <param name="radius">The radius to search within.</param>
-    /// <param name="filter">The contact filter.</param>
     /// <param name="colliderTag">An optional collider tag.</param>
     /// <param name="predicate">Optional predicate to test if the object is valid.</param>
     /// <typeparam name="T">The type of the object.</typeparam>
     /// <returns>The object if it was found, or null if there is none within the radius.</returns>
-    public static T? GetNearestObjectOfType<T>(
-        this PlayerControl playerControl,
-        float radius,
-        ContactFilter2D filter,
-        string? colliderTag = null,
-        Predicate<T>? predicate = null) where T : Component
+    public static T? GetNearestObjectOfType<T>(this PlayerControl playerControl, float radius, string? colliderTag = null, Predicate<T>? predicate = null) where T : Component
     {
-        return Helpers.GetNearestObjectsOfType<T>(playerControl.GetTruePosition(), radius, filter, colliderTag)
-            .Find(predicate ?? (component => component));
+        return Helpers.GetNearestObjectsOfType<T>(playerControl.GetTruePosition(), radius, colliderTag).Find(predicate ?? (component => component));
     }
 
     /// <summary>
-    /// Gets the closest player that matches the given criteria.
+    /// Gets the nearest player to a player.
     /// </summary>
     /// <param name="playerControl">The player object.</param>
     /// <param name="includeImpostors">Whether impostors should be included in the search.</param>
     /// <param name="distance">The radius to search within.</param>
     /// <param name="ignoreColliders">Whether colliders should be ignored when searching.</param>
-    /// <param name="predicate">Optional predicate to test if the object is valid.</param>
     /// <returns>The closest player if there is one, false otherwise.</returns>
-    public static PlayerControl? GetClosestPlayer(
-        this PlayerControl playerControl,
-        bool includeImpostors,
-        float distance,
-        bool ignoreColliders = false,
-        Predicate<PlayerControl>? predicate = null)
+    public static PlayerControl? GetClosestPlayer(this PlayerControl playerControl, bool includeImpostors, float distance, bool ignoreColliders = false)
     {
         var filteredPlayers = Helpers.GetClosestPlayers(playerControl, distance, ignoreColliders)
-            .Where(
-                playerInfo => !playerInfo.Data.Disconnected &&
-                              playerInfo.PlayerId != playerControl.PlayerId &&
-                              !playerInfo.Data.IsDead &&
-                              (includeImpostors || !playerInfo.Data.Role.IsImpostor))
-            .ToList();
+            .Where(playerInfo => !playerInfo.Data.Disconnected && playerInfo.PlayerId != playerControl.PlayerId && !playerInfo.Data.IsDead &&
+                                 (includeImpostors || !playerInfo.Data.Role.IsImpostor));
 
-        return predicate != null ? filteredPlayers.Find(predicate) : filteredPlayers.FirstOrDefault();
+        return filteredPlayers.FirstOrDefault();
     }
 }

MiraAPI/Utilities/Helpers.cs

@@ -1,8 +1,8 @@
-using System.Collections.Generic;
+using MiraAPI.Roles;
+using System.Collections.Generic;
 using System.Globalization;
 using System.Linq;
 using System.Text;
-using MiraAPI.Roles;
 using TMPro;
 using UnityEngine;
 using Object = UnityEngine.Object;
@@ -15,14 +15,12 @@ namespace MiraAPI.Utilities;
 public static class Helpers
 {
     /// <summary>
-    /// Creates a ContactFilter2D from a layer mask.
+    /// NotShipMask filter for collisions.
     /// </summary>
-    /// <param name="layerMask">The layer mask.</param>
-    /// <returns>A new ContactFilter2D that represents the layer mask.</returns>
-    public static ContactFilter2D CreateFilter(int layerMask)
-    {
-        return ContactFilter2D.CreateLegacyFilter(layerMask, float.MinValue, float.MaxValue);
-    }
+    public static readonly ContactFilter2D Filter = ContactFilter2D.CreateLegacyFilter(
+        Constants.NotShipMask,
+        float.MinValue,
+        float.MaxValue);
 
     /// <summary>
     /// Get the room at a specific position.
@@ -39,12 +37,11 @@ public static class Helpers
     /// </summary>
     /// <param name="source">The source location.</param>
     /// <param name="radius">The radius to search in.</param>
-    /// <param name="filter">The contact filter.</param>
     /// <returns>A list of dead bodies.</returns>
-    public static List<DeadBody> GetNearestDeadBodies(Vector2 source, float radius, ContactFilter2D filter)
+    public static List<DeadBody> GetNearestDeadBodies(Vector2 source, float radius)
     {
         var results = new Il2CppSystem.Collections.Generic.List<Collider2D>();
-        Physics2D.OverlapCircle(source, radius, filter, results);
+        Physics2D.OverlapCircle(source, radius, Filter, results);
         return results.ToArray()
             .Where(collider2D => collider2D.CompareTag("DeadBody"))
             .Select(collider2D => collider2D.GetComponent<DeadBody>()).ToList();
@@ -55,15 +52,14 @@ public static class Helpers
     /// </summary>
     /// <param name="source">The source point.</param>
     /// <param name="radius">The radius to search in.</param>
-    /// <param name="filter">The contact filter.</param>
     /// <param name="colliderTag">An optional collider tag.</param>
     /// <typeparam name="T">The type of the object.</typeparam>
     /// <returns>A list of objects of type T.</returns>
-    public static List<T> GetNearestObjectsOfType<T>(Vector2 source, float radius, ContactFilter2D filter, string? colliderTag = null)
+    public static List<T> GetNearestObjectsOfType<T>(Vector2 source, float radius, string? colliderTag = null)
         where T : Component
     {
         var results = new Il2CppSystem.Collections.Generic.List<Collider2D>();
-        Physics2D.OverlapCircle(source, radius, filter, results);
+        Physics2D.OverlapCircle(source, radius, Filter, results);
         return results.ToArray()
             .Where(collider2D => colliderTag == null || collider2D.CompareTag(colliderTag))
             .Select(collider2D => collider2D.GetComponent<T>()).ToList();
@@ -81,7 +77,7 @@ public static class Helpers
         float radius,
         bool ignoreColliders = true)
     {
-        var newList = GetNearestObjectsOfType<PlayerControl>(source, radius, CreateFilter(Constants.NotShipMask));
+        var newList = GetNearestObjectsOfType<PlayerControl>(source, radius);
 
         if (!ignoreColliders)
         {

README.md

@@ -23,8 +23,6 @@ To start using Mira API, you need to:
 2. Add a BepInDependency on your plugin class like this: `[BepInDependency(MiraApiPlugin.Id)]`
 3. Implement the IMiraPlugin interface on your plugin class.
 
-Mira API also depends on [Reactor](https://github.com/NuclearPowered/Reactor) in order to function properly! Do not forget to include it as a reference and `BepInDependency`!
-
 For a full example, see [this file](https://github.com/All-Of-Us-Mods/MiraAPI/blob/master/MiraAPI.Example/ExamplePlugin.cs).
 
 ## Recommended Project Structure