New events & extensions

Modifier assignment priority 2

.github/workflows/main.yaml

@@ -6,11 +6,11 @@ jobs:
   build:
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           submodules: true
 
-      - uses: actions/cache@v3
+      - uses: actions/cache@v4
         with:
           path: |
             ~/.nuget/packages
@@ -20,7 +20,7 @@ jobs:
             ${{ runner.os }}-nuget-
 
       - name: Setup .NET
-        uses: actions/setup-dotnet@v3
+        uses: actions/setup-dotnet@v4
         with:
           dotnet-version: 8.0.x
 
@@ -29,17 +29,17 @@ jobs:
         with:
           verbosity: Diagnostic
 
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: MiraAPI.dll
           path: MiraAPI/bin/Release/net6.0/MiraAPI.dll
 
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: AllOfUs.MiraAPI.nupkg
           path: MiraAPI/bin/Release/AllOfUs.MiraAPI.*.nupkg
           
-      - uses: softprops/action-gh-release@v1
+      - uses: softprops/action-gh-release@v2
         if: github.ref_type == 'tag'
         with:
           draft: true

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.10.29" 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" />

MiraAPI.Example/Buttons/Freezer/FreezeButton.cs

@@ -13,9 +13,11 @@ namespace MiraAPI.Example.Buttons.Freezer;
 public class FreezeButton : CustomActionButton<PlayerControl>
 {
     public override string Name => "Freeze";
+
     public override float Cooldown => OptionGroupSingleton<FreezerRoleSettings>.Instance.FreezeDuration;
-    public override float EffectDuration => 0f;
+
     public override int MaxUses => (int)OptionGroupSingleton<FreezerRoleSettings>.Instance.FreezeUses;
+
     public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
 
     protected override void OnClick()

MiraAPI.Example/Buttons/MeetingButton.cs

@@ -13,8 +13,6 @@ public class MeetingButton : CustomActionButton
 
     public override float Cooldown => 15;
 
-    public override float EffectDuration => 0;
-
     public override int MaxUses => 3;
 
     public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;

MiraAPI.Example/Buttons/Teleporter/TeleportButton.cs

@@ -1,13 +1,14 @@
-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;
+
 [RegisterButton]
 public class TeleportButton : CustomActionButton
 {
@@ -17,15 +18,15 @@ public class TeleportButton : CustomActionButton
 
     public override float EffectDuration => OptionGroupSingleton<TeleporterOptions>.Instance.TeleportDuration;
 
-    public override int MaxUses => 0;
-
     public override LoadableAsset<Sprite> Sprite => ExampleAssets.TeleportButton;
+
     public static bool IsZoom { get; private set; }
 
     public override bool Enabled(RoleBehaviour? role)
     {
         return role is TeleporterRole;
     }
+
     protected override void OnClick()
     {
         Coroutines.Start(ZoomOutCoroutine());
@@ -40,10 +41,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/ExampleEventHandlers.cs

@@ -0,0 +1,59 @@
+using MiraAPI.Events;
+using MiraAPI.Events.Mira;
+using MiraAPI.Events.Vanilla.Gameplay;
+using MiraAPI.Events.Vanilla.Map;
+using MiraAPI.Events.Vanilla.Player;
+using MiraAPI.Example.Buttons.Freezer;
+using Reactor.Utilities;
+
+namespace MiraAPI.Example;
+
+public static class ExampleEventHandlers
+{
+    public static void Initialize()
+    {
+        // Register event handlers here
+        MiraEventManager.RegisterEventHandler<MiraButtonClickEvent<FreezeButton>>(FreezeButtonClickHandler, 1);
+        MiraEventManager.RegisterEventHandler<MiraButtonCancelledEvent<FreezeButton>>(FreezeButtonCancelledHandler);
+        MiraEventManager.RegisterEventHandler<UpdateSystemEvent>(UpdateSystemEventHandler);
+
+        MiraEventManager.RegisterEventHandler<BeforeMurderEvent>(@event =>
+        {
+            Logger<ExamplePlugin>.Info($"{@event.Source.Data.PlayerName} is about to kill {@event.Target.Data.PlayerName}");
+        });
+
+        MiraEventManager.RegisterEventHandler<AfterMurderEvent>(@event =>
+        {
+            Logger<ExamplePlugin>.Info($"{@event.Source.Data.PlayerName} has killed {@event.Target.Data.PlayerName}");
+        });
+
+        MiraEventManager.RegisterEventHandler<CompleteTaskEvent>(@event =>
+        {
+            Logger<ExamplePlugin>.Info($"{@event.Player.Data.PlayerName} completed {@event.Task.TaskType.ToString()}");
+        });
+    }
+
+    public static void UpdateSystemEventHandler(UpdateSystemEvent @event)
+    {
+        Logger<ExamplePlugin>.Error(@event.SystemType.ToString());
+    }
+
+    // Example event handler
+    public static void FreezeButtonClickHandler(MiraButtonClickEvent<FreezeButton> @event)
+    {
+        Logger<ExamplePlugin>.Warning("Freeze button clicked!");
+
+        if (PlayerControl.LocalPlayer.Data.PlayerName == "stupid")
+        {
+            @event.Cancel();
+            @event.Button.SetTimer(15f);
+        }
+    }
+
+    // Example event handler
+    public static void FreezeButtonCancelledHandler(MiraButtonCancelledEvent<FreezeButton> @event)
+    {
+        Logger<ExamplePlugin>.Warning("Freeze button cancelled!");
+        @event.Button.OverrideName("Freeze Canceled");
+    }
+}

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;
@@ -25,13 +21,7 @@ public partial class ExamplePlugin : BasePlugin, IMiraPlugin
     public ConfigFile GetConfigFile() => Config;
     public override void Load()
     {
+        ExampleEventHandlers.Initialize();
         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/Modifiers/HighPriorityModifier.cs

@@ -0,0 +1,24 @@
+using MiraAPI.Modifiers;
+using MiraAPI.Modifiers.Types;
+
+namespace MiraAPI.Example.Modifiers;
+
+[RegisterModifier]
+public class HighPriorityModifier : GameModifier
+{
+    public override string ModifierName => "High Priority";
+    public override int GetAssignmentChance()
+    {
+        return 100;
+    }
+
+    public override int GetAmountPerGame()
+    {
+        return 1;
+    }
+
+    public override int Priority()
+    {
+        return 100;
+    }
+}

MiraAPI.Example/Options/ExampleOptions2.cs

@@ -14,16 +14,16 @@ public class ExampleOptions2 : AbstractOptionGroup
 
     public ModdedToggleOption ToggleOpt2 { get; } = new("Toggle Option 2", false)
     {
-        Visible = () => OptionGroupSingleton<ExampleOptions2>.Instance.ToggleOpt1.Value,
+        Visible = () => OptionGroupSingleton<ExampleOptions2>.Instance.ToggleOpt1, // implicit cast from ModdedToggleOption to bool
     };
 
-    public ModdedEnumOption EnumOpt { get; } = new("Enum Opt", 0, typeof(TestingData))
+    public ModdedEnumOption<TestingData> EnumOpt { get; } = new("Enum Opt", 0)
     {
         ChangedEvent = x => Logger<ExamplePlugin>.Info($"changed Enum Opt to {x}"),
     };
 }
 
-public enum TestingData
+public enum TestingData : ulong
 {
     Happy,
     Sad,

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,5 @@
 using MiraAPI.Roles;
+using TMPro;
 using UnityEngine;
 
 namespace MiraAPI.Example.Roles;
@@ -21,8 +22,8 @@ public class ChameloenRole : CrewmateRole, ICustomRole
     {
         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 +34,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);
 

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/Events/Mira/MiraButtonCancelledEvent.cs

@@ -0,0 +1,44 @@
+using MiraAPI.Hud;
+
+namespace MiraAPI.Events.Mira;
+
+/// <summary>
+/// Invoked when a Mira Button click is cancelled. Do not use for vanilla buttons.
+/// </summary>
+/// <typeparam name="T">The Mira Button type.</typeparam>
+public sealed class MiraButtonCancelledEvent<T> : MiraEvent where T : CustomActionButton
+{
+    /// <summary>
+    /// Gets Mira Button whose click was cancelled.
+    /// </summary>
+    public T Button { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="MiraButtonCancelledEvent{T}"/> class.
+    /// </summary>
+    /// <param name="button">The Mira Button whose click was cancelled.</param>
+    public MiraButtonCancelledEvent(T button)
+    {
+        Button = button;
+    }
+}
+
+/// <summary>
+/// Invoked when a Mira Button click is cancelled. Do not use for vanilla buttons.
+/// </summary>
+public sealed class MiraButtonCancelledEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets Mira Button whose click was cancelled.
+    /// </summary>
+    public CustomActionButton Button { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="MiraButtonCancelledEvent"/> class.
+    /// </summary>
+    /// <param name="button">The Mira Button whose click was cancelled.</param>
+    public MiraButtonCancelledEvent(CustomActionButton button)
+    {
+        Button = button;
+    }
+}

MiraAPI/Events/Mira/MiraButtonClickEvent.cs

@@ -0,0 +1,51 @@
+using MiraAPI.Hud;
+
+namespace MiraAPI.Events.Mira;
+
+/// <summary>
+/// Button click event for Mira Buttons only. Do not use for vanilla buttons.
+/// </summary>
+/// <typeparam name="T">The Mira Button type.</typeparam>
+public sealed class MiraButtonClickEvent<T> : MiraCancelableEvent where T : CustomActionButton
+{
+    /// <summary>
+    /// Gets Mira Button that was clicked.
+    /// </summary>
+    public T Button { get; }
+
+    /// <summary>
+    /// Gets the generic click event that is invoked before this button-specific event.
+    /// </summary>
+    public MiraButtonClickEvent GenericClickEvent { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="MiraButtonClickEvent{T}"/> class.
+    /// </summary>
+    /// <param name="button">The Mira Button that was clicked.</param>
+    /// <param name="genericClickEvent">The generic click event invoked before button-specific events.</param>
+    public MiraButtonClickEvent(T button, MiraButtonClickEvent genericClickEvent)
+    {
+        GenericClickEvent = genericClickEvent;
+        Button = button;
+    }
+}
+
+/// <summary>
+/// Button click event for Mira Buttons only. Do not use for vanilla buttons.
+/// </summary>
+public sealed class MiraButtonClickEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets Mira Button that was clicked.
+    /// </summary>
+    public CustomActionButton Button { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="MiraButtonClickEvent"/> class.
+    /// </summary>
+    /// <param name="button">The Mira Button that was clicked.</param>
+    public MiraButtonClickEvent(CustomActionButton button)
+    {
+        Button = button;
+    }
+}

MiraAPI/Events/MiraCancelableEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events;
+
+/// <summary>
+/// Abstract class for Mira Events that can be cancelled.
+/// </summary>
+public abstract class MiraCancelableEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets a value indicating whether the event is cancelled.
+    /// </summary>
+    public bool IsCancelled { get; private set; }
+
+    /// <summary>
+    /// Cancels the event.
+    /// </summary>
+    public void Cancel()
+    {
+        IsCancelled = true;
+    }
+
+    /// <summary>
+    /// Uncancels the event.
+    /// </summary>
+    public void UnCancel()
+    {
+        IsCancelled = false;
+    }
+}

MiraAPI/Events/MiraEvent.cs

@@ -0,0 +1,6 @@
+namespace MiraAPI.Events;
+
+/// <summary>
+/// Abstract class for Mira Events.
+/// </summary>
+public abstract class MiraEvent;

MiraAPI/Events/MiraEventManager.cs

@@ -0,0 +1,82 @@
+using System;
+using System.Collections.Generic;
+using Reactor.Utilities;
+
+namespace MiraAPI.Events;
+
+/// <summary>
+/// Mira Event manager.
+/// </summary>
+public static class MiraEventManager
+{
+    private static readonly Dictionary<Type, List<MiraEventWrapper>> EventWrappers = [];
+
+    /// <summary>
+    /// Invoke an event.
+    /// </summary>
+    /// <param name="eventInstance">The event instance.</param>
+    /// <typeparam name="T">Type of Event.</typeparam>
+    /// <returns>If there was an event handler invoked for this event, return true. Otherwise, return false.</returns>
+    public static bool InvokeEvent<T>(T eventInstance) where T : MiraEvent
+    {
+        EventWrappers.TryGetValue(typeof(T), out var handlers);
+        if (handlers == null)
+        {
+            return false;
+        }
+
+        foreach (var handler in handlers)
+        {
+            ((Action<T>)handler.EventHandler).Invoke(eventInstance);
+        }
+
+        return true;
+    }
+
+    /// <summary>
+    /// Invoke an event and use a specific type to find the handlers.
+    /// </summary>
+    /// <param name="eventInstance">The event instance.</param>
+    /// <param name="type">The type to use for handler lookup.</param>
+    /// <returns>If there was an event handler invoked for this event, return true. Otherwise, return false.</returns>
+    public static bool InvokeEvent(MiraEvent eventInstance, Type type)
+    {
+        EventWrappers.TryGetValue(type, out var handlers);
+        if (handlers == null)
+        {
+            return false;
+        }
+
+        foreach (var handler in handlers)
+        {
+            handler.EventHandler.DynamicInvoke(eventInstance);
+        }
+
+        return true;
+    }
+
+    /// <summary>
+    /// Register an event.
+    /// </summary>
+    /// <param name="handler">The callback method/handler for the event.</param>
+    /// <param name="priority">The priority of the event handler. Higher values are called first.</param>
+    /// <typeparam name="T">Type of event.</typeparam>
+    public static void RegisterEventHandler<T>(Action<T> handler, int priority = 0) where T : MiraEvent
+    {
+        if (!EventWrappers.ContainsKey(typeof(T)))
+        {
+            EventWrappers.Add(typeof(T), []);
+        }
+
+        var handlers = EventWrappers[typeof(T)];
+        handlers.Add(new MiraEventWrapper(handler, priority));
+    }
+
+    internal static void SortAllHandlers()
+    {
+        foreach (var handlers in EventWrappers.Values)
+        {
+            handlers.Sort((a, b) => a.Priority.CompareTo(b.Priority));
+        }
+    }
+}

MiraAPI/Events/MiraEventWrapper.cs

@@ -0,0 +1,30 @@
+using System;
+
+namespace MiraAPI.Events;
+
+/// <summary>
+/// Wrapper for event handlers.
+/// </summary>
+public class MiraEventWrapper
+{
+    /// <summary>
+    /// Gets the event handler delegate.
+    /// </summary>
+    public Delegate EventHandler { get; }
+
+    /// <summary>
+    /// Gets the priority of the handler. Higher values are called first.
+    /// </summary>
+    public int Priority { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="MiraEventWrapper"/> class.
+    /// </summary>
+    /// <param name="eventHandler">The action for the event handler.</param>
+    /// <param name="priority">The priority of the handler.</param>
+    public MiraEventWrapper(Delegate eventHandler, int priority)
+    {
+        EventHandler = eventHandler;
+        Priority = priority;
+    }
+}

MiraAPI/Events/Vanilla/Gameplay/AfterMurderEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events.Vanilla.Gameplay;
+
+/// <summary>
+/// Event that is invoked after a player is murdered. Only called after a successful murder. This event is not cancelable.
+/// </summary>
+public class AfterMurderEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets the player that killed the target.
+    /// </summary>
+    public PlayerControl Source { get; }
+
+    /// <summary>
+    /// Gets the player that was killed.
+    /// </summary>
+    public PlayerControl Target { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="AfterMurderEvent"/> class.
+    /// </summary>
+    /// <param name="source">The killer.</param>
+    /// <param name="target">The killed player.</param>
+    public AfterMurderEvent(PlayerControl source, PlayerControl target)
+    {
+        Source = source;
+        Target = target;
+    }
+}

MiraAPI/Events/Vanilla/Gameplay/BeforeMurderEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events.Vanilla.Gameplay;
+
+/// <summary>
+/// Event that is invoked before a player is murdered. This event is cancelable.
+/// </summary>
+public sealed class BeforeMurderEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the player that is killing the target.
+    /// </summary>
+    public PlayerControl Source { get; }
+
+    /// <summary>
+    /// Gets the player that is being killed.
+    /// </summary>
+    public PlayerControl Target { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="BeforeMurderEvent"/> class.
+    /// </summary>
+    /// <param name="source">The player that is killing the target.</param>
+    /// <param name="target">The player that is being killed.</param>
+    public BeforeMurderEvent(PlayerControl source, PlayerControl target)
+    {
+        Source = source;
+        Target = target;
+    }
+}

MiraAPI/Events/Vanilla/Gameplay/GameEndEvent.cs

@@ -0,0 +1,21 @@
+namespace MiraAPI.Events.Vanilla.Gameplay;
+
+/// <summary>
+/// The event that is invoked when the end game screen is shown. Non cancelable.
+/// </summary>
+public class GameEndEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets the instance of the EndGameManager.
+    /// </summary>
+    public EndGameManager EndGameManager { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="GameEndEvent"/> class.
+    /// </summary>
+    /// <param name="manager">The instance of the EndGameManager.</param>
+    public GameEndEvent(EndGameManager manager)
+    {
+        EndGameManager = manager;
+    }
+}

MiraAPI/Events/Vanilla/Gameplay/IntroBeginEvent.cs

@@ -0,0 +1,21 @@
+namespace MiraAPI.Events.Vanilla.Gameplay;
+
+/// <summary>
+/// The event that is invoked when the intro cutscene is shown. Non cancelable.
+/// </summary>
+public class IntroBeginEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets the instance of the IntroCutscene.
+    /// </summary>
+    public IntroCutscene IntroCutscene { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="IntroBeginEvent"/> class.
+    /// </summary>
+    /// <param name="introCutscene">The intro cutscene.</param>
+    public IntroBeginEvent(IntroCutscene introCutscene)
+    {
+        IntroCutscene = introCutscene;
+    }
+}

MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs

@@ -0,0 +1,21 @@
+namespace MiraAPI.Events.Vanilla.Map;
+
+/// <summary>
+/// Event fired when a player closes the doors in a room.
+/// </summary>
+public class CloseDoorsEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the room that the doors were closed in.
+    /// </summary>
+    public SystemTypes Room { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="CloseDoorsEvent"/> class.
+    /// </summary>
+    /// <param name="room">The room that was closed.</param>
+    public CloseDoorsEvent(SystemTypes room)
+    {
+        Room = room;
+    }
+}

MiraAPI/Events/Vanilla/Map/PlayerOpenSabotageEvent.cs

@@ -0,0 +1,21 @@
+namespace MiraAPI.Events.Vanilla.Map;
+
+/// <summary>
+/// Sabotage from Vanilla Among Us.
+/// </summary>
+public class PlayerOpenSabotageEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the MapBehaviour.
+    /// </summary>
+    public MapBehaviour MapBehaviour { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PlayerOpenSabotageEvent"/> class.
+    /// </summary>
+    /// <param name="mapBehaviour">The MapBehaviour.</param>
+    public PlayerOpenSabotageEvent(MapBehaviour mapBehaviour)
+    {
+        MapBehaviour = mapBehaviour;
+    }
+}

MiraAPI/Events/Vanilla/Map/UpdateSystemEvent.cs

@@ -0,0 +1,34 @@
+namespace MiraAPI.Events.Vanilla.Map;
+
+/// <summary>
+/// Cancelable event that is invoked before a system is updated. Usually used for sabotage events.
+/// </summary>
+public class UpdateSystemEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the type of system that will be updated.
+    /// </summary>
+    public SystemTypes SystemType { get; }
+
+    /// <summary>
+    /// Gets the player that is updating the system.
+    /// </summary>
+    public PlayerControl Player { get; }
+
+    /// <summary>
+    /// Gets the byte amount the system is being updated by.
+    /// </summary>
+    public byte Amount { get; }
+
+    /// <summary>
+    ///  Initializes a new instance of the <see cref="UpdateSystemEvent"/> class.
+    /// </summary>
+    /// <param name="systemType">The SystemType being updated.</param>
+    /// <param name="amount">Amount to update System to.</param>
+    public UpdateSystemEvent(SystemTypes systemType, PlayerControl player, byte amount)
+    {
+        SystemType = systemType;
+        Player = player;
+        Amount = amount;
+    }
+}

MiraAPI/Events/Vanilla/Meeting/EjectionEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events.Vanilla.Meeting;
+
+/// <summary>
+/// The event that is invoked when a player is ejected.
+/// </summary>
+public class EjectionEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the player that is being ejected.
+    /// </summary>
+    public PlayerControl? Player { get; }
+
+    /// <summary>
+    /// Gets the instance of the ExileController.
+    /// </summary>
+    public ExileController ExileController { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="EjectionEvent"/> class.
+    /// </summary>
+    /// <param name="player">The player who is being ejected.</param>
+    /// <param name="controller">The exile controller.</param>
+    public EjectionEvent(PlayerControl player, ExileController controller)
+    {
+        Player = player;
+        ExileController = controller;
+    }
+}

MiraAPI/Events/Vanilla/Meeting/StartMeetingEvent.cs

@@ -0,0 +1,35 @@
+namespace MiraAPI.Events.Vanilla.Meeting;
+
+/// <summary>
+/// The event that is invoked when a meeting is called.
+/// </summary>
+public class StartMeetingEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the player that is calling the meeting.
+    /// </summary>
+    public PlayerControl Reporter { get; }
+
+    /// <summary>
+    /// Gets the player that is being reported. Will be null for emergency meeting.
+    /// </summary>
+    public NetworkedPlayerInfo? Target { get; }
+
+    /// <summary>
+    /// Gets the body that is being reported. Will be null for emergency meeting.
+    /// </summary>
+    public DeadBody? Body { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="StartMeetingEvent"/> class.
+    /// </summary>
+    /// <param name="reporter">The player who reported the body.</param>
+    /// <param name="target">The player being reported.</param>
+    /// <param name="body">The body being reported.</param>
+    public StartMeetingEvent(PlayerControl reporter, NetworkedPlayerInfo? target, DeadBody? body)
+    {
+        Reporter = reporter;
+        Target = target;
+        Body = body;
+    }
+}

MiraAPI/Events/Vanilla/Player/CompleteTaskEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events.Vanilla.Player;
+
+/// <summary>
+/// The event that is invoked when a player completes a task. Non cancelable.
+/// </summary>
+public class CompleteTaskEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets the instance of the <see cref="PlayerControl"/>.
+    /// </summary>
+    public PlayerControl Player { get; }
+
+    /// <summary>
+    /// Gets the instance of the <see cref="PlayerTask"/> that the player completed.
+    /// </summary>
+    public PlayerTask Task { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="CompleteTaskEvent"/> class.
+    /// </summary>
+    /// <param name="player">The player who completed the task.</param>
+    /// <param name="task">The task that the player completed.</param>
+    public CompleteTaskEvent(PlayerControl player, PlayerTask task)
+    {
+        Player = player;
+        Task = task;
+    }
+}

MiraAPI/Events/Vanilla/Player/PlayerDeathEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events.Vanilla.Player;
+
+/// <summary>
+/// Event that is invoked when a player dies. Non cancelable.
+/// </summary>
+public class PlayerDeathEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets the player who died.
+    /// </summary>
+    public PlayerControl Player { get; }
+
+    /// <summary>
+    /// Gets the reason the player died.
+    /// </summary>
+    public DeathReason DeathReason { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PlayerDeathEvent"/> class.
+    /// </summary>
+    /// <param name="player">The player who died.</param>
+    /// <param name="reason">The reason the player died.</param>
+    public PlayerDeathEvent(PlayerControl player, DeathReason reason)
+    {
+        Player = player;
+        DeathReason = reason;
+    }
+}

MiraAPI/Events/Vanilla/Player/PlayerJoinEvent.cs

@@ -0,0 +1,23 @@
+using InnerNet;
+
+namespace MiraAPI.Events.Vanilla.Player;
+
+/// <summary>
+/// Event that is invoked when a player joins the lobby. Non cancelable.
+/// </summary>
+public class PlayerJoinEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets the player who joined.
+    /// </summary>
+    public ClientData ClientData { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PlayerJoinEvent"/> class.
+    /// </summary>
+    /// <param name="data">The data of the player who joined.</param>
+    public PlayerJoinEvent(ClientData data)
+    {
+        ClientData = data;
+    }
+}

MiraAPI/Events/Vanilla/Player/PlayerLeaveEvent.cs

@@ -0,0 +1,30 @@
+using InnerNet;
+
+namespace MiraAPI.Events.Vanilla.Player;
+
+/// <summary>
+/// Event that is invoked when a player leaves the game. Non cancelable.
+/// </summary>
+public class PlayerLeaveEvent : MiraEvent
+{
+    /// <summary>
+    /// Gets the player who left.
+    /// </summary>
+    public ClientData ClientData { get; }
+
+    /// <summary>
+    /// Gets the reason why the player left.
+    /// </summary>
+    public DisconnectReasons Reason { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PlayerLeaveEvent"/> class.
+    /// </summary>
+    /// <param name="data">The data of the player who left.</param>
+    /// <param name="reason">The reason why the player left.</param>
+    public PlayerLeaveEvent(ClientData data, DisconnectReasons reason)
+    {
+        ClientData = data;
+        Reason = reason;
+    }
+}

MiraAPI/Events/Vanilla/Usables/EnterVentEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events.Vanilla.Usables;
+
+/// <summary>
+/// Event that is invoked when a player enters a vent. This event is cancelable.
+/// </summary>
+public class EnterVentEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the player that is entering the vent.
+    /// </summary>
+    public PlayerControl Player { get; }
+
+    /// <summary>
+    /// Gets the vent that the player is entering.
+    /// </summary>
+    public Vent? Vent { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="EnterVentEvent"/> class.
+    /// </summary>
+    /// <param name="player">The player that is entering the vent.</param>
+    /// <param name="vent">The vent being entered.</param>
+    public EnterVentEvent(PlayerControl player, Vent? vent)
+    {
+        Player = player;
+        Vent = vent;
+    }
+}

MiraAPI/Events/Vanilla/Usables/ExitVentEvent.cs

@@ -0,0 +1,28 @@
+namespace MiraAPI.Events.Vanilla.Usables;
+
+/// <summary>
+/// Event that is invoked when a player exits a vent. This event is cancelable.
+/// </summary>
+public class ExitVentEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the player that is exiting the vent.
+    /// </summary>
+    public PlayerControl Player { get; }
+
+    /// <summary>
+    /// Gets the vent that the player is exiting.
+    /// </summary>
+    public Vent? Vent { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ExitVentEvent"/> class.
+    /// </summary>
+    /// <param name="player">The player who is exiting the vent.</param>
+    /// <param name="vent">The vent being exited from.</param>
+    public ExitVentEvent(PlayerControl player, Vent? vent)
+    {
+        Player = player;
+        Vent = vent;
+    }
+}

MiraAPI/Events/Vanilla/Usables/PlayerCanUseEvent.cs

@@ -0,0 +1,15 @@
+namespace MiraAPI.Events.Vanilla.Usables;
+
+/// <summary>
+/// Event for if a <see cref="PlayerControl"/> can use an <see cref="IUsable"/> from Vanilla Among Us. Will always be ran locally.
+/// </summary>
+public class PlayerCanUseEvent : PlayerUseEvent
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PlayerCanUseEvent"/> class.
+    /// </summary>
+    /// <param name="usable">The IUsable.</param>
+    public PlayerCanUseEvent(IUsable usable) : base(usable)
+    {
+    }
+}

MiraAPI/Events/Vanilla/Usables/PlayerUseEvent.cs

@@ -0,0 +1,34 @@
+namespace MiraAPI.Events.Vanilla;
+
+/// <summary>
+/// Event for <see cref="PlayerControl"/> using a <see cref="IUsable"/> from Vanilla Among Us. Will always be ran locally.
+/// </summary>
+public class PlayerUseEvent : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the instance of <see cref="IUsable"/> that was used.
+    /// </summary>
+    public IUsable Usable { get; }
+
+    /// <summary>
+    /// Gets a value indicating whether the IUsable is a <see cref="Console"/>, <see cref="MapConsole"/>, or <see cref="SystemConsole"/>.
+    /// </summary>
+    public bool IsPrimaryConsole { get; }
+
+    /// <summary>
+    /// Gets a value indicating whether the IUsable is a <see cref="Vent"/>.
+    /// </summary>
+    public bool IsVent { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="PlayerUseEvent"/> class.
+    /// </summary>
+    /// <param name="usable">The IUsable.</param>
+    public PlayerUseEvent(IUsable usable)
+    {
+        Usable = usable;
+
+        IsPrimaryConsole = usable.TryCast<Console>() || usable.TryCast<SystemConsole>() || usable.TryCast<MapConsole>();
+        IsVent = usable.TryCast<Vent>();
+    }
+}

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;
 
@@ -27,10 +27,8 @@ public class ModdedEnumOptionAttribute(string title, Type enumType, string[]? va
     /// <inheritdoc />
     public override object GetValue()
     {
-        if (HolderOption is ModdedEnumOption opt)
-        {
-            return Enum.ToObject(enumType, opt.Value);
-        }
-        throw new InvalidOperationException($"HolderOption for option \"{Title}\" with EnumType ${enumType.FullName} is not a ModdedEnumOption");
+        return HolderOption is ModdedEnumOption opt
+            ? Enum.ToObject(enumType, opt.Value)
+            : throw new InvalidOperationException($"HolderOption for option \"{Title}\" with EnumType ${enumType.FullName} is not a ModdedEnumOption");
     }
 }

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

@@ -21,5 +21,4 @@ public interface IModdedOption
     float GetFloatData();
     NetData GetNetData();
     void HandleNetData(byte[] data);
-    void ResetToConfig();
 }

MiraAPI/GameOptions/ModdedOptionsManager.cs

@@ -31,7 +31,7 @@ public static class ModdedOptionsManager
     {
         if (Activator.CreateInstance(type) is not AbstractOptionGroup group)
         {
-            Logger<MiraApiPlugin>.Error($"Failed to create group from {type.Name}");
+            Logger<MiraApiPlugin>.Error($"Skipping option group {type.Name}. Does not inherit AbstractOptionGroup.");
             return false;
         }
 
@@ -142,6 +142,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 +162,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

@@ -1,5 +1,7 @@
 using System;
+using System.Globalization;
 using System.Linq;
+using System.Text;
 using Il2CppInterop.Runtime.InteropTypes.Arrays;
 using MiraAPI.Networking;
 using Reactor.Localization.Utilities;
@@ -86,10 +88,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);
-        }
+        HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, Data?.GetValueString(newValue), false);
         if (!OptionBehaviour)
         {
             return;
@@ -101,3 +100,96 @@ public class ModdedEnumOption : ModdedOption<int>
         }
     }
 }
