Adjust code that gets roles and modifiers list

This is necessary to prevent some pretty common option desync that tends to happen. If anyone else can optimize it further or move it somewhere else, go for it.

.editorconfig

@@ -1 +1,106 @@
-[*.{cs,vb}]
+[*.{cs,vb}]
+
+# IDE0008: Use explicit type
+dotnet_diagnostic.IDE0008.severity = none
+
+# IDE0160: Convert to block scoped namespace
+dotnet_diagnostic.IDE0160.severity = none
+
+# IDE0011: Add braces
+dotnet_diagnostic.IDE0011.severity = none
+
+# CS8618: Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable.
+dotnet_diagnostic.CS8618.severity = none
+
+# CA1805: Do not initialize unnecessarily
+dotnet_diagnostic.CA1805.severity = none
+
+# S3358: Ternary operators should not be nested
+dotnet_diagnostic.S3358.severity = none
+
+# IDE1006: Naming Styles
+dotnet_diagnostic.IDE1006.severity = none
+
+# S3267: Use LINQ methods to simply foreach loops
+dotnet_diagnostic.S3267.severity = none
+
+# S125: Sections of code should not be commented out
+dotnet_diagnostic.S125.severity = none
+
+# SA1512: Single-line comments should not be followed by blank line
+dotnet_diagnostic.SA1512.severity = none
+
+# S2696: Instance members should not write to "static" fields
+dotnet_diagnostic.S2696.severity = none
+
+# S2245: Pseudorandom number generators (PRNGs) should not be used in security contexts
+dotnet_diagnostic.S2245.severity = none
+
+# IDE0130: Namespace does not match folder structure
+dotnet_diagnostic.IDE0130.severity = none
+
+# SA1633: File should have header
+dotnet_diagnostic.SA1633.severity = none
+
+# SA1101: Prefix local calls with this
+dotnet_diagnostic.SA1101.severity = none
+
+# SA1600: Elements should be documented
+dotnet_diagnostic.SA1600.severity = none
+
+# SA1516: Elements should be separated by blank line
+dotnet_diagnostic.SA1516.severity = none
+
+# SA1503: Braces should not be omitted
+dotnet_diagnostic.SA1503.severity = none
+
+# SA1201: Elements should appear in the correct order
+dotnet_diagnostic.SA1201.severity = none
+
+# SA1402: File may only contain a single type
+dotnet_diagnostic.SA1402.severity = none
+
+# SA1204: Static elements should appear before instance elements
+dotnet_diagnostic.SA1204.severity = none
+
+# SA1202: Elements should be ordered by access
+dotnet_diagnostic.SA1202.severity = none
+
+# SA1649: File name should match first type name
+dotnet_diagnostic.SA1649.severity = none
+
+# SA1313: Parameter names should begin with lower-case letter
+dotnet_diagnostic.SA1313.severity = none
+
+# SA1636: The file header copyright text should match the copyright text from the settings
+dotnet_diagnostic.SA1636.severity = none
+
+# SA1309: Field names should not begin with underscore
+dotnet_diagnostic.SA1309.severity = none
+
+# SA1407: Arithmetic expressions should declare precedence
+dotnet_diagnostic.SA1407.severity = none
+
+# SA1133: Each attribute should be placed in its own set of square brackets
+dotnet_diagnostic.SA1133.severity = none
+
+# IDE0001: Simplify Names
+dotnet_diagnostic.IDE0001.severity = warning
+
+# IDE0079: Remove unnecessary suppression
+dotnet_diagnostic.IDE0079.severity = none
+
+# S3903: Types should be defined in named namespaces
+dotnet_diagnostic.S3903.severity = none
+
+# IDE0045: Convert to conditional expression
+dotnet_diagnostic.IDE0045.severity = none
+
+# IDE0046: Convert to conditional expression
+dotnet_diagnostic.IDE0046.severity = none
+
+# S1244: Floating point numbers should not be tested for equality
+dotnet_diagnostic.S1244.severity = none
+
+# S2325: Methods and properties that don't access instance data should be static
+dotnet_diagnostic.S2325.severity = none

.gitignore

@@ -1,9 +1,9 @@
 .git/
 .idea/
-.vs/
+.vs*/
 obj/
 bin/
 .qodo/
 
 *.user
-*.lock.json
+*.lock.json

AmongUs.props

@@ -1,14 +1,14 @@
 <Project>
     <ItemGroup>
-        <PackageReference Include="Reactor" Version="2.3.1" />
+        <PackageReference Include="Reactor" Version="2.5.0-ci.371" />
         <PackageReference Include="BepInEx.Unity.IL2CPP" Version="6.0.0-be.735" Private="false" ExcludeAssets="runtime;native" />
-        <PackageReference Include="AmongUs.GameLibs.Steam" Version="2025.4.15" PrivateAssets="all" />
+        <PackageReference Include="AmongUs.GameLibs.Steam" Version="2026.9.29" PrivateAssets="all" />
 
         <PackageReference Include="BepInEx.AutoPlugin" Version="1.1.0" PrivateAssets="all" />
         <PackageReference Include="BepInEx.IL2CPP.MSBuild" Version="2.1.0-rc.1" PrivateAssets="all" ExcludeAssets="runtime" />
     </ItemGroup>
-
+    
     <Target Name="Copy" AfterTargets="Build" Condition="'$(AmongUs)' != ''">
         <Copy SourceFiles="$(TargetPath)" DestinationFolder="$(AmongUs)/BepInEx/plugins/" UseSymboliclinksIfPossible="true" />
     </Target>
-</Project>
+</Project>

Directory.Build.props

@@ -8,7 +8,7 @@
 
         <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
 
-        <VersionPrefix>0.2.0</VersionPrefix>
+        <VersionPrefix>0.5.0</VersionPrefix>
         <VersionSuffix>dev</VersionSuffix>
 
         <Authors>All Of Us, XtraCube, Angxl</Authors>
@@ -28,18 +28,15 @@
         <AnalysisLevel>latest</AnalysisLevel>
         <AnalysisMode>recommended</AnalysisMode>
         <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
+		<NoWarn>$(NoWarn);SA0001</NoWarn>
     </PropertyGroup>
 
     <ItemGroup>
+        <PackageReference Include="Roslynator.Analyzers" Version="5.0.0" PrivateAssets="all" />
+        <PackageReference Include="Roslynator.Formatting.Analyzers" Version="5.0.0" PrivateAssets="all" />
+        <PackageReference Include="Roslynator.CodeAnalysis.Analyzers" Version="5.0.0" PrivateAssets="all" />
+        <PackageReference Include="SonarAnalyzer.CSharp" Version="10.32.0.713" PrivateAssets="all" />
         <PackageReference Include="StyleCop.Analyzers" Version="1.2.0-beta.556" PrivateAssets="all" />
-        <AdditionalFiles Include="$(MSBuildThisFileDirectory)\stylecop.json" Link="stylecop.json" Visible="false" />
+        <AdditionalFiles Include="$(MSBuildThisFileDirectory)/stylecop.json" Link="stylecop.json" Visible="false" />
-
-        <PackageReference Include="SonarAnalyzer.CSharp" Version="10.7.0.110445">
-            <PrivateAssets>all</PrivateAssets>
-            <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
-        </PackageReference>
     </ItemGroup>
-    <PropertyGroup>
+</Project>
-        <CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)\stylecop.ruleset</CodeAnalysisRuleSet>
-    </PropertyGroup>
-</Project>

ExternalAnnotations/0Harmony.xml

@@ -0,0 +1,29 @@
+<assembly name="0Harmony">
+  <member name="T:HarmonyLib.HarmonyPatch">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor(JetBrains.Annotations.ImplicitUseTargetFlags)">
+      <argument>3</argument>
+    </attribute>
+  </member>
+
+  <member name="T:HarmonyLib.HarmonyPrefix">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor" />
+  </member>
+  <member name="T:HarmonyLib.HarmonyPostfix">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor" />
+  </member>
+  <member name="T:HarmonyLib.HarmonyTranspiler">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor" />
+  </member>
+  <member name="T:HarmonyLib.HarmonyFinalizer">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor" />
+  </member>
+  <member name="T:HarmonyLib.HarmonyPrepare">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor" />
+  </member>
+  <member name="T:HarmonyLib.HarmonyTargetMethod">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor" />
+  </member>
+  <member name="T:HarmonyLib.HarmonyTargetMethods">
+    <attribute ctor="M:JetBrains.Annotations.MeansImplicitUseAttribute.#ctor" />
+  </member>
+</assembly>

MiraAPI.Example.Extension/ExampleExtensionPlugin.cs

@@ -1,31 +0,0 @@
-using System;
-using BepInEx;
-using BepInEx.Unity.IL2CPP;
-using HarmonyLib;
-using MiraAPI.PluginLoading;
-using Reactor;
-using Reactor.Networking;
-using Reactor.Networking.Attributes;
-
-namespace MiraAPI.Example.Extension;
-
-[BepInAutoPlugin("mira.example.extension", "MiraExampleExtensionMod")]
-[BepInProcess("Among Us.exe")]
-[BepInDependency(ReactorPlugin.Id)]
-[BepInDependency(MiraApiPlugin.Id)]
-[BepInDependency(ExamplePlugin.Id)]
-[ReactorModFlags(ModFlags.RequireOnAllClients)]
-public partial class ExampleExtensionPlugin : BasePlugin, IMiraExtension
-{
-    public Harmony Harmony { get; } = new(Id);
-
-    public override void Load()
-    {
-        Harmony.PatchAll();
-    }
-
-    public Type GetBasePluginType()
-    {
-        return typeof(ExamplePlugin);
-    }
-}

MiraAPI.Example.Extension/MiraAPI.Example.Extension.csproj

@@ -1,14 +0,0 @@
-<Project Sdk="Microsoft.NET.Sdk">
-    <PropertyGroup>
-        <Version>1.0.0</Version>
-        <Description>Example extension for Mira API</Description>
-        <Authors>Angxl, XtraCube</Authors>
-    </PropertyGroup>
-
-    <ItemGroup>
-        <ProjectReference Include="..\MiraAPI\MiraAPI.csproj" />
-        <ProjectReference Include="..\MiraAPI.Example\MiraAPI.Example.csproj" />
-    </ItemGroup>
-
-    <Import Project="..\AmongUs.props" />
-</Project>

MiraAPI.Example.Extension/Modifiers/ExtensionModifier.cs

@@ -1,16 +0,0 @@
-using MiraAPI.Example.Extension.Options;
-using MiraAPI.GameOptions;
-using MiraAPI.Modifiers.Types;
-
-namespace MiraAPI.Example.Extension.Modifiers;
-
-public class ExtensionModifier : GameModifier
-{
-    public override string ModifierName => "Extension Modifier";
-
-    public override string GetDescription() => "This is from the extension mod!";
-
-    public override int GetAssignmentChance() => (int)OptionGroupSingleton<ExtensionModifierOptions>.Instance.ModifierChance;
-
-    public override int GetAmountPerGame() => (int)OptionGroupSingleton<ExtensionModifierOptions>.Instance.ModifierLimit;
-}

MiraAPI.Example.Extension/Options/ExtendedFreezerOptions.cs

@@ -1,13 +0,0 @@
-using MiraAPI.Example.Roles;
-using MiraAPI.GameOptions;
-using MiraAPI.GameOptions.Attributes;
-
-namespace MiraAPI.Example.Extension.Options;
-
-public class ExtendedFreezerOptions : AbstractOptionGroup<FreezerRole>
-{
-    public override string GroupName => "Extended Freezer Role Options";
-
-    [ModdedNumberOption("Freeze Uses", 1, 5)]
-    public float FreezeUses { get; set; } = 1;
-}

MiraAPI.Example.Extension/Options/ExtensionModifierOptions.cs

@@ -1,17 +0,0 @@
-using MiraAPI.Example.Extension.Modifiers;
-using MiraAPI.GameOptions;
-using MiraAPI.GameOptions.Attributes;
-using MiraAPI.Utilities;
-
-namespace MiraAPI.Example.Extension.Options;
-
-public class ExtensionModifierOptions : AbstractOptionGroup<ExtensionModifier>
-{
-    public override string GroupName => "Extension Modifier Options";
-
-    [ModdedNumberOption("Modifier Chance", 0, 100, 10, MiraNumberSuffixes.Percent)]
-    public float ModifierChance { get; set; } = 100f;
-
-    [ModdedNumberOption("Modifier Limit", 0, 10)]
-    public float ModifierLimit { get; set; } = 0;
-}

MiraAPI.Example.Extension/Patches/FreezeButtonPatch.cs

@@ -1,15 +0,0 @@
-using HarmonyLib;
-using MiraAPI.Example.Buttons.Freezer;
-using MiraAPI.Example.Extension.Options;
-using MiraAPI.GameOptions;
-
-namespace MiraAPI.Example.Extension.Patches;
-
-[HarmonyPatch(typeof(FreezeButton), nameof(FreezeButton.MaxUses), MethodType.Getter)]
-public static class FreezeButtonPatch
-{
-    public static void Postfix(ref int __result)
-    {
-        __result = (int)OptionGroupSingleton<ExtendedFreezerOptions>.Instance.FreezeUses;
-    }
-}

MiraAPI.Example/.editorconfig

@@ -0,0 +1,7 @@
+[*.{cs,vb}]
+
+# SA1602: Enumeration items should be documented.
+dotnet_diagnostic.SA1602.severity = none
+
+# SA1601: Partial elements should be documented
+dotnet_diagnostic.SA1601.severity = none

MiraAPI.Example/Buttons/Freezer/FreezeButton.cs

@@ -3,6 +3,7 @@ using MiraAPI.Example.Options.Roles;
 using MiraAPI.Example.Roles;
 using MiraAPI.GameOptions;
 using MiraAPI.Hud;
+using MiraAPI.Keybinds;
 using MiraAPI.Modifiers;
 using MiraAPI.Utilities;
 using MiraAPI.Utilities.Assets;