+
+
+/// <summary>
+/// An option for selecting an enum value.
+/// </summary>
+/// <typeparam name="T">The enum type.</typeparam>
+public class ModdedEnumOption<T> : ModdedOption<T> where T : Enum
+{
+    /// <summary>
+    /// Gets the string values of the enum.
+    /// </summary>
+    public string[]? Values { get; }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ModdedEnumOption{T}"/> class.
+    /// </summary>
+    /// <param name="title">The title of the option.</param>
+    /// <param name="defaultValue">The default value as an int.</param>
+    /// <param name="enumType">The Enum type.</param>
+    /// <param name="values">An option list of string values to use in place of the enum name.</param>
+    /// <param name="roleType">An optional role type to specify for a specific role.</param>
+    public ModdedEnumOption(string title, T defaultValue, string[]? values = null, Type? roleType = null) : base(title, defaultValue, roleType)
+    {
+        Values = values ?? Enum.GetNames(typeof(T));
+        Data = ScriptableObject.CreateInstance<StringGameSetting>();
+        var data = (StringGameSetting)Data;
+
+        data.Title = StringName;
+        data.Type = global::OptionTypes.String;
+        data.Values = values is null ?
+            Enum.GetNames(typeof(T)).Select(CustomStringName.CreateAndRegister).ToArray()
+            : values.Select(CustomStringName.CreateAndRegister).ToArray();
+
+        data.Index = Convert.ToInt32(Value);
+    }
+
+    /// <inheritdoc />
+    public override OptionBehaviour CreateOption(ToggleOption toggleOpt, NumberOption numberOpt, StringOption stringOpt, Transform container)
+    {
+        var stringOption = Object.Instantiate(stringOpt, container);
+
+        stringOption.SetUpFromData(Data, 20);
+        stringOption.OnValueChanged = (Il2CppSystem.Action<OptionBehaviour>)ValueChanged;
+
+        // SetUpFromData method doesnt work correctly so we must set the values manually
+        stringOption.Title = StringName;
+        stringOption.Values = (Data as StringGameSetting)?.Values ?? new Il2CppStructArray<StringNames>(0);
+        stringOption.Value = Convert.ToInt32(Value);
+
+        OptionBehaviour = stringOption;
+
+        return stringOption;
+    }
+
+    /// <inheritdoc />
+    public override float GetFloatData()
+    {
+        return Convert.ToSingle(Value);
+    }
+
+    /// <inheritdoc />
+    public override NetData GetNetData()
+    {
+        return new NetData(Id, Encoding.Unicode.GetBytes(Convert.ToString(Value)));
+    }
+
+    /// <inheritdoc />
+    public override void HandleNetData(byte[] data)
+    {
+        SetValue((T)Enum.Parse(typeof(T), Encoding.Unicode.GetString(data)));
+    }
+
+    /// <inheritdoc />
+    public override T GetValueFromOptionBehaviour(OptionBehaviour optionBehaviour)
+    {
+        return (T)Enum.Parse(typeof(T), optionBehaviour.GetInt().ToString());
+    }
+
+    /// <inheritdoc />
+    protected override void OnValueChanged(T newValue)
+    {
+        HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, Data?.GetValueString(Convert.ToInt32(newValue)), false);
+        if (!OptionBehaviour)
+        {
+            return;
+        }
+
+        if (OptionBehaviour is StringOption opt)
+        {
+            opt.Value = Convert.ToInt32(newValue);
+        }
+    }
+}

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,17 +134,24 @@ 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);
-        }
+        HudManager.Instance.Notifier.AddSettingsChangeMessage(
+            StringName,
+            Data?.GetValueString(Value),
+            false);
 
         if (OptionBehaviour is NumberOption opt)
         {
             opt.Value = Value;
         }
     }
+
+    /// <summary>
+    /// Implicitly converts the option to an int.
+    /// </summary>
+    /// <param name="option">The option.</param>
+    /// <returns>Integer value.</returns>
+    public static implicit operator int(ModdedNumberOption option)
+    {
+        return (int)option.Value;
+    }
 }

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;
@@ -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>
@@ -196,4 +194,14 @@ public abstract class ModdedOption<T> : IModdedOption
         NumberOption numberOpt,
         StringOption stringOpt,
         Transform container);
+
+    /// <summary>
+    /// Implicitly converts the option to type of <typeparamref name="T"/>.
+    /// </summary>
+    /// <param name="option">The option.</param>
+    /// <returns>Value of type <typeparamref name="T"/>.</returns>
+    public static implicit operator T(ModdedOption<T> option)
+    {
+        return option.Value;
+    }
 }

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);
-        }
+        HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, newValue ? "On" : "Off", false);
         if (!OptionBehaviour)
         {
             return;

MiraAPI/Hud/CustomActionButton.cs

@@ -1,7 +1,12 @@
-using MiraAPI.Utilities.Assets;
+using MiraAPI.Events;
+using MiraAPI.Events.Mira;
+using MiraAPI.Patches;
+using MiraAPI.Utilities.Assets;
+using System;
 using UnityEngine;
 using UnityEngine.Events;
 using UnityEngine.UI;
+using Object = UnityEngine.Object;
 
 namespace MiraAPI.Hud;
 
@@ -15,30 +20,35 @@ public abstract class CustomActionButton
     /// </summary>
     public abstract string Name { get; }
 
+    /// <summary>
+    /// Gets the initial cooldown duration in seconds.
+    /// </summary>
+    public virtual float InitialCooldown => Cooldown;
+
     /// <summary>
     /// Gets the button's cooldown duration in seconds.
     /// </summary>
     public abstract float Cooldown { get; }
 
-    /// <summary>
-    /// Gets the button's effect duration in seconds. If the button has no effect, set to 0.
-    /// </summary>
-    public abstract float EffectDuration { get; }
-
-    /// <summary>
-    /// Gets the maximum amount of uses the button has. If the button has infinite uses, set to 0.
-    /// </summary>
-    public abstract int MaxUses { get; }
-
     /// <summary>
     /// Gets the sprite of the button. Use <see cref="LoadableResourceAsset"/> to load a sprite from a resource path. Use <see cref="LoadableBundleAsset{T}"/> to load a sprite from an asset bundle.
     /// </summary>
     public abstract LoadableAsset<Sprite> Sprite { get; }
 
+    /// <summary>
+    /// Gets the button's effect duration in seconds. If the button has no effect, set to 0.
+    /// </summary>
+    public virtual float EffectDuration => 0;
+
+    /// <summary>
+    /// Gets the maximum amount of uses the button has. If the button has infinite uses, set to 0.
+    /// </summary>
+    public virtual int MaxUses => 0;
+
     /// <summary>
     /// Gets the location of the button on the screen.
     /// </summary>
-    public virtual ButtonLocation Location => ButtonLocation.BottomLeft;
+    public virtual ButtonLocation Location { get; private set; } = ButtonLocation.BottomLeft;
 
     /// <summary>
     /// Gets a value indicating whether the button has an effect ability.
@@ -70,7 +80,11 @@ public abstract class CustomActionButton
     /// </summary>
     protected ActionButton? Button { get; private set; }
 
-    internal void CreateButton(Transform parent)
+    /// <summary>
+    /// The method used to create the button.
+    /// </summary>
+    /// <param name="parent">The parent of the button.</param>
+    public virtual void CreateButton(Transform parent)
     {
         if (Button)
         {
@@ -78,7 +92,7 @@ public abstract class CustomActionButton
         }
 
         UsesLeft = MaxUses;
-        Timer = Cooldown;
+        Timer = AmongUsClient.Instance?.NetworkMode == NetworkModes.FreePlay ? 0 : InitialCooldown;
         EffectActive = false;
 
         Button = Object.Instantiate(HudManager.Instance.AbilityButton, parent);
@@ -95,13 +109,87 @@ public abstract class CustomActionButton
 
         var pb = Button.GetComponent<PassiveButton>();
         pb.OnClick = new Button.ButtonClickedEvent();
-        pb.OnClick.AddListener((UnityAction)ClickHandler);
+        pb.OnClick.AddListener((UnityAction)(() =>
+        {
+            // Invoke the generic button click event.
+            var genericEvent = new MiraButtonClickEvent(this);
+            MiraEventManager.InvokeEvent(genericEvent);
+            if (genericEvent.IsCancelled)
+            {
+                MiraEventManager.InvokeEvent(new MiraButtonCancelledEvent(this));
+            }
+
+            // Invoke the button click event for specific button.
+            var eventType = CustomButtonManager.ButtonEventTypes[GetType()];
+            var @event = (MiraCancelableEvent)Activator.CreateInstance(eventType, this, genericEvent)!;
+            var specificInvoked = MiraEventManager.InvokeEvent(@event, eventType);
+            if (@event.IsCancelled)
+            {
+                var cancelEventType = CustomButtonManager.ButtonCancelledEventTypes[GetType()];
+                var cancelEvent = (MiraEvent)Activator.CreateInstance(cancelEventType, this)!;
+                MiraEventManager.InvokeEvent(cancelEvent, cancelEventType);
+            }
+
+            if (specificInvoked)
+            {
+                if (!@event.IsCancelled)
+                {
+                    ClickHandler();
+                }
+            }
+            else
+            {
+                if (!genericEvent.IsCancelled)
+                {
+                    ClickHandler();
+                }
+            }
+        }));
+    }
+
+    /// <summary>
+    /// Allows you to change the button's location.
+    /// </summary>
+    /// <param name="location">The new location.</param>
+    /// <param name="moveButton">Whether the button's position should change ingame.</param>
+    public virtual void SetButtonLocation(ButtonLocation location, bool moveButton = true)
+    {
+        if (HudManager.Instance == null || Button == null)
+        {
+            return;
+        }
+
+        this.Location = location;
+
+        if (!moveButton) return;
+
+        if (HudManagerPatches._bottomLeft == null || HudManagerPatches._bottomRight == null)
+        {
+            return;
+        }
+
+        switch (location)
+        {
+            case ButtonLocation.BottomLeft:
+                var gridArrange = HudManagerPatches._bottomLeft.GetComponent<GridArrange>();
+                var aspectPosition = HudManagerPatches._bottomLeft.GetComponent<AspectPosition>();
+
+                Button.transform.SetParent(HudManagerPatches._bottomLeft.transform);
+
+                gridArrange.Start();
+                gridArrange.ArrangeChilds();
+                aspectPosition.AdjustPosition();
+                break;
+            case ButtonLocation.BottomRight:
+                Button.transform.SetParent(HudManagerPatches._bottomRight);
+                break;
+        }
     }
 
     /// <summary>
     /// A utility function to reset the cooldown and/or effect of the button.
     /// </summary>
-    public void ResetCooldownAndOrEffect()
+    public virtual void ResetCooldownAndOrEffect()
     {
         Timer = Cooldown;
         if (EffectActive)
@@ -116,7 +204,7 @@ public abstract class CustomActionButton
     /// A utility function to override the sprite of the button.
     /// </summary>
     /// <param name="sprite">The new sprite to override with.</param>
-    public void OverrideSprite(Sprite sprite)
+    public virtual void OverrideSprite(Sprite sprite)
     {
         if (Button != null)
         {
@@ -128,7 +216,7 @@ public abstract class CustomActionButton
     /// A utility function to override the name of the button.
     /// </summary>
     /// <param name="name">The new name to override with.</param>
-    public void OverrideName(string name)
+    public virtual void OverrideName(string name)
     {
         Button?.OverrideText(name);
     }
@@ -137,7 +225,7 @@ public abstract class CustomActionButton
     /// Set the button's timer.
     /// </summary>
     /// <param name="time">The time you want to set to.</param>
-    public void SetTimer(float time)
+    public virtual void SetTimer(float time)
     {
         Timer = Mathf.Clamp(time, -1, float.MaxValue);
     }
@@ -146,7 +234,7 @@ public abstract class CustomActionButton
     /// Increase the button's timer.
     /// </summary>
     /// <param name="amount">The amount you want to increase by.</param>
-    public void IncreaseTimer(float amount)
+    public virtual void IncreaseTimer(float amount)
     {
         SetTimer(Timer + amount);
     }
@@ -155,7 +243,7 @@ public abstract class CustomActionButton
     /// Decrease the button's timer.
     /// </summary>
     /// <param name="amount">The amount you want to decrease by.</param>
-    public void DecreaseTimer(float amount)
+    public virtual void DecreaseTimer(float amount)
     {
         SetTimer(Timer - amount);
     }
@@ -164,17 +252,17 @@ public abstract class CustomActionButton
     /// Set the amount of uses this button has left.
     /// </summary>
     /// <param name="amount">The amount you want to set to.</param>
-    public void SetUses(int amount)
+    public virtual void SetUses(int amount)
     {
         UsesLeft = Mathf.Clamp(amount, 0, int.MaxValue);
-        Button?.SetUsesRemaining(MaxUses);
+        Button?.SetUsesRemaining(UsesLeft);
     }
 
     /// <summary>
     /// Increase the amount of uses this button has left.
     /// </summary>
     /// <param name="amount">The amount you want to increase by. Default: 1.</param>
-    public void IncreaseUses(int amount = 1)
+    public virtual void IncreaseUses(int amount = 1)
     {
         SetUses(UsesLeft + amount);
     }
@@ -183,7 +271,7 @@ public abstract class CustomActionButton
     /// Decrease the amount of uses this button has left.
     /// </summary>
     /// <param name="amount">The amount you want to decrease by. Default: 1.</param>
-    public void DecreaseUses(int amount = 1)
+    public virtual void DecreaseUses(int amount = 1)
     {
         SetUses(UsesLeft - amount);
     }
@@ -245,7 +333,7 @@ public abstract class CustomActionButton
     /// This method takes into account cooldowns, effects, and uses, before calling the <see cref="OnClick"/> method.
     /// It can be overridden for custom behavior.
     /// </summary>
-    protected virtual void ClickHandler()
+    public virtual void ClickHandler()
     {
         if (!CanUse())
         {
@@ -357,4 +445,13 @@ public abstract class CustomActionButton<T> : CustomActionButton where T : MonoB
 
         return base.CanUse() && Target != null;
     }
+
+    /// <summary>
+    /// Use this to reset the button's target after used.
+    /// </summary>
+    public virtual void ResetTarget()
+    {
+        Target = null;
+        SetOutline(false);
+    }
 }

MiraAPI/Hud/CustomButtonManager.cs

@@ -1,20 +1,26 @@
-using System;
-using System.Collections.Generic;
-using System.Reflection;
+using MiraAPI.Events.Mira;
 using MiraAPI.PluginLoading;
 using Reactor.Utilities;
+using System;
+using System.Collections.Generic;
+using System.Reflection;
 
 namespace MiraAPI.Hud;
 
-internal static class CustomButtonManager
+/// <summary>
+/// Custom button manager for handling custom buttons.
+/// </summary>
+public static class CustomButtonManager
 {
     internal static readonly List<CustomActionButton> CustomButtons = [];
+    internal static readonly Dictionary<Type, Type> ButtonEventTypes = [];
+    internal static readonly Dictionary<Type, Type> ButtonCancelledEventTypes = [];
 
     internal static void RegisterButton(Type buttonType, MiraPluginInfo pluginInfo)
     {
         if (!typeof(CustomActionButton).IsAssignableFrom(buttonType))
         {
-            Logger<MiraApiPlugin>.Error($"{buttonType?.Name} does not inherit from CustomActionButton.");
+            Logger<MiraApiPlugin>.Error($"Skipping button {buttonType.Name}. Does not inherit CustomActionButton!");
             return;
         }
 
@@ -29,5 +35,8 @@ internal static class CustomButtonManager
         typeof(CustomButtonSingleton<>).MakeGenericType(buttonType)
             .GetField("_instance", BindingFlags.Static | BindingFlags.NonPublic)!
             .SetValue(null, button);
+
+        ButtonEventTypes.Add(buttonType, typeof(MiraButtonClickEvent<>).MakeGenericType(buttonType));
+        ButtonCancelledEventTypes.Add(buttonType, typeof(MiraButtonCancelledEvent<>).MakeGenericType(buttonType));
     }
 }

MiraAPI/Hud/CustomPlayerMenu.cs

@@ -2,6 +2,7 @@
 using System.Collections.Generic;
 using System.Linq;
 using AmongUs.GameOptions;
+using Il2CppInterop.Runtime.Attributes;
 using MiraAPI.Patches.Stubs;
 using Reactor.Utilities.Attributes;
 using Reactor.Utilities.Extensions;
@@ -84,6 +85,7 @@ public class CustomPlayerMenu(IntPtr il2CppPtr) : Minigame(il2CppPtr)
     /// </summary>
     /// <param name="playerMatch">Function to determine if player should show in the custom menu.</param>
     /// <param name="onClick">Onclick action for player.</param>
+    [HideFromIl2Cpp]
     public void Begin(Func<PlayerControl, bool> playerMatch, Action<PlayerControl> onClick)
     {
         MinigameStubs.Begin(this, null);

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/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;
 
@@ -79,7 +79,7 @@ public class ModifierComponent(IntPtr cppPtr) : MonoBehaviour(cppPtr)
         {
             if (_player?.AmOwner == true)
             {
-                HudManager.Instance?.SetHudActive(HudManager.Instance.TaskPanel.isActiveAndEnabled);
+                HudManager.Instance?.SetHudActive(_player, _player.Data.Role, HudManager.Instance.TaskPanel.isActiveAndEnabled);
             }
             _toAdd.Clear();
             _toRemove.Clear();
@@ -107,10 +107,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();
@@ -259,4 +255,24 @@ public class ModifierComponent(IntPtr cppPtr) : MonoBehaviour(cppPtr)
     {
         return AddModifier(typeof(T)) as T;
     }
+
+    /// <summary>
+    /// Checks if a player has an active or queued modifier by its ID.
+    /// </summary>
+    /// <param name="id">The Modifier ID.</param>
+    /// <returns>True if the Modifier is present, false otherwise.</returns>
+    public bool HasModifier(uint id)
+    {
+        return ActiveModifiers.Exists(x => x.ModifierId == id) || _toAdd.Exists(x => x.ModifierId == id);
+    }
+
+    /// <summary>
+    /// Checks if a player has an active or queued modifier by its type.
+    /// </summary>
+    /// <typeparam name="T">The Type of the Modifier.</typeparam>
+    /// <returns>True if the Modifier is present, false otherwise.</returns>
+    public bool HasModifier<T>()
+    {
+        return ActiveModifiers.Exists(x => x is T) || _toAdd.Exists(x => x is T);
+    }
 }

MiraAPI/Modifiers/ModifierManager.cs

@@ -19,6 +19,7 @@ public static class ModifierManager
 {
     private static readonly Dictionary<uint, Type> IdToTypeModifierMap = [];
     private static readonly Dictionary<Type, uint> TypeToIdModifierMap = [];
+    private static readonly Dictionary<int, List<uint>> PrioritiesToIdsMap = [];
 
     private static uint _nextId;
 
@@ -57,75 +58,90 @@ public static class ModifierManager
 
         IdToTypeModifierMap.Add(GetNextId(), modifierType);
         TypeToIdModifierMap.Add(modifierType, _nextId);
+
+        if (!typeof(GameModifier).IsAssignableFrom(modifierType))
+        {
+            return;
+        }
+
+        var mod = Activator.CreateInstance(modifierType) as GameModifier;
+        var priority = mod!.Priority();
+
+        if (!PrioritiesToIdsMap.TryGetValue(priority, out var list))
+        {
+            PrioritiesToIdsMap[priority] = list = [];
+        }
+
+        list.Add(_nextId);
     }
 
     internal static void AssignModifiers(List<PlayerControl> plrs)
     {
         var rand = new Random();
 
-        List<uint> filteredModifiers = [];
-
-        foreach (var modifier in IdToTypeModifierMap.Where(pair => pair.Value.IsAssignableTo(typeof(GameModifier))))
+        foreach (var priority in PrioritiesToIdsMap.Keys.OrderByDescending(x => x))
         {
-            if (Activator.CreateInstance(modifier.Value) is not GameModifier mod)
+            var filteredModifiers = new List<uint>();
+
+            foreach (var id in PrioritiesToIdsMap[priority])
             {
-                Logger<MiraApiPlugin>.Error($"Failed to create instance of {modifier.Value.Name}");
-                continue;
-            }
+                var mod = Activator.CreateInstance(IdToTypeModifierMap[id]) as GameModifier;
+                var chance = Math.Clamp(mod!.GetAssignmentChance(), 0, 100);
+                var count = mod.GetAmountPerGame();
 
-            if (!plrs.Exists(x => IsGameModifierValid(x, mod, modifier.Key)))
-            {
-                Logger<MiraApiPlugin>.Warning("No players are valid for modifier: " + mod.ModifierName);
-                continue;
-            }
-
-            var maxCount = plrs.Count(x => IsGameModifierValid(x, mod, modifier.Key));
-
-            var num = Math.Clamp(mod.GetAmountPerGame(), 0, maxCount);
-            var chance = mod.GetAssignmentChance();
-
-            for (var i = 0; i < num; i++)
-            {
-                var randomNum = rand.Next(100);
-
-                if (randomNum < Math.Clamp(chance, 0, 100))
+                if (chance == 0 || count == 0)
                 {
-                    filteredModifiers.Add(TypeToIdModifierMap[modifier.Value]);
+                    continue;
+                }
+
+                var maxCount = plrs.Count(x => IsGameModifierValid(x, mod, id));
+
+                if (maxCount == 0)
+                {
+                    Logger<MiraApiPlugin>.Warning($"No players are valid for {mod.ModifierName}");
+                    continue;
+                }
+
+                var num = Math.Clamp(count, 0, maxCount);
+
+                for (var i = 0; i < num; i++)
+                {
+                    var randomNum = rand.Next(100);
+
+                    if (randomNum < chance)
+                    {
+                        filteredModifiers.Add(id);
+                    }
                 }
             }
-        }
 
-        var shuffledModifiers = filteredModifiers.Randomize();
-        if (shuffledModifiers.Count > plrs.Count)
-        {
-            shuffledModifiers = shuffledModifiers.GetRange(0, plrs.Count);
-        }
-
-        while (shuffledModifiers.Count > 0)
-        {
-            var id = shuffledModifiers[0];
-
-            if (Activator.CreateInstance(IdToTypeModifierMap[id]) is not GameModifier mod)
+            if (filteredModifiers.Count == 0)
             {
-                Logger<MiraApiPlugin>.Error($"Failed to create instance of {IdToTypeModifierMap[id].Name}");
+                Logger<MiraApiPlugin>.Warning($"No filtered modifiers for priority {priority}");
                 continue;
             }
 
-            if (!plrs.Exists(x => IsGameModifierValid(x, mod, id)))
+            var shuffledList = filteredModifiers.Randomize();
+
+            if (shuffledList.Count > plrs.Count)
             {
-                shuffledModifiers.RemoveAt(0);
-                continue;
+                shuffledList = shuffledList.GetRange(0, plrs.Count);
             }
 
-            var plr = plrs.Random();
-
-            if (plr == null || !IsGameModifierValid(plr, mod, id))
+            foreach (var id in shuffledList)
             {
-                continue;
-            }
+                var mod = Activator.CreateInstance(IdToTypeModifierMap[id]) as GameModifier;
+                var plr = plrs.Where(x => IsGameModifierValid(x, mod!, id)).Random();
 
-            shuffledModifiers.RemoveAt(0);
-            plr.RpcAddModifier(id);
+                if (plr == null)
+                {
+                    Logger<MiraApiPlugin>.Warning($"Somehow valid players for modifier {mod!.ModifierName} disappeared");
+                }
+                else
+                {
+                    plr.RpcAddModifier(id);
+                }
+            }
         }
     }
 

MiraAPI/Modifiers/Types/GameModifier.cs

@@ -17,6 +17,12 @@ public abstract class GameModifier : BaseModifier
     /// <returns>An int value greater than or equal to zero.</returns>
     public abstract int GetAmountPerGame();
 
+    /// <summary>
+    /// Gets the priority at which the modifier will spawn. The higher the value, the higher up on the assignment list.
+    /// </summary>
+    /// <returns>An int value greater than or equal to -1.</returns>
+    public virtual int Priority() => -1;
+
     /// <summary>
     /// Determines whether the modifier is valid on a role.
     /// </summary>
@@ -27,6 +33,7 @@ public abstract class GameModifier : BaseModifier
     /// <summary>
     /// Determines whether the player won the game with this modifier.
     /// </summary>
+    /// <param name="reason">The reason why the game ended.</param>
     /// <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/Networking/CustomMurderRpc.cs

@@ -1,12 +1,14 @@
-using System.Collections;
-using System.Linq;
-using AmongUs.GameOptions;
+using AmongUs.GameOptions;
 using Assets.CoreScripts;
 using BepInEx.Unity.IL2CPP.Utils;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Gameplay;
 using Reactor.Networking.Attributes;
 using Reactor.Networking.Rpc;
 using Reactor.Utilities;
 using Reactor.Utilities.Extensions;
+using System.Collections;
+using System.Linq;
 using UnityEngine;
 
 namespace MiraAPI.Networking;
@@ -39,6 +41,15 @@ public static class CustomMurderRpc
         bool playKillSound = true)
     {
         var murderResultFlags = didSucceed ? MurderResultFlags.Succeeded : MurderResultFlags.FailedError;
+
+        var beforeMurderEvent = new BeforeMurderEvent(source, target);
+        MiraEventManager.InvokeEvent(beforeMurderEvent);
+
+        if (beforeMurderEvent.IsCancelled)
+        {
+            murderResultFlags = MurderResultFlags.FailedError;
+        }
+
         var murderResultFlags2 = MurderResultFlags.DecisionByHost | murderResultFlags;
 
         source.CustomMurder(
@@ -73,7 +84,6 @@ public static class CustomMurderRpc
         bool playKillSound = true)
     {
         source.isKilling = false;
-        Logger<MiraApiPlugin>.Error($"{source.PlayerId} trying to murder {target.PlayerId}");
         var data = target.Data;
         if (resultFlags.HasFlag(MurderResultFlags.FailedError))
         {
@@ -268,5 +278,8 @@ public static class CustomMurderRpc
 
         PlayerControl.LocalPlayer.isKilling = false;
         source.isKilling = false;
+
+        var afterMurderEvent = new AfterMurderEvent(source, target);
+        MiraEventManager.InvokeEvent(afterMurderEvent);
     }
 }

MiraAPI/Patches/AmongUsClientSyncPatch.cs

@@ -1,5 +1,7 @@
 using HarmonyLib;
 using InnerNet;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Player;
 using MiraAPI.GameOptions;
 using MiraAPI.Modifiers;
 using MiraAPI.Roles;
@@ -9,11 +11,16 @@ namespace MiraAPI.Patches;
 /// <summary>
 /// Sync all options, role settings, and modifiers to the player when they join the game.
 /// </summary>
-[HarmonyPatch(typeof(AmongUsClient), nameof(AmongUsClient.CreatePlayer))]
+[HarmonyPatch(typeof(AmongUsClient))]
 public static class AmongUsClientSyncPatch
 {
-    public static void Postfix(ClientData clientData)
+    [HarmonyPostfix]
+    [HarmonyPatch(typeof(AmongUsClient), nameof(AmongUsClient.CreatePlayer))]
+    public static void CreatePlayerPatch(ClientData clientData)
     {
+        var joinEvent = new PlayerJoinEvent(clientData);
+        MiraEventManager.InvokeEvent(joinEvent);
+
         if (!AmongUsClient.Instance.AmHost)
         {
             return;
@@ -28,4 +35,12 @@ public static class AmongUsClientSyncPatch
         CustomRoleManager.SyncAllRoleSettings(clientData.Id);
         ModifierManager.SyncAllModifiers(clientData.Id);
     }
+
+    [HarmonyPostfix]
+    [HarmonyPatch(typeof(AmongUsClient), nameof(AmongUsClient.OnPlayerLeft))]
+    public static void PlayerLeftPatch(ClientData data, DisconnectReasons reason)
+    {
+        var leftEvent = new PlayerLeaveEvent(data, reason);
+        MiraEventManager.InvokeEvent(leftEvent);
+    }
 }

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/Events/CanUsePatches.cs

@@ -0,0 +1,36 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Usables;
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace MiraAPI.Patches.Events;
+
+[HarmonyPatch]
+public static class CanUsePatches
+{
+    public static IEnumerable<MethodBase> TargetMethods()
+    {
+        yield return AccessTools.Method(typeof(Console), nameof(Console.CanUse));
+        yield return AccessTools.Method(typeof(MapConsole), nameof(MapConsole.CanUse));
+        yield return AccessTools.Method(typeof(SystemConsole), nameof(SystemConsole.CanUse));
+        yield return AccessTools.Method(typeof(Ladder), nameof(Ladder.CanUse));
+        yield return AccessTools.Method(typeof(PlatformConsole), nameof(PlatformConsole.CanUse));
+        yield return AccessTools.Method(typeof(OpenDoorConsole), nameof(OpenDoorConsole.CanUse));
+        yield return AccessTools.Method(typeof(DoorConsole), nameof(DoorConsole.CanUse));
+        yield return AccessTools.Method(typeof(OptionsConsole), nameof(OptionsConsole.CanUse));
+        yield return AccessTools.Method(typeof(ZiplineConsole), nameof(ZiplineConsole.CanUse));
+    }
+
+    [HarmonyPriority(Priority.Last)]
+    [HarmonyPrefix]
+    public static bool CanUsePatch(Il2CppSystem.Object __instance, [HarmonyArgument(0)] NetworkedPlayerInfo pc, [HarmonyArgument(1)] out bool canUse, [HarmonyArgument(2)] out bool couldUse)
+    {
+        var @event = new PlayerCanUseEvent(__instance.Cast<IUsable>());
+        MiraEventManager.InvokeEvent(@event);
+
+        canUse = couldUse = false;
+
+        return !@event.IsCancelled;
+    }
+}

MiraAPI/Patches/Events/EndGamePatches.cs

@@ -0,0 +1,20 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Gameplay;
+
+namespace MiraAPI.Patches.Events;
+
+/// <summary>
+/// Patch for trigging the GameEndEvent.
+/// </summary>
+[HarmonyPatch]
+public static class EndGamePatches
+{
+    [HarmonyPostfix]
+    [HarmonyPatch(typeof(EndGameManager), nameof(EndGameManager.SetEverythingUp))]
+    public static void SetEverythingUpPatch(EndGameManager __instance)
+    {
+        var @event = new GameEndEvent(__instance);
+        MiraEventManager.InvokeEvent(@event);
+    }
+}

MiraAPI/Patches/Events/KillAnimationPatches.cs

@@ -0,0 +1,25 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Gameplay;
+
+namespace MiraAPI.Patches;
+
+/// <summary>
+/// General patches for the KillAnimation class.
+/// </summary>
+[HarmonyPatch]
+public static class KillAnimationPatches
+{
+    /// <summary>
+    /// Used to trigger the <see cref="AfterMurderEvent"/>.
+    /// </summary>
+    /// <param name="source">The killer.</param>
+    /// <param name="target">The target.</param>
+    [HarmonyPostfix]
+    [HarmonyPatch(typeof(KillAnimation), nameof(KillAnimation.CoPerformKill))]
+    public static void KillAnimPostfix(PlayerControl source, PlayerControl target)
+    {
+        var afterMurderEvent = new AfterMurderEvent(source, target);
+        MiraEventManager.InvokeEvent(afterMurderEvent);
+    }
+}

MiraAPI/Patches/Events/MapBehaviourPatches.cs

@@ -0,0 +1,21 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Map;
+
+namespace MiraAPI.Patches.Events;
+
+/// <summary>
+/// Patch for map related MiraEvents.
+/// </summary>
+[HarmonyPatch]
+public static class MapBehaviourPatches
+{
+    [HarmonyPrefix]
+    [HarmonyPatch(typeof(MapBehaviour), nameof(MapBehaviour.ShowSabotageMap))]
+    public static bool MapShowSabotagePatch(MapBehaviour __instance)
+    {
+        var @event = new PlayerOpenSabotageEvent(__instance);
+        MiraEventManager.InvokeEvent(@event);
+        return !@event.IsCancelled;
+    }
+}

MiraAPI/Patches/Events/SabotageEventPatches.cs

@@ -0,0 +1,30 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Map;
+
+namespace MiraAPI.Patches.Events;
+
+/// <summary>
+/// Used for patching sabotage/system related MiraEvents.
+/// </summary>
+[HarmonyPatch]
+public static class SabotageEventPatches
+{
+    [HarmonyPrefix]
+    [HarmonyPatch(typeof(ShipStatus), nameof(ShipStatus.RpcUpdateSystem), typeof(SystemTypes), typeof(byte))]
+    public static bool ShipStatusUpdateSystemPrefix(ShipStatus __instance, SystemTypes systemType, byte amount)
+    {
+        var @event = new UpdateSystemEvent(systemType, PlayerControl.LocalPlayer, amount);
+        MiraEventManager.InvokeEvent(@event);
+        return !@event.IsCancelled;
+    }
+
+    [HarmonyPrefix]
+    [HarmonyPatch(typeof(ShipStatus), nameof(ShipStatus.RpcCloseDoorsOfType))]
+    public static bool ShipStatusCloseDoorsOfTypePrefix(ShipStatus __instance, SystemTypes type)
+    {
+        var @event = new CloseDoorsEvent(type);
+        MiraEventManager.InvokeEvent(@event);
+        return !@event.IsCancelled;
+    }
+}

MiraAPI/Patches/Events/StartMeetingEventPatch.cs

@@ -0,0 +1,21 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Meeting;
+using MiraAPI.Utilities;
+
+namespace MiraAPI.Patches.Events;
+
+[HarmonyPatch]
+public static class StartMeetingEventPatch
+{
+    [HarmonyPrefix]
+    [HarmonyPatch(typeof(PlayerControl), nameof(PlayerControl.CmdReportDeadBody))]
+    public static bool PlayerControlCmdReportDeadBodyPrefix(PlayerControl __instance, NetworkedPlayerInfo? target)
+    {
+        var body = target != null ? Helpers.GetBodyById(target.PlayerId) : null;
+
+        var @event = new StartMeetingEvent(__instance, target, body);
+        MiraEventManager.InvokeEvent(@event);
+        return !@event.IsCancelled;
+    }
+}

MiraAPI/Patches/Events/UsePatches.cs

@@ -0,0 +1,35 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla;
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace MiraAPI.Patches.Events;
+
+[HarmonyPatch]
+public static class UsePatches
+{
+    public static IEnumerable<MethodBase> TargetMethods()
+    {
+        yield return AccessTools.Method(typeof(Console), nameof(Console.Use));
+        yield return AccessTools.Method(typeof(MapConsole), nameof(MapConsole.Use));
+        yield return AccessTools.Method(typeof(SystemConsole), nameof(SystemConsole.Use));
+        yield return AccessTools.Method(typeof(Vent), nameof(Vent.Use));
+        yield return AccessTools.Method(typeof(Ladder), nameof(Ladder.Use));
+        yield return AccessTools.Method(typeof(PlatformConsole), nameof(PlatformConsole.Use));
+        yield return AccessTools.Method(typeof(OpenDoorConsole), nameof(OpenDoorConsole.Use));
+        yield return AccessTools.Method(typeof(DoorConsole), nameof(DoorConsole.Use));
+        yield return AccessTools.Method(typeof(OptionsConsole), nameof(OptionsConsole.Use));
+        yield return AccessTools.Method(typeof(ZiplineConsole), nameof(ZiplineConsole.Use));
+    }
+
+    [HarmonyPriority(Priority.Last)]
+    [HarmonyPrefix]
+    public static bool UsePatch(Il2CppSystem.Object __instance)
+    {
+        var @event = new PlayerUseEvent(__instance.Cast<IUsable>());
+        MiraEventManager.InvokeEvent(@event);
+
+        return !@event.IsCancelled;
+    }
+}

MiraAPI/Patches/Events/VentEventPatches.cs

@@ -0,0 +1,57 @@
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Usables;
+using System.Linq;
+
+namespace MiraAPI.Patches.Events;
+
+/// <summary>
+/// Patches to invoke vent related MiraEvents.
+/// </summary>
+[HarmonyPatch]
+public static class VentEventPatches
+{
+    // necessary because Vent.Use is inlined in il2cpp.
+    private static bool _showButtons;
+
+    [HarmonyPostfix]
+    [HarmonyPatch(typeof(VentButton), nameof(VentButton.DoClick))]
+    public static void VentUsePostfix(VentButton __instance)
+    {
+        __instance.currentTarget?.SetButtons(_showButtons);
+    }
+
+    [HarmonyPrefix]
+    [HarmonyPatch(typeof(PlayerPhysics), nameof(PlayerPhysics.RpcEnterVent))]
+    public static bool PlayerPhysicsRpcEnterVentPrefix(PlayerPhysics __instance, int id)
+    {
+        var pc = __instance.myPlayer;
+        var vent = ShipStatus.Instance.AllVents.FirstOrDefault(v => v.Id == id);
+
+        var @event = new EnterVentEvent(pc, vent);
+        MiraEventManager.InvokeEvent(@event);
+
+        if (pc.AmOwner)
+        {
+            _showButtons = !@event.IsCancelled;
+        }
+        return !@event.IsCancelled;
+    }
+
+    [HarmonyPrefix]
+    [HarmonyPatch(typeof(PlayerPhysics), nameof(PlayerPhysics.RpcExitVent))]
+    public static bool PlayerPhysicsRpcExitVentPrefix(PlayerPhysics __instance, int id)
+    {
+        var pc = __instance.myPlayer;
+        var vent = ShipStatus.Instance.AllVents.First(v => v.Id == id);
+
+        var @event = new ExitVentEvent(pc, vent);
+        MiraEventManager.InvokeEvent(@event);
+
+        if (pc.AmOwner)
+        {
+            _showButtons = @event.IsCancelled;
+        }
+        return !@event.IsCancelled;
+    }
+}

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

@@ -13,7 +13,9 @@ namespace MiraAPI.Patches;
 public static class HudManagerPatches
 {
     // Custom buttons parent.
-    private static GameObject? _bottomLeft;
+    internal static GameObject? _bottomLeft;
+    internal static Transform? _bottomRight;
+    internal static Transform? _buttons;
 
     /*
     /// <summary>
@@ -34,12 +36,19 @@ public static class HudManagerPatches
     [HarmonyPatch(nameof(HudManager.Start))]
     public static void StartPostfix(HudManager __instance)
     {
-        var buttons = __instance.transform.Find("Buttons");
-        var bottomRight = buttons.Find("BottomRight");
+        if (_buttons == null)
+        {
+            _buttons = __instance.transform.Find("Buttons");
+        }
+
+        if (_bottomRight == null)
+        {
+            _bottomRight = _buttons.Find("BottomRight");
+        }
 
         if (_bottomLeft == null)
         {
-            _bottomLeft = Object.Instantiate(bottomRight.gameObject, buttons);
+            _bottomLeft = Object.Instantiate(_bottomRight.gameObject, _buttons);
         }
 
         foreach (var t in _bottomLeft.GetComponentsInChildren<ActionButton>(true))
@@ -59,7 +68,7 @@ public static class HudManagerPatches
             var location = button.Location switch
             {
                 ButtonLocation.BottomLeft => _bottomLeft.transform,
-                ButtonLocation.BottomRight => bottomRight,
+                ButtonLocation.BottomRight => _bottomRight,
                 _ => null,
             };
 

MiraAPI/Patches/IntroCutscenePatches.cs

@@ -1,4 +1,6 @@
 using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Gameplay;
 using MiraAPI.Roles;
 using MiraAPI.Utilities;
 using UnityEngine;
@@ -20,6 +22,14 @@ public static class IntroCutscenePatches
         }
     }*/
 
+    [HarmonyPostfix]
+    [HarmonyPatch(nameof(IntroCutscene.CoBegin))]
+    public static void IntroBeginPatch(IntroCutscene __instance)
+    {
+        var @event = new IntroBeginEvent(__instance);
+        MiraEventManager.InvokeEvent(@event);
+    }
+
     [HarmonyPrefix]
     [HarmonyPatch(nameof(IntroCutscene.BeginCrewmate))]
     public static bool BeginCrewmatePatch(IntroCutscene __instance)

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;

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

@@ -1,11 +1,11 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using HarmonyLib;
+using HarmonyLib;
 using MiraAPI.PluginLoading;
 using MiraAPI.Roles;
 using MiraAPI.Utilities;
 using MiraAPI.Utilities.Assets;
+using System;
+using System.Collections.Generic;
+using System.Linq;
 using UnityEngine;
 using UnityEngine.Events;
 using UnityEngine.UI;

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;
 
@@ -25,13 +23,9 @@ public static class NotificationPopperPatch
             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(
             StringNames.LobbyChangeSettingNotificationRole,

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;

MiraAPI/Patches/PlayerControlPatches.cs

@@ -1,8 +1,12 @@
 using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Gameplay;
+using MiraAPI.Events.Vanilla.Player;
 using MiraAPI.Hud;
 using MiraAPI.Modifiers;
 using MiraAPI.Roles;
 using Reactor.Utilities.Extensions;
+using System.Linq;
 
 namespace MiraAPI.Patches;
 
@@ -16,7 +20,7 @@ public static class PlayerControlPatches
     /// Adds the modifier component to the player on start.
     /// </summary>
     /// <param name="__instance">PlayerControl instance.</param>
-    [HarmonyPrefix]
+    [HarmonyPostfix]
     [HarmonyPatch(nameof(PlayerControl.Start))]
     public static void PlayerControlStartPostfix(PlayerControl __instance)
     {
@@ -32,19 +36,54 @@ public static class PlayerControlPatches
     /// Calls the OnDeath method for all active modifiers.
     /// </summary>
     /// <param name="__instance">PlayerControl instance.</param>
-    /// <param name="reason">The death reason.</param>
     [HarmonyPostfix]
     [HarmonyPatch(nameof(PlayerControl.Die))]
     public static void PlayerControlDiePostfix(PlayerControl __instance, DeathReason reason)
     {
+        var deathEvent = new PlayerDeathEvent(__instance, reason);
+        MiraEventManager.InvokeEvent(deathEvent);
+
         var modifiersComponent = __instance.GetComponent<ModifierComponent>();
 
         if (modifiersComponent)
         {
-            modifiersComponent.ActiveModifiers.ForEach(x=>x.OnDeath(reason));
+            modifiersComponent.ActiveModifiers.ForEach(x => x.OnDeath(reason));
         }
     }
 
+    /// <summary>
+    /// Used to trigger the <see cref="CompleteTaskEvent"/>.
+    /// </summary>
+    /// <param name="__instance">PlayerControl instance.</param>
+    /// <param name="idx">The task id.</param>
+    [HarmonyPostfix]
+    [HarmonyPatch(nameof(PlayerControl.CompleteTask))]
+    public static void PlayerCompleteTaskPostfix(PlayerControl __instance, uint idx)
+    {
+        var playerTask = __instance.myTasks.ToArray().First(playerTask => playerTask.Id == idx);
+        if (playerTask != null)
+        {
+            var completeTaskEvent = new CompleteTaskEvent(__instance, playerTask);
+            MiraEventManager.InvokeEvent(completeTaskEvent);
+        }
+    }
+
+    /// <summary>
+    /// Used to trigger the <see cref="BeforeMurderEvent"/>.
+    /// </summary>
+    /// <param name="__instance">The source player.</param>
+    /// <param name="target">The target.</param>
+    /// <param name="didSucceed">Whether the kill succeeded.</param>
+    [HarmonyPrefix]
+    [HarmonyPatch(nameof(PlayerControl.RpcMurderPlayer))]
+    public static void PlayerControlMurderPrefix(PlayerControl __instance, PlayerControl target, ref bool didSucceed)
+    {
+        var beforeMurderEvent = new BeforeMurderEvent(__instance, target);
+        MiraEventManager.InvokeEvent(beforeMurderEvent);
+
+        didSucceed = beforeMurderEvent.IsCancelled;
+    }
+
     /// <summary>
     /// FixedUpdate handler for custom roles and custom buttons.
     /// </summary>

MiraAPI/Patches/Roles/EjectionPatches.cs

@@ -1,4 +1,6 @@
 using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Meeting;
 using MiraAPI.Roles;
 
 namespace MiraAPI.Patches.Roles;
@@ -13,6 +15,13 @@ public static class EjectionPatches
     [HarmonyPatch(nameof(ExileController.Begin))]
     public static void BeginPostfix(ExileController __instance)
     {
+        var @event = new EjectionEvent(__instance.initData.networkedPlayer.Object, __instance);
+        MiraEventManager.InvokeEvent(@event);
+
+        if (@event.IsCancelled)
+        {
+            return;
+        }
         if (!__instance.initData.networkedPlayer || !__instance.initData.networkedPlayer.Role ||
             __instance.initData.networkedPlayer.Role is not ICustomRole role)
         {

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/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;
 

MiraAPI/Patches/Roles/RoleOptionsCollectionPatch.cs

@@ -12,7 +12,7 @@ namespace MiraAPI.Patches.Roles;
 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]
@@ -42,7 +42,7 @@ public static class RoleOptionsCollectionPatch
     }
 
     /// <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]

MiraAPI/Patches/Roles/SabotageButtonPatch.cs

@@ -4,7 +4,7 @@ using MiraAPI.Roles;
 namespace MiraAPI.Patches.Roles;
 
 [HarmonyPatch(typeof(SabotageButton))]
-public static class SabotageButtonPatch
+public class SabotageButtonPatch
 {
     /// <summary>
     /// Patches the Sabotage button to check if the player's custom role can use sabotage.

MiraAPI/Patches/Roles/TaskAdderPatch.cs

@@ -1,11 +1,11 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using AmongUs.GameOptions;
+using AmongUs.GameOptions;
 using HarmonyLib;
+using System;
+using System.Collections.Generic;
 using MiraAPI.PluginLoading;
 using MiraAPI.Roles;
 using MiraAPI.Utilities.Assets;
+using System.Linq;
 using TMPro;
 using UnityEngine;
 using Object = UnityEngine.Object;

MiraAPI/Patches/VentPatches.cs

@@ -1,8 +1,8 @@
-using System.Linq;
-using HarmonyLib;
+using HarmonyLib;
+using MiraAPI.Events;
+using MiraAPI.Events.Vanilla.Usables;
 using MiraAPI.Roles;
 using MiraAPI.Utilities;
-using Reactor.Utilities;
 using UnityEngine;
 
 namespace MiraAPI.Patches;
@@ -20,6 +20,15 @@ public static class VentPatches
     [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 @event = new PlayerCanUseEvent(__instance.Cast<IUsable>());
+        MiraEventManager.InvokeEvent(@event);
+
+        if (@event.IsCancelled)
+        {
+            canUse = couldUse = false;
+            return;
+        }
+
         var @object = pc.Object;
         var role = @object.Data.Role;
 
@@ -31,10 +40,10 @@ public static class VentPatches
         {
             switch (canVent)
             {
-                case true when modifiers.Exists(x => x.CanVent().HasValue && x.CanVent()==false):
+                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):
+                case false when modifiers.Exists(x => x.CanVent().HasValue && x.CanVent() == true):
                     couldUse = true;
                     break;
             }
@@ -50,6 +59,7 @@ public static class VentPatches
             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,9 +1,9 @@
-using System.Collections.Generic;
-using System.Collections.ObjectModel;
-using BepInEx;
+using BepInEx;
 using BepInEx.Configuration;
 using MiraAPI.GameModes;
 using MiraAPI.GameOptions;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
 using MiraAPI.Hud;
 
 namespace MiraAPI.PluginLoading;
@@ -57,21 +57,10 @@ public class MiraPluginInfo
         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; } = [];

MiraAPI/PluginLoading/MiraPluginManager.cs

@@ -1,10 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Reflection;
-using BepInEx.Unity.IL2CPP;
+using BepInEx.Unity.IL2CPP;
 using MiraAPI.Colors;
-using MiraAPI.Cosmetics;
+using MiraAPI.Events;
 using MiraAPI.GameOptions;
 using MiraAPI.GameOptions.Attributes;
 using MiraAPI.Hud;
@@ -13,6 +9,10 @@ using MiraAPI.Roles;
 using MiraAPI.Utilities;
 using Reactor.Networking;
 using Reactor.Utilities;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Reflection;
 
 namespace MiraAPI.PluginLoading;
 
@@ -30,7 +30,6 @@ public sealed class MiraPluginManager
     internal void Initialize()
     {
         Instance = this;
-        CustomCosmeticManager.RegisterVanilla();
         IL2CPPChainloader.Instance.PluginLoad += (pluginInfo, assembly, plugin) =>
         {
             if (plugin is not IMiraPlugin miraPlugin)
@@ -42,7 +41,6 @@ public sealed class MiraPluginManager
 
             RegisterModifierAttribute(assembly);
             RegisterAllOptions(assembly, info);
-            RegisterAllCosmetics(assembly, info);
 
             RegisterRoleAttribute(assembly, info);
             RegisterButtonAttribute(assembly, info);
@@ -54,16 +52,17 @@ public sealed class MiraPluginManager
             Logger<MiraApiPlugin>.Info($"Registering mod {pluginInfo.Metadata.GUID} with Mira API.");
         };
         IL2CPPChainloader.Instance.Finished += PaletteManager.RegisterAllColors;
+        IL2CPPChainloader.Instance.Finished += MiraEventManager.SortAllHandlers;
     }
 
     /// <summary>
     /// Get a mira plugin by its GUID.
     /// </summary>
-    /// <param name="uniqueId">The plugin GUID.</param>
+    /// <param name="guid">The plugin GUID.</param>
     /// <returns>A MiraPluginInfo.</returns>
-    public static MiraPluginInfo GetPluginByGuid(string uniqueId)
+    public static MiraPluginInfo GetPluginByGuid(string guid)
     {
-        return Instance._registeredPlugins.Values.First(plugin => plugin.PluginId == uniqueId);
+        return Instance._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 = [];

MiraAPI/Roles/CustomRoleConfiguration.cs

@@ -15,6 +15,8 @@ public struct CustomRoleConfiguration
     /// <param name="role">The role in which you are configuring.</param>
     public CustomRoleConfiguration(ICustomRole role)
     {
+        var roleBehaviour = role as RoleBehaviour;
+
         MaxRoleCount = 15;
         DefaultRoleCount = 0;
         DefaultChance = 0;
@@ -29,18 +31,15 @@ public struct CustomRoleConfiguration
         };
         RoleHintType = RoleHintType.RoleTab;
         GhostRole = role.Team is ModdedRoleTeams.Impostor ? RoleTypes.ImpostorGhost : RoleTypes.CrewmateGhost;
-        CanGetKilled = !IsGhostRole && role.Team is not ModdedRoleTeams.Impostor;
+        CanGetKilled = roleBehaviour?.IsDead == false && 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;
+        HideSettings = roleBehaviour?.IsDead == true;
         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>
@@ -101,11 +100,6 @@ public struct CustomRoleConfiguration
     /// </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>
@@ -125,6 +119,4 @@ public struct CustomRoleConfiguration
     /// 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;
@@ -93,7 +93,7 @@ public static class CustomRoleManager
         roleBehaviour.MaxCount = customRole.Configuration.MaxRoleCount;
         roleBehaviour.RoleScreenshot = customRole.Configuration.OptionsScreenshot.LoadAsset();
 
-        if (customRole.Configuration.IsGhostRole)
+        if (roleBehaviour.IsDead)
         {
             RoleManager.GhostRoles.Add(roleBehaviour.Role);
         }

MiraAPI/Roles/CustomRoleSingleton.cs

@@ -8,7 +8,7 @@ namespace MiraAPI.Roles;
 /// <typeparam name="T">The role you are trying to access.</typeparam>
 public static class CustomRoleSingleton<T> where T : ICustomRole
 {
-    private static T? _instance;
+    private static ICustomRole? _instance;
 
     /// <summary>
     /// Gets the instance of the role.

MiraAPI/Roles/ICustomRole.cs

@@ -1,9 +1,9 @@
-using System.Text;
-using BepInEx.Configuration;
+using BepInEx.Configuration;
 using MiraAPI.Modifiers;
 using MiraAPI.PluginLoading;
 using MiraAPI.Utilities;
 using Reactor.Utilities;
+using System.Text;
 using UnityEngine;
 
 namespace MiraAPI.Roles;
@@ -39,7 +39,7 @@ public interface ICustomRole
     ModdedRoleTeams Team { get; }
 
     /// <summary>
-    /// Gets the advanced settings of the role.
+    /// Gets advanced settings of the role.
     /// </summary>
     CustomRoleConfiguration Configuration { get; }
 
@@ -63,7 +63,7 @@ public interface ICustomRole
     /// Gets the role chance option.
     /// </summary>
     /// <returns>The role chance option.</returns>
-    public int? GetChance()
+    public virtual int? GetChance()
     {
         if (!Configuration.CanModifyChance)
         {
@@ -82,7 +82,7 @@ public interface ICustomRole
     /// Gets the role count option.
     /// </summary>
     /// <returns>The role count option.</returns>
-    public int? GetCount()
+    public virtual int? GetCount()
     {
         if (ParentMod.PluginConfig.TryGetEntry(NumConfigDefinition, out ConfigEntry<int> entry))
         {
@@ -96,7 +96,7 @@ public interface ICustomRole
     /// Sets the role chance option.
     /// </summary>
     /// <param name="chance">The chance between 0 and 100.</param>
-    public void SetChance(int chance)
+    public virtual void SetChance(int chance)
     {
         if (!Configuration.CanModifyChance)
         {
@@ -117,7 +117,7 @@ public interface ICustomRole
     /// 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)
+    public virtual void SetCount(int count)
     {
         if (ParentMod.PluginConfig.TryGetEntry(NumConfigDefinition, out ConfigEntry<int> entry))
         {