@@ -12,13 +13,13 @@ namespace MiraAPI.Example.Buttons.Freezer;
 
 public class FreezeButton : CustomActionButton<PlayerControl>
 {
-    public override string Name => "Freeze";
+    public override string Name => "button.freeze";
 
     public override float Cooldown => OptionGroupSingleton<FreezerRoleSettings>.Instance.FreezeDuration;
-
+    public override bool PauseTimerInVent => true;
-    public override int MaxUses => 1;
 
     public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
+    public override MiraKeybind? Keybind => MiraGlobalKeybinds.PrimaryAbility;
 
     protected override void OnClick()
     {

MiraAPI.Example/Buttons/MeetingButton.cs

@@ -1,5 +1,6 @@
 using MiraAPI.Example.Modifiers;
 using MiraAPI.Hud;
+using MiraAPI.Keybinds;
 using MiraAPI.Modifiers;
 using MiraAPI.Utilities.Assets;
 using UnityEngine;
@@ -8,13 +9,12 @@ namespace MiraAPI.Example.Buttons;
 
 public class MeetingButton : CustomActionButton
 {
-    public override string Name => "Call Meeting";
+    public override string Name => "button.callMeeting";
-
     public override float Cooldown => 15;
-
     public override int MaxUses => 3;
 
     public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
+    public override MiraKeybind? Keybind => MiraGlobalKeybinds.ModifierPrimaryAbility;
 
     public override bool Enabled(RoleBehaviour? role)
     {
@@ -28,10 +28,10 @@ public class MeetingButton : CustomActionButton
         PlayerControl.LocalPlayer.NetTransform.Halt();
         var minigame = Object.Instantiate(bt.MinigamePrefab, Camera.main!.transform, false);
 
-        var taskAdderGame = minigame as TaskAdderGame;
+        var taskAdderGame = minigame.TryCast<TaskAdderGame>();
-        if (taskAdderGame != null)
+        if (taskAdderGame)
         {
-            taskAdderGame.SafePositionWorld = bt.SafePositionLocal + (Vector2)bt.transform.position;
+            taskAdderGame!.SafePositionWorld = bt.SafePositionLocal + (Vector2)bt.transform.position;
         }
 
         minigame.transform.localPosition = new Vector3(0f, 0f, -50f);

MiraAPI.Example/Buttons/NeutralKillerButton.cs

@@ -1,19 +1,19 @@
-using MiraAPI.Example.Extension.GameOver;
+using MiraAPI.Example.GameOver;
-using MiraAPI.Example.Extension.Roles;
+using MiraAPI.Example.Roles;
 using MiraAPI.GameEnd;
 using MiraAPI.Hud;
+using MiraAPI.Keybinds;
 using MiraAPI.Utilities.Assets;
 using UnityEngine;
 
-namespace MiraAPI.Example.Extension.Buttons;
+namespace MiraAPI.Example.Buttons;
 
 public class NeutralKillerButton : CustomActionButton
 {
-    public override string Name => "Win Game";
+    public override string Name => "button.winGame";
-
     public override float Cooldown => 0f;
-
     public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
+    public override MiraKeybind Keybind => ExampleKeybinds.NeutralWinKeybind;
 
     protected override void OnClick()
     {

MiraAPI.Example/Buttons/Teleporter/TeleportButton.cs

@@ -3,6 +3,7 @@ using MiraAPI.Example.Options.Roles;
 using MiraAPI.Example.Roles;
 using MiraAPI.GameOptions;
 using MiraAPI.Hud;
+using MiraAPI.Keybinds;
 using MiraAPI.Utilities.Assets;
 using Reactor.Utilities;
 using UnityEngine;
@@ -11,7 +12,7 @@ namespace MiraAPI.Example.Buttons.Teleporter;
 
 public class TeleportButton : CustomActionButton
 {
-    public override string Name => "Teleport";
+    public override string Name => "button.teleport";
 
     public override float Cooldown => OptionGroupSingleton<TeleporterOptions>.Instance.TeleportCooldown.Value;
 
@@ -21,6 +22,7 @@ public class TeleportButton : CustomActionButton
     public override LoadableAsset<Sprite> Sprite => ExampleAssets.TeleportButton;
     public override Color TextOutlineColor => new Color32(221, 176, 152, 255);
     public static bool IsZoom { get; private set; }
+    public override MiraKeybind? Keybind => MiraGlobalKeybinds.PrimaryAbility;
 
     public override bool Enabled(RoleBehaviour? role)
     {
@@ -59,11 +61,14 @@ public class TeleportButton : CustomActionButton
         {
             Camera.main.orthographicSize = MeetingHud.Instance ? 3f : ft;
             ResolutionManager.ResolutionChanged.Invoke((float)Screen.width / Screen.height, Screen.width, Screen.height, Screen.fullScreen);
-            foreach (var cam in Camera.allCameras) cam.orthographicSize = Camera.main.orthographicSize;
+            foreach (var cam in Camera.allCameras)
+                cam.orthographicSize = Camera.main.orthographicSize;
+
             yield return null;
         }
 
-        foreach (var cam in Camera.allCameras) cam.orthographicSize = zoomDistance;
+        foreach (var cam in Camera.allCameras)
+            cam.orthographicSize = zoomDistance;
         ResolutionManager.ResolutionChanged.Invoke((float)Screen.width / Screen.height, Screen.width, Screen.height, Screen.fullScreen);
     }
 
@@ -73,12 +78,14 @@ public class TeleportButton : CustomActionButton
         {
             Camera.main.orthographicSize = MeetingHud.Instance ? 3f : ft;
             ResolutionManager.ResolutionChanged.Invoke((float)Screen.width / Screen.height, Screen.width, Screen.height, Screen.fullScreen);
-            foreach (var cam in Camera.allCameras) cam.orthographicSize = Camera.main.orthographicSize;
+            foreach (var cam in Camera.allCameras)
+                cam.orthographicSize = Camera.main.orthographicSize;
 
             yield return null;
         }
 
-        foreach (var cam in Camera.allCameras) cam.orthographicSize = 3f;
+        foreach (var cam in Camera.allCameras)
+            cam.orthographicSize = 3f;
         HudManager.Instance.ShadowQuad.gameObject.SetActive(true);
         IsZoom = false;
 

MiraAPI.Example/Buttons/ThinkButton.cs

@@ -0,0 +1,38 @@
+using MiraAPI.Hud;
+using MiraAPI.Keybinds;
+using MiraAPI.Translation;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.Buttons;
+
+public class ThinkButton : CustomActionButton
+{
+    public override string Name => "button.think";
+    public override float Cooldown => 15f;
+    public override float EffectDuration => 10f;
+    public override int MaxUses => 1;
+    public override ButtonUsesMode UsesMode => ButtonUsesMode.PerRound;
+    public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
+    public override MiraKeybind Keybind => MiraGlobalKeybinds.SecondaryAbility;
+
+    protected override void OnClick()
+    {
+        Button!.OverrideText("button.think.thinking".Translate());
+    }
+
+    public override void OnEffectEnd()
+    {
+        Button!.OverrideText("button.think".Translate());
+    }
+
+    public override bool IsEffectCancellable()
+    {
+        return true;
+    }
+
+    public override bool Enabled(RoleBehaviour? role)
+    {
+        return role != null && role.IsImpostor;
+    }
+}

MiraAPI.Example/ExampleAssets.cs

@@ -9,5 +9,6 @@ public static class ExampleAssets
 
     // Credit to EpicHorrors for the teleport button asset.
     public static LoadableResourceAsset TeleportButton { get; } = new("MiraAPI.Example.Resources.TeleportButton.png");
+    public static LoadableResourceAsset SharpshootButton { get; } = new("MiraAPI.Example.Resources.SharpshootButton.png");
     public static LoadableResourceAsset Banner { get; } = new("MiraAPI.Example.Resources.FortniteBanner.jpeg");
 }

MiraAPI.Example/ExampleColors.cs

@@ -1,4 +1,6 @@
 using MiraAPI.Colors;
+using MiraAPI.Colors.ColorSpaces;
+using MiraAPI.Utilities;
 using UnityEngine;
 
 namespace MiraAPI.Example;
@@ -6,12 +8,17 @@ namespace MiraAPI.Example;
 [RegisterCustomColors]
 public static class ExampleColors
 {
-    public static CustomColor Cerulean { get; } = new("Cerulean", new Color(0.0f, 0.48f, 0.65f))
+    public static CustomColor Cerulean { get; } = new("color.cerulean", new Color(0.0f, 0.48f, 0.65f))
     {
         ColorBrightness = CustomColorBrightness.Lighter,
     };
 
-    public static CustomColor Rose { get; } = new("Rose", new Color(0.98f, 0.26f, 0.62f));
+    public static CustomColor Rose { get; } = new("color.rose", new Color(0.98f, 0.26f, 0.62f));
 
-    public static CustomColor Gold { get; } = new("Gold", new Color(1.0f, 0.84f, 0.0f));
+    public static CustomColor Gold { get; } = new("color.gold", new Color(1.0f, 0.84f, 0.0f));
+
+    public static VariableColor Rainbow { get; } = new("color.rainbow", t => new HsbColor(MathUtilities.PingPong(t, 1f, 0.3f), 1f, 1f))
+    {
+        ColorBrightness = CustomColorBrightness.Lighter,
+    };
 }

MiraAPI.Example/ExampleEventHandlers.cs

@@ -1,4 +1,5 @@
-using System.Linq;
+using System.Globalization;
+using System.Linq;
 using MiraAPI.Events;
 using MiraAPI.Events.Mira;
 using MiraAPI.Events.Vanilla.Gameplay;
@@ -17,7 +18,7 @@ public static class ExampleEventHandlers
 {
     public static void Initialize()
     {
-        // You can register event handlers with the MiraEventManager class.
+        // You can register event handlers with the MiraEventManager class
         var handle = MiraEventManager.RegisterEventHandler<BeforeMurderEvent>(@event =>
         {
             Logger<ExamplePlugin>.Info($"{@event.Source.Data.PlayerName} is about to kill {@event.Target.Data.PlayerName}");
@@ -37,6 +38,21 @@ public static class ExampleEventHandlers
         MiraEventManager.UnregisterEventHandler(handle);
     }
 
+    // If you want to check vanilla buttons, use something like this!
+    [RegisterEvent]
+    public static void VanillaButtonClickHandler(VanillaButtonClickEvent @event)
+    {
+        Logger<ExamplePlugin>.Info($"{@event.Button.buttonLabelText.text} is being used!");
+        if (@event.PlayerTarget != null)
+        {
+            Logger<ExamplePlugin>.Info($"{@event.PlayerTarget.Data.PlayerName} is being targeted!");
+        }
+        else if (@event.VentTarget != null)
+        {
+            Logger<ExamplePlugin>.Info($"Vent with id {@event.VentTarget.Id.ToString(CultureInfo.InvariantCulture)} is being targeted!");
+        }
+    }
+
     // If you want to add extra votes to a player, do something like this.
     [RegisterEvent]
     public static void StartMeetingEvent(StartMeetingEvent _)
@@ -51,7 +67,7 @@ public static class ExampleEventHandlers
     [RegisterEvent(15)]
     public static void HandleVoteEvent(HandleVoteEvent @event)
     {
-        if (@event.VoteData.Owner.Data.Role is not FreezerRole) return;
+        if (@event.VoteData.Owner.Data.Role is not NeutralKillerRole) return;
 
         @event.VoteData.SetRemainingVotes(0);
 

MiraAPI.Example/ExampleKeybinds.cs

@@ -0,0 +1,10 @@
+using MiraAPI.Keybinds;
+using Rewired;
+
+namespace MiraAPI.Example;
+
+[RegisterCustomKeybinds]
+public static class ExampleKeybinds
+{
+    public static MiraKeybind NeutralWinKeybind { get; } = new("Neutral Win", KeyboardKeyCode.C, ControllerButton.RightStick, [ModifierKey.Shift]);
+}

MiraAPI.Example/ExampleLocalSetings.cs

@@ -0,0 +1,53 @@
+using BepInEx.Configuration;
+using MiraAPI.LocalSettings;
+using MiraAPI.LocalSettings.Attributes;
+using MiraAPI.Utilities;
+using UnityEngine;
+
+namespace MiraAPI.Example;
+
+public class ExampleLocalSettings(ConfigFile config) : LocalSettingsTab(config)
+{
+    public override string TabName => "settings.miraExample";
+    protected override bool ShouldCreateLabels => false;
+
+    public override LocalSettingTabAppearance TabAppearance => new()
+    {
+        ToggleActiveColor = Color.blue,
+        ToggleInactiveColor = Color.red,
+    };
+
+    [LocalSettingsButton]
+    public LocalSettingsButton ExampleButton { get; private set; } = new("settings.miraExample.button.exampleButton", OnExampleButtonClick);
+
+    [LocalToggleSetting]
+    public ConfigEntry<bool> ExampleToggle { get; private set; } = config.Bind("General", "Example Bool", true);
+
+    [LocalToggleSetting]
+    public ConfigEntry<bool> ExampleToggle2 { get; private set; } = config.Bind("General", "Example Bool 2", false);
+
+    [LocalSliderSetting(suffixType: MiraNumberSuffixes.Percent, formatString: "0", roundValue: true)]
+    public ConfigEntry<float> ExampleSlider { get; private set; } = config.Bind("General", "Slider", 50f);
+
+    [LocalNumberSetting]
+    public ConfigEntry<float> ExampleNumber { get; private set; } = config.Bind("General", "Example Number", 4f);
+
+    [LocalNumberSetting(min: 0.1f, max: 2.5f, increment: 0.1f, formatString: "0.0", suffixType: MiraNumberSuffixes.Multiplier)]
+    public ConfigEntry<float> ExampleFloatNumber { get; private set; } = config.Bind("General", "Example Multiplier", 1f);
+
+    [LocalEnumSetting]
+    public ConfigEntry<ExampleEnumSetting> ExampleEnum { get; private set; } = config.Bind("General", "Example Enum", ExampleEnumSetting.Fries);
+
+    private static void OnExampleButtonClick()
+    {
+        LocalSettingsTabSingleton<MiraApiSettings>.Instance.Open();
+    }
+}
+
+public enum ExampleEnumSetting
+{
+    Cheeseburger,
+    Sandwich,
+    Fries,
+    ChickenNuggets,
+}

MiraAPI.Example/ExamplePlugin.cs

@@ -3,6 +3,7 @@ using BepInEx.Configuration;
 using BepInEx.Unity.IL2CPP;
 using HarmonyLib;
 using MiraAPI.PluginLoading;
+using MiraAPI.Translation;
 using Reactor;
 using Reactor.Networking;
 using Reactor.Networking.Attributes;
@@ -16,9 +17,20 @@ namespace MiraAPI.Example;
 [ReactorModFlags(ModFlags.RequireOnAllClients)]
 public partial class ExamplePlugin : BasePlugin, IMiraPlugin
 {
+    public ExamplePlugin()
+    {
+        MiraLocaleManager.Register("mira.example");
+    }
+
     public Harmony Harmony { get; } = new(Id);
-    public string OptionsTitleText => "Mira API\nExample Mod";
+    public string OptionsTitleText { get; } = "Mira API\nExample Mod";
-    public ConfigFile GetConfigFile() => Config;
+    public string CustomOptionMenuNameTwo { get; } = "Example Options";
+
+    public ConfigFile GetConfigFile()
+    {
+        return Config;
+    }
+
     public override void Load()
     {
         ExampleEventHandlers.Initialize();

MiraAPI.Example/GameModes/ExampleMode.cs

@@ -0,0 +1,13 @@
+using MiraAPI.GameModes;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.GameModes;
+
+public class ExampleMode : AbstractGameMode
+{
+    public override string Name => "Example Mode";
+    public override string Description => "An example gamemode.";
+    public override LoadableAsset<Sprite>? Icon => ExampleAssets.ExampleButton;
+    public override Color Color => Color.red;
+}

MiraAPI.Example/GameOver/NeutralKillerGameOver.cs

@@ -1,9 +1,10 @@
-using MiraAPI.Example.Extension.Roles;
+using MiraAPI.Example.Roles;
 using MiraAPI.GameEnd;
+using MiraAPI.Translation;
 using MiraAPI.Utilities;
 using UnityEngine;
 
-namespace MiraAPI.Example.Extension.GameOver;
+namespace MiraAPI.Example.GameOver;
 
 public class NeutralKillerGameOver : CustomGameOver
 {
@@ -14,7 +15,7 @@ public class NeutralKillerGameOver : CustomGameOver
 
     public override void AfterEndGameSetup(EndGameManager endGameManager)
     {
-        endGameManager.WinText.text = "Outcast Killer Wins!";
+        endGameManager.WinText.text = "gameover.outcastKiller.win".Translate();
         endGameManager.WinText.color = Color.magenta;
         endGameManager.BackgroundBar.material.SetColor(ShaderID.Color, Color.magenta);
     }

MiraAPI.Example/MeetingAbilities/EndMeetingButton.cs

@@ -0,0 +1,29 @@
+using MiraAPI.Example.Roles;
+using MiraAPI.MeetingAbilities;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.MeetingAbilities;
+
+public class EndMeetingButton : MeetingActionButton
+{
+    public override string Name => "End Meeting";
+
+    public override float Cooldown => 15;
+
+    public override float InitialCooldown => 30;
+
+    public override int MaxUses => 3;
+
+    public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
+
+    public override bool Enabled(RoleBehaviour? role)
+    {
+        return PlayerControl.LocalPlayer != null && role is MayorRole;
+    }
+
+    protected override void OnClick()
+    {
+        MeetingHud.Instance.RpcClose();
+    }
+}

MiraAPI.Example/MeetingAbilities/ShootButton.cs

@@ -0,0 +1,37 @@
+using MiraAPI.MeetingAbilities;
+using MiraAPI.Networking;
+using MiraAPI.Utilities;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.MeetingAbilities;
+
+public class ShootButton : TargetedMeetingButton
+{
+    public override string Name => "Shoot";
+
+    public override int MaxUses => 3;
+
+    public override float InitialCooldown => 5;
+
+    public override float Cooldown => 3;
+
+    public override LoadableAsset<Sprite> Sprite => ExampleAssets.SharpshootButton;
+
+    public override Color OutlineColor => Color.red;
+
+    public override bool Enabled(RoleBehaviour r)
+    {
+        return r.IsImpostor;
+    }
+
+    protected override void OnClick(PlayerVoteArea playerVoteArea)
+    {
+        playerVoteArea.SetDisabled();
+        var player = playerVoteArea.GetPlayer();
+        if (player != null)
+        {
+            PlayerControl.LocalPlayer.RpcCustomMurder(player);
+        }
+    }
+}

MiraAPI.Example/MeetingAbilities/ShotgunButton.cs

@@ -0,0 +1,54 @@
+using MiraAPI.MeetingAbilities;
+using MiraAPI.Networking;
+using MiraAPI.Utilities;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.MeetingAbilities;
+
+public class ShotgunButton : MultiTargetMeetingButton
+{
+    public override string Name => "Shotgun";
+
+    public override int MaxUses => 3;
+
+    public override float InitialCooldown => 5;
+
+    public override float Cooldown => 3;
+
+    public override LoadableAsset<Sprite> Sprite => ExampleAssets.SharpshootButton;
+
+    public override Color OutlineColor => Color.red;
+
+    public override bool Enabled(RoleBehaviour r)
+    {
+        return r.IsImpostor;
+    }
+
+    protected override void OnClick(PlayerVoteArea playerVoteArea)
+    {
+        // Emptu because it only triggers the actual kills once all meeting abilities have been used.
+    }
+
+    public override LoadableAsset<Sprite> SpriteActive => ExampleAssets.CallMeetingButton;
+
+    public override int TargetsCount => 4;
+
+    protected override void OnSelect(PlayerVoteArea playerVoteArea, bool toggle)
+    {
+        HudManager.Instance.PlayerCam.ShakeScreen(0.5f, 2);
+    }
+
+    public override void OnFinish()
+    {
+        foreach (var playerVoteArea in Targets.Keys)
+        {
+            playerVoteArea.SetDisabled();
+            var player = playerVoteArea.GetPlayer();
+            if (player != null)
+            {
+                PlayerControl.LocalPlayer.RpcCustomMurder(player);
+            }
+        }
+    }
+}

MiraAPI.Example/MiraAPI.Example.csproj

@@ -1,17 +1,18 @@
- <Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 	<PropertyGroup>
 		<Version>1.0.0</Version>
 		<Description>Example mod for Mira API</Description>
-		<Authors>Angxl, XtraCube</Authors>
+		<Authors>Author Name</Authors>
+		<NoWarn>$(NoWarn);EnableGenerateDocumentationFile</NoWarn>
 	</PropertyGroup>
 
 	<ItemGroup>
-		<ProjectReference Include="..\MiraAPI\MiraAPI.csproj" />
+		<ProjectReference Include="..\MiraAPI\MiraAPI.csproj" /> <!-- You typically would use the nuget package here: AllOfUs.MiraAPI -->
 	</ItemGroup>
 
-	 <ItemGroup>
+	<ItemGroup>
-		 <EmbeddedResource Include="Resources\**\*.*" />
+		<EmbeddedResource Include="Resources\**\*.*" />
-	 </ItemGroup>
+	</ItemGroup>
 
 	<Import Project="..\AmongUs.props" />
 </Project>

MiraAPI.Example/Modifiers/CaptainModifier.cs

@@ -2,6 +2,7 @@
 using MiraAPI.GameOptions;
 using MiraAPI.Modifiers;
 using MiraAPI.Modifiers.Types;
+using MiraAPI.Translation;
 using MiraAPI.Utilities.Assets;
 using UnityEngine;
 
@@ -9,7 +10,7 @@ namespace MiraAPI.Example.Modifiers;
 
 public class CaptainModifier : GameModifier
 {
-    public override string ModifierName => "Captain";
+    public override string ModifierName => MiraLocaleManager.Get("modifier.captain");
     public override LoadableAsset<Sprite>? ModifierIcon => ExampleAssets.CallMeetingButton;
 
     public override void OnDeath(DeathReason reason)
@@ -19,7 +20,7 @@ public class CaptainModifier : GameModifier
 
     public override string GetDescription()
     {
-        return $"You can call a meeting from anywhere on the map.";
+        return MiraLocaleManager.Get("modifier.captain.TabDescription");
     }
 
     public override int GetAssignmentChance()

MiraAPI.Example/Modifiers/Freezer/FreezeModifier.cs

@@ -1,13 +1,13 @@
-using Il2CppSystem;
+using MiraAPI.Example.Roles;
-using MiraAPI.Example.Roles;
 using MiraAPI.Modifiers.Types;
+using MiraAPI.Translation;
 using UnityEngine;
 
 namespace MiraAPI.Example.Modifiers.Freezer;
 
 public class FreezeModifier : TimedModifier
 {
-    public override string ModifierName => "Freezed";
+    public override string ModifierName => MiraLocaleManager.Get("modifier.freezed");
     public override bool HideOnUi => false;
     public override float Duration => 15f;
     public override bool AutoStart => true;
@@ -27,7 +27,7 @@ public class FreezeModifier : TimedModifier
 
         if (Player.AmOwner || PlayerControl.LocalPlayer.Data.Role is FreezerRole)
         {
-            Player.cosmetics.SetOutline(true, new Nullable<Color>(Palette.LightBlue));
+            Player.cosmetics.SetOutline(true, new Il2CppSystem.Nullable<Color>(Palette.LightBlue));
         }
     }
 

MiraAPI.Example/Modifiers/HighPriorityModifier.cs

@@ -1,14 +1,15 @@
 using MiraAPI.Modifiers.Types;
+using MiraAPI.Translation;
 
 namespace MiraAPI.Example.Modifiers;
 
 public class HighPriorityModifier : GameModifier
 {
-    public override string ModifierName => "High Priority";
+    public override string ModifierName => MiraLocaleManager.Get("modifier.highPriority");
 
     public override string GetDescription()
     {
-        return "You are high priority! Idrk what this means either tbh...";
+        return MiraLocaleManager.Get("modifier.highPriority.TabDescription");
     }
 
     public override int GetAssignmentChance()

MiraAPI.Example/Options/ExampleOptions.cs

@@ -1,31 +1,88 @@
-using MiraAPI.GameOptions;
+using System.Diagnostics.CodeAnalysis;
+using MiraAPI.GameOptions;
 using MiraAPI.GameOptions.Attributes;
 using MiraAPI.Utilities;
 using UnityEngine;
 
 namespace MiraAPI.Example.Options;
 
+[SuppressMessage("Style", "IDE0060:Remove unused parameter", Justification = "Demo.")]
+[SuppressMessage("Performance", "CA1822:Mark members as static", Justification = "Read above.")]
+[SuppressMessage("Minor Code Smell", "S3400:Methods should not return constants", Justification = "Read above.")]
 public class ExampleOptions : AbstractOptionGroup
 {
-    public override string GroupName => "Example Options 1";
+    public override string GroupName => "options.exampleOptions1";
     public override Color GroupColor => Color.green;
+    public override bool ShowInMatchInfoGuide => true;
 
-    [ModdedToggleOption("Toggle Opt 1")]
+    [ModdedToggleOption("options.exampleOptions1.toggleOpt1")]
-    public bool ToggleOpt { get; set; } = false;
+    [ModdedOptionVisibility] // Automatically resolves to using ToggleOpt1Visibility, can also target toggle options
+    public bool ToggleOpt1 { get; set; } = false;
 
-    [ModdedToggleOption("Toggle Opt 2")]
+    [ModdedToggleOption("options.exampleOptions1.toggleOpt2")]
+    [ModdedOptionVisibility(nameof(ToggleOpt1))] // ToggleOpt2 will be visible only when ToggleOpt1 is true
     public bool ToggleOpt2 { get; set; } = true;
 
-    [ModdedNumberOption("Number Opt", min: 0, max: 10, increment: .25f, formatString: "0.00", suffixType: MiraNumberSuffixes.Percent)]
+    [ModdedNumberOption("options.exampleOptions1.numberOpt", min: 0, max: 10, increment: .25f, formatString: "0.00", suffixType: MiraNumberSuffixes.Percent)]
+    [ModdedOptionVisibility(nameof(NumberOptVisibility))] // Can also target static methods
     public float NumberOpt { get; set; } = 4f;
 
-    [ModdedEnumOption("Best API", typeof(BestApi), ["Mira API", "Mitochondria", "Reactor"])]
+    [ModdedNumberOption("options.exampleOptions1.numberOpt", min: 0, max: 10, suffixType: MiraNumberSuffixes.Distance)]
-    public BestApi Opt { get; set; } = BestApi.MiraAPI;
+    public int NumberOpt2 { get; set; } = 4; // Can also be int!
+
+    [ModdedEnumOption("options.exampleOptions1.bestApi", typeof(Api), ["Mira API", "Mitochondria", "Reactor"])]
+    public Api BestApi { get; set; } = Api.MiraAPI;
+
+    [ModdedEnumOption<Api>("options.exampleOptions1.worstApi", ["Mira API", "Mitochondria", "Reactor"])]
+
+    // These three can target both instance and static methods
+    [ModdedOptionGetter(nameof(GetApi))] // Can also automatically resolve to {Option Name}Getter
+    [ModdedOptionSetter(nameof(SetApi))] // Can also automatically resolve to {Option Name}Setter
+    [ModdedOptionChanged(nameof(ApiChanged))] // Can also automatically resolve to {Option Name}Changed
+    public Api WorstApi { get; set; } = Api.MiraAPI;
+
+    [ModdedEnumOptionList<ValueState>("Value State {0}", ["None", "Primary", "Secondary"])]
+    public ModdedArray<ValueState> ValueStates { get; set; } = [ValueState.Primary, ValueState.Secondary, ValueState.None, ValueState.None, ValueState.None];
+
+    [ModdedPlayerOption("options.exampleOptions1.players")]
+    public NetworkedPlayerInfo PlayerSelected { get; set; }
+
+    public bool ToggleOpt1Visibility()
+    {
+        return true;
+    }
+
+    public static bool NumberOptVisibility()
+    {
+        return true;
+    }
+
+    public static Api GetApi(Api currentValue)
+    {
+        return currentValue;
+    }
+
+    public static Api SetApi(Api newValue, Api oldValue)
+    {
+        return default;
+    }
+
+    public static void ApiChanged(Api currentValue)
+    {
+        // Something
+    }
 }
 
-public enum BestApi
+public enum Api
 {
     MiraAPI,
     Mitochondria,
     Reactor,
 }
+
+public enum ValueState
+{
+    None,
+    Primary,
+    Secondary,
+}

MiraAPI.Example/Options/ExampleOptions2.cs

@@ -6,22 +6,28 @@ namespace MiraAPI.Example.Options;
 
 public class ExampleOptions2 : AbstractOptionGroup
 {
-    public override string GroupName => "Example Options 2";
+    public override string GroupName => "options.exampleOptions2";
-
     public override uint GroupPriority => 0; // This group will be displayed first. The default value is uint.MaxValue.
+    public override MenuCategory ParentMenu => MenuCategory.CustomTwo;
+    public override bool ShowInMatchInfoGuide => true;
 
-    public ModdedPlayerOption PlayerOption2 { get; } = new("YOU MUST CHOSE A PLAYER", false);
+    public ModdedPlayerOption PlayerOption2 { get; } = new("options.exampleOptions2.youMustChoseAPlayer", false);
-    public ModdedPlayerOption PlayerOption { get; } = new("Eh whatever");
+    public ModdedPlayerOption PlayerOption { get; } = new("options.exampleOptions2.ehWhatever");
-    public ModdedToggleOption ToggleOpt1 { get; } = new("Toggle Option 1", false);
+    public ModdedToggleOption ToggleOpt1 { get; } = new("options.exampleOptions2.toggleOption1", false);
 
-    public ModdedToggleOption ToggleOpt2 { get; } = new("Toggle Option 2", false)
+    public ModdedOptionList<ModdedNumberOption> PlayerNums { get; } = new(5, i =>
+        new($"PlayerNum{i}", 2, 0, 5, 1, Utilities.MiraNumberSuffixes.None));
+
+    public ModdedToggleOption ToggleOpt2 { get; } = new("options.exampleOptions2.toggleOption2", false)
     {
         Visible = () => OptionGroupSingleton<ExampleOptions2>.Instance.ToggleOpt1, // implicit cast from ModdedToggleOption to bool
     };
 
-    public ModdedEnumOption<TestingData> EnumOpt { get; } = new("Enum Opt", 0)
+    public ModdedEnumOption<TestingData> EnumOpt { get; } = new("options.exampleOptions2.enumOpt", 0)
     {
         ChangedEvent = x => Logger<ExamplePlugin>.Info($"changed Enum Opt to {x}"),
+        Getter = currentValue => currentValue,
+        Setter = (newValue, oldValue) => newValue,
     };
 }
 

MiraAPI.Example/Options/Modifiers/CaptainModifierSettings.cs

@@ -6,14 +6,14 @@ namespace MiraAPI.Example.Options.Modifiers;
 
 public class CaptainModifierSettings : AbstractOptionGroup<CaptainModifier>
 {
-    public override string GroupName => "Captain Settings";
+    public override string GroupName => "options.captainSettings";
 
-    [ModdedNumberOption("Amount", 0, 5)]
+    [ModdedNumberOption("options.captainSettings.amount", 0, 5)]
     public float Amount { get; set; } = 1;
 
-    [ModdedNumberOption("Chance", 0, 100, 10)]
+    [ModdedNumberOption("options.captainSettings.chance", 0, 100, 10)]
     public float Chance { get; set; } = 50;
 
-    [ModdedNumberOption("Uses", 1, 5)]
+    [ModdedNumberOption("options.captainSettings.uses", 1, 5)]
     public float NumUses { get; set; } = 3;
 }

MiraAPI.Example/Options/Modifiers/FreezeModifierSettings.cs

@@ -6,8 +6,8 @@ namespace MiraAPI.Example.Options.Modifiers;
 
 public class FreezeModifierSettings : AbstractOptionGroup<FreezeModifier>
 {
-    public override string GroupName => "Freeze";
+    public override string GroupName => "options.freezeModifierSettings";
 
-    [ModdedToggleOption("Use Color")]
+    [ModdedToggleOption("options.freezeModifierSettings.useColor")]
     public bool UseColor { get; set; } = true;
 }

MiraAPI.Example/Options/Modifiers/GeneralModifierOptions.cs

@@ -5,15 +5,13 @@ namespace MiraAPI.Example.Options.Modifiers;
 
 public class GeneralModifierOptions : AbstractOptionGroup
 {
-    public override string GroupName => "General";
+    public override string GroupName => "options.generalModifier";
-
     public override uint GroupPriority => 0;
+    public override MenuCategory ParentMenu => MenuCategory.Modifiers;
 
-    public override bool ShowInModifiersMenu => true;
+    [ModdedToggleOption("options.generalModifier.someBooleanOption")]
-
-    [ModdedToggleOption("Some Boolean Option")]
     public bool SomeBooleanOption { get; set; } = true;
 
-    [ModdedNumberOption("Number Option", 0, 10, 1)]
+    [ModdedNumberOption("options.generalModifier.numberOption", 0, 10)]
     public float NumberOption { get; set; } = 5;
 }

MiraAPI.Example/Options/Roles/FreezerRoleSettings.cs

@@ -2,13 +2,22 @@
 using MiraAPI.GameOptions;
 using MiraAPI.GameOptions.Attributes;
 using MiraAPI.Utilities;
+using MiraAPI.Utilities.Assets;
 
 namespace MiraAPI.Example.Options.Roles;
 
 public class FreezerRoleSettings : AbstractOptionGroup<FreezerRole>
 {
-    public override string GroupName => "Custom Role";
+    public override OptionNotifConfiguration Configuration => new(
+        Palette.Blue,
+        TmpSpriteUtils.CreateSpriteAsset(
+            MiraAssets.ImpostorFile.LoadAsset(),
+            "ApiExample.Role.Impostor.FreezerRole"));
+    public override string GroupName => "ApiExample.Role.Freezer";
 
-    [ModdedNumberOption("Freeze Duration", 1, 15, 1, MiraNumberSuffixes.Seconds)]
+    [ModdedNumberOption("ApiExample.Role.Freezer.Settings.FreezeDuration", 1, 15, 1, MiraNumberSuffixes.Seconds)]
     public float FreezeDuration { get; set; } = 5;
+
+    [ModdedNumberOption("ApiExample.Role.Freezer.Settings.FreezeUses", 1, 5)]
+    public float FreezeUses { get; set; } = 1;
 }

MiraAPI.Example/Options/Roles/TeleporterOptions.cs

@@ -6,15 +6,15 @@ using MiraAPI.Utilities;
 
 namespace MiraAPI.Example.Options.Roles;
 
-public class TeleporterOptions : AbstractOptionGroup<TeleporterRole>
+public class TeleporterOptions : AbstractRoleOptionGroup<TeleporterRole>
 {
-    public override string GroupName => "Teleporter";
+    public override string GroupName => "ApiExample.Role.Teleporter";
 
-    public ModdedNumberOption TeleportCooldown { get; set; } = new("Teleport Cooldown", 10, 5, 60, 2.5f, MiraNumberSuffixes.Seconds);
+    public ModdedNumberOption TeleportCooldown { get; set; } = new("ApiExample.Role.Teleporter.Settings.TeleportCooldown", 10, 5, 60, 2.5f, MiraNumberSuffixes.Seconds);
 
-    [ModdedNumberOption("Teleport Duration", 5, 25, 1, MiraNumberSuffixes.Seconds)]
+    [ModdedNumberOption("ApiExample.Role.Teleporter.Settings.TeleportDuration", 5, 25, 1, MiraNumberSuffixes.Seconds)]
     public float TeleportDuration { get; set; } = 10;
 
-    [ModdedNumberOption("Zoom Distance", 4, 15)]
+    [ModdedNumberOption("ApiExample.Role.Teleporter.Settings.ZoomDistance", 4, 15)]
     public float ZoomDistance { get; set; } = 6;
 }

MiraAPI.Example/Resources/Locale/en_US.xml

@@ -0,0 +1,86 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<resources>
+    <string name="ApiExample.Role.Crewmate.Teleporter">Teleporter</string>
+    <string name="ApiExample.Role.Crewmate.Teleporter.IntroBlurb">Zoom out and teleport across the map!</string>
+    <string name="ApiExample.Role.Crewmate.Teleporter.MedDescription">Zoom out and teleport across the map!</string>
+    <string name="ApiExample.Role.Crewmate.Teleporter.TabDescription">Zoom out and teleport across the map!</string>
+    <string name="ApiExample.Role.Crewmate.Teleporter.WikiDescription">The Teleporter is a Crewmate role that can move around the map using their dope-ass ability.</string>
+    <string name="ApiExample.Role.Impostor.Freezer">Freezer</string>
+    <string name="ApiExample.Role.Impostor.Freezer.IntroBlurb">Get iced, nerd.</string>
+    <string name="ApiExample.Role.Impostor.Freezer.MedDescription">Freeze others for a duration of time.</string>
+    <string name="ApiExample.Role.Impostor.Freezer.TabDescription">Freeze another player for a duration of time.</string>
+    <string name="ApiExample.Role.Impostor.Freezer.WikiDescription">The Freezer is an Impostor role that can freeze players. Or something along those lines.</string>
+    <string name="ApiExample.Role.Crewmate.Mayor">Mayor</string>
+    <string name="ApiExample.Role.Crewmate.Mayor.IntroBlurb">Democracy is the best policy.</string>
+    <string name="ApiExample.Role.Crewmate.Mayor.MedDescription">Vote out the Impostors with more votes.
+Your votes have double the power.</string>
+    <string name="ApiExample.Role.Crewmate.Mayor.TabDescription">You get one extra vote in the meeting!</string>
+    <string name="ApiExample.Role.Crewmate.Mayor.WikiDescription">The Mayor is a Crewmate role that gets two votes in the meeting, instead of the singular vote other Crewmates get.</string>
+    <string name="ApiExample.Role.Crewmate.Chameleon">Chameleon</string>
+    <string name="ApiExample.Role.Crewmate.Chameleon.IntroBlurb">Become one with the environment.</string>
+    <string name="ApiExample.Role.Crewmate.Chameleon.MedDescription">Fade out of everyone's vision by not moving.</string>
+    <string name="ApiExample.Role.Crewmate.Chameleon.TabDescription">Stay invisible while not moving.</string>
+    <string name="ApiExample.Role.Crewmate.Chameleon.WikiDescription">The Chameleon is a Crewmate role that slowly becomes invisible while standing still.</string>
+    <string name="ApiExample.Role.Outcast.OutcastKiller">Outcast Killer</string>
+    <string name="ApiExample.Role.Outcast.OutcastKiller.IntroBlurb">Kill everyone else.</string>
+    <string name="ApiExample.Role.Outcast.OutcastKiller.MedDescription">Be the last outcast standing.
+Eliminate every other faction.</string>
+    <string name="ApiExample.Role.Outcast.OutcastKiller.TabDescription">Outcast who can kill.</string>
+    <string name="ApiExample.Role.Outcast.OutcastKiller.WikiDescription">The Outcast Killer is an Outcast role that can kill, like some sort of neutral killer...</string>
+    <string name="outcast">Outcast</string>
+    <string name="outcast.group">Outcast Roles</string>
+    <string name="outcast.roleTitle">OUTCAST</string>
+    <string name="outcast.teamIntroDescription">You are an Outcast. You do not have a team.</string>
+    <string name="button.think">Think</string>
+    <string name="button.think.thinking">Thinking...</string>
+    <string name="button.freeze">Freeze</string>
+    <string name="button.teleport">Teleport</string>
+    <string name="button.callMeeting">Call Meeting</string>
+    <string name="button.winGame">Win Game</string>
+    <string name="modifier.captain">Captain</string>
+    <string name="modifier.captain.TabDescription">You can call a meeting from anywhere on the map.</string>
+    <string name="modifier.freezed">Freezed</string>
+    <string name="modifier.highPriority">High Priority</string>
+    <string name="modifier.highPriority.TabDescription">You are high priority! Idrk what this means either tbh...</string>
+    <string name="options.exampleOptions1">Example Options 1</string>
+    <string name="options.exampleOptions1.toggleOpt1">Toggle Opt 1</string>
+    <string name="options.exampleOptions1.toggleOpt2">Toggle Opt 2</string>
+    <string name="options.exampleOptions1.numberOpt">Number Opt</string>
+    <string name="options.exampleOptions1.bestApi">Best API</string>
+    <string name="options.exampleOptions1.worstApi">Worst API</string>
+    <string name="options.exampleOptions1.players">Choose A Player</string>
+    <string name="options.exampleOptions2">Example Options 2</string>
+    <string name="options.exampleOptions2.youMustChoseAPlayer">YOU MUST CHOSE A PLAYER</string>
+    <string name="options.exampleOptions2.ehWhatever">Eh whatever</string>
+    <string name="options.exampleOptions2.toggleOption1">Toggle Option 1</string>
+    <string name="options.exampleOptions2.toggleOption2">Toggle Option 2</string>
+    <string name="options.exampleOptions2.enumOpt">Enum Opt</string>
+    <string name="options.captainSettings">Captain Settings</string>
+    <string name="options.captainSettings.amount">Amount</string>
+    <string name="options.captainSettings.chance">Chance</string>
+    <string name="options.captainSettings.uses">Uses</string>
+    <string name="options.freezeModifierSettings">Freeze</string>
+    <string name="options.freezeModifierSettings.useColor">Use Color</string>
+    <string name="options.generalModifier">General</string>
+    <string name="options.generalModifier.someBooleanOption">Some Boolean Option</string>
+    <string name="options.generalModifier.numberOption">Number Option</string>
+    <string name="options.freezerRoleSettings">Custom Role</string>
+    <string name="ApiExample.Role.Freezer.Settings.FreezeDuration">Freeze Duration</string>
+    <string name="ApiExample.Role.Freezer.Settings.FreezeUses">Freeze Uses</string>
+    <string name="ApiExample.Role.Teleporter.Settings.TeleportCooldown">Teleport Cooldown</string>
+    <string name="ApiExample.Role.Teleporter.Settings.TeleportDuration">Teleport Duration</string>
+    <string name="ApiExample.Role.Teleporter.Settings.ZoomDistance">Zoom Distance</string>
+    <string name="settings.miraExample">Mira Example</string>
+    <string name="settings.miraExample.exampleBool">Example Bool</string>
+    <string name="settings.miraExample.exampleBool2">Example Bool 2</string>
+    <string name="settings.miraExample.slider">Slider</string>
+    <string name="settings.miraExample.exampleNumber">Example Number</string>
+    <string name="settings.miraExample.exampleMultiplier">Example Multiplier</string>
+    <string name="settings.miraExample.exampleEnum">Example Enum</string>
+    <string name="settings.miraExample.button.exampleButton">Example Button</string>
+    <string name="gameover.outcastKiller.win">Outcast Killer Wins!</string>
+    <string name="color.cerulean">Cerulean</string>
+    <string name="color.rose">Rose</string>
+    <string name="color.gold">Gold</string>
+    <string name="color.rainbow">Rainbow</string>
+</resources>

MiraAPI.Example/Resources/Locale/zh_CN.xml

@@ -0,0 +1,66 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<resources>
+  <string name="ApiExample.Role.Teleporter">传送者</string>
+  <string name="ApiExample.Role.Teleporter.IntroBlurb">缩小视野并在地图上传送！</string>
+    <string name="ApiExample.Role.Teleporter.MedDescription">缩小视野并在地图上传送！</string>
+    <string name="ApiExample.Role.Teleporter.TabDescription">缩小视野并在地图上传送！</string>
+  <string name="ApiExample.Role.Freezer">冰冻者</string>
+  <string name="ApiExample.Role.Freezer.TabDescription">将其他玩家冰冻一段时间。</string>
+  <string name="ApiExample.Role.Crewmate.Mayor">市长</string>
+  <string name="ApiExample.Role.Crewmate.Mayor.TabDescription">你拥有额外投票权！</string>
+  <string name="ApiExample.Role.Crewmate.Chamelon">变色龙</string>
+  <string name="ApiExample.Role.Crewmate.Chamelon.TabDescription">静止不动时保持隐身。</string>
+  <string name="ApiExample.Role.Outcast.OutcastKiller">流放杀手</string>
+  <string name="ApiExample.Role.Outcast.OutcastKiller.TabDescription">可以击杀的流放者。</string>
+  <string name="outcast">流放者</string>
+  <string name="outcast.roleTitle">流放者</string>
+  <string name="outcast.teamIntroDescription">你是流放者，你没有队伍。</string>
+  <string name="button.think">思考</string>
+  <string name="button.think.thinking">思考中...</string>
+  <string name="button.freeze">冰冻</string>
+  <string name="button.teleport">传送</string>
+  <string name="button.callMeeting">召集会议</string>
+  <string name="button.winGame">赢得游戏</string>
+  <string name="modifier.captain">队长</string>
+  <string name="modifier.captain.TabDescription">你可以在地图上任意位置召集会议。</string>
+  <string name="modifier.freezed">已被冰冻</string>
+  <string name="modifier.highPriority">高优先级</string>
+  <string name="modifier.highPriority.TabDescription">你是高优先级！老实说我也不太清楚这是什么意思……</string>
+  <string name="options.exampleOptions1">示例选项组 1</string>
+  <string name="options.exampleOptions1.toggleOpt1">开关选项 1</string>
+  <string name="options.exampleOptions1.toggleOpt2">开关选项 2</string>
+  <string name="options.exampleOptions1.numberOpt">数字选项</string>
+  <string name="options.exampleOptions1.bestApi">谁是最好的API</string>
+  <string name="options.exampleOptions2">示例选项组 2</string>
+  <string name="options.exampleOptions2.youMustChoseAPlayer">你必须选择一个玩家</string>
+  <string name="options.exampleOptions2.ehWhatever">咕咕嘎嘎</string>
+  <string name="options.exampleOptions2.toggleOption1">开关选项 1</string>
+  <string name="options.exampleOptions2.toggleOption2">开关选项 2</string>
+  <string name="options.exampleOptions2.enumOpt">枚举选项</string>
+  <string name="options.captainSettings">队长设置</string>
+  <string name="options.captainSettings.amount">数量</string>
+  <string name="options.captainSettings.chance">概率</string>
+  <string name="options.captainSettings.uses">使用次数</string>
+  <string name="options.freezeModifierSettings">冰冻</string>
+  <string name="options.freezeModifierSettings.useColor">使用颜色</string>
+  <string name="options.generalModifier">通用</string>
+  <string name="options.generalModifier.someBooleanOption">某个布尔选项</string>
+  <string name="options.generalModifier.numberOption">数字选项</string>
+  <string name="ApiExample.Role.Freezer.Settings.FreezeDuration">冰冻时长</string>
+  <string name="ApiExample.Role.Freezer.Settings.FreezeUses">冰冻次数</string>
+  <string name="ApiExample.Role.Teleporter.Settings.TeleportCooldown">传送冷却</string>
+  <string name="ApiExample.Role.Teleporter.Settings.TeleportDuration">传送持续时间</string>
+  <string name="ApiExample.Role.Teleporter.Settings.ZoomDistance">缩放距离</string>
+  <string name="settings.miraExample">Mira 示例插件</string>
+  <string name="settings.miraExample.exampleBool">示例布尔</string>
+  <string name="settings.miraExample.exampleBool2">示例布尔 2</string>
+  <string name="settings.miraExample.slider">滑块</string>
+  <string name="settings.miraExample.exampleNumber">示例数字</string>
+  <string name="settings.miraExample.exampleMultiplier">示例倍数</string>
+  <string name="settings.miraExample.exampleEnum">示例枚举</string>
+  <string name="settings.miraExample.button.exampleButton">示例按钮</string>
+  <string name="gameover.outcastKiller.win">流放杀手获胜！</string>
+  <string name="color.cerulean">天蓝</string>
+  <string name="color.rose">玫瑰红</string>
+  <string name="color.gold">金色</string>
+</resources>

MiraAPI.Example/Roles/ChameleonRole.cs

@@ -1,38 +1,41 @@
 using AmongUs.GameOptions;
 using MiraAPI.Patches.Stubs;
 using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
 using Reactor.Utilities;
-using TMPro;
 using UnityEngine;
 
 namespace MiraAPI.Example.Roles;
 
-public class ChameloenRole : CrewmateRole, ICustomRole
+public class ChameleonRole : CrewmateRole, ICustomRole
 {
-    public string RoleName => "Chamelon";
+    private bool shouldHide;
-    public string RoleLongDescription => "Stay invisible while not moving.";
+
-    public string RoleDescription => RoleLongDescription;
+    public string IdPart => "Chameleon";
+    public string IdPrefix => "ApiExample.Role.Crewmate";
     public Color RoleColor => Palette.AcceptedGreen;
     public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
 
-    private bool _shouldHide;
-
     public CustomRoleConfiguration Configuration => new(this)
     {
         OptionsScreenshot = ExampleAssets.Banner,
+        Icon = MiraAssets.CrewmateFile,
+        IconTmp = TmpSpriteUtils.CreateSpriteAsset(
+            MiraAssets.CrewmateFile.LoadAsset(),
+            "ApiExample.Role.Impostor.ChameleonRole"),
         IntroSound = CustomRoleUtils.GetIntroSound(RoleTypes.Shapeshifter),
     };
 
     public override void Initialize(PlayerControl player)
     {
-        Logger<ExamplePlugin>.Info("Initializing ChamelonRole for player: " + player.PlayerId);
+        Logger<ExamplePlugin>.Info("Initializing ChameleonRole for player: " + player.PlayerId);
         RoleBehaviourStubs.Initialize(this, player);
-        _shouldHide = true;
+        shouldHide = true;
     }
 
     public void FixedUpdate()
     {
-        if (!Player || !_shouldHide)
+        if (!Player || !shouldHide)
         {
             return;
         }
@@ -51,27 +54,34 @@ public class ChameloenRole : CrewmateRole, ICustomRole
         }
         else
         {
-            SpriteRenderer rend = Player.cosmetics.currentBodySprite.BodySprite;
+            var rend = Player.cosmetics.currentBodySprite.BodySprite;
-            TextMeshPro tmp = Player.cosmetics.nameText;
+            var tmp = Player.cosmetics.nameText;
-            tmp.color = Color.Lerp(tmp.color, new Color(tmp.color.r, tmp.color.g, tmp.color.b, Player.AmOwner ? 0.3f : 0), Time.deltaTime * 4f);
+            tmp.color = Color.Lerp(
+                tmp.color,
+                new Color(tmp.color.r, tmp.color.g, tmp.color.b, Player.AmOwner ? 0.3f : 0),
+                Time.deltaTime * 4f);
             rend.color = Color.Lerp(rend.color, new Color(1, 1, 1, Player.AmOwner ? 0.3f : 0), Time.deltaTime * 4f);
 
             foreach (var cosmetic in Player.cosmetics.transform.GetComponentsInChildren<SpriteRenderer>())
             {
-                cosmetic.color = Color.Lerp(cosmetic.color, new Color(1, 1, 1, Player.AmOwner ? 0.3f : 0), Time.deltaTime * 4f);
+                cosmetic.color = Color.Lerp(
+                    cosmetic.color,
+                    new Color(1, 1, 1, Player.AmOwner ? 0.3f : 0),
+                    Time.deltaTime * 4f);
             }
         }
     }
 
     public override void Deinitialize(PlayerControl targetPlayer)
     {
-        Logger<ExamplePlugin>.Info("Deinitializing ChamelonRole for player: " + targetPlayer.PlayerId);
+        Logger<ExamplePlugin>.Info("Deinitializing ChameleonRole for player: " + targetPlayer.PlayerId);
         RoleBehaviourStubs.Deinitialize(this, targetPlayer);
-        _shouldHide = false;
+        shouldHide = false;
         foreach (var cosmetic in Player.cosmetics.transform.GetComponentsInChildren<SpriteRenderer>(true))
         {
             cosmetic.color = Color.white;
         }
+
         Player.cosmetics.currentBodySprite.BodySprite.color = Color.white;
         Player.cosmetics.nameText.color = Color.white;
     }

MiraAPI.Example/Roles/FreezerRole.cs

@@ -1,18 +1,20 @@
 using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
 using UnityEngine;
 
 namespace MiraAPI.Example.Roles;
 
 public class FreezerRole : ImpostorRole, ICustomRole
 {
-    public string RoleName => "Freezer";
+    public string IdPart => "Freezer";
-    public string RoleLongDescription => "Freeze another player for a duration of time.";
+    public string IdPrefix => "ApiExample.Role.Impostor";
-    public string RoleDescription => RoleLongDescription;
     public Color RoleColor => Palette.Blue;
     public ModdedRoleTeams Team => ModdedRoleTeams.Impostor;
 
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
+    public CustomRoleConfiguration Configuration => new(this)
     {
+        Icon = MiraAssets.ImpostorFile,
+        IconTmp = TmpSpriteUtils.CreateSpriteAsset(MiraAssets.ImpostorFile.LoadAsset(), "ApiExample.Role.Impostor.Freezer"),
         OptionsScreenshot = ExampleAssets.Banner,
         MaxRoleCount = 2,
     };

MiraAPI.Example/Roles/MayorRole.cs

@@ -5,9 +5,8 @@ namespace MiraAPI.Example.Roles;
 
 public class MayorRole : CrewmateRole, ICustomRole
 {
-    public string RoleName => "Mayor";
+    public string IdPart => "Mayor";
-    public string RoleLongDescription => "You get extra votes!";
+    public string IdPrefix => "ApiExample.Role.Crewmate";
-    public string RoleDescription => RoleLongDescription;
     public Color RoleColor => new Color32(221, 176, 152, 255);
     public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
     public CustomRoleConfiguration Configuration => new(this);

MiraAPI.Example/Roles/NeutralKillerRole.cs

@@ -1,20 +1,16 @@
-using MiraAPI.Example.Extension.GameOver;
+using Il2CppInterop.Runtime.Attributes;
+using MiraAPI.Example.GameOver;
 using MiraAPI.GameEnd;
 using MiraAPI.Roles;
 using UnityEngine;
 
-namespace MiraAPI.Example.Extension.Roles;
+namespace MiraAPI.Example.Roles;
 
 public class NeutralKillerRole : ImpostorRole, ICustomRole
 {
-    public string RoleName => "Outcast Killer";
+    public string IdPart => "OutcastKiller";
-
+    public string IdPrefix => "ApiExample.Role.Outcast";
-    public string RoleDescription => "Outcast who can kill.";
-
-    public string RoleLongDescription => this.RoleDescription;
-
     public Color RoleColor => Color.magenta;
-
     public ModdedRoleTeams Team => ModdedRoleTeams.Custom;
 
     public CustomRoleConfiguration Configuration => new(this)
@@ -24,12 +20,13 @@ public class NeutralKillerRole : ImpostorRole, ICustomRole
         CanUseVent = true,
     };
 
-    public RoleOptionsGroup RoleOptionsGroup { get; } = new("Outcast", Color.gray);
+    public RoleOptionsGroup RoleOptionsGroup { get; } = new("outcast.group", Color.gray);
 
+    [HideFromIl2Cpp]
     public TeamIntroConfiguration? IntroConfiguration { get; } = new(
         Color.gray,
-        "OUTCAST",
+        "outcast.roleTitle",
-        "You are an Outcast. You do not have a team.");
+        "outcast.teamIntroDescription");
 
     public override void SpawnTaskHeader(PlayerControl playerControl)
     {

MiraAPI.Example/Roles/TeleporterRole.cs

@@ -5,13 +5,12 @@ namespace MiraAPI.Example.Roles;
 
 public class TeleporterRole : CrewmateRole, ICustomRole
 {
-    public string RoleName => "Teleporter";
+    public string IdPart => "Teleporter";
-    public string RoleLongDescription => "Zoom out and teleport across the map!";
+    public string IdPrefix => "ApiExample.Role.Crewmate";
-    public string RoleDescription => RoleLongDescription;
     public Color RoleColor => new Color32(221, 176, 152, 255);
     public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
 
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
+    public CustomRoleConfiguration Configuration => new(this)
     {
         OptionsScreenshot = ExampleAssets.Banner,
         CanModifyChance = false,

MiraAPI.sln

@@ -7,8 +7,6 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MiraAPI", "MiraAPI\MiraAPI.
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MiraAPI.Example", "MiraAPI.Example\MiraAPI.Example.csproj", "{19B76855-16CC-43CC-A0A6-5A7FFB43F077}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "MiraAPI.Example.Extension", "MiraAPI.Example.Extension\MiraAPI.Example.Extension.csproj", "{526FF017-80E1-4094-804D-741AF35AA226}"
-EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -23,10 +21,6 @@ Global
 		{19B76855-16CC-43CC-A0A6-5A7FFB43F077}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{19B76855-16CC-43CC-A0A6-5A7FFB43F077}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{19B76855-16CC-43CC-A0A6-5A7FFB43F077}.Release|Any CPU.Build.0 = Release|Any CPU
-		{526FF017-80E1-4094-804D-741AF35AA226}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{526FF017-80E1-4094-804D-741AF35AA226}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{526FF017-80E1-4094-804D-741AF35AA226}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{526FF017-80E1-4094-804D-741AF35AA226}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

MiraAPI/Colors/ColorSpaces/CmykColor.cs

@@ -0,0 +1,107 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+using MiraAPI.Utilities;
+using UnityEngine;
+
+namespace MiraAPI.Colors.ColorSpaces;
+
+/// <summary>
+/// A struct that denotes the CMYK (Cyan, Magenta, Yellow, Key) color space.
+/// </summary>
+/// <param name="c">The cyan component.</param>
+/// <param name="m">The magenta component.</param>
+/// <param name="y">The yellow component.</param>
+/// <param name="k">The key component.</param>
+/// <param name="a">The alpha component.</param>
+[Serializable]
+[SuppressMessage("StyleCop.CSharp.NamingRules", "SA1300:Element should begin with upper-case letter", Justification = "Unity parity.")]
+public record struct CmykColor(float c, float m, float y, float k, float a = 1f)
+{
+    /// <summary>
+    /// Implicitly converts a <see cref="CmykColor"/> to a Unity <see cref="Color"/>.
+    /// </summary>
+    /// <param name="c">The color being converted.</param>
+    public static implicit operator Color(CmykColor c)
+    {
+        return ToColor(c);
+    }
+
+    /// <summary>
+    /// Implicitly converts a Unity <see cref="Color"/> to a <see cref="CmykColor"/>.
+    /// </summary>
+    /// <param name="c">The color being converted.</param>
+    public static implicit operator CmykColor(Color c)
+    {
+        return FromColor(c);
+    }
+
+    /// <summary>
+    /// Converts a <see cref="CmykColor"/> to a standard Unity RGB <see cref="Color"/>.
+    /// </summary>
+    /// <param name="cmyk">The CMYK color to convert.</param>
+    /// <returns>A Unity <see cref="Color"/> representing the same visual color.</returns>
+    public static Color ToColor(CmykColor cmyk)
+    {
+        var key = 1f - cmyk.k;
+
+        var r = (1f - cmyk.c) * key;
+        var g = (1f - cmyk.m) * key;
+        var b = (1f - cmyk.y) * key;
+
+        return new Color(MathUtilities.Clamp01(r), MathUtilities.Clamp01(g), MathUtilities.Clamp01(b), cmyk.a);
+    }
+
+    /// <summary>
+    /// Converts a standard Unity RGB <see cref="Color"/> to a <see cref="CmykColor"/>.
+    /// </summary>
+    /// <param name="color">The Unity Color to convert.</param>
+    /// <returns>A <see cref="CmykColor"/> representing the same visual color.</returns>
+    public static CmykColor FromColor(Color color)
+    {
+        var r = color.r;
+        var g = color.g;
+        var b = color.b;
+
+        var k = 1f - MathF.Max(r, MathF.Max(g, b));
+
+        if (k >= 1f)
+            return new CmykColor(0f, 0f, 0f, 1f, color.a);
+
+        var invK = 1f / (1f - k);
+
+        var c = (1f - r - k) * invK;
+        var m = (1f - g - k) * invK;
+        var y = (1f - b - k) * invK;
+
+        return new CmykColor(MathUtilities.Clamp01(c), MathUtilities.Clamp01(m), MathUtilities.Clamp01(y), MathUtilities.Clamp01(k), color.a);
+    }
+
+    /// <summary>
+    /// Linearly interpolates between two <see cref="CmykColor"/> values.
+    /// </summary>
+    /// <param name="a">The starting color.</param>
+    /// <param name="b">The ending color.</param>
+    /// <param name="t">The interpolation value between the two colors, clamped to a 0 to 1 range.</param>
+    /// <returns>The interpolated <see cref="CmykColor"/>.</returns>
+    public static CmykColor Lerp(CmykColor a, CmykColor b, float t)
+    {
+        return LerpUnclamped(a, b, MathUtilities.Clamp01(t));
+    }
+
+    /// <summary>
+    /// Linearly interpolates between two <see cref="CmykColor"/> values without clamping the interpolant.
+    /// </summary>
+    /// <param name="a">The starting color.</param>
+    /// <param name="b">The ending color.</param>
+    /// <param name="t">The interpolation value between the two colors.</param>
+    /// <returns>The interpolated <see cref="CmykColor"/>.</returns>
+    public static CmykColor LerpUnclamped(CmykColor a, CmykColor b, float t)
+    {
+        return new CmykColor(
+            MathUtilities.LerpUnclamped(a.c, b.c, t),
+            MathUtilities.LerpUnclamped(a.m, b.m, t),
+            MathUtilities.LerpUnclamped(a.y, b.y, t),
+            MathUtilities.LerpUnclamped(a.k, b.k, t),
+            MathUtilities.LerpUnclamped(a.a, b.a, t));
+    }
+}

MiraAPI/Colors/ColorSpaces/HsbColor.cs

@@ -0,0 +1,136 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+using MiraAPI.Utilities;
+using UnityEngine;
+
+namespace MiraAPI.Colors.ColorSpaces;
+
+/// <summary>
+/// A struct that denotes the HSB (Hue, Saturation, Brightness) color space.
+/// </summary>
+/// <param name="h">The hue component.</param>
+/// <param name="s">The saturation component.</param>
+/// <param name="b">The brightness component.</param>
+/// <param name="a">The alpha component.</param>
+[Serializable]
+[SuppressMessage("StyleCop.CSharp.NamingRules", "SA1300:Element should begin with upper-case letter", Justification = "Unity parity.")]
+public record struct HsbColor(float h, float s, float b, float a = 1f)
+{
+    /// <summary>
+    /// Implicitly converts an <see cref="HsbColor"/> to a Unity <see cref="Color"/>.
+    /// </summary>
+    /// <param name="c">The color being converted.</param>
+    public static implicit operator Color(HsbColor c)
+    {
+        return ToColor(c);
+    }
+
+    /// <summary>
+    /// Implicitly converts a Unity <see cref="Color"/> to an <see cref="HsbColor"/>.
+    /// </summary>
+    /// <param name="c">The color being converted.</param>
+    public static implicit operator HsbColor(Color c)
+    {
+        return FromColor(c);
+    }
+
+    /// <summary>
+    /// Converts an <see cref="HsbColor"/> to a standard Unity RGB <see cref="Color"/>.
+    /// </summary>
+    /// <param name="hsb">The HSB color to convert.</param>
+    /// <returns>A Unity <see cref="Color"/> representing the same visual color.</returns>
+    public static Color ToColor(HsbColor hsb)
+    {
+        if (hsb.s <= float.Epsilon)
+            return new Color(MathUtilities.Clamp01(hsb.b), MathUtilities.Clamp01(hsb.b), MathUtilities.Clamp01(hsb.b), hsb.a);
+
+        var c = hsb.b * hsb.s;
+        var hPrime = hsb.h * 6f;
+        var x = c * (1f - MathF.Abs((hPrime % 2f) - 1f));
+        var m = hsb.b - c;
+
+        var (r, g, b) = hPrime switch
+        {
+            < 1f => (c, x, 0f),
+            < 2f => (x, c, 0f),
+            < 3f => (0f, c, x),
+            < 4f => (0f, x, c),
+            < 5f => (x, 0f, c),
+            <= 6f => (c, 0f, x),
+            _ => (0f, 0f, 0f),
+        };
+
+        return new Color(
+            MathUtilities.Clamp01(r + m),
+            MathUtilities.Clamp01(g + m),
+            MathUtilities.Clamp01(b + m),
+            hsb.a);
+    }
+
+    /// <summary>
+    /// Converts a standard Unity RGB <see cref="Color"/> to an <see cref="HsbColor"/>.
+    /// </summary>
+    /// <param name="color">The Unity Color to convert.</param>
+    /// <returns>An <see cref="HsbColor"/> representing the same visual color.</returns>
+    public static HsbColor FromColor(Color color)
+    {
+        var max = MathF.Max(color.r, MathF.Max(color.g, color.b));
+        var min = MathF.Min(color.r, MathF.Min(color.g, color.b));
+        var delta = max - min;
+
+        var h = 0f;
+
+        if (delta > 0f)
+        {
+            if (max == color.r)
+                h = (color.g - color.b) / delta % 6f;
+            else if (max == color.g)
+                h = (color.b - color.r) / delta + 2f;
+            else
+                h = (color.r - color.g) / delta + 4f;
+
+            h /= 6f;
+
+            if (h < 0f)
+                h += 1f;
+        }
+
+        var s = max == 0f ? 0f : delta / max;
+        var b = max;
+
+        return new HsbColor(h, s, b, color.a);
+    }
+
+    /// <summary>
+    /// Linearly interpolates between two <see cref="HsbColor"/> values, using the shortest path for the hue.
+    /// </summary>
+    /// <param name="a">The starting color.</param>
+    /// <param name="b">The ending color.</param>
+    /// <param name="t">The interpolation value between the two colors, clamped to a 0 to 1 range.</param>
+    /// <returns>The interpolated <see cref="HsbColor"/>.</returns>
+    public static HsbColor Lerp(HsbColor a, HsbColor b, float t)
+    {
+        return LerpUnclamped(a, b, MathUtilities.Clamp01(t));
+    }
+
+    /// <summary>
+    /// Linearly interpolates between two <see cref="HsbColor"/> values without clamping the interpolant.
+    /// </summary>
+    /// <param name="a">The starting color.</param>
+    /// <param name="b">The ending color.</param>
+    /// <param name="t">The interpolation value between the two colors.</param>
+    /// <returns>The interpolated <see cref="HsbColor"/>.</returns>
+    public static HsbColor LerpUnclamped(HsbColor a, HsbColor b, float t)
+    {
+        var hueDifference = MathUtilities.Repeat(b.h - a.h, 1f);
+
+        if (hueDifference > 0.5f)
+            hueDifference -= 1f;
+
+        return new HsbColor(
+            MathUtilities.Repeat(a.h + (hueDifference * t), 1f),
+            MathUtilities.LerpUnclamped(a.s, b.s, t),
+            MathUtilities.LerpUnclamped(a.b, b.b, t),
+            MathUtilities.LerpUnclamped(a.a, b.a, t));
+    }
+}

MiraAPI/Colors/ColorSpaces/HslColor.cs

@@ -0,0 +1,132 @@
+using System;
+using System.Diagnostics.CodeAnalysis;
+using MiraAPI.Utilities;
+using UnityEngine;
+
+namespace MiraAPI.Colors.ColorSpaces;
+
+/// <summary>
+/// A struct that denotes the HSL (Hue, Saturation, Lightness) color space.
+/// </summary>
+/// <param name="h">The hue component.</param>
+/// <param name="s">The saturation component.</param>
+/// <param name="l">The lightness component.</param>
+/// <param name="a">The alpha component.</param>
+[Serializable]
+[SuppressMessage("StyleCop.CSharp.NamingRules", "SA1300:Element should begin with upper-case letter", Justification = "Unity parity.")]
+public record struct HslColor(float h, float s, float l, float a = 1f)
+{
+    /// <summary>
+    /// Implicitly converts an <see cref="HslColor"/> to a Unity <see cref="Color"/>.
+    /// </summary>
+    /// <param name="c">The color being converted.</param>
+    public static implicit operator Color(HslColor c)
+    {
+        return ToColor(c);
+    }
+
+    /// <summary>
+    /// Implicitly converts a Unity <see cref="Color"/> to an <see cref="HslColor"/>.
+    /// </summary>
+    /// <param name="c">The color being converted.</param>
+    public static implicit operator HslColor(Color c)
+    {
+        return FromColor(c);
+    }
+
+    /// <summary>
+    /// Converts an <see cref="HslColor"/> to a standard Unity RGB <see cref="Color"/>.
+    /// </summary>
+    /// <param name="hsl">The HSL color to convert.</param>
+    /// <returns>A Unity <see cref="Color"/> representing the same visual color.</returns>
+    public static Color ToColor(HslColor hsl)
+    {
+        if (hsl.s <= float.Epsilon)
+            return new Color(MathUtilities.Clamp01(hsl.l), MathUtilities.Clamp01(hsl.l), MathUtilities.Clamp01(hsl.l), hsl.a);
+
+        var c = (1f - MathF.Abs(2f * hsl.l - 1f)) * hsl.s;
+        var hPrime = hsl.h * 6f;
+        var x = c * (1f - MathF.Abs((hPrime % 2f) - 1f));
+        var m = hsl.l - c / 2f;
+
+        var (r, g, b) = hPrime switch
+        {
+            < 1f => (c, x, 0f),
+            < 2f => (x, c, 0f),
+            < 3f => (0f, c, x),
+            < 4f => (0f, x, c),
+            < 5f => (x, 0f, c),
+            <= 6f => (c, 0f, x),
+            _ => (0f, 0f, 0f),
+        };
+
+        return new Color(MathUtilities.Clamp01(r + m), MathUtilities.Clamp01(g + m), MathUtilities.Clamp01(b + m), hsl.a);
+    }
+
+    /// <summary>
+    /// Converts a standard Unity RGB <see cref="Color"/> to an <see cref="HslColor"/>.
+    /// </summary>
+    /// <param name="color">The Unity Color to convert.</param>
+    /// <returns>An <see cref="HslColor"/> representing the same visual color.</returns>
+    public static HslColor FromColor(Color color)
+    {
+        var max = MathF.Max(color.r, MathF.Max(color.g, color.b));
+        var min = MathF.Min(color.r, MathF.Min(color.g, color.b));
+        var l = (max + min) / 2f;
+        var delta = max - min;
+
+        var s = delta == 0f ? 0f : delta / (1f - MathF.Abs((2f * l) - 1f));
+
+        var h = 0f;
+
+        if (delta > 0f)
+        {
+            if (max == color.r)
+                h = (color.g - color.b) / delta % 6f;
+            else if (max == color.g)
+                h = (color.b - color.r) / delta + 2f;
+            else
+                h = (color.r - color.g) / delta + 4f;
+
+            h /= 6f;
+
+            if (h < 0f)
+                h += 1f;
+        }
+
+        return new HslColor(h, s, l, color.a);
+    }
+
+    /// <summary>
+    /// Linearly interpolates between two <see cref="HslColor"/> values, using the shortest path for the hue.
+    /// </summary>
+    /// <param name="a">The starting color.</param>
+    /// <param name="b">The ending color.</param>
+    /// <param name="t">The interpolation value between the two colors, clamped to a 0 to 1 range.</param>
+    /// <returns>The interpolated <see cref="HslColor"/>.</returns>
+    public static HslColor Lerp(HslColor a, HslColor b, float t)
+    {
+        return LerpUnclamped(a, b, MathUtilities.Clamp01(t));
+    }
+
+    /// <summary>
+    /// Linearly interpolates between two <see cref="HslColor"/> values without clamping the interpolant.
+    /// </summary>
+    /// <param name="a">The starting color.</param>
+    /// <param name="b">The ending color.</param>
+    /// <param name="t">The interpolation value between the two colors.</param>
+    /// <returns>The interpolated <see cref="HslColor"/>.</returns>
+    public static HslColor LerpUnclamped(HslColor a, HslColor b, float t)
+    {
+        var hueDifference = MathUtilities.Repeat(b.h - a.h, 1f);
+
+        if (hueDifference > 0.5f)
+            hueDifference -= 1f;
+
+        return new HslColor(
+            MathUtilities.Repeat(a.h + (hueDifference * t), 1f),
+            MathUtilities.LerpUnclamped(a.s, b.s, t),
+            MathUtilities.LerpUnclamped(a.l, b.l, t),
+            MathUtilities.LerpUnclamped(a.a, b.a, t));
+    }
+}

MiraAPI/Colors/CustomColor.cs

@@ -1,5 +1,6 @@
-using MiraAPI.Utilities;
+using System.Diagnostics.CodeAnalysis;
-using Reactor.Localization.Utilities;
+using MiraAPI.Translation;
+using MiraAPI.Utilities;
 using UnityEngine;
 
 namespace MiraAPI.Colors;
@@ -10,17 +11,37 @@ namespace MiraAPI.Colors;
 /// <param name="name">The name of the option.</param>
 /// <param name="mainColor">The main color.</param>
 /// <param name="shadowColor">The shadow color.</param>
-public sealed class CustomColor(StringNames name, Color32 mainColor, Color32 shadowColor)
+[SuppressMessage("StyleCop.CSharp.MaintainabilityRules", "SA1401:Fields should be private", Justification = "Internal code.")]
+[SuppressMessage("StyleCop.CSharp.LayoutRules", "SA1513:Closing brace should be followed by blank line", Justification = "Looks weird.")]
+public class CustomColor(StringNames name, Color32 mainColor, Color32 shadowColor)
 {
     /// <summary>
     /// Gets or sets the main color.
     /// </summary>
-    public Color32 MainColor { get; set; } = mainColor;
+    public Color32 MainColor
+    {
+        get;
+        set
+        {
+            field = value;
+            InternalMainColor = value;
+        }
+    }
+    = mainColor;
 
     /// <summary>
     /// Gets or sets the shadow color.
     /// </summary>
-    public Color32 ShadowColor { get; set; } = shadowColor;
+    public Color32 ShadowColor
+    {
+        get;
+        set
+        {
+            field = value;
+            InternalShadowColor = value;
+        }
+    }
+    = shadowColor;
 
     /// <summary>
     /// Gets or sets the name of the color.
@@ -32,18 +53,24 @@ public sealed class CustomColor(StringNames name, Color32 mainColor, Color32 sha
     /// </summary>
     public CustomColorBrightness ColorBrightness { get; set; } = CustomColorBrightness.Darker;
 
-    /// <inheritdoc />
+    internal Color InternalMainColor = mainColor;
-    public CustomColor(StringNames name, Color32 mainColor) : this(name, mainColor, mainColor.GetShadowColor(60))
+    internal Color InternalShadowColor = shadowColor;
+
+    /// <inheritdoc cref="CustomColor"/>
+    public CustomColor(StringNames name, Color32 mainColor)
+        : this(name, mainColor, mainColor.GetShadowColor(60))
     {
     }
 
-    /// <inheritdoc />
+    /// <inheritdoc cref="CustomColor"/>
-    public CustomColor(string name, Color32 mainColor) : this(name, mainColor, mainColor.GetShadowColor(60))
+    public CustomColor(string name, Color32 mainColor)
+        : this(name, mainColor, mainColor.GetShadowColor(60))
     {
     }
 
-    /// <inheritdoc />
+    /// <inheritdoc cref="CustomColor"/>
-    public CustomColor(string name, Color32 mainColor, Color32 shadowColor) : this(CustomStringName.CreateAndRegister(name), mainColor, shadowColor)
+    public CustomColor(string name, Color32 mainColor, Color32 shadowColor)
+        : this(MiraLocaleManager.GetOrCreateLocaleString(name), mainColor, shadowColor)
     {
     }
 }
@@ -53,6 +80,11 @@ public sealed class CustomColor(StringNames name, Color32 mainColor, Color32 sha
 /// </summary>
 public enum CustomColorBrightness
 {
+    /// <summary>
+    /// An invalid color.
+    /// </summary>
+    Invalid = -1,
+
     /// <summary>
     /// A lighter color.
     /// </summary>

MiraAPI/Colors/PaletteManager.cs

@@ -1,23 +1,52 @@
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using HarmonyLib;
+using UnityEngine;
 
 namespace MiraAPI.Colors;
 
 /// <summary>
-/// Used to register and track custom colors.
+/// Used to register and track <see cref="CustomColor"/>s.
 /// </summary>
 public static class PaletteManager
 {
     /// <summary>
-    /// Gets all registered custom colors.
+    /// Gets all registered <see cref="CustomColor"/>s.
     /// </summary>
     public static CustomColor[] RegisteredColors => [.. CustomColors];
 
     internal static readonly List<CustomColor> CustomColors = [];
+    internal static readonly HashSet<StringNames> VariableColorNames = [];
+
+    private static readonly CustomColorBrightness[] ColorBrightnessMap =
+    [
+        CustomColorBrightness.Darker,  // Red
+        CustomColorBrightness.Darker,  // Blue
+        CustomColorBrightness.Darker,  // Green
+        CustomColorBrightness.Lighter, // Pink
+        CustomColorBrightness.Lighter, // Orange
+        CustomColorBrightness.Lighter, // Yellow
+        CustomColorBrightness.Darker,  // Black
+        CustomColorBrightness.Lighter, // White
+        CustomColorBrightness.Darker,  // Purple
+        CustomColorBrightness.Darker,  // Brown
+        CustomColorBrightness.Lighter, // Cyan
+        CustomColorBrightness.Lighter, // Lime
+        CustomColorBrightness.Darker,  // Maroon
+        CustomColorBrightness.Lighter, // Rose
+        CustomColorBrightness.Lighter, // Banana
+        CustomColorBrightness.Darker,  // Gray
+        CustomColorBrightness.Darker,  // Tan
+        CustomColorBrightness.Lighter, // Coral
+    ];
+
+    private static int originalLength;
 
     internal static void RegisterAllColors()
     {
+        originalLength = Palette.PlayerColors.Length;
+
         var colors = CustomColors.Select(x => x.MainColor).ToArray();
         var shadowColors = CustomColors.Select(x => x.ShadowColor).ToArray();
         var stringNames = CustomColors.Select(x => x.Name).ToArray();
@@ -29,4 +58,90 @@ public static class PaletteManager
         Palette.TextColors = Palette.TextColors.ToArray().AddRangeToArray(colors);
         Palette.TextOutlineColors = Palette.TextOutlineColors.ToArray().AddRangeToArray(shadowColors);
     }
+
+    /// <summary>
+    /// Checks to see if the provided color ID belongs to a variable color.
+    /// </summary>
+    /// <param name="colorId">The id of the color.</param>
+    /// <returns><c>true</c> if the color is a variable color; <c>false</c> otherwise.</returns>
+    public static bool IsVariable(int colorId)
+    {
+        if ((uint)colorId >= (uint)Palette.ColorNames.Length)
+            return false;
+
+        return VariableColorNames.Contains(Palette.ColorNames[colorId]);
+    }
+
+    /// <summary>
+    /// Checks to see if the provided color ID belongs to a custom color.
+    /// </summary>
+    /// <param name="colorId">The ID of the color.</param>
+    /// <returns><c>true</c> if the color is a custom color; <c>false</c> otherwise.</returns>
+    public static bool IsCustomColor(int colorId)
+    {
+        return (uint)(colorId - originalLength) < (uint)CustomColors.Count;
+    }
+
+    /// <summary>
+    /// Gets the main color of the provided color ID.
+    /// </summary>
+    /// <param name="colorId">The id of the color.</param>
+    /// <returns>The main color associated with the provided ID.</returns>
+    public static Color GetMainColor(int colorId)
+    {
+        if ((uint)colorId >= (uint)Palette.ColorNames.Length)
+            return Color.white;
+
+        return !TryGetCustomColor(colorId, out var custom)
+            ? Palette.PlayerColors[colorId]
+            : (custom is VariableColor variable
+                ? variable.EvaluateMainColor(Time.time)
+                : custom.InternalMainColor);
+    }
+
+    /// <summary>
+    /// Gets the shadow color of the provided color ID.
+    /// </summary>
+    /// <param name="colorId">The ID of the color.</param>
+    /// <returns>The shadow color associated with the provided ID.</returns>
+    public static Color GetShadowColor(int colorId)
+    {
+        if ((uint)colorId >= (uint)Palette.ColorNames.Length)
+            return Color.white;
+
+        return !TryGetCustomColor(colorId, out var custom)
+            ? Palette.ShadowColors[colorId]
+            : (custom is VariableColor variable
+                ? variable.EvaluateShadowColor(Time.time)
+                : custom.InternalShadowColor);
+    }
+
+    /// <summary>
+    /// Gets the brightness type of the color associated with the provided ID.
+    /// </summary>
+    /// <param name="colorId">The ID of the color.</param>
+    /// <returns>The brightness type of the provided ID.</returns>
+    public static CustomColorBrightness GetBrightness(int colorId)
+    {
+        if ((uint)colorId >= (uint)Palette.ColorNames.Length)
+            return CustomColorBrightness.Invalid;
+
+        return TryGetCustomColor(colorId, out var custom)
+            ? custom.ColorBrightness
+            : ColorBrightnessMap[colorId];
+    }
+
+    internal static bool TryGetCustomColor(int colorId, [NotNullWhen(true)] out CustomColor? custom)
+    {
+        var index = colorId - originalLength;
+
+        if ((uint)index >= (uint)CustomColors.Count)
+        {
+            custom = null;
+            return false;
+        }
+
+        custom = CustomColors[index];
+        return true;
+    }
 }

MiraAPI/Colors/RegisterCustomColorsAttribute.cs

@@ -3,7 +3,7 @@
 namespace MiraAPI.Colors;
 
 /// <summary>
-/// Used to mark a class for custom colors registration.
+/// Used to mark a class for <see cref="CustomColor"/> registration.
 /// </summary>
 [AttributeUsage(AttributeTargets.Class)]
 public class RegisterCustomColorsAttribute : Attribute;

MiraAPI/Colors/VariableColor.cs

@@ -0,0 +1,72 @@
+using System;
+using MiraAPI.LocalSettings;
+using MiraAPI.Translation;
+using MiraAPI.Utilities;
+using UnityEngine;
+
+namespace MiraAPI.Colors;
+
+/// <summary>
+/// Represents a dynamic custom color that changes over time.
+/// </summary>
+/// <param name="name">The name of the color.</param>
+/// <param name="mainEvaluator">The function to evaluate the dynamic main color.</param>
+/// <param name="shadowEvaluator">The function to evaluate the dynamic shadow color.</param>
+/// <param name="mainColor">The static main color used when dynamic colors are disabled.</param>
+/// <param name="shadowColor">The static shadow color used when dynamic colors are disabled.</param>
+/// <param name="defaultTime">The default time that is used to automatically fill in the static colors when the latter is not provided.</param>
+public sealed class VariableColor(StringNames name, Func<float, Color> mainEvaluator, Func<float, Color>? shadowEvaluator, Color32? mainColor = null, Color32? shadowColor = null, float defaultTime = 0f)
+    : CustomColor(name, mainColor ?? mainEvaluator(defaultTime), shadowColor ?? shadowEvaluator?.Invoke(defaultTime) ?? (mainColor ?? mainEvaluator(defaultTime)).GetShadowColor(60))
+{
+    /// <summary>
+    /// Gets or sets a delegate that takes in a time value and returns the dynamic main color.
+    /// </summary>
+    public Func<float, Color> MainEvaluator { get; set; } = mainEvaluator;
+
+    /// <summary>
+    /// Gets or sets a delegate that takes in a time value and returns the dynamic shadow color.
+    /// </summary>
+    public Func<float, Color> ShadowEvaluator { get; set; } = shadowEvaluator ?? (t => mainEvaluator(t).GetShadowColor(0.24f));
+
+    /// <inheritdoc cref="VariableColor"/>
+    public VariableColor(StringNames name, Func<float, Color> mainEvaluator, Color32? mainColor = null, float defaultTime = 0f)
+        : this(name, mainEvaluator, null, mainColor, null, defaultTime)
+    {
+    }
+
+    /// <inheritdoc cref="VariableColor"/>
+    public VariableColor(string name, Func<float, Color> mainEvaluator, Color32? mainColor = null, float defaultTime = 0f)
+        : this(name, mainEvaluator, null, mainColor, null, defaultTime)
+    {
+    }
+
+    /// <inheritdoc cref="VariableColor"/>
+    public VariableColor(string name, Func<float, Color> mainEvaluator, Func<float, Color>? shadowEvaluator, Color32? mainColor = null, Color32? shadowColor = null, float defaultTime = 0f)
+        : this(MiraLocaleManager.GetOrCreateLocaleString(name), mainEvaluator, shadowEvaluator, mainColor, shadowColor, defaultTime)
+    {
+    }
+
+    /// <summary>
+    /// Evaluates the dynamic main color based on the provided time value.
+    /// </summary>
+    /// <param name="time">The time to evaluate the color against.</param>
+    /// <returns>The dynamically evaluated color, or the static <see cref="CustomColor.MainColor"/> if static variable colors are enabled in the user's settings.</returns>
+    public Color EvaluateMainColor(float time)
+    {
+        return LocalSettingsTabSingleton<MiraApiSettings>.Instance.EnableVariableColors.Value
+            ? MainEvaluator(time)
+            : InternalMainColor;
+    }
+
+    /// <summary>
+    /// Evaluates the dynamic shadow color based on the provided time value.
+    /// </summary>
+    /// <param name="time">The time to evaluate the color against.</param>
+    /// <returns>The dynamically evaluated color, or the static <see cref="CustomColor.ShadowColor"/> if static variable colors are enabled in the user's settings.</returns>
+    public Color EvaluateShadowColor(float time)
+    {
+        return LocalSettingsTabSingleton<MiraApiSettings>.Instance.EnableVariableColors.Value
+            ? ShadowEvaluator(time)
+            : InternalShadowColor;
+    }
+}

MiraAPI/Colors/VariableColorBehaviour.cs

@@ -0,0 +1,102 @@
+using System.Diagnostics.CodeAnalysis;
+using Il2CppInterop.Runtime.Attributes;
+using MiraAPI.Colors;
+using MiraAPI.Utilities;
+using Reactor.Utilities.Attributes;
+using UnityEngine;
+
+namespace MiraAPI;
+
+/// <summary>
+/// The base class for variable color behaviour on <see cref="SpriteRenderer"/>s.
+/// </summary>
+[SuppressMessage("Style", "IDE0051:Remove unused private members", Justification = "Unity methods.")]
+[SuppressMessage("Design", "CA1051:Do not declare visible instance fields", Justification = "Unity fields.")]
+[SuppressMessage("StyleCop.CSharp.MaintainabilityRules", "SA1401:Fields should be private", Justification = "Read above.")]
+public abstract class BaseVariableColorBehaviour : MonoBehaviour
+{
+    /// <summary>
+    /// The <see cref="VariableColor"/> to apply.
+    /// </summary>
+    protected VariableColor? color;
+
+    /// <summary>
+    /// Sets the current variable color.
+    /// </summary>
+    /// <param name="newColor">The new <see cref="VariableColor"/>.</param>
+    [HideFromIl2Cpp]
+    public void SetColor(VariableColor? newColor)
+    {
+        color = newColor;
+    }
+}
+
+/// <summary>
+/// A mono script that adjusts the material colors of a <see cref="Renderer"/> component that it's attached to based on the provided variable color.
+/// </summary>
+[RegisterInIl2Cpp]
+[SuppressMessage("Style", "IDE0051:Remove unused private members", Justification = "Unity methods.")]
+public sealed class VariableColorBehaviour : BaseVariableColorBehaviour
+{
+    private Renderer? rend;
+
+    private static readonly Color VisorColor = Palette.VisorColor;
+
+    /// <summary>
+    /// Sets the new <see cref="Renderer"/> target.
+    /// </summary>
+    /// <param name="newRend">The new <see cref="Renderer"/> that the script must target.</param>
+    public void SetRend(Renderer? newRend)
+    {
+        rend = newRend;
+    }
+
+    private void Awake()
+    {
+        rend = GetComponent<Renderer>();
+    }
+
+    private void Update()
+    {
+        if (color == null || rend == null)
+            return;
+
+        var time = Time.time;
+        var material = rend.material;
+
+        material.SetColor(ShaderID.VisorColor, VisorColor);
+
+        material.SetColor(ShaderID.BodyColor, color.EvaluateMainColor(time));
+        material.SetColor(ShaderID.BackColor, color.EvaluateShadowColor(time));
+    }
+}
+
+/// <summary>
+/// A mono script that adjusts the graphic colors of a <see cref="SpriteRenderer"/> component that it's attached to based on the provided variable color.
+/// </summary>
+[RegisterInIl2Cpp]
+[SuppressMessage("Style", "IDE0051:Remove unused private members", Justification = "Unity methods.")]
+public sealed class BasicVariableColorBehaviour : BaseVariableColorBehaviour
+{
+    private SpriteRenderer? rend;
+
+    /// <summary>
+    /// Sets the new <see cref="SpriteRenderer"/> target.
+    /// </summary>
+    /// <param name="newRend">The new <see cref="SpriteRenderer"/> that the script must target.</param>
+    public void SetRend(SpriteRenderer? newRend)
+    {
+        rend = newRend;
+    }
+
+    private void Awake()
+    {
+        rend = GetComponent<SpriteRenderer>();
+    }
+
+    private void Update()
+    {
+        if (color != null && rend != null)
+            rend.color = color.EvaluateMainColor(Time.time);
+    }
+}

MiraAPI/Events/Mira/MiraButtonCancelledEvent.cs

@@ -3,42 +3,27 @@
 namespace MiraAPI.Events.Mira;
 
 /// <summary>
-/// Invoked when a Mira Button click is cancelled. Do not use for vanilla buttons.
+/// Invoked when a <see cref="CustomActionButton"/> click is cancelled. Do not use for vanilla <see cref="AbilityButton"/>s.
 /// </summary>
-/// <typeparam name="T">The Mira Button type.</typeparam>
+/// <typeparam name="T">The <see cref="CustomActionButton"/> type.</typeparam>
-public sealed class MiraButtonCancelledEvent<T> : MiraEvent where T : CustomActionButton
+/// <param name="button">The <see cref="CustomActionButton"/> whose click was cancelled.</param>
+public sealed class MiraButtonCancelledEvent<T>(T button) : MiraEvent
+    where T : CustomActionButton
 {
     /// <summary>
-    /// Gets Mira Button whose click was cancelled.
+    /// Gets the <see cref="CustomActionButton"/> whose click was cancelled.
     /// </summary>
-    public T Button { get; }
+    public T Button { get; } = button;
-
-    /// <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.
+/// Invoked when a <see cref="CustomActionButton"/> click is cancelled. Do not use for vanilla <see cref="AbilityButton"/>s.
 /// </summary>
-public sealed class MiraButtonCancelledEvent : MiraEvent
+/// <param name="button">The <see cref="CustomActionButton"/> whose click was cancelled.</param>
+public sealed class MiraButtonCancelledEvent(CustomActionButton button) : MiraEvent
 {
     /// <summary>
-    /// Gets Mira Button whose click was cancelled.
+    /// Gets the <see cref="CustomActionButton"/> whose click was cancelled.
     /// </summary>
-    public CustomActionButton Button { get; }
+    public CustomActionButton Button { get; } = button;
-
-    /// <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

@@ -3,49 +3,33 @@
 namespace MiraAPI.Events.Mira;
 
 /// <summary>
-/// Button click event for Mira Buttons only. Do not use for vanilla buttons.
+/// Button click event for <see cref="CustomActionButton"/>s only. Do not use for vanilla <see cref="AbilityButton"/>s.
 /// </summary>
-/// <typeparam name="T">The Mira Button type.</typeparam>
+/// <typeparam name="T">The <see cref="CustomActionButton"/> type.</typeparam>
-public sealed class MiraButtonClickEvent<T> : MiraCancelableEvent where T : CustomActionButton
+/// <param name="button">The <see cref="CustomActionButton"/> that was clicked.</param>
+/// <param name="genericClickEvent">The generic <see cref="MiraButtonClickEvent"/> invoked before button-specific events.</param>
+public class MiraButtonClickEvent<T>(T button, MiraButtonClickEvent genericClickEvent) : MiraCancelableEvent
+    where T : CustomActionButton
 {
     /// <summary>
-    /// Gets Mira Button that was clicked.
+    /// Gets the <see cref="CustomActionButton"/> that was clicked.
     /// </summary>
-    public T Button { get; }
+    public T Button { get; } = button;
 
     /// <summary>
-    /// Gets the generic click event that is invoked before this button-specific event.
+    /// Gets the generic <see cref="MiraButtonClickEvent"/> that is invoked before this button-specific event.
     /// </summary>
-    public MiraButtonClickEvent GenericClickEvent { get; }
+    public MiraButtonClickEvent GenericClickEvent { get; } = genericClickEvent;
-
-    /// <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.
+/// Button click event for <see cref="CustomActionButton"/>s only. Do not use for vanilla <see cref="AbilityButton"/>s.
 /// </summary>
-public sealed class MiraButtonClickEvent : MiraCancelableEvent
+/// <param name="button">The <see cref="CustomActionButton"/> that was clicked.</param>
+public class MiraButtonClickEvent(CustomActionButton button) : MiraCancelableEvent
 {
     /// <summary>
-    /// Gets Mira Button that was clicked.
+    /// Gets the <see cref="CustomActionButton"/> that was clicked.
     /// </summary>
-    public CustomActionButton Button { get; }
+    public CustomActionButton Button { get; } = button;
-
-    /// <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/Mira/UiButtonPostResetEvent.cs

@@ -0,0 +1,21 @@
+using UnityEngine;
+
+namespace MiraAPI.Events.Mira;
+
+/// <summary>
+/// Event fired by Mira API to adjust the UI buttons at the top right of the screen.
+/// </summary>
+/// <param name="topUiRow">The <see cref="GameObject"/> for the top UI row.</param>
+/// <param name="secondUiRow">The <see cref="GameObject"/> for the second UI row.</param>
+public class UiButtonPostResetEvent(GameObject topUiRow, GameObject secondUiRow) : MiraEvent
+{
+    /// <summary>
+    /// Gets the <see cref="GameObject"/> parent for the very top UI row.
+    /// </summary>
+    public GameObject MainTopUiRow { get; } = topUiRow;
+
+    /// <summary>
+    /// Gets the <see cref="GameObject"/> parent for the second top UI row.
+    /// </summary>
+    public GameObject SecondTopUiRow { get; } = secondUiRow;
+}

MiraAPI/Events/Mira/UiButtonResetEvent.cs

@@ -0,0 +1,15 @@
+namespace MiraAPI.Events.Mira;
+
+/// <summary>
+/// Event fired by Mira API prior to adjusting the UI buttons at the top right of the screen.
+/// </summary>
+public class UiButtonResetEvent : MiraEvent
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="UiButtonResetEvent"/> class.
+    /// </summary>
+    public UiButtonResetEvent()
+    {
+        // nothing!
+    }
+}

MiraAPI/Events/MiraCancelableEvent.cs

@@ -1,8 +1,11 @@
-namespace MiraAPI.Events;
+using MiraAPI.PluginLoading;
+
+namespace MiraAPI.Events;
 
 /// <summary>
 /// Abstract class for Mira Events that can be cancelled.
 /// </summary>
+[MiraIgnore]
 public abstract class MiraCancelableEvent : MiraEvent
 {
     /// <summary>

MiraAPI/Events/MiraEvent.cs

@@ -1,6 +1,9 @@
-namespace MiraAPI.Events;
+using MiraAPI.PluginLoading;
+
+namespace MiraAPI.Events;
 
 /// <summary>
 /// Abstract class for Mira Events.
 /// </summary>
+[MiraIgnore]
 public abstract class MiraEvent;

MiraAPI/Events/MiraEventHandle.cs

@@ -3,7 +3,7 @@
 namespace MiraAPI.Events;
 
 /// <summary>
-/// Event handle to use when unregistering an event.
+/// Event handle to use when unregistering a <see cref="MiraEvent"/>.
 /// </summary>
 public class MiraEventHandle
 {

MiraAPI/Events/MiraEventManager.cs

@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Reflection;
-using Reactor.Utilities;
 
 namespace MiraAPI.Events;
 
@@ -13,14 +12,16 @@ public static class MiraEventManager
     private static readonly Dictionary<Type, List<MiraEventWrapper>> EventWrappers = [];
 
     /// <summary>
-    /// Invoke an event.
+    /// Invoke a <see cref="MiraEvent"/>.
     /// </summary>
-    /// <param name="eventInstance">The event instance.</param>
+    /// <param name="eventInstance">The <typeparamref name="T"/> 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>
+    /// <returns>If there was an event handler invoked for this event, return <see langword="true"/>. Otherwise, return <see langword="false"/>.</returns>
-    public static bool InvokeEvent<T>(T eventInstance) where T : MiraEvent
+    public static bool InvokeEvent<T>(this T eventInstance)
+        where T : MiraEvent
     {
         EventWrappers.TryGetValue(typeof(T), out var handlers);
+
         if (handlers == null || handlers.Count == 0)
         {
             return false;
@@ -34,7 +35,7 @@ public static class MiraEventManager
             }
             catch (Exception ex)
             {
-                Logger<MiraApiPlugin>.Error($"Error invoking event handler for {typeof(T).Name}: {ex.ToString()}");
+                Error($"Error invoking event handler for {typeof(T).Name}: {ex.ToString()}");
             }
         }
 
@@ -42,14 +43,15 @@ public static class MiraEventManager
     }
 
     /// <summary>
-    /// Invoke an event and use a specific type to find the handlers.
+    /// Invoke a <see cref="MiraEvent"/> and use a specific type to find the handlers.
     /// </summary>
-    /// <param name="eventInstance">The event instance.</param>
+    /// <param name="eventInstance">The <see cref="MiraEvent"/> 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>
+    /// <returns>If there was an event handler invoked for this event, return <see langword="true"/>. Otherwise, return <see langword="false"/>.</returns>
-    public static bool InvokeEvent(MiraEvent eventInstance, Type type)
+    public static bool InvokeEvent(this MiraEvent eventInstance, Type type)
     {
         EventWrappers.TryGetValue(type, out var handlers);
+
         if (handlers == null || handlers.Count == 0)
         {
             return false;
@@ -63,7 +65,7 @@ public static class MiraEventManager
             }
             catch (Exception ex)
             {
-                Logger<MiraApiPlugin>.Error($"Error invoking event handler for {type.Name}: {ex.ToString()}");
+                Error($"Error invoking event handler for {type.Name}: {ex.ToString()}");
             }
         }
 
@@ -71,12 +73,12 @@ public static class MiraEventManager
     }
 
     /// <summary>
-    /// Register an event.
+    /// Register a <see cref="MiraEvent"/> handler.
     /// </summary>
-    /// <param name="type">The type of event.</param>
+    /// <param name="type">The type of <see cref="MiraEvent"/> event.</param>
-    /// <param name="methodInfo">The MethodInfo of the event handler.</param>
+    /// <param name="methodInfo">The <see cref="MethodInfo"/> of the event handler.</param>
     /// <param name="priority">The priority of the event handler. Lower values are called first.</param>
-    /// <returns>An event handle to use when unregistering the event.</returns>
+    /// <returns>A <see cref="MiraEventHandle"/> to use when unregistering the event.</returns>
     public static MiraEventHandle RegisterEventHandler(Type type, MethodInfo methodInfo, int priority = 0)
     {
         if (!type.IsSubclassOf(typeof(MiraEvent)))
@@ -102,13 +104,14 @@ public static class MiraEventManager
     }
 
     /// <summary>
-    /// Register an event.
+    /// Register a <typeparamref name="T"/> handler.
     /// </summary>
     /// <param name="handler">The callback method/handler for the event.</param>
     /// <param name="priority">The priority of the event handler. Lower values are called first.</param>
-    /// <typeparam name="T">Type of event.</typeparam>
+    /// <typeparam name="T">Type of <see cref="MiraEvent"/> event.</typeparam>
-    /// <returns>An event handle to use when unregistering the event.</returns>
+    /// <returns>A <see cref="MiraEventHandle"/> to use when unregistering the event.</returns>
-    public static MiraEventHandle RegisterEventHandler<T>(Action<T> handler, int priority = 0) where T : MiraEvent
+    public static MiraEventHandle RegisterEventHandler<T>(Action<T> handler, int priority = 0)
+        where T : MiraEvent
     {
         EventWrappers.TryAdd(typeof(T), []);
 
@@ -127,10 +130,10 @@ public static class MiraEventManager
     }
 
     /// <summary>
-    /// Unregister an event using the event handle.
+    /// Unregister a <see cref="MiraEvent"/> handler using the <see cref="MiraEventHandle"/>.
     /// </summary>
     /// <param name="eventHandle">A handle to the event.</param>
-    /// <returns>True if the event was unregistered successfully, false otherwise.</returns>
+    /// <returns><see langword="true"/> if the event was unregistered successfully, <see langword="false"/> otherwise.</returns>
     public static bool UnregisterEventHandler(MiraEventHandle eventHandle)
     {
         if (!EventWrappers.TryGetValue(eventHandle.EventType, out var handlers))
@@ -147,6 +150,7 @@ public static class MiraEventManager
         {
             EventWrappers.Remove(eventHandle.EventType);
         }
+
         return true;
     }
 }

MiraAPI/Events/MiraEventWrapper.cs

@@ -3,28 +3,19 @@
 namespace MiraAPI.Events;
 
 /// <summary>
-/// Wrapper for event handlers.
+/// Wrapper for <see cref="MiraEvent"/> handlers.
 /// </summary>
-public class MiraEventWrapper
+/// <param name="eventHandler">The action for the event handler.</param>
+/// <param name="priority">The priority of the handler.</param>
+public class MiraEventWrapper(Delegate eventHandler, int priority)
 {
     /// <summary>
     /// Gets the event handler delegate.
     /// </summary>
-    public Delegate EventHandler { get; }
+    public Delegate EventHandler { get; } = eventHandler;
 
     /// <summary>
     /// Gets the priority of the handler. Lower values are called first.
     /// </summary>
-    public int Priority { get; }
+    public int Priority { get; } = priority;
-
-    /// <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/RegisterEventAttribute.cs

@@ -3,22 +3,14 @@
 namespace MiraAPI.Events;
 
 /// <summary>
-/// Register an event.
+/// Register a <see cref="MiraEvent"/> handler.
 /// </summary>
+/// <param name="priority">The priority of the event. Lower values are called first.</param>
 [AttributeUsage(AttributeTargets.Method)]
-public class RegisterEventAttribute : Attribute
+public class RegisterEventAttribute(int priority = 0) : Attribute
 {
     /// <summary>
     /// Gets the priority of the event. Lower values are called first.
     /// </summary>
-    public int Priority { get; }
+    public int Priority { get; } = priority;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="RegisterEventAttribute"/> class.
-    /// </summary>
-    /// <param name="priority">The priority of the event. Lower values are called first.</param>
-    public RegisterEventAttribute(int priority = 0)
-    {
-        Priority = priority;
-    }
 }

MiraAPI/Events/Vanilla/Gameplay/AfterMurderEvent.cs

@@ -3,33 +3,66 @@
 /// <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
+/// <param name="source">The <see cref="PlayerControl"/> that killed the <paramref name="target"/>.</param>
+/// <param name="target">The <see cref="PlayerControl"/> that was killed.</param>
+/// <param name="framed">The <see cref="PlayerControl"/> that was framed.</param>
+/// <param name="deadBody">The <paramref name="target"/>'s <see cref="global::DeadBody"/>, if it exists.</param>
+/// <param name="isIndirect">Whether the murder was caused indirectly.</param>
+/// <param name="ignoreDefense">Whether the murder ignored protection.</param>
+public class AfterMurderEvent(PlayerControl source, PlayerControl target, PlayerControl? framed, DeadBody? deadBody, bool isIndirect = true, bool ignoreDefense = false) : MiraEvent
 {
     /// <summary>
-    /// Gets the player that killed the target.
+    /// Gets the <see cref="PlayerControl"/> that killed the <see cref="Target"/>.
     /// </summary>
-    public PlayerControl Source { get; }
+    public PlayerControl Source { get; } = source;
 
     /// <summary>
-    /// Gets the player that was killed.
+    /// Gets the <see cref="PlayerControl"/> that was killed.
     /// </summary>
-    public PlayerControl Target { get; }
+    public PlayerControl Target { get; } = target;
 
     /// <summary>
-    /// Gets the player's body, if it exists.
+    /// Gets the <see cref="PlayerControl"/> that was framed, if any.
     /// </summary>
-    public DeadBody? DeadBody { get; }
+    public PlayerControl? Framed { get; } = framed;
+
+    /// <summary>
+    /// Gets a value indicating whether the murder was done indirectly.
+    /// This is commonly used to prevent the <see cref="Source"/> <see cref="PlayerControl"/> from being killed.
+    /// </summary>
+    public bool IsIndirectAttack { get; } = isIndirect;
+
+    /// <summary>
+    /// Gets a value indicating whether the murder was able to bypass protective roles or general defense, such as <see cref="GuardianAngelRole"/>.
+    /// </summary>
+    public bool IgnoreDefense { get; } = ignoreDefense;
+
+    /// <summary>
+    /// Gets the <see cref="Target"/>'s <see cref="DeadBody"/>, if it exists.
+    /// </summary>
+    public DeadBody? DeadBody { get; } = deadBody;
 
     /// <summary>
     /// Initializes a new instance of the <see cref="AfterMurderEvent"/> class.
     /// </summary>
-    /// <param name="source">The killer.</param>
+    /// <param name="source">The <see cref="PlayerControl"/> that killed the <paramref name="target"/>.</param>
-    /// <param name="target">The killed player.</param>
+    /// <param name="target">The <see cref="PlayerControl"/> that was killed.</param>
-    /// <param name="deadBody">The player's vody, if it exists.</param>
+    /// <param name="deadBody">The <paramref name="target"/>'s <see cref="DeadBody"/>, if it exists.</param>
+    /// <param name="isIndirect">Whether the murder was caused indirectly.</param>
+    /// <param name="ignoreDefense">Whether the murder ignored protection.</param>
+    public AfterMurderEvent(PlayerControl source, PlayerControl target, DeadBody? deadBody, bool isIndirect, bool ignoreDefense = false)
+        : this(source, target, null, deadBody, isIndirect, ignoreDefense)
+    {
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="AfterMurderEvent"/> class.
+    /// </summary>
+    /// <param name="source">The <see cref="PlayerControl"/> that killed the <paramref name="target"/>.</param>
+    /// <param name="target">The <see cref="PlayerControl"/> that was killed.</param>
+    /// <param name="deadBody">The <paramref name="target"/>'s <see cref="DeadBody"/>, if it exists.</param>
     public AfterMurderEvent(PlayerControl source, PlayerControl target, DeadBody? deadBody)
+        : this(source, target, null, deadBody)
     {
-        Source = source;
-        Target = target;
-        DeadBody = deadBody;
     }
 }

MiraAPI/Events/Vanilla/Gameplay/BeforeGameEndEvent.cs

@@ -1,21 +1,13 @@
 namespace MiraAPI.Events.Vanilla.Gameplay;
 
 /// <summary>
-/// Invoked before RpcEndGame is called, allowing cancellation of the game end entirely.
+/// Invoked before <see cref="GameManager.RpcEndGame"/> is called, allowing cancellation of the game end entirely.
 /// </summary>
-public class BeforeGameEndEvent : MiraCancelableEvent
+/// <param name="reason">The reason for the game end.</param>
+public class BeforeGameEndEvent(GameOverReason reason) : MiraCancelableEvent
 {
     /// <summary>
     /// Gets the reason for the game end.
     /// </summary>
-    public GameOverReason Reason { get; }
+    public GameOverReason Reason { get; } = reason;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="BeforeGameEndEvent"/> class.
-    /// </summary>
-    /// <param name="reason">The reason for the game end.</param>
-    public BeforeGameEndEvent(GameOverReason reason)
-    {
-        Reason = reason;
-    }
 }

MiraAPI/Events/Vanilla/Gameplay/BeforeMurderEvent.cs

@@ -1,28 +1,71 @@
-namespace MiraAPI.Events.Vanilla.Gameplay;
+using MiraAPI.Networking;
+
+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
+/// <param name="source">The <see cref="PlayerControl"/> that is killing the <paramref name="target"/>.</param>
+/// <param name="target">The <see cref="PlayerControl"/> that is being killed.</param>
+/// <param name="framed">The <see cref="PlayerControl"/> that is being framed.</param>
+/// <param name="isIndirect">Whether the murder is caused indirectly.</param>
+/// <param name="ignoreDefense">Whether the murder should ignore protection.</param>
+/// <param name="inMeeting">Whether the murder is intended to be triggered in a meeting.</param>
+public sealed class BeforeMurderEvent(PlayerControl source, PlayerControl target, PlayerControl? framed, bool isIndirect = true, bool ignoreDefense = false, MeetingCheck inMeeting = MeetingCheck.Ignore)
+    : MiraCancelableEvent
 {
     /// <summary>
-    /// Gets the player that is killing the target.
+    /// Gets the <see cref="PlayerControl"/> that is killing the <see cref="Target"/>.
     /// </summary>
-    public PlayerControl Source { get; }
+    public PlayerControl Source { get; } = source;
 
     /// <summary>
-    /// Gets the player that is being killed.
+    /// Gets the <see cref="PlayerControl"/> that is being killed.
     /// </summary>
-    public PlayerControl Target { get; }
+    public PlayerControl Target { get; } = target;
+
+    /// <summary>
+    /// Gets the <see cref="PlayerControl"/> that is being framed, if any.
+    /// </summary>
+    public PlayerControl? Framed { get; } = framed;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether the murder is done indirectly.
+    /// This is commonly used to prevent the <see cref="Source"/> <see cref="PlayerControl"/> from being killed.
+    /// </summary>
+    public bool IsIndirectAttack { get; set; } = isIndirect;
+
+    /// <summary>
+    /// Gets or sets  a value indicating whether the murder should bypass protective roles or general defense, such as <see cref="GuardianAngelRole"/>.
+    /// </summary>
+    public bool IgnoreDefense { get; set; } = ignoreDefense;
+
+    /// <summary>
+    /// Gets whether the murder was meant to be done in a meeting, via an enum.
+    /// </summary>
+    public MeetingCheck InMeeting { get; } = inMeeting;
 
     /// <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="source">The <see cref="PlayerControl"/> that is killing the <paramref name="target"/>.</param>
-    /// <param name="target">The player that is being killed.</param>
+    /// <param name="target">The <see cref="PlayerControl"/> that is being killed.</param>
-    public BeforeMurderEvent(PlayerControl source, PlayerControl target)
+    /// <param name="inMeeting">Whether the murder is intended to be triggered in a meeting.</param>
+    public BeforeMurderEvent(PlayerControl source, PlayerControl target, MeetingCheck inMeeting = MeetingCheck.Ignore)
+        : this(source, target, false, false, inMeeting)
+    {
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="BeforeMurderEvent"/> class.
+    /// </summary>
+    /// <param name="source">The <see cref="PlayerControl"/> that is killing the <paramref name="target"/>.</param>
+    /// <param name="target">The <see cref="PlayerControl"/> that is being killed.</param>
+    /// <param name="isIndirect">Whether the murder is caused indirectly.</param>
+    /// <param name="ignoreDefense">Whether the murder should ignore protection.</param>
+    /// <param name="inMeeting">Whether the murder is intended to be triggered in a meeting.</param>
+    public BeforeMurderEvent(PlayerControl source, PlayerControl target, bool isIndirect, bool ignoreDefense = false, MeetingCheck inMeeting = MeetingCheck.Ignore)
+        : this(source, target, null, isIndirect, ignoreDefense, inMeeting)
     {
-        Source = source;
-        Target = target;
     }
 }

MiraAPI/Events/Vanilla/Gameplay/BeforeRoundStartEvent.cs

@@ -0,0 +1,13 @@
+namespace MiraAPI.Events.Vanilla.Gameplay;
+
+/// <summary>
+/// Event invoked on <see cref="IntroCutscene.OnDestroy"/> and <see cref="ExileController.WrapUp"/> to determine if it should run the <see cref="RoundStartEvent"/> event or not.
+/// </summary>
+/// <param name="triggeredByIntro">Whether the event was triggered by the intro or not.</param>
+public class BeforeRoundStartEvent(bool triggeredByIntro) : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets a value indicating whether the event was triggered by the <see cref="IntroCutscene"/> or <see cref="ExileController"/>.
+    /// </summary>
+    public bool TriggeredByIntro { get; } = triggeredByIntro;
+}

MiraAPI/Events/Vanilla/Gameplay/GameEndEvent.cs

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

@@ -1,21 +1,13 @@
 namespace MiraAPI.Events.Vanilla.Gameplay;
 
 /// <summary>
-/// The event that is invoked when the intro cutscene is shown. Non cancelable.
+/// The event that is invoked when the intro cutscene is shown. Non-cancelable.
 /// </summary>
-public class IntroBeginEvent : MiraEvent
+/// <param name="introCutscene">The intro cutscene.</param>
+public class IntroBeginEvent(IntroCutscene introCutscene) : MiraEvent
 {
     /// <summary>
-    /// Gets the instance of the IntroCutscene.
+    /// Gets the <see cref="global::IntroCutscene"/> instance.
     /// </summary>
-    public IntroCutscene IntroCutscene { get; }
+    public IntroCutscene IntroCutscene { get; } = introCutscene;
-
-    /// <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/Gameplay/IntroEndEvent.cs

@@ -3,10 +3,11 @@
 /// <summary>
 /// The event that is invoked when the intro cutscene has finished playing.
 /// </summary>
+/// <param name="introCutscene">The intro cutscene.</param>
 public class IntroEndEvent(IntroCutscene introCutscene) : MiraEvent
 {
     /// <summary>
-    /// Gets the instance of the IntroCutscene.
+    /// Gets the <see cref="global::IntroCutscene"/> instance.
     /// </summary>
     public IntroCutscene IntroCutscene { get; } = introCutscene;
 }

MiraAPI/Events/Vanilla/Gameplay/IntroRoleRevealEvent.cs

@@ -0,0 +1,13 @@
+namespace MiraAPI.Events.Vanilla.Gameplay;
+
+/// <summary>
+/// The event that is invoked when the player's role is shown on the intro cutscene. Non-cancelable.
+/// </summary>
+/// <param name="introCutscene">The intro cutscene.</param>
+public class IntroRoleRevealEvent(IntroCutscene introCutscene) : MiraEvent
+{
+    /// <summary>
+    /// Gets the <see cref="global::IntroCutscene"/> instance.
+    /// </summary>
+    public IntroCutscene IntroCutscene { get; } = introCutscene;
+}

MiraAPI/Events/Vanilla/Gameplay/RoundStartEvent.cs

@@ -1,21 +1,14 @@
 namespace MiraAPI.Events.Vanilla.Gameplay;
 
 /// <summary>
-/// Start Round event, invoked on IntroCutscene.OnDestroy and ExileController.WrapUp.
+/// Start Round event, invoked on <see cref="IntroCutscene.OnDestroy"/> and <see cref="ExileController.WrapUp"/>
+/// if the <see cref="BeforeRoundStartEvent"/> isn't cancelled.
 /// </summary>
-public class RoundStartEvent : MiraEvent
+/// <param name="triggeredByIntro">Whether the event was triggered by the intro or not.</param>
+public class RoundStartEvent(bool triggeredByIntro) : MiraEvent
 {
     /// <summary>
-    /// Gets a value indicating whether the event was triggered by the IntroCutscene or ExileController.
+    /// Gets a value indicating whether the event was triggered by the <see cref="IntroCutscene"/> or <see cref="ExileController"/>.
     /// </summary>
-    public bool TriggeredByIntro { get; }
+    public bool TriggeredByIntro { get; } = triggeredByIntro;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="RoundStartEvent"/> class.
-    /// </summary>
-    /// <param name="triggeredByIntro">Whether the event was triggered by the intro or not.</param>
-    public RoundStartEvent(bool triggeredByIntro)
-    {
-        TriggeredByIntro = triggeredByIntro;
-    }
 }

MiraAPI/Events/Vanilla/Gameplay/SetRoleEvent.cs

@@ -5,26 +5,17 @@ namespace MiraAPI.Events.Vanilla.Gameplay;
 /// <summary>
 /// Event that is invoked after a player's role is set. This event is not cancelable.
 /// </summary>
-public class SetRoleEvent : MiraEvent
+/// <param name="player">The player.</param>
+/// <param name="role">The new role.</param>
+public class SetRoleEvent(PlayerControl player, RoleTypes role) : MiraEvent
 {
     /// <summary>
-    /// Gets the player whos role was changed.
+    /// Gets the <see cref="PlayerControl"/> whose role was changed.
     /// </summary>
-    public PlayerControl Player { get; }
+    public PlayerControl Player { get; } = player;
 
     /// <summary>
     /// Gets the role that the player was set to.
     /// </summary>
-    public RoleTypes Role { get; }
+    public RoleTypes Role { get; } = role;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="SetRoleEvent"/> class.
-    /// </summary>
-    /// <param name="player">The player.</param>
-    /// <param name="role">The new role.</param>
-    public SetRoleEvent(PlayerControl player, RoleTypes role)
-    {
-        Player = player;
-        Role = role;
-    }
 }

MiraAPI/Events/Vanilla/Gameplay/VanillaButtonCancelledEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/VanillaButtonClickEvent.cs

@@ -0,0 +1,47 @@
+using MiraAPI.Hud;
+
+namespace MiraAPI.Events.Vanilla.Gameplay;
+
+/// <summary>
+/// Button click event for Vanilla <see cref="AbilityButton"/>s only. Do not use for <see cref="CustomActionButton"/>s.
+/// </summary>
+/// <typeparam name="T">The vanilla <see cref="AbilityButton"/> type.</typeparam>
+/// <param name="button">The vanilla <see cref="AbilityButton"/> that was clicked.</param>
+/// <param name="genericClickEvent">The generic <see cref="VanillaButtonClickEvent"/> invoked before button-specific events.</param>
+public sealed class VanillaButtonClickEvent<T>(T button, VanillaButtonClickEvent genericClickEvent) : MiraCancelableEvent
+    where T : AbilityButton
+{
+    /// <summary>
+    /// Gets the vanilla <see cref="AbilityButton"/> that was clicked.
+    /// </summary>
+    public T Button { get; } = button;
+
+    /// <summary>
+    /// Gets the generic <see cref="VanillaButtonClickEvent"/> that is invoked before this button-specific event.
+    /// </summary>
+    public VanillaButtonClickEvent GenericClickEvent { get; } = genericClickEvent;
+}
+
+/// <summary>
+/// Button click event for Vanilla <see cref="AbilityButton"/> only. Do not use for <see cref="CustomActionButton"/>s.
+/// </summary>
+/// <param name="button">The Vanilla <see cref="AbilityButton"/> that was clicked.</param>
+/// <param name="playerTarget">The <see cref="PlayerControl"/> target, if any.</param>
+/// <param name="ventTarget">The <see cref="Vent"/> target, if any.</param>
+public sealed class VanillaButtonClickEvent(AbilityButton button, PlayerControl? playerTarget = null, Vent? ventTarget = null) : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the Vanilla <see cref="AbilityButton"/> that was clicked.
+    /// </summary>
+    public AbilityButton Button { get; } = button;
+
+    /// <summary>
+    /// Gets the target <see cref="PlayerControl"/>, if any, of the Vanilla <see cref="AbilityButton"/> that was clicked.
+    /// </summary>
+    public PlayerControl? PlayerTarget { get; } = playerTarget;
+
+    /// <summary>
+    /// Gets the target <see cref="Vent"/>, if any, of the Vanilla <see cref="AbilityButton"/> that was clicked.
+    /// </summary>
+    public Vent? VentTarget { get; } = ventTarget;
+}

MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs

@@ -3,19 +3,11 @@
 /// <summary>
 /// Event fired when a player closes the doors in a room.
 /// </summary>
-public class CloseDoorsEvent : MiraCancelableEvent
+/// <param name="room">The room that was closed.</param>
+public class CloseDoorsEvent(SystemTypes room) : MiraCancelableEvent
 {
     /// <summary>
     /// Gets the room that the doors were closed in.
     /// </summary>
-    public SystemTypes Room { get; }
+    public SystemTypes Room { get; } = room;
-
-    /// <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

@@ -3,19 +3,11 @@
 /// <summary>
 /// Sabotage from Vanilla Among Us.
 /// </summary>
-public class PlayerOpenSabotageEvent : MiraCancelableEvent
+/// <param name="mapBehaviour">The <see cref="global::MapBehaviour"/>.</param>
+public class PlayerOpenSabotageEvent(MapBehaviour mapBehaviour) : MiraCancelableEvent
 {
     /// <summary>
-    /// Gets the MapBehaviour.
+    /// Gets the <see cref="global::MapBehaviour"/>.
     /// </summary>
-    public MapBehaviour MapBehaviour { get; }
+    public MapBehaviour MapBehaviour { get; } = mapBehaviour;
-
-    /// <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

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

@@ -3,19 +3,11 @@
 /// <summary>
 /// The event that is invoked when a player is ejected. Non-cancelable.
 /// </summary>
-public class EjectionEvent : MiraEvent
+/// <param name="controller">The <see cref="global::ExileController"/> instance.</param>
+public class EjectionEvent(ExileController controller) : MiraEvent
 {
     /// <summary>
-    /// Gets the instance of the ExileController.
+    /// Gets the <see cref="global::ExileController"/> instance.
     /// </summary>
-    public ExileController ExileController { get; }
+    public ExileController ExileController { get; } = controller;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="EjectionEvent"/> class.
-    /// </summary>
-    /// <param name="controller">The exile controller.</param>
-    public EjectionEvent(ExileController controller)
-    {
-        ExileController = controller;
-    }
 }

MiraAPI/Events/Vanilla/Meeting/EndMeetingEvent.cs

@@ -6,7 +6,7 @@
 public class EndMeetingEvent(MeetingHud meetingHud) : MiraEvent
 {
     /// <summary>
-    /// Gets the MeetingHud instance.
+    /// Gets the <see cref="global::MeetingHud"/> instance.
     /// </summary>
     public MeetingHud MeetingHud { get; } = meetingHud;
 }

MiraAPI/Events/Vanilla/Meeting/ReportBodyEvent.cs

@@ -1,36 +1,26 @@
 namespace MiraAPI.Events.Vanilla.Meeting;
 
 /// <summary>
-/// The event that is invoked when a body is reported.
+/// The event that is invoked when a body is reported.<br/>
-/// This is invoked in CmdReportBody.
+/// This is invoked in <see cref="PlayerControl.CmdReportDeadBody(NetworkedPlayerInfo)"/>.
 /// </summary>
-public class ReportBodyEvent : MiraCancelableEvent
+/// <param name="reporter">The player who reported the body.</param>
+/// <param name="target">The player being reported.</param>
+/// <param name="body">The <see cref="DeadBody"/> being reported.</param>
+public class ReportBodyEvent(PlayerControl reporter, NetworkedPlayerInfo? target, DeadBody? body) : MiraCancelableEvent
 {
     /// <summary>
     /// Gets the player that is reporting the body.
     /// </summary>
-    public PlayerControl Reporter { get; }
+    public PlayerControl Reporter { get; } = reporter;
 
     /// <summary>
-    /// Gets the player that is being reported. Will be null for emergency meeting.
+    /// Gets the player that is being reported. Will be <see langword="null"/> for emergency meeting.
     /// </summary>
-    public NetworkedPlayerInfo? Target { get; }
+    public NetworkedPlayerInfo? Target { get; } = target;
 
     /// <summary>
-    /// Gets the body that is being reported. Will be null for emergency meeting.
+    /// Gets the <see cref="DeadBody"/> that is being reported. Will be <see langword="null"/> for emergency meeting.
     /// </summary>
-    public DeadBody? Body { get; }
+    public DeadBody? Body { get; } = body;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="ReportBodyEvent"/> 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 ReportBodyEvent(PlayerControl reporter, NetworkedPlayerInfo? target, DeadBody? body)
-    {
-        Reporter = reporter;
-        Target = target;
-        Body = body;
-    }
 }

MiraAPI/Events/Vanilla/Meeting/StartMeetingEvent.cs

@@ -4,19 +4,11 @@
 /// The event that is invoked when a meeting is called. This event is not cancelable.
 /// This event is called after Mira resets votes, so if you plan on adding votes to a specific player, do it with this event.
 /// </summary>
-public class StartMeetingEvent : MiraEvent
+/// <param name="meetingHud">The <see cref="global::MeetingHud"/> instance.</param>
+public class StartMeetingEvent(MeetingHud meetingHud) : MiraEvent
 {
     /// <summary>
-    /// Gets the MeetingHud instance.
+    /// Gets the <see cref="global::MeetingHud"/> instance.
     /// </summary>
-    public MeetingHud MeetingHud { get; }
+    public MeetingHud MeetingHud { get; } = meetingHud;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="StartMeetingEvent"/> class.
-    /// </summary>
-    /// <param name="meetingHud">The MeetingHud instance.</param>
-    public StartMeetingEvent(MeetingHud meetingHud)
-    {
-        MeetingHud = meetingHud;
-    }
 }

MiraAPI/Events/Vanilla/Meeting/Voting/AfterVoteEvent.cs

@@ -0,0 +1,19 @@
+namespace MiraAPI.Events.Vanilla.Meeting.Voting;
+
+/// <summary>
+/// Event that is invoked after the local player successfully votes a player or skips. This event is not cancelable.
+/// </summary>
+/// <param name="playerVoteArea">The <see cref="PlayerVoteArea"/> that was voted on.</param>
+/// <param name="voter">The player who voted.</param>
+public class AfterVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter) : MiraEvent
+{
+    /// <summary>
+    /// Gets the instance of the voter's <see cref="PlayerVoteArea"/>.
+    /// </summary>
+    public PlayerVoteArea VoteArea { get; } = playerVoteArea;
+
+    /// <summary>
+    /// Gets the player who voted.
+    /// </summary>
+    public PlayerControl Player { get; } = voter;
+}

MiraAPI/Events/Vanilla/Meeting/Voting/BeforeVoteEvent.cs

@@ -0,0 +1,19 @@
+namespace MiraAPI.Events.Vanilla.Meeting.Voting;
+
+/// <summary>
+/// Event that is invoked before the local player confirms a vote on a player or when skipping. This event is cancelable.
+/// </summary>
+/// <param name="playerVoteArea">The <see cref="PlayerVoteArea"/> that was voted on.</param>
+/// <param name="voter">The player who voted.</param>
+public class BeforeVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter) : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the instance of the voter's <see cref="PlayerVoteArea"/>.
+    /// </summary>
+    public PlayerVoteArea VoteArea { get; } = playerVoteArea;
+
+    /// <summary>
+    /// Gets the player who voted.
+    /// </summary>
+    public PlayerControl Player { get; } = voter;
+}

MiraAPI/Events/Vanilla/Meeting/Voting/CheckForEndVotingEvent.cs

@@ -3,24 +3,16 @@
 /// <summary>
 /// Checks if voting is complete. If canceled, the default end voting logic will be skipped.
 /// </summary>
-public class CheckForEndVotingEvent : MiraCancelableEvent
+/// <param name="isVotingComplete"><see langword="true"/> if voting is complete, <see langword="false"/> otherwise.</param>
+public class CheckForEndVotingEvent(bool isVotingComplete) : MiraCancelableEvent
 {
     /// <summary>
     /// Gets a value indicating whether default voting logic determines that voting is complete.
     /// </summary>
-    public bool IsVotingComplete { get; }
+    public bool IsVotingComplete { get; } = isVotingComplete;
 
     /// <summary>
     /// Gets or sets a value indicating whether the voting should be forced to end, regardless of the default logic.
     /// </summary>
     public bool ForceEndVoting { get; set; }
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="CheckForEndVotingEvent"/> class.
-    /// </summary>
-    /// <param name="isVotingComplete">>True if voting is complete, false otherwise.</param>
-    public CheckForEndVotingEvent(bool isVotingComplete)
-    {
-        IsVotingComplete = isVotingComplete;
-    }
 }

MiraAPI/Events/Vanilla/Meeting/Voting/DummyVoteEvent.cs

@@ -0,0 +1,33 @@
+using System;
+using MiraAPI.Utilities;
+using MiraAPI.Voting;
+
+namespace MiraAPI.Events.Vanilla.Meeting.Voting;
+
+/// <summary>
+/// Invoked before the dummy selects their vote. If canceled, the dummy won't vote.
+/// </summary>
+/// <param name="dummy">The voting dummy.</param>
+public class DummyVoteEvent(DummyBehaviour dummy) : MiraCancelableEvent
+{
+    /// <summary>
+    /// Gets the dummy that needs to vote.
+    /// </summary>
+    public DummyBehaviour Dummy { get; } = dummy;
+
+    /// <summary>
+    /// Gets the instance of the dummy's <see cref="PlayerVoteData"/>.
+    /// </summary>
+    public PlayerVoteData VoteData { get; } = dummy.myPlayer.GetVoteData();
+
+    /// <summary>
+    /// Gets or sets a value indicating whether the dummy can vote to skip the meeting.
+    /// </summary>
+    public bool CanSkip { get; set; } = true;
+
+    /// <summary>
+    /// Gets or sets a predicate for validating whether the dummy can vote on a player.
+    /// By default, excludes dead and disconnected players.
+    /// </summary>
+    public Predicate<PlayerControl> PlayerIsValid { get; set; } = x => !x.Data.IsDead && !x.Data.Disconnected;
+}

MiraAPI/Events/Vanilla/Meeting/Voting/HandleVoteEvent.cs

@@ -4,47 +4,43 @@ namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 
 /// <summary>
 /// The event that is invoked when Mira handles a vote. This is invoked before Mira's behaviour, so be cautious.
-/// If you intend on adding custom vote behaviour, cancel the event and do so.
-/// If you are NOT canceling the event, keep in mind that Mira automatically removes a vote and adds the suspect to the VotedPlayers list after this event is invoked.
 /// </summary>
-public class HandleVoteEvent : MiraCancelableEvent
+/// <remarks>
+/// If you intend on adding custom vote behaviour, cancel the event and do so.<br/>
+/// If you are NOT canceling the event, keep in mind that Mira automatically removes a vote and adds the suspect to the <see cref="PlayerVoteData.Votes"/> list after this event is invoked.
+/// </remarks>
+/// <param name="playerVoteData">The voter's <see cref="PlayerVoteData"/>.</param>
+/// <param name="targetId">The target's playerId.</param>
+/// <param name="isOverruling">Whether the vote is actually for a Judge.</param>
+public class HandleVoteEvent(PlayerVoteData playerVoteData, byte targetId, bool isOverruling = false) : MiraCancelableEvent
 {
     /// <summary>
-    /// Gets the instance of the voter's vote data.
+    /// Gets the instance of the voter's <see cref="PlayerVoteData"/>.
     /// </summary>
-    public PlayerVoteData VoteData { get; }
+    public PlayerVoteData VoteData { get; } = playerVoteData;
 
     /// <summary>
     /// Gets the player who voted.
     /// </summary>
-    public PlayerControl Player { get; }
+    public PlayerControl Player { get; } = playerVoteData.Owner;
 
     /// <summary>
     /// Gets the player id of the target.
     /// </summary>
-    public byte TargetId { get; }
+    public byte TargetId { get; } = targetId;
 
     /// <summary>
-    /// Gets a value indicating whether to prevent the vote from commencing.
+    /// Gets or sets a value indicating whether to prevent the vote from commencing.
     /// </summary>
-    public bool PreventVote { get; }
+    public bool PreventVote { get; set; } = false;
 
     /// <summary>
-    /// Gets the player info of the target.
+    /// Gets the <see cref="NetworkedPlayerInfo"/> of the target.
     /// </summary>
-    public NetworkedPlayerInfo TargetPlayerInfo { get; }
+    public NetworkedPlayerInfo TargetPlayerInfo { get; } = GameData.Instance.GetPlayerById(targetId);
 
     /// <summary>
-    /// Initializes a new instance of the <see cref="HandleVoteEvent"/> class.
+    /// Gets or sets a value indicating whether the vote event is an Overrule caused by a Judge.
     /// </summary>
-    /// <param name="playerVoteData">The voter's data.</param>
+    public bool IsOverruling { get; set; } = isOverruling;
-    /// <param name="targetId">The target's playerId.</param>
-    public HandleVoteEvent(PlayerVoteData playerVoteData, byte targetId)
-    {
-        VoteData = playerVoteData;
-        Player = playerVoteData.Owner;
-        TargetId = targetId;
-        PreventVote = false;
-        TargetPlayerInfo = GameData.Instance.GetPlayerById(targetId);
-    }
 }

MiraAPI/Events/Vanilla/Meeting/Voting/MeetingSelectEvent.cs

@@ -5,39 +5,28 @@ namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 /// <summary>
 /// The event that is invoked when the player tries to select another player to vote.
 /// </summary>
-public class MeetingSelectEvent : MiraEvent
+/// <param name="playerVoteData">The voter's <see cref="PlayerVoteData"/>.</param>
+/// <param name="targetId">The target's playerId.</param>
+/// <param name="allowSelect">Whether the player is allowed to select the target.</param>
+public class MeetingSelectEvent(PlayerVoteData playerVoteData, int targetId, bool allowSelect) : MiraEvent
 {
     /// <summary>
-    /// Gets the instance of the voter's vote data.
+    /// Gets the instance of the voter's <see cref="PlayerVoteData"/>.
     /// </summary>
-    public PlayerVoteData VoteData { get; }
+    public PlayerVoteData VoteData { get; } = playerVoteData;
 
     /// <summary>
     /// Gets the player id of the target.
     /// </summary>
-    public int TargetId { get; }
+    public int TargetId { get; } = targetId;
 
     /// <summary>
-    /// Gets the player info of the target.
+    /// Gets the <see cref="NetworkedPlayerInfo"/> of the target.
     /// </summary>
-    public NetworkedPlayerInfo TargetPlayerInfo { get; }
+    public NetworkedPlayerInfo TargetPlayerInfo { get; } = GameData.Instance.GetPlayerById((byte)targetId);
 
     /// <summary>
     /// Gets or sets a value indicating whether the player is allowed to select the target.
     /// </summary>
-    public bool AllowSelect { get; set; }
+    public bool AllowSelect { get; set; } = allowSelect;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="MeetingSelectEvent"/> class.
-    /// </summary>
-    /// <param name="playerVoteData">The voter's data.</param>
-    /// <param name="targetId">The target's playerId.</param>
-    /// <param name="allowSelect">>Whether the player is allowed to select the target.</param>
-    public MeetingSelectEvent(PlayerVoteData playerVoteData, int targetId, bool allowSelect)
-    {
-        VoteData = playerVoteData;
-        TargetId = targetId;
-        TargetPlayerInfo = GameData.Instance.GetPlayerById((byte)targetId);
-        AllowSelect = allowSelect;
-    }
 }

MiraAPI/Events/Vanilla/Meeting/Voting/PopulateResultsEvent.cs

@@ -4,22 +4,16 @@ using MiraAPI.Voting;
 namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 
 /// <summary>
-/// Called in VotingUtils.HandlePopulateResults.
+/// Called in <see cref="VotingUtils.HandlePopulateResults"/>.
-/// Cancelling is NOT advised but if you do plan on cancelling, please ensure you account for displaying ALL player's votes.
 /// </summary>
-public class PopulateResultsEvent : MiraCancelableEvent
+/// <remarks>
+/// Cancelling is NOT advised but if you do plan on cancelling, please ensure you account for displaying ALL player's votes.
+/// </remarks>
+/// <param name="votes">The list of <see cref="CustomVote"/>s.</param>
+public class PopulateResultsEvent(List<CustomVote> votes) : MiraCancelableEvent
 {
     /// <summary>
-    /// Gets a list of networked votes.
+    /// Gets a list of networked <see cref="CustomVote"/>s.
     /// </summary>
-    public List<CustomVote> Votes { get; }
+    public List<CustomVote> Votes { get; } = votes;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="PopulateResultsEvent"/> class.
-    /// </summary>
-    /// <param name="votes">The list of votes.</param>
-    public PopulateResultsEvent(List<CustomVote> votes)
-    {
-        Votes = votes;
-    }
 }

MiraAPI/Events/Vanilla/Meeting/Voting/ProcessVotesEvent.cs

@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using MiraAPI.Voting;
 
@@ -7,16 +8,11 @@ namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 /// <summary>
 /// Ran after calculating votes and before displaying the results. Only ran on the host.
 /// </summary>
-/// <remarks>
+/// <param name="votes">The list of <see cref="CustomVote"/>s that are being processed.</param>
-/// Initializes a new instance of the <see cref="ProcessVotesEvent"/> class.
+/// <param name="exiledPlayer">The player to be exiled. Will be <see langword="null"/> if no player is to be exiled.</param>
-/// </remarks>
-/// <param name="votes">>The list of votes that are being processed.</param>
-/// <param name="exiledPlayer">The player to be exiled. Will be null if no player is to be exiled.</param>
 public class ProcessVotesEvent(List<CustomVote> votes, NetworkedPlayerInfo? exiledPlayer = null) : MiraEvent
 {
-    private readonly List<CustomVote> _originalVotes = [.. votes];
+    private readonly List<CustomVote> originalVotes = [.. votes];
-
-    private NetworkedPlayerInfo? _exiledPlayer = exiledPlayer;
 
     /// <summary>
     /// Gets a value indicating whether the exiled player has been modified by the event.
@@ -26,23 +22,35 @@ public class ProcessVotesEvent(List<CustomVote> votes, NetworkedPlayerInfo? exil
     /// <summary>
     /// Gets a value indicating whether the votes have been modified by the event.
     /// </summary>
-    public bool VotesModified => !Votes.SequenceEqual(_originalVotes);
+    public bool VotesModified => !Votes.SequenceEqual(originalVotes);
 
     /// <summary>
-    /// Gets the list of votes that are being processed.
+    /// Gets the list of <see cref="CustomVote"/>s that are being processed.
     /// </summary>
     public List<CustomVote> Votes { get; } = votes;
 
     /// <summary>
-    /// Gets or sets the player to be exiled. Will be null if no player is to be exiled.
+    /// Gets or sets a value indicating whether an overruling was done. Normally set by judge but can be overwritten.
     /// </summary>
+    public bool OverruledVote { get; set; }
+
+    /// <summary>
+    /// Gets or sets a value specifically to determine which Judge (if any) caused the overruling. Normally set by judge but can be overwritten.
+    /// </summary>
+    public ushort OverruledNonce { get; set; }
+
+    /// <summary>
+    /// Gets or sets the player to be exiled. Will be <see langword="null"/> if no player is to be exiled.
+    /// </summary>
+    [SuppressMessage("StyleCop.CSharp.LayoutRules", "SA1513:Closing brace should be followed by blank line", Justification = "Looks weird.")]
     public NetworkedPlayerInfo? ExiledPlayer
     {
-        get => _exiledPlayer;
+        get;
         set
         {
-            _exiledPlayer = value;
+            field = value;
             ExiledPlayerModified = true;
         }
     }
+    = exiledPlayer;
 }

MiraAPI/Events/Vanilla/Meeting/Voting/VotingCompleteEvent.cs

@@ -3,11 +3,11 @@
 /// <summary>
 /// The event that is invoked when the voting phase of a meeting is complete.
 /// </summary>
-/// <param name="meetingHud">The MeetingHud instance.</param>
+/// <param name="meetingHud">The <see cref="global::MeetingHud"/> instance.</param>
 public class VotingCompleteEvent(MeetingHud meetingHud) : MiraEvent
 {
     /// <summary>
-    /// Gets the MeetingHud instance.
+    /// Gets the <see cref="global::MeetingHud"/> instance.
     /// </summary>
     public MeetingHud MeetingHud { get; } = meetingHud;
 }

MiraAPI/Events/Vanilla/Player/CompleteHnsTaskEvent.cs

@@ -0,0 +1,25 @@
+namespace MiraAPI.Events.Vanilla.Player;
+
+/// <summary>
+/// The event that is invoked when a player completes a task within Hide and Seek. Non-cancelable.
+/// </summary>
+/// <param name="hnsManager">The <see cref="HideAndSeekManager"/> currently active.</param>
+/// <param name="player">The player who completed the task.</param>
+/// <param name="task">The task that the player completed.</param>
+public class CompleteHnsTaskEvent(HideAndSeekManager hnsManager, PlayerControl player, PlayerTask task) : MiraEvent
+{
+    /// <summary>
+    /// Gets the instance of the <see cref="PlayerControl"/>.
+    /// </summary>
+    public PlayerControl Player { get; } = player;
+
+    /// <summary>
+    /// Gets the instance of the <see cref="PlayerTask"/> that the player completed.
+    /// </summary>
+    public PlayerTask Task { get; } = task;
+
+    /// <summary>
+    /// Gets the instance of the <see cref="HideAndSeekManager"/> attached to the game.
+    /// </summary>
+    public HideAndSeekManager HnsManager { get; } = hnsManager;
+}

MiraAPI/Events/Vanilla/Player/CompleteTaskEvent.cs

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

@@ -1,35 +1,25 @@
 namespace MiraAPI.Events.Vanilla.Player;
 
 /// <summary>
-/// Event that is invoked when a player dies. Non cancelable.
+/// Event that is invoked when a player dies. Non-cancelable.
 /// </summary>
-public class PlayerDeathEvent : MiraEvent
+/// <param name="player">The player who died.</param>
+/// <param name="reason">The reason the player died.</param>
+/// <param name="deadBody">The player's <see cref="global::DeadBody"/>, if it exists.</param>
+public class PlayerDeathEvent(PlayerControl player, DeathReason reason, DeadBody? deadBody) : MiraEvent
 {
     /// <summary>
     /// Gets the player who died.
     /// </summary>
-    public PlayerControl Player { get; }
+    public PlayerControl Player { get; } = player;
 
     /// <summary>
     /// Gets the reason the player died.
     /// </summary>
-    public DeathReason DeathReason { get; }
+    public DeathReason DeathReason { get; } = reason;
 
     /// <summary>
-    /// Gets the dead body associated with the player, if any.
+    /// Gets the <see cref="global::DeadBody"/> associated with the player, if any.
     /// </summary>
-    public DeadBody? DeadBody { get; }
+    public DeadBody? DeadBody { get; } = deadBody;
-
-    /// <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>
-    /// <param name="deadBody">The player's body, if it exists.</param>
-    public PlayerDeathEvent(PlayerControl player, DeathReason reason, DeadBody? deadBody)
-    {
-        Player = player;
-        DeathReason = reason;
-        DeadBody = deadBody;
-    }
 }

MiraAPI/Events/Vanilla/Player/PlayerJoinEvent.cs

@@ -3,21 +3,13 @@
 namespace MiraAPI.Events.Vanilla.Player;
 
 /// <summary>
-/// Event that is invoked when a player joins the lobby. Non cancelable.
+/// Event that is invoked when a player joins the lobby. Non-cancelable.
 /// </summary>
-public class PlayerJoinEvent : MiraEvent
+/// <param name="data">The data of the player who joined.</param>
+public class PlayerJoinEvent(ClientData data) : MiraEvent
 {
     /// <summary>
     /// Gets the player who joined.
     /// </summary>
-    public ClientData ClientData { get; }
+    public ClientData ClientData { get; } = data;
-
-    /// <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

@@ -3,28 +3,19 @@
 namespace MiraAPI.Events.Vanilla.Player;
 
 /// <summary>
-/// Event that is invoked when a player leaves the game. Non cancelable.
+/// Event that is invoked when a player leaves the game. Non-cancelable.
 /// </summary>
-public class PlayerLeaveEvent : MiraEvent
+/// <param name="data">The data of the player who left.</param>
+/// <param name="reason">The reason why the player left.</param>
+public class PlayerLeaveEvent(ClientData data, DisconnectReasons reason) : MiraEvent
 {
     /// <summary>
     /// Gets the player who left.
     /// </summary>
-    public ClientData ClientData { get; }
+    public ClientData ClientData { get; } = data;
 
     /// <summary>
     /// Gets the reason why the player left.
     /// </summary>
-    public DisconnectReasons Reason { get; }
+    public DisconnectReasons Reason { get; } = reason;
-
-    /// <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

@@ -3,26 +3,17 @@
 /// <summary>
 /// Event that is invoked when a player enters a vent. This event is cancelable.
 /// </summary>
-public class EnterVentEvent : MiraCancelableEvent
+/// <param name="player">The <see cref="PlayerControl"/> that is entering the <paramref name="vent"/>.</param>
+/// <param name="vent">The <see cref="global::Vent"/> being entered.</param>
+public class EnterVentEvent(PlayerControl player, Vent? vent) : MiraCancelableEvent
 {
     /// <summary>
-    /// Gets the player that is entering the vent.
+    /// Gets the <see cref="PlayerControl"/> that is entering the <see cref="Vent"/>.
     /// </summary>
-    public PlayerControl Player { get; }
+    public PlayerControl Player { get; } = player;
 
     /// <summary>
-    /// Gets the vent that the player is entering.
+    /// Gets the <see cref="global::Vent"/> that the <see cref="Player"/> is entering.
     /// </summary>
-    public Vent? Vent { get; }
+    public Vent? Vent { get; } = vent;
-
-    /// <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;
-    }
 }