Merge pull request #97 from All-Of-Us-Mods/dev

MiraAPI 0.4.3
Merge branch 'master' into dev
2026-10-20 01:46:15 +00:00 · 2026-08-06 18:29:35 -05:00 · 2026-08-06 18:25:58 -05:00 · 2026-08-06 17:50:25 -05:00 · 2026-08-05 15:08:58 -04:00 · 2026-08-05 13:39:43 -05:00
194 changed files with 3057 additions and 2363 deletions
@@ -8,7 +8,7 @@

        <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>

-        <VersionPrefix>0.4.0</VersionPrefix>
+        <VersionPrefix>0.4.3</VersionPrefix>
        <VersionSuffix>dev</VersionSuffix>

        <Authors>All Of Us, XtraCube, Angxl</Authors>
@@ -1,5 +1,4 @@
-using System.Linq;
-using BepInEx;
+using BepInEx;
 using BepInEx.Configuration;
 using BepInEx.Unity.IL2CPP;
 using HarmonyLib;
@@ -10,6 +10,8 @@ public class ExampleOptions2 : AbstractOptionGroup

    public override uint GroupPriority => 0; // This group will be displayed first. The default value is uint.MaxValue.

+    public override MenuCategory ParentMenu => MenuCategory.CustomTwo;
+
    public ModdedPlayerOption PlayerOption2 { get; } = new("YOU MUST CHOSE A PLAYER", false);
    public ModdedPlayerOption PlayerOption { get; } = new("Eh whatever");
    public ModdedToggleOption ToggleOpt1 { get; } = new("Toggle Option 1", false);
@@ -9,7 +9,7 @@ public class GeneralModifierOptions : AbstractOptionGroup

    public override uint GroupPriority => 0;

-    public override bool ShowInModifiersMenu => true;
+    public override MenuCategory ParentMenu => MenuCategory.Modifiers;

    [ModdedToggleOption("Some Boolean Option")]
    public bool SomeBooleanOption { get; set; } = true;
@@ -2,11 +2,17 @@
 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 OptionNotifConfiguration Configuration => new(
+        Palette.Blue,
+        TmpSpriteUtils.CreateSpriteAsset(
+            MiraAssets.ImpostorFile.LoadAsset(),
+            "ApiExample.Role.Impostor.FreezerRole"));
    public override string GroupName => "Custom Role";

    [ModdedNumberOption("Freeze Duration", 1, 15, 1, MiraNumberSuffixes.Seconds)]
@@ -6,7 +6,7 @@ using MiraAPI.Utilities;

 namespace MiraAPI.Example.Options.Roles;

-public class TeleporterOptions : AbstractOptionGroup<TeleporterRole>
+public class TeleporterOptions : AbstractRoleOptionGroup<TeleporterRole>
 {
    public override string GroupName => "Teleporter";

@@ -1,6 +1,7 @@
 using AmongUs.GameOptions;
 using MiraAPI.Patches.Stubs;
 using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
 using Reactor.Utilities;
 using TMPro;
 using UnityEngine;
@@ -20,6 +21,8 @@ public class ChameloenRole : CrewmateRole, ICustomRole
    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),
    };

@@ -1,4 +1,5 @@
 using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
 using UnityEngine;

 namespace MiraAPI.Example.Roles;
@@ -13,6 +14,8 @@ public class FreezerRole : ImpostorRole, ICustomRole

    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
    {
+        Icon = MiraAssets.ImpostorFile,
+        IconTmp = TmpSpriteUtils.CreateSpriteAsset(MiraAssets.ImpostorFile.LoadAsset(), "ApiExample.Role.Impostor.FreezerRole"),
        OptionsScreenshot = ExampleAssets.Banner,
        MaxRoleCount = 2,
    };
@@ -5,12 +5,12 @@ using HarmonyLib;
 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];

@@ -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;
@@ -3,20 +3,20 @@
 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
 {
    /// <summary>
-    /// Gets Mira Button whose click was cancelled.
+    /// Gets the <see cref="CustomActionButton"/> whose click was cancelled.
    /// </summary>
    public T Button { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="MiraButtonCancelledEvent{T}"/> class.
    /// </summary>
-    /// <param name="button">The Mira Button whose click was cancelled.</param>
+    /// <param name="button">The <see cref="CustomActionButton"/> whose click was cancelled.</param>
    public MiraButtonCancelledEvent(T button)
    {
        Button = button;
@@ -24,19 +24,19 @@ public sealed class MiraButtonCancelledEvent<T> : MiraEvent where T : CustomActi
 }

 /// <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
 {
    /// <summary>
-    /// Gets Mira Button whose click was cancelled.
+    /// Gets the <see cref="CustomActionButton"/> whose click was cancelled.
    /// </summary>
    public CustomActionButton Button { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="MiraButtonCancelledEvent"/> class.
    /// </summary>
-    /// <param name="button">The Mira Button whose click was cancelled.</param>
+    /// <param name="button">The <see cref="CustomActionButton"/> whose click was cancelled.</param>
    public MiraButtonCancelledEvent(CustomActionButton button)
    {
        Button = button;
@@ -3,26 +3,26 @@
 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
 {
    /// <summary>
-    /// Gets Mira Button that was clicked.
+    /// Gets the <see cref="CustomActionButton"/> that was clicked.
    /// </summary>
    public T Button { get; }

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

    /// <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>
+    /// <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 MiraButtonClickEvent(T button, MiraButtonClickEvent genericClickEvent)
    {
        GenericClickEvent = genericClickEvent;
@@ -31,19 +31,19 @@ public sealed class MiraButtonClickEvent<T> : MiraCancelableEvent where T : Cust
 }

 /// <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
 {
    /// <summary>
-    /// Gets Mira Button that was clicked.
+    /// Gets the <see cref="CustomActionButton"/> that was clicked.
    /// </summary>
    public CustomActionButton Button { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="MiraButtonClickEvent"/> class.
    /// </summary>
-    /// <param name="button">The Mira Button that was clicked.</param>
+    /// <param name="button">The <see cref="CustomActionButton"/> that was clicked.</param>
    public MiraButtonClickEvent(CustomActionButton button)
    {
        Button = button;
@@ -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
 {
@@ -1,7 +1,6 @@
 using System;
 using System.Collections.Generic;
 using System.Reflection;
-using Reactor.Utilities;

 namespace MiraAPI.Events;

@@ -13,11 +12,11 @@ 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
    {
        EventWrappers.TryGetValue(typeof(T), out var handlers);
@@ -42,11 +41,11 @@ 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)
    {
        EventWrappers.TryGetValue(type, out var handlers);
@@ -71,12 +70,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="methodInfo">The MethodInfo of the event handler.</param>
+    /// <param name="type">The type of <see cref="MiraEvent"/> event.</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,12 +101,12 @@ 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>
-    /// <returns>An event handle to use when unregistering the event.</returns>
+    /// <typeparam name="T">Type of <see cref="MiraEvent"/> event.</typeparam>
+    /// <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
    {
        EventWrappers.TryAdd(typeof(T), []);
@@ -127,10 +126,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))
@@ -3,7 +3,7 @@
 namespace MiraAPI.Events;

 /// <summary>
-/// Wrapper for event handlers.
+/// Wrapper for <see cref="MiraEvent"/> handlers.
 /// </summary>
 public class MiraEventWrapper
 {
@@ -3,7 +3,7 @@
 namespace MiraAPI.Events;

 /// <summary>
-/// Register an event.
+/// Register a <see cref="MiraEvent"/> handler.
 /// </summary>
 [AttributeUsage(AttributeTargets.Method)]
 public class RegisterEventAttribute : Attribute
@@ -6,17 +6,17 @@
 public class AfterMurderEvent : 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; }

    /// <summary>
-    /// Gets the player that was killed.
+    /// Gets the <see cref="PlayerControl"/> that was killed.
    /// </summary>
    public PlayerControl Target { get; }

    /// <summary>
-    /// Gets the player's body, if it exists.
+    /// Gets the <see cref="Target"/>'s <see cref="global::DeadBody"/>, if it exists.
    /// </summary>
    public DeadBody? DeadBody { get; }

@@ -24,8 +24,8 @@ public class AfterMurderEvent : MiraEvent
    /// Initializes a new instance of the <see cref="AfterMurderEvent"/> class.
    /// </summary>
    /// <param name="source">The killer.</param>
-    /// <param name="target">The killed player.</param>
-    /// <param name="deadBody">The player's vody, if it exists.</param>
+    /// <param name="target">The killed <see cref="PlayerControl"/>.</param>
+    /// <param name="deadBody">The <paramref name="target"/>'s <see cref="global::DeadBody"/>, if it exists.</param>
    public AfterMurderEvent(PlayerControl source, PlayerControl target, DeadBody? deadBody)
    {
        Source = source;
@@ -1,7 +1,7 @@
 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
 {
@@ -8,25 +8,25 @@ namespace MiraAPI.Events.Vanilla.Gameplay;
 public sealed class BeforeMurderEvent : 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; }

    /// <summary>
-    /// Gets the player that is being killed.
+    /// Gets the <see cref="PlayerControl"/> that is being killed.
    /// </summary>
    public PlayerControl Target { get; }

    /// <summary>
-    /// Gets whether the murder was meant to be done in a meeting via an enum.
+    /// Gets whether the murder was meant to be done in a meeting, via an enum.
    /// </summary>
    public MeetingCheck InMeeting { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="BeforeMurderEvent"/> class.
    /// </summary>
-    /// <param name="source">The player that is killing the target.</param>
-    /// <param name="target">The player that is being killed.</param>
+    /// <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="inMeeting">Whether the murder is intended to be triggered in a meeting.</param>
    public BeforeMurderEvent(PlayerControl source, PlayerControl target, MeetingCheck inMeeting)
    {
@@ -38,8 +38,8 @@ public sealed class BeforeMurderEvent : MiraCancelableEvent
    /// <summary>
    /// Initializes a new instance of the <see cref="BeforeMurderEvent"/> class.
    /// </summary>
-    /// <param name="source">The player that is killing the target.</param>
-    /// <param name="target">The player that is being killed.</param>
+    /// <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>
    public BeforeMurderEvent(PlayerControl source, PlayerControl target)
    {
        Source = source;
@@ -1,12 +1,13 @@
 namespace MiraAPI.Events.Vanilla.Gameplay;

 /// <summary>
-/// Event invoked on IntroCutscene.OnDestroy and ExileController.WrapUp to determine if it should run the round event or not.
+/// 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>
 public class BeforeRoundStartEvent : MiraCancelableEvent
 {
    /// <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; }

@@ -6,14 +6,14 @@
 public class GameEndEvent : MiraEvent
 {
    /// <summary>
-    /// Gets the instance of the EndGameManager.
+    /// Gets the <see cref="global::EndGameManager"/> instance.
    /// </summary>
    public EndGameManager EndGameManager { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="GameEndEvent"/> class.
    /// </summary>
-    /// <param name="manager">The instance of the EndGameManager.</param>
+    /// <param name="manager">The <see cref="global::EndGameManager"/> instance.</param>
    public GameEndEvent(EndGameManager manager)
    {
        EndGameManager = manager;
@@ -6,7 +6,7 @@
 public class IntroBeginEvent : MiraEvent
 {
    /// <summary>
-    /// Gets the instance of the IntroCutscene.
+    /// Gets the <see cref="global::IntroCutscene"/> instance.
    /// </summary>
    public IntroCutscene IntroCutscene { get; }

@@ -6,7 +6,7 @@
 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;
 }
@@ -6,7 +6,7 @@
 public class IntroRoleRevealEvent : MiraEvent
 {
    /// <summary>
-    /// Gets the instance of the IntroCutscene.
+    /// Gets the <see cref="global::IntroCutscene"/> instance.
    /// </summary>
    public IntroCutscene IntroCutscene { get; }

@@ -1,12 +1,13 @@
 namespace MiraAPI.Events.Vanilla.Gameplay;

 /// <summary>
-/// Start Round event, invoked on IntroCutscene.OnDestroy and ExileController.WrapUp if the event isn't cancelled.
+/// 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
 {
    /// <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; }

@@ -8,7 +8,7 @@ namespace MiraAPI.Events.Vanilla.Gameplay;
 public class SetRoleEvent : MiraEvent
 {
    /// <summary>
-    /// Gets the player whos role was changed.
+    /// Gets the <see cref="PlayerControl"/> whose role was changed.
    /// </summary>
    public PlayerControl Player { get; }

@@ -3,20 +3,20 @@
 namespace MiraAPI.Events.Vanilla.Gameplay;

 /// <summary>
-/// Invoked when a Vanilla Button click is cancelled. Do not use for custom buttons.
+/// Invoked when a Vanilla <see cref="AbilityButton"/> click is cancelled. Do not use for <see cref="CustomActionButton"/>.
 /// </summary>
-/// <typeparam name="T">The Vanilla Button type.</typeparam>
+/// <typeparam name="T">The vanilla <see cref="AbilityButton"/> type.</typeparam>
 public sealed class VanillaButtonCancelledEvent<T> : MiraEvent where T : AbilityButton
 {
    /// <summary>
-    /// Gets Vanilla Button whose click was cancelled.
+    /// Gets the Vanilla <see cref="AbilityButton"/> whose click was cancelled.
    /// </summary>
    public T Button { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="VanillaButtonCancelledEvent{T}"/> class.
    /// </summary>
-    /// <param name="button">The Mira Button whose click was cancelled.</param>
+    /// <param name="button">The vanilla <see cref="AbilityButton"/> whose click was cancelled.</param>
    public VanillaButtonCancelledEvent(T button)
    {
        Button = button;
@@ -24,19 +24,19 @@ public sealed class VanillaButtonCancelledEvent<T> : MiraEvent where T : Ability
 }

 /// <summary>
-/// Invoked when a Vanilla Button click is cancelled. Do not use for custom buttons.
+/// Invoked when a Vanilla <see cref="AbilityButton"/> click is cancelled. Do not use for <see cref="CustomActionButton"/>s.
 /// </summary>
 public sealed class VanillaButtonCancelledEvent : MiraEvent
 {
    /// <summary>
-    /// Gets Vanilla Button whose click was cancelled.
+    /// Gets the Vanilla <see cref="AbilityButton"/> whose click was cancelled.
    /// </summary>
    public AbilityButton Button { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="VanillaButtonCancelledEvent"/> class.
    /// </summary>
-    /// <param name="button">The Vanilla Button whose click was cancelled.</param>
+    /// <param name="button">The vanilla <see cref="AbilityButton"/> whose click was cancelled.</param>
    public VanillaButtonCancelledEvent(AbilityButton button)
    {
        Button = button;
@@ -3,26 +3,26 @@
 namespace MiraAPI.Events.Vanilla.Gameplay;

 /// <summary>
-/// Button click event for Vanilla Buttons only. Do not use for custom buttons.
+/// Button click event for Vanilla <see cref="AbilityButton"/>s only. Do not use for <see cref="CustomActionButton"/>s.
 /// </summary>
-/// <typeparam name="T">The Vanilla Button type.</typeparam>
+/// <typeparam name="T">The vanilla <see cref="AbilityButton"/> type.</typeparam>
 public sealed class VanillaButtonClickEvent<T> : MiraCancelableEvent where T : AbilityButton
 {
    /// <summary>
-    /// Gets Vanilla Button that was clicked.
+    /// Gets the vanilla <see cref="AbilityButton"/> that was clicked.
    /// </summary>
    public T Button { get; }

    /// <summary>
-    /// Gets the generic click event that is invoked before this button-specific event.
+    /// Gets the generic <see cref="VanillaButtonClickEvent"/> that is invoked before this button-specific event.
    /// </summary>
    public VanillaButtonClickEvent GenericClickEvent { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="VanillaButtonClickEvent{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>
+    /// <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 VanillaButtonClickEvent(T button, VanillaButtonClickEvent genericClickEvent)
    {
        GenericClickEvent = genericClickEvent;
@@ -31,31 +31,31 @@ public sealed class VanillaButtonClickEvent<T> : MiraCancelableEvent where T : A
 }

 /// <summary>
-/// Button click event for Vanilla Buttons only. Do not use for custom buttons.
+/// Button click event for Vanilla <see cref="AbilityButton"/> only. Do not use for <see cref="CustomActionButton"/>s.
 /// </summary>
 public sealed class VanillaButtonClickEvent : MiraCancelableEvent
 {
    /// <summary>
-    /// Gets Vanilla Button that was clicked.
+    /// Gets the Vanilla <see cref="AbilityButton"/> that was clicked.
    /// </summary>
    public AbilityButton Button { get; }

    /// <summary>
-    /// Gets the target player, if any, of the Vanilla Button that was clicked.
+    /// Gets the target <see cref="PlayerControl"/>, if any, of the Vanilla <see cref="AbilityButton"/> that was clicked.
    /// </summary>
    public PlayerControl? PlayerTarget { get; }

    /// <summary>
-    /// Gets the target vent, if any, of the Vanilla Button that was clicked.
+    /// Gets the target <see cref="Vent"/>, if any, of the Vanilla <see cref="AbilityButton"/> that was clicked.
    /// </summary>
    public Vent? VentTarget { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="VanillaButtonClickEvent"/> class.
    /// </summary>
-    /// <param name="button">The Vanilla Button that was clicked.</param>
-    /// <param name="playerTarget">The Player target, if any.</param>
-    /// <param name="ventTarget">The Vent target, if any.</param>
+    /// <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 VanillaButtonClickEvent(AbilityButton button, PlayerControl? playerTarget = null, Vent? ventTarget = null)
    {
        Button = button;
@@ -6,14 +6,14 @@
 public class PlayerOpenSabotageEvent : MiraCancelableEvent
 {
    /// <summary>
-    /// Gets the MapBehaviour.
+    /// Gets the <see cref="global::MapBehaviour"/>.
    /// </summary>
    public MapBehaviour MapBehaviour { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="PlayerOpenSabotageEvent"/> class.
    /// </summary>
-    /// <param name="mapBehaviour">The MapBehaviour.</param>
+    /// <param name="mapBehaviour">The <see cref="global::MapBehaviour"/>.</param>
    public PlayerOpenSabotageEvent(MapBehaviour mapBehaviour)
    {
        MapBehaviour = mapBehaviour;
@@ -1,7 +1,7 @@
 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
 {
@@ -11,7 +11,7 @@ public class UpdateSystemEvent : MiraCancelableEvent
    public SystemTypes SystemType { get; }

    /// <summary>
-    /// Gets the player that is updating the system.
+    /// Gets the <see cref="PlayerControl"/> that is updating the system.
    /// </summary>
    public PlayerControl Player { get; }

@@ -21,10 +21,10 @@ public class UpdateSystemEvent : MiraCancelableEvent
    public byte Amount { get; }

    /// <summary>
-    ///  Initializes a new instance of the <see cref="UpdateSystemEvent"/> class.
+    /// 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="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 UpdateSystemEvent(SystemTypes systemType, PlayerControl player, byte amount)
    {
@@ -6,14 +6,14 @@
 public class EjectionEvent : MiraEvent
 {
    /// <summary>
-    /// Gets the instance of the ExileController.
+    /// Gets the <see cref="global::ExileController"/> instance.
    /// </summary>
    public ExileController ExileController { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="EjectionEvent"/> class.
    /// </summary>
-    /// <param name="controller">The exile controller.</param>
+    /// <param name="controller">The <see cref="global::ExileController"/> instance.</param>
    public EjectionEvent(ExileController controller)
    {
        ExileController = controller;
@@ -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;
 }
@@ -2,7 +2,7 @@

 /// <summary>
 /// The event that is invoked when a body is reported.
-/// This is invoked in CmdReportBody.
+/// This is invoked in <see cref="PlayerControl.CmdReportDeadBody(NetworkedPlayerInfo)"/>.
 /// </summary>
 public class ReportBodyEvent : MiraCancelableEvent
 {
@@ -12,12 +12,12 @@ public class ReportBodyEvent : MiraCancelableEvent
    public PlayerControl Reporter { get; }

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

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

@@ -26,7 +26,7 @@ public class ReportBodyEvent : MiraCancelableEvent
    /// </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>
+    /// <param name="body">The <see cref="DeadBody"/> being reported.</param>
    public ReportBodyEvent(PlayerControl reporter, NetworkedPlayerInfo? target, DeadBody? body)
    {
        Reporter = reporter;
@@ -7,14 +7,14 @@
 public class StartMeetingEvent : MiraEvent
 {
    /// <summary>
-    /// Gets the MeetingHud instance.
+    /// Gets the <see cref="global::MeetingHud"/> instance.
    /// </summary>
    public MeetingHud MeetingHud { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="StartMeetingEvent"/> class.
    /// </summary>
-    /// <param name="meetingHud">The MeetingHud instance.</param>
+    /// <param name="meetingHud">The <see cref="global::MeetingHud"/> instance.</param>
    public StartMeetingEvent(MeetingHud meetingHud)
    {
        MeetingHud = meetingHud;
@@ -1,6 +1,4 @@
-using MiraAPI.Voting;
-
-namespace MiraAPI.Events.Vanilla.Meeting.Voting;
+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.
@@ -8,7 +6,7 @@ namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 public class AfterVoteEvent : MiraEvent
 {
    /// <summary>
-    /// Gets the instance of the voter's vote data.
+    /// Gets the instance of the voter's <see cref="PlayerVoteArea"/>.
    /// </summary>
    public PlayerVoteArea VoteArea { get; }

@@ -20,7 +18,7 @@ public class AfterVoteEvent : MiraEvent
    /// <summary>
    /// Initializes a new instance of the <see cref="AfterVoteEvent"/> class.
    /// </summary>
-    /// <param name="playerVoteArea">The player vote area that was voted on.</param>
+    /// <param name="playerVoteArea">The <see cref="PlayerVoteArea"/> that was voted on.</param>
    /// <param name="voter">The player who voted.</param>
    public AfterVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter)
    {
@@ -1,6 +1,4 @@
-using MiraAPI.Voting;
-
-namespace MiraAPI.Events.Vanilla.Meeting.Voting;
+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.
@@ -8,7 +6,7 @@ namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 public class BeforeVoteEvent : MiraCancelableEvent
 {
    /// <summary>
-    /// Gets the instance of the voter's vote data.
+    /// Gets the instance of the voter's <see cref="PlayerVoteArea"/>.
    /// </summary>
    public PlayerVoteArea VoteArea { get; }

@@ -20,7 +18,7 @@ public class BeforeVoteEvent : MiraCancelableEvent
    /// <summary>
    /// Initializes a new instance of the <see cref="BeforeVoteEvent"/> class.
    /// </summary>
-    /// <param name="playerVoteArea">The player vote area that was voted on.</param>
+    /// <param name="playerVoteArea">The <see cref="PlayerVoteArea"/> that was voted on.</param>
    /// <param name="voter">The player who voted.</param>
    public BeforeVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter)
    {
@@ -18,7 +18,7 @@ public class CheckForEndVotingEvent : MiraCancelableEvent
    /// <summary>
    /// Initializes a new instance of the <see cref="CheckForEndVotingEvent"/> class.
    /// </summary>
-    /// <param name="isVotingComplete">>True if voting is complete, false otherwise.</param>
+    /// <param name="isVotingComplete"><see langword="true"/> if voting is complete, <see langword="false"/> otherwise.</param>
    public CheckForEndVotingEvent(bool isVotingComplete)
    {
        IsVotingComplete = isVotingComplete;
@@ -15,7 +15,7 @@ public class DummyVoteEvent : MiraCancelableEvent
    public DummyBehaviour Dummy { get; }

    /// <summary>
-    /// Gets the instance of the dummy's vote data.
+    /// Gets the instance of the dummy's <see cref="PlayerVoteData"/>.
    /// </summary>
    public PlayerVoteData VoteData { get; }

@@ -5,12 +5,12 @@ 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.
+/// 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.
 /// </summary>
 public class HandleVoteEvent : 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; }

@@ -30,14 +30,14 @@ public class HandleVoteEvent : MiraCancelableEvent
    public bool PreventVote { get; }

    /// <summary>
-    /// Gets the player info of the target.
+    /// Gets the <see cref="NetworkedPlayerInfo"/> of the target.
    /// </summary>
    public NetworkedPlayerInfo TargetPlayerInfo { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="HandleVoteEvent"/> class.
    /// </summary>
-    /// <param name="playerVoteData">The voter's data.</param>
+    /// <param name="playerVoteData">The voter's <see cref="PlayerVoteData"/>.</param>
    /// <param name="targetId">The target's playerId.</param>
    public HandleVoteEvent(PlayerVoteData playerVoteData, byte targetId)
    {
@@ -8,7 +8,7 @@ namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 public class MeetingSelectEvent : 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; }

@@ -18,7 +18,7 @@ public class MeetingSelectEvent : MiraEvent
    public int TargetId { get; }

    /// <summary>
-    /// Gets the player info of the target.
+    /// Gets the <see cref="NetworkedPlayerInfo"/> of the target.
    /// </summary>
    public NetworkedPlayerInfo TargetPlayerInfo { get; }

@@ -30,9 +30,9 @@ public class MeetingSelectEvent : MiraEvent
    /// <summary>
    /// Initializes a new instance of the <see cref="MeetingSelectEvent"/> class.
    /// </summary>
-    /// <param name="playerVoteData">The voter's data.</param>
+    /// <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>
+    /// <param name="allowSelect">Whether the player is allowed to select the target.</param>
    public MeetingSelectEvent(PlayerVoteData playerVoteData, int targetId, bool allowSelect)
    {
        VoteData = playerVoteData;
@@ -4,20 +4,20 @@ 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
 {
    /// <summary>
-    /// Gets a list of networked votes.
+    /// Gets a list of networked <see cref="CustomVote"/>s.
    /// </summary>
    public List<CustomVote> Votes { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="PopulateResultsEvent"/> class.
    /// </summary>
-    /// <param name="votes">The list of votes.</param>
+    /// <param name="votes">The list of <see cref="CustomVote"/>s.</param>
    public PopulateResultsEvent(List<CustomVote> votes)
    {
        Votes = votes;
@@ -10,8 +10,8 @@ namespace MiraAPI.Events.Vanilla.Meeting.Voting;
 /// <remarks>
 /// Initializes a new instance of the <see cref="ProcessVotesEvent"/> class.
 /// </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>
+/// <param name="votes">The list of <see cref="CustomVote"/>s that are being processed.</param>
+/// <param name="exiledPlayer">The player to be exiled. Will be <see langword="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];
@@ -29,12 +29,12 @@ public class ProcessVotesEvent(List<CustomVote> votes, NetworkedPlayerInfo? exil
    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 the player to be exiled. Will be <see langword="null"/> if no player is to be exiled.
    /// </summary>
    public NetworkedPlayerInfo? ExiledPlayer
    {
@@ -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;
 }
@@ -16,14 +16,14 @@ public class CompleteHnsTaskEvent : MiraEvent
    public PlayerTask Task { get; }

    /// <summary>
-    /// Gets the instance of the <see cref="HnsManager"/> attached to the game.
+    /// Gets the instance of the <see cref="HideAndSeekManager"/> attached to the game.
    /// </summary>
    public HideAndSeekManager HnsManager { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="CompleteHnsTaskEvent"/> class.
    /// </summary>
-    /// <param name="hnsManager">The Hide and Seek Manager currently active.</param>
+    /// <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 CompleteHnsTaskEvent(HideAndSeekManager hnsManager, PlayerControl player, PlayerTask task)
@@ -16,7 +16,7 @@ public class PlayerDeathEvent : MiraEvent
    public DeathReason DeathReason { get; }

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

@@ -25,7 +25,7 @@ public class PlayerDeathEvent : MiraEvent
    /// </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>
+    /// <param name="deadBody">The player's <see cref="global::DeadBody"/>, if it exists.</param>
    public PlayerDeathEvent(PlayerControl player, DeathReason reason, DeadBody? deadBody)
    {
        Player = player;
@@ -6,20 +6,20 @@
 public class EnterVentEvent : 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; }

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

    /// <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>
+    /// <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 EnterVentEvent(PlayerControl player, Vent? vent)
    {
        Player = player;
@@ -6,20 +6,20 @@
 public class ExitVentEvent : MiraCancelableEvent
 {
    /// <summary>
-    /// Gets the player that is exiting the vent.
+    /// Gets the <see cref="PlayerControl"/> that is exiting the <see cref="Vent"/>.
    /// </summary>
    public PlayerControl Player { get; }

    /// <summary>
-    /// Gets the vent that the player is exiting.
+    /// Gets the <see cref="global::Vent"/> that the <see cref="Player"/> is exiting.
    /// </summary>
    public Vent? Vent { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="ExitVentEvent"/> class.
    /// </summary>
-    /// <param name="player">The player who is exiting the vent.</param>
-    /// <param name="vent">The vent being exited from.</param>
+    /// <param name="player">The <see cref="PlayerControl"/> who is exiting the <paramref name="vent"/>.</param>
+    /// <param name="vent">The <see cref="global::Vent"/> being exited from.</param>
    public ExitVentEvent(PlayerControl player, Vent? vent)
    {
        Player = player;
@@ -8,7 +8,7 @@ public class PlayerCanUseEvent : PlayerUseEvent
    /// <summary>
    /// Initializes a new instance of the <see cref="PlayerCanUseEvent"/> class.
    /// </summary>
-    /// <param name="usable">The IUsable.</param>
+    /// <param name="usable">The <see cref="IUsable"/>.</param>
    public PlayerCanUseEvent(IUsable usable) : base(usable)
    {
    }
@@ -11,19 +11,19 @@ public class PlayerUseEvent : MiraCancelableEvent
    public IUsable Usable { get; }

    /// <summary>
-    /// Gets a value indicating whether the IUsable is a <see cref="Console"/>, <see cref="MapConsole"/>, or <see cref="SystemConsole"/>.
+    /// Gets a value indicating whether the <see cref="Usable"/> is a <see cref="Console"/>, <see cref="MapConsole"/>, or <see cref="SystemConsole"/>.
    /// </summary>
    public bool IsPrimaryConsole { get; }

    /// <summary>
-    /// Gets a value indicating whether the IUsable is a <see cref="Vent"/>.
+    /// Gets a value indicating whether the <see cref="Usable"/> is a <see cref="Vent"/>.
    /// </summary>
    public bool IsVent { get; }

    /// <summary>
    /// Initializes a new instance of the <see cref="PlayerUseEvent"/> class.
    /// </summary>
-    /// <param name="usable">The IUsable.</param>
+    /// <param name="usable">The <see cref="IUsable"/>.</param>
    public PlayerUseEvent(IUsable usable)
    {
        Usable = usable;
@@ -10,44 +10,44 @@ namespace MiraAPI.GameEnd;
 public abstract class CustomGameOver
 {
    /// <summary>
-    /// Gets the current CustomGameOver.
+    /// Gets the current <see cref="CustomGameOver"/>.
    /// </summary>
    public static CustomGameOver? Instance { get; internal set; }

    /// <summary>
-    /// Verifies if the condition for this CustomGameOver is met.
+    /// Verifies if the condition for this <see cref="CustomGameOver"/> is met.
    /// </summary>
-    /// <param name="playerControl">The PlayerControl that requested the Game Over.</param>
+    /// <param name="playerControl">The <see cref="PlayerControl"/> that requested the Game Over.</param>
    /// <param name="winners">The collection of winners.</param>
-    /// <returns>True if the condition is met, otherwise false.</returns>
+    /// <returns><see langword="true"/> if the condition is met, otherwise <see langword="false"/>.</returns>
    public virtual bool VerifyCondition(PlayerControl playerControl, NetworkedPlayerInfo[] winners)
    {
        return true;
    }

    /// <summary>
-    /// Runs before the base game calls EndGameManager.SetEverythingUp.
+    /// Runs before the base game calls <see cref="EndGameManager.SetEverythingUp"/>.
    /// </summary>
-    /// <param name="endGameManager">The EndGameManager instance.</param>
-    /// <returns>Return True to use the run the original method, return False to skip it.</returns>
+    /// <param name="endGameManager">The <see cref="EndGameManager"/> instance.</param>
+    /// <returns>Return <see langword="true"/> to use the run the original method, return <see langword="false"/> to skip it.</returns>
    public virtual bool BeforeEndGameSetup(EndGameManager endGameManager)
    {
        return true;
    }

    /// <summary>
-    /// Runs after the base game calls EndGameManager.SetEverythingUp.
+    /// Runs after the base game calls <see cref="EndGameManager.SetEverythingUp"/>.
    /// </summary>
-    /// <param name="endGameManager">The EndGameManager instance.</param>
+    /// <param name="endGameManager">The <see cref="EndGameManager"/> instance.</param>
    public virtual void AfterEndGameSetup(EndGameManager endGameManager)
    {
    }

    /// <summary>
-    /// Get the GameOverReason associated with this CustomGameOver.
+    /// Get the <see cref="global::GameOverReason"/> associated with this <see cref ="CustomGameOver"/>.
    /// </summary>
    /// <typeparam name="T">Type of the custom game over.</typeparam>
-    /// <returns>The GameOverReason associated with the custom game over.</returns>
+    /// <returns>The <see cref="global::GameOverReason"/> associated with the custom game over.</returns>
    public static GameOverReason GameOverReason<T>() where T : CustomGameOver
    {
        return (GameOverReason)GameOverManager.GetGameOverId<T>();
@@ -67,10 +67,10 @@ public abstract class CustomGameOver
    }

    /// <summary>
-    /// Implicitly convert a CustomGameOver to a GameOverReason.
+    /// Implicitly convert a <see cref="CustomGameOver"/> to a <see cref="global::GameOverReason"/>.
    /// </summary>
-    /// <param name="gameOver">The CustomGameOver instance.</param>
-    /// <returns>The GameOverReason associated with the CustomGameOver.</returns>
+    /// <param name="gameOver">The <see cref="CustomGameOver"/> instance.</param>
+    /// <returns>The <see cref="global::GameOverReason"/> associated with the CustomGameOver.</returns>
    public static implicit operator GameOverReason(CustomGameOver gameOver)
    {
        return (GameOverReason)GameOverManager.GetGameOverId(gameOver.GetType());
@@ -1,12 +1,11 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics.CodeAnalysis;
-using Reactor.Utilities;

 namespace MiraAPI.GameEnd;

 /// <summary>
-/// Manage custom game overs.
+/// Manage <see cref="CustomGameOver"/>s.
 /// </summary>
 public static class GameOverManager
 {
@@ -16,11 +15,11 @@ public static class GameOverManager
    private static int _nextId = Enum.GetNames<GameOverReason>().Length;

    /// <summary>
-    /// Register a custom game over.
+    /// Register a <see cref="CustomGameOver"/>.
    /// </summary>
-    /// <param name="gameOverType">Type of the custom game over.</param>
-    /// <exception cref="ArgumentException">Thrown when the type is not a subclass of CustomGameOver, is abstract, or does not have a parameterless constructor.</exception>
-    /// <returns>>True if the game over was registered successfully, false otherwise.</returns>
+    /// <param name="gameOverType">Type of the <see cref="CustomGameOver"/>.</param>
+    /// <exception cref="ArgumentException">Thrown when the type is not a subclass of <see cref="CustomGameOver"/>, is abstract, or does not have a parameterless constructor.</exception>
+    /// <returns><see langword="true"/> if the game over was registered successfully, <see langword="false"/> otherwise.</returns>
    public static bool RegisterGameOver(Type gameOverType)
    {
        if (!typeof(CustomGameOver).IsAssignableFrom(gameOverType))
@@ -47,11 +46,11 @@ public static class GameOverManager
    }

    /// <summary>
-    /// Create an instance of a custom game over.
+    /// Create an instance of a <see cref="CustomGameOver"/>.
    /// </summary>
-    /// <param name="id">ID of the custom game over.</param>
-    /// <param name="customGameOver">The created instance of the custom game over.</param>
-    /// <returns>An instance of the custom game over.</returns>
+    /// <param name="id">ID of the <see cref="CustomGameOver"/>.</param>
+    /// <param name="customGameOver">The created instance of the <see cref="CustomGameOver"/>.</param>
+    /// <returns>An instance of the <see cref="CustomGameOver"/>.</returns>
    public static bool TryGetGameOver(int id, [NotNullWhen(true)] out CustomGameOver? customGameOver)
    {
        if (GameOverTypes.TryGetValue(id, out var gameOverType))
@@ -65,20 +64,20 @@ public static class GameOverManager
    }

    /// <summary>
-    /// Get the ID of a custom game over.
+    /// Get the ID of a <see cref="CustomGameOver"/>.
    /// </summary>
-    /// <typeparam name="T">Type of the custom game over.</typeparam>
-    /// <returns>The ID of the custom game over.</returns>
+    /// <typeparam name="T">Type of the <see cref="CustomGameOver"/>.</typeparam>
+    /// <returns>The ID of the <see cref="CustomGameOver"/>.</returns>
    public static int GetGameOverId<T>() where T : CustomGameOver
    {
        return GetGameOverId(typeof(T));
    }

    /// <summary>
-    /// Get the ID of a custom game over.
+    /// Get the ID of a <see cref="CustomGameOver"/>.
    /// </summary>
-    /// <param name="gameOverType">Type of the custom game over.</param>
-    /// <returns>The ID of the custom game over.</returns>
+    /// <param name="gameOverType">Type of the <see cref="CustomGameOver"/>.</param>
+    /// <returns>The ID of the <see cref="CustomGameOver"/>.</returns>
    /// <exception cref="ArgumentException">Thrown when the type is not registered.</exception>
    public static int GetGameOverId(Type gameOverType)
    {
@@ -23,24 +23,24 @@ public abstract class CustomGameMode
    public abstract int Id { get; }

    /// <summary>
-    /// Called when Intro Cutscene is destroyed.
+    /// Called when <see cref="IntroCutscene"/> is destroyed.
    /// </summary>
    public virtual void Initialize()
    {
    }

    /// <summary>
-    /// Called on HudManager.Start().
+    /// Called on <see cref="HudManager.Start"/>.
    /// </summary>
-    /// <param name="instance">Instance of HudManager.</param>
+    /// <param name="instance">Instance of <see cref="HudManager"/>.</param>
    public virtual void HudStart(HudManager instance)
    {
    }

    /// <summary>
-    /// Called every frame on HudManager.Update().
+    /// Called every frame on <see cref="HudManager.Update"/>.
    /// </summary>
-    /// <param name="instance">Instance of HudManager.</param>
+    /// <param name="instance">Instance of <see cref="HudManager"/>.</param>
    public virtual void HudUpdate(HudManager instance)
    {
    }
@@ -48,7 +48,7 @@ public abstract class CustomGameMode
    /// <summary>
    /// Called when a player is killed.
    /// </summary>
-    /// <param name="player">PlayerControl that was killed.</param>
+    /// <param name="player"><see cref="PlayerControl"/> that was killed.</param>
    public virtual void OnDeath(PlayerControl player)
    {
    }
@@ -57,7 +57,7 @@ public abstract class CustomGameMode
    /// Calculate Game End logic.
    /// </summary>
    /// <param name="runOriginal">Should original game end logic be used.</param>
-    /// <param name="instance">Instance of LogicGameFlowNormal.</param>
+    /// <param name="instance">Instance of <see cref="LogicGameFlowNormal"/>.</param>
    public virtual void CheckGameEnd(out bool runOriginal, LogicGameFlowNormal instance)
    {
        runOriginal = true;
@@ -67,7 +67,7 @@ public abstract class CustomGameMode
    /// Custom role assignment.
    /// </summary>
    /// <param name="runOriginal">Should original role assignment be used.</param>
-    /// <param name="instance">Instance of LogicRoleSelection.</param>
+    /// <param name="instance">Instance of <see cref="LogicRoleSelection"/>.</param>
    public virtual void AssignRoles(out bool runOriginal, LogicRoleSelectionNormal instance)
    {
        runOriginal = true;
@@ -78,7 +78,7 @@ public abstract class CustomGameMode
    /// </summary>
    /// <param name="runOriginal">Should the original murder logic be used.</param>
    /// <param name="result">Result of custom murder logic.</param>
-    /// <param name="target">Target player for murder.</param>
+    /// <param name="target">Target <see cref="PlayerControl"/> for murder.</param>
    public virtual void CanKill(out bool runOriginal, out bool result, PlayerControl target)
    {
        result = false;
@@ -88,60 +88,60 @@ public abstract class CustomGameMode
    /// <summary>
    /// Should Roles Settings be available when this gamemode is selected.
    /// </summary>
-    /// <returns>True if Role Settings are enabled in this game mode.</returns>
+    /// <returns><see langword="true"/> if Role Settings are enabled in this game mode.</returns>
    public virtual bool AreRoleSettingsEnabled() => true;

    /// <summary>
    /// Should Game Settings be available when this gamemode is selected.
    /// </summary>
-    /// <returns>True if Game Settings are enabled in this mode.</returns>
+    /// <returns><see langword="true"/> if Game Settings are enabled in this mode.</returns>
    public virtual bool AreGameSettingsEnabled() => true;

    /// <summary>
    /// Custom winner selection.
    /// </summary>
-    /// <returns>List of winners or null.</returns>
+    /// <returns>List of winners or <see langword="null"/>.</returns>
    public virtual List<NetworkedPlayerInfo>? CalculateWinners() => null;

    /// <summary>
-    /// Show gamemode in Intro Cutscene.
+    /// Show gamemode in <see cref="IntroCutscene"/>.
    /// </summary>
-    /// <returns>True if the game mode should be shown in the intro cutscene.</returns>
+    /// <returns><see langword="true"/> if the game mode should be shown in the intro cutscene.</returns>
    public virtual bool ShowGameModeIntroCutscene() => false;

    /// <summary>
    /// Can Admin be used in this gamemode.
    /// </summary>
    /// <param name="console">Admin Console.</param>
-    /// <returns>True if Admin console is enabled.</returns>
+    /// <returns><see langword="true"/> if Admin console is enabled.</returns>
    public virtual bool CanUseMapConsole(MapConsole console) => true;

    /// <summary>
-    /// Can a body be reported in this gamemode.
+    /// Can a <see cref="DeadBody"/> be reported in this gamemode.
    /// </summary>
-    /// <param name="body">Target body for reporting.</param>
-    /// <returns>True if dead bodies can be reported.</returns>
+    /// <param name="body">Target <see cref="DeadBody"/> for reporting.</param>
+    /// <returns><see langword="true"/> if <see cref="DeadBody"/>s can be reported.</returns>
    public virtual bool CanReport(DeadBody body) => true;

    /// <summary>
-    /// Can system consoles be used in this gamemode.
+    /// Can <see cref="SystemConsole"/>s be used in this gamemode.
    /// </summary>
    /// <param name="console">System Console.</param>
-    /// <returns>True if system consoles are enabled in this mode.</returns>
+    /// <returns><see langword="true"/> if <see cref="SystemConsole"/>s are enabled in this mode.</returns>
    public virtual bool CanUseSystemConsole(SystemConsole console) => true;

    /// <summary>
    /// Can tasks be interacted with in this gamemode.
    /// </summary>
    /// <param name="console">Task console.</param>
-    /// <returns>True if tasks are enabled in this mode.</returns>
+    /// <returns><see langword="true"/> if tasks are enabled in this mode.</returns>
    public virtual bool CanUseTasks(Console console) => true;

    /// <summary>
    /// Should the sabotage map be used when attempting to open sabotage overlay.
    /// </summary>
-    /// <param name="map">MapBehaviour object.</param>
-    /// <returns>True if the sabotage map should be shown.</returns>
+    /// <param name="map"><see cref="MapBehaviour"/> object.</param>
+    /// <returns><see langword="true"/> if the sabotage map should be shown.</returns>
    public virtual bool ShouldShowSabotageMap(MapBehaviour map) => true;

    /// <summary>
@@ -149,6 +149,6 @@ public abstract class CustomGameMode
    /// </summary>
    /// <param name="vent">Target vent.</param>
    /// <param name="playerInfo">Player attempting to vent.</param>
-    /// <returns>True if venting is enabled in this mode.</returns>
+    /// <returns><see langword="true"/> if venting is enabled in this mode.</returns>
    public virtual bool CanVent(Vent vent, NetworkedPlayerInfo playerInfo) => true;
 }
@@ -1,17 +1,16 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using Reactor.Utilities;

 namespace MiraAPI.GameModes;

 /// <summary>
-/// Manages custom gamemodes.
+/// Manages <see cref="CustomGameMode"/>s.
 /// </summary>
 public static class CustomGameModeManager
 {
    /// <summary>
-    /// List of registered gamemodes.
+    /// List of registered <see cref="CustomGameMode"/>.
    /// </summary>
    internal static readonly Dictionary<int, CustomGameMode> GameModes = [];

@@ -21,14 +20,14 @@ public static class CustomGameModeManager
    }

    /// <summary>
-    /// Gets the current gamemode.
+    /// Gets the current <see cref="CustomGameMode"/>.
    /// </summary>
    public static CustomGameMode? ActiveMode { get; internal set; } = new DefaultMode();

    /// <summary>
-    /// Set current gamemode.
+    /// Set current <see cref="CustomGameMode"/>.
    /// </summary>
-    /// <param name="id">gamemode ID.</param>
+    /// <param name="id"><see cref="CustomGameMode"/> ID.</param>
    public static void SetGameMode(int id)
    {
        if (GameModes.TryGetValue(id, out var gameMode))
@@ -41,9 +40,9 @@ public static class CustomGameModeManager
    }

    /// <summary>
-    /// Register gamemode from type.
+    /// Register <see cref="CustomGameMode"/> from type.
    /// </summary>
-    /// <param name="gameModeType">Type of gamemode class, should inherit from <see cref="CustomGameMode"/>.</param>
+    /// <param name="gameModeType">Type of <see cref="CustomGameMode"/>, should inherit from <see cref="CustomGameMode"/>.</param>
    internal static void RegisterGameMode(Type gameModeType)
    {
        if (!typeof(CustomGameMode).IsAssignableFrom(gameModeType))
@@ -1,7 +1,9 @@
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
+using System.Linq;
 using MiraAPI.Modifiers;
+using MiraAPI.Roles;
 using UnityEngine;

 namespace MiraAPI.GameOptions;
@@ -29,15 +31,18 @@ public abstract class AbstractOptionGroup
    public virtual Type? OptionableType => null;

    /// <summary>
-    /// Gets a value indicating whether the group should be shown in the modifiers menu. This is deprecated, please use ParentMenu!
+    /// Gets a value indicating whether the group should be shown in the modifiers menu.
    /// </summary>
    // TODO: make this not a boolean
+#pragma warning disable S1133
+    [Obsolete("Use ParentMenu instead.")]
+#pragma warning restore S1133
    public virtual bool ShowInModifiersMenu => false;

    /// <summary>
    /// Gets a value indicating which menu the group is in.
    /// </summary>
-    public virtual MenuCategory ParentMenu => MenuCategory.Roles;
+    public virtual MenuCategory ParentMenu => MenuCategory.Game;

    /// <summary>
    /// Gets the function that determines whether the group should be visible or not.
@@ -45,19 +50,26 @@ public abstract class AbstractOptionGroup
    public virtual Func<bool> GroupVisible => () => true;

    /// <summary>
-    /// Gets the group color. This is used to color the group in the options menu.
+    /// Gets the group <see cref="Color"/>. This is used to color the group in the options menu.
    /// </summary>
    public virtual Color GroupColor => MiraApiPlugin.DefaultHeaderColor;

    /// <summary>
    /// Gets the group priority. This is used to determine the order in which groups are displayed in the options menu.
-    /// Zero is the highest priority, and the default value is the max uint value.
+    /// Zero is the highest priority, and the default value is the max <see langword="uint"/> value.
    /// </summary>
    public virtual uint GroupPriority => uint.MaxValue;

+    /// <summary>
+    /// Gets the default notification settings for the group.
+    /// </summary>
+    public virtual OptionNotifConfiguration Configuration => new(new Color(0.7333f, 0.7333f, 0.7333f, 1));
+
    internal bool AllOptionsHidden { get; set; }

    internal CategoryHeaderMasked? Header { get; set; }
+
+    internal bool Ready { get; set; }
 }

 /// <summary>
@@ -69,9 +81,7 @@ public abstract class AbstractOptionGroup<T> : AbstractOptionGroup where T : IOp
    /// <inheritdoc />
    public override Type OptionableType => typeof(T);

-    /// <summary>
-    /// Gets a value indicating which menu the group is in.
-    /// </summary>
+    /// <inheritdoc />
    public override MenuCategory ParentMenu
    {
        get
@@ -90,11 +100,65 @@ public abstract class AbstractOptionGroup<T> : AbstractOptionGroup where T : IOp
    }
 }

+/// <summary>
+/// Base class for option groups. An option group is a collection of options that are displayed together in the options menu.
+/// </summary>
+/// <typeparam name="T">The custom role that the group is for.</typeparam>
+public abstract class AbstractRoleOptionGroup<T>() : AbstractOptionGroup<T> where T : ICustomRole
+{
+    /// <inheritdoc />
+    public override Type OptionableType => typeof(T);
+
+    /// <inheritdoc />
+    public override MenuCategory ParentMenu => MenuCategory.Roles;
+
+    /// <inheritdoc />
+    public override OptionNotifConfiguration Configuration
+    {
+        get
+        {
+            var role = CustomRoleManager.CustomMiraRoles.FirstOrDefault(x => x.GetType() == OptionableType);
+            if (role == null)
+            {
+                return new(new Color(0.7333f, 0.7333f, 0.7333f, 1));
+            }
+            return new(role.RoleColor, role.Configuration.IconTmp);
+        }
+    }
+}
+
+/// <summary>
+/// Menu categories for option groups.
+/// </summary>
 public enum MenuCategory
 {
+    /// <summary>
+    /// Placeholder for indexing purposes. Options don't exist in the presset tab.
+    /// </summary>
+    Preset,
+
+    /// <summary>
+    /// Determines the option group is in the game settings tab.
+    /// </summary>
    Game,
+
+    /// <summary>
+    /// Determines the option group is in the role settings tab.
+    /// </summary>
    Roles,
+
+    /// <summary>
+    /// Determines the option group is in the modifier settings tab.
+    /// </summary>
    Modifiers,
+
+    /// <summary>
+    /// Determines the option group is in the first custom settings tab.
+    /// </summary>
    CustomOne,
-    CustomTwo
+
+    /// <summary>
+    /// Determines the option group is in the second custom settings tab.
+    /// </summary>
+    CustomTwo,
 }
@@ -5,7 +5,7 @@ using MiraAPI.GameOptions.OptionTypes;
 namespace MiraAPI.GameOptions.Attributes;

 /// <summary>
-/// Attribute for creating an enum option.
+/// Attribute for creating a <see cref="ModdedEnumOption"/>.
 /// </summary>
 [AttributeUsage(AttributeTargets.Property)]
 public class ModdedEnumOptionAttribute(string title, Type enumType, string[]? values = null)
@@ -6,7 +6,7 @@ using MiraAPI.Utilities;
 namespace MiraAPI.GameOptions.Attributes;

 /// <summary>
-/// A number option attribute for the modded options system.
+/// Attribute for a <see cref="ModdedNumberOption"/>.
 /// </summary>
 [AttributeUsage(AttributeTargets.Property)]
 public class ModdedNumberOptionAttribute(
@@ -4,7 +4,7 @@ using System.Reflection;
 namespace MiraAPI.GameOptions.Attributes;

 /// <summary>
-/// Represents an attribute that is used to define a modded option.
+/// Represents an attribute that is used to define an <see cref="IModdedOption"/>.
 /// </summary>
 /// <param name="title">The option title.</param>
 /// <param name="roleType">Optional parameter to specify a role Type.</param>
@@ -26,13 +26,13 @@ public abstract class ModdedOptionAttribute(string title, Type? roleType = null)
    /// <summary>
    /// Sets the value of the option.
    /// </summary>
-    /// <param name="value">The new value as an object.</param>
+    /// <param name="value">The new value as an <see langword="object"/>.</param>
    public abstract void SetValue(object value);

    /// <summary>
    /// Gets the value of the option.
    /// </summary>
-    /// <returns>The value of the option as an object.</returns>
+    /// <returns>The value of the option as an <see langword="object"/>.</returns>
    public abstract object GetValue();

    internal abstract IModdedOption? CreateOption(object? value, PropertyInfo property);
@@ -5,7 +5,7 @@ using MiraAPI.GameOptions.OptionTypes;
 namespace MiraAPI.GameOptions.Attributes;

 /// <summary>
-/// Attribute for a toggle option.
+/// Attribute for a <see cref="ModdedToggleOption"/>.
 /// </summary>
 /// <param name="title">The option title.</param>
 [AttributeUsage(AttributeTargets.Property)]
@@ -22,22 +22,32 @@ public interface IModdedOption
    string Title { get; set; }

    /// <summary>
-    /// Gets the StringName for the option, used for localization.
+    /// Gets or sets the parent <see cref="AbstractOptionGroup"/> of the option.
+    /// </summary>
+    AbstractOptionGroup ParentGroup { get; set; }
+
+    /// <summary>
+    /// Gets the notification settings for the option.
+    /// </summary>
+    OptionNotifConfiguration Configuration { get; }
+
+    /// <summary>
+    /// Gets the <see cref="StringNames"/> for the option, used for localization.
    /// </summary>
    StringNames StringName { get; }

    /// <summary>
-    /// Gets or sets the MiraPlugin that created this option.
+    /// Gets or sets the <see cref="IMiraPlugin"/> that created this option.
    /// </summary>
    IMiraPlugin? ParentMod { get; set; }

    /// <summary>
-    /// Gets the game setting data for the option.
+    /// Gets the <see cref="BaseGameSetting"/> for the option.
    /// </summary>
    BaseGameSetting Data { get; }

    /// <summary>
-    /// Gets the OptionBehaviour object of the option.
+    /// Gets the <see cref="global::OptionBehaviour"/> object of the option.
    /// </summary>
    OptionBehaviour? OptionBehaviour { get; }

@@ -52,55 +62,55 @@ public interface IModdedOption
    bool IncludeInPreset { get; set; }

    /// <summary>
-    /// Gets or sets the ConfigDefinition for the option, used for BepInEx configuration.
+    /// Gets or sets the <see cref="BepInEx.Configuration.ConfigDefinition"/> for the option, used for BepInEx configuration.
    /// </summary>
    ConfigDefinition? ConfigDefinition { get; set; }

    /// <summary>
    /// Creates the option behaviour for the modded option.
    /// </summary>
-    /// <param name="toggleOpt">The ToggleOption template.</param>
-    /// <param name="numberOpt">The NumberOption template.</param>
-    /// <param name="stringOpt">The StringOption template.</param>
-    /// <param name="playerOpt">The PlayerOption template.</param>
-    /// <param name="container">>The Transform container for the option.</param>
-    /// <returns>>The created OptionBehaviour object.</returns>
+    /// <param name="toggleOpt">The <see cref="ToggleOption"/> template.</param>
+    /// <param name="numberOpt">The <see cref="NumberOption"/> template.</param>
+    /// <param name="stringOpt">The <see cref="StringOption"/> template.</param>
+    /// <param name="playerOpt">The <see cref="PlayerOption"/> template.</param>
+    /// <param name="container">The <see cref="Transform"/> container for the option.</param>
+    /// <returns>The created <see cref="global::OptionBehaviour"/> object.</returns>
    OptionBehaviour CreateOption(ToggleOption toggleOpt, NumberOption numberOpt, StringOption stringOpt, PlayerOption playerOpt, Transform container);

    /// <summary>
-    /// Gets the value as a float.
+    /// Gets the value as a <see langword="float"/>.
    /// </summary>
-    /// <returns>>The value of the option as a float.</returns>
+    /// <returns>The value of the option as a <see langword="float"/>.</returns>
    float GetFloatData();

    /// <summary>
-    /// Gets the NetData for the option, used for network synchronization.
+    /// Gets the <see cref="NetData"/> for the option, used for network synchronization.
    /// </summary>
-    /// <returns>>Returns the NetData object for the option.</returns>
+    /// <returns>Returns the <see cref="NetData"/> object for the option.</returns>
    NetData GetNetData();

    /// <summary>
    /// Handles incoming network data for the option.
    /// </summary>
-    /// <param name="data">>The byte array representing the network data.</param>
+    /// <param name="data">The byte array representing the network data.</param>
    void HandleNetData(byte[] data);

    /// <summary>
    /// Saves the option to a preset configuration file.
    /// </summary>
-    /// <param name="presetConfig">The ConfigFile representing the preset configuration.</param>
+    /// <param name="presetConfig">The <see cref="ConfigFile"/> representing the preset configuration.</param>
    /// <param name="saveDefault">Indicates whether to save the default value instead of the current value.</param>
    void SaveToPreset(ConfigFile presetConfig, bool saveDefault = false);

    /// <summary>
    /// Binds the option to a configuration file.
    /// </summary>
-    /// <param name="config">The ConfigFile to bind the option to.</param>
+    /// <param name="config">The <see cref="ConfigFile"/> to bind the option to.</param>
    void Bind(ConfigFile config);

    /// <summary>
    /// Loads the option from a preset configuration file, applying the values to the option's configuration.
    /// </summary>
-    /// <param name="presetConfig">The ConfigFile representing the preset configuration.</param>
+    /// <param name="presetConfig">The <see cref="ConfigFile"/> representing the preset configuration.</param>
    void LoadFromPreset(ConfigFile presetConfig);
 }
@@ -13,7 +13,7 @@ namespace MiraAPI.GameOptions;
 public class MiraNumberOptionComponent(IntPtr cppPtr) : MonoBehaviour(cppPtr)
 {
    /// <summary>
-    /// Gets or sets the modded option associated with the object.
+    /// Gets or sets the <see cref="ModdedNumberOption"/> associated with the object.
    /// </summary>
    [HideFromIl2Cpp]
    public ModdedNumberOption NumberOption { get; set; }
@@ -12,11 +12,13 @@ using MiraAPI.PluginLoading;
 using MiraAPI.Utilities;
 using Reactor.Networking.Rpc;
 using Reactor.Utilities;
+using TMPro;
+using UnityEngine;

 namespace MiraAPI.GameOptions;

 /// <summary>
-/// Handles modded options.
+/// Handles <see cref="IModdedOption"/>s.
 /// </summary>
 public static class ModdedOptionsManager
 {
@@ -30,6 +32,36 @@ public static class ModdedOptionsManager
    internal static uint NextId => _nextId++;
    private static uint _nextId = 1;

+    public static void AddSettingsChangeMessage(NotificationPopper notif, StringNames key, string value, Color textColor, TMP_SpriteAsset? sprite, bool playSound = true)
+    {
+        var item = string.Empty;
+        var text = textColor.ToTextColor();
+        if (sprite != null)
+        {
+            item = TranslationController.Instance.GetString(
+                StringNames.LobbyChangeSettingNotification,
+                string.Concat(
+                    "<sprite name=\"",
+                    sprite.name,
+                    "\"><font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">",
+                    text,
+                    TranslationController.Instance.GetString(key),
+                    "</color></font>"),
+                "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">" + value + "</font>"
+            );
+        }
+        else
+        {
+            item = TranslationController.Instance.GetString(
+                StringNames.LobbyChangeSettingNotification,
+                "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">" +
+                text +
+                TranslationController.Instance.GetString(key) + "</color></font>",
+                "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">" + value + "</font>");
+        }
+        notif.SettingsChangeMessageLogic(key, item, playSound);
+    }
+
    internal static bool RegisterGroup(Type type, MiraPluginInfo pluginInfo)
    {
        if (Activator.CreateInstance(type) is not AbstractOptionGroup group)
@@ -123,6 +155,7 @@ public static class ModdedOptionsManager

        option.ConfigDefinition = new ConfigDefinition(groupName, propertyName);

+        option.ParentGroup = group;
        option.ParentMod = pluginInfo.MiraPlugin;
        pluginInfo.InternalOptions.Add(option);
        ModdedOptions.Add(option.Id, option);
@@ -192,7 +225,7 @@ public static class ModdedOptionsManager
    /// </summary>
    /// <param name="__originalMethod">The original getter method.</param>
    /// <param name="__result">The result of the property getter.</param>
-    /// <returns>False so the original getter gets skipped.</returns>
+    /// <returns><see langword="false"/> so the original getter gets skipped.</returns>
 #pragma warning disable CA1707
    [SuppressMessage("ReSharper", "InconsistentNaming", Justification = "Harmony naming convention")]
    public static bool PropertyGetterPatch(MethodBase __originalMethod, ref object __result)
@@ -3,7 +3,7 @@
 namespace MiraAPI.GameOptions;

 /// <summary>
-/// Singleton for option groups.
+/// Singleton for <see cref="AbstractOptionGroup"/>s.
 /// </summary>
 /// <typeparam name="T">The option group type.</typeparam>
 public static class OptionGroupSingleton<T> where T : AbstractOptionGroup
@@ -11,7 +11,7 @@ public static class OptionGroupSingleton<T> where T : AbstractOptionGroup
    private static T? _instance;

    /// <summary>
-    /// Gets the instance of the option group.
+    /// Gets the instance of the <typeparamref name="T"/> group.
    /// </summary>
 #pragma warning disable CA1000
    public static T Instance => _instance ??= ModdedOptionsManager.Groups.OfType<T>().Single();
@@ -0,0 +1,53 @@
+using System;
+using Il2CppInterop.Runtime.Attributes;
+using TMPro;
+using UnityEngine;
+namespace MiraAPI.GameOptions;
+
+/// <summary>
+/// Used to configure the specific visuals for option notifications.
+/// </summary>
+public record struct OptionNotifConfiguration
+{
+#pragma warning disable S1133
+    [Obsolete("Default constructor is not supported")]
+#pragma warning restore S1133
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member
+    public OptionNotifConfiguration()
+#pragma warning restore CS1591 // Missing XML comment for publicly visible type or member
+    {
+        throw new NotImplementedException("Default constructor is not supported.");
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="OptionNotifConfiguration"/> struct based on a group.
+    /// </summary>
+    /// <param name="group">The <see cref="AbstractOptionGroup"/> in which you are configuring.</param>
+    public OptionNotifConfiguration(AbstractOptionGroup group)
+    {
+        PopUpIconTmp = group.Configuration.PopUpIconTmp;
+        PopUpTextColor = group.Configuration.PopUpTextColor;
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="OptionNotifConfiguration"/> struct from scratch.
+    /// </summary>
+    /// <param name="color">The text <see cref="Color"/> for the configuration.</param>
+    /// <param name="asset">The <see cref="TMP_SpriteAsset"/> icon for the configuration.</param>
+    public OptionNotifConfiguration(Color color, TMP_SpriteAsset asset = null!)
+    {
+        PopUpIconTmp = asset;
+        PopUpTextColor = color;
+    }
+
+    /// <summary>
+    /// Gets or sets the <see cref="TMP_SpriteAsset"/> for the icon on the options pop-up.
+    /// </summary>
+    public TMP_SpriteAsset PopUpIconTmp { get; set; }
+
+    /// <summary>
+    /// Gets or sets the <see cref="Color"/> for the text on the options pop-up.
+    /// </summary>
+    [HideFromIl2Cpp]
+    public Color PopUpTextColor { get; set; }
+}
@@ -11,7 +11,7 @@ using Object = UnityEngine.Object;
 namespace MiraAPI.GameOptions.OptionTypes;

 /// <summary>
-/// An option for selecting an enum value.
+/// An option for selecting an <see langword="enum"/> value.
 /// </summary>
 public class ModdedEnumOption : ModdedOption<int>
 {
@@ -25,8 +25,8 @@ public class ModdedEnumOption : ModdedOption<int>
    /// </summary>
    /// <param name="title">The title of the option.</param>
    /// <param name="defaultValue">The default value as an int.</param>
-    /// <param name="enumType">The Enum type.</param>
-    /// <param name="values">An option list of string values to use in place of the enum name.</param>
+    /// <param name="enumType">The <see cref="Enum"/> type.</param>
+    /// <param name="values">An option list of string values to use in place of the <see langword="enum"/> name.</param>
    /// <param name="includeInPreset">Whether to include this option in the preset or not.</param>
    public ModdedEnumOption(string title, int defaultValue, Type enumType, string[]? values = null, bool includeInPreset=true) : base(title, defaultValue, includeInPreset)
    {
@@ -90,7 +90,13 @@ public class ModdedEnumOption : ModdedOption<int>
    /// <inheritdoc />
    protected override void OnValueChanged(int newValue)
    {
-        HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, Data.GetValueString(newValue), false);
+        ModdedOptionsManager.AddSettingsChangeMessage(
+            HudManager.Instance.Notifier,
+            StringName,
+            Data.GetValueString(newValue),
+            Configuration.PopUpTextColor,
+            Configuration.PopUpIconTmp,
+            false);
        if (!OptionBehaviour)
        {
            return;
@@ -104,13 +110,13 @@ public class ModdedEnumOption : ModdedOption<int>
 }

 /// <summary>
-/// An option for selecting an enum value.
+/// An option for selecting an <see langword="enum"/> value.
 /// </summary>
-/// <typeparam name="T">The enum type.</typeparam>
+/// <typeparam name="T">The <see cref="Enum"/> type.</typeparam>
 public class ModdedEnumOption<T> : ModdedOption<T> where T : Enum
 {
    /// <summary>
-    /// Gets the string values of the enum.
+    /// Gets the string values of the <see langword="enum"/>.
    /// </summary>
    public string[] Values { get; }

@@ -118,8 +124,8 @@ public class ModdedEnumOption<T> : ModdedOption<T> where T : Enum
    /// Initializes a new instance of the <see cref="ModdedEnumOption{T}"/> class.
    /// </summary>
    /// <param name="title">The title of the option.</param>
-    /// <param name="defaultValue">The default value as an int.</param>
-    /// <param name="values">An option list of string values to use in place of the enum name.</param>
+    /// <param name="defaultValue">The default value as an <see langword="int"/>.</param>
+    /// <param name="values">An option list of string values to use in place of the <see langword="enum"/> name.</param>
    /// <param name="includeInPreset">Whether to include this option in the preset or not.</param>
    public ModdedEnumOption(string title, T defaultValue, string[]? values = null, bool includeInPreset=true) : base(title, defaultValue, includeInPreset)
    {
@@ -183,7 +189,13 @@ public class ModdedEnumOption<T> : ModdedOption<T> where T : Enum
    /// <inheritdoc />
    protected override void OnValueChanged(T newValue)
    {
-        HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, Data.GetValueString(Convert.ToInt32(newValue, NumberFormatInfo.InvariantInfo)), false);
+        ModdedOptionsManager.AddSettingsChangeMessage(
+            HudManager.Instance.Notifier,
+            StringName,
+            Data.GetValueString(Convert.ToInt32(newValue, NumberFormatInfo.InvariantInfo)),
+            Configuration.PopUpTextColor,
+            Configuration.PopUpIconTmp,
+            false);
        if (!OptionBehaviour)
        {
            return;
@@ -225,9 +225,12 @@ public class ModdedNumberOption : ModdedOption<float>
    protected override void OnValueChanged(float newValue)
    {
        Value = Mathf.Clamp(newValue, Min, Max);
-        HudManager.Instance.Notifier.AddSettingsChangeMessage(
+        ModdedOptionsManager.AddSettingsChangeMessage(
+            HudManager.Instance.Notifier,
            StringName,
-            Data.GetValueString(Value),
+            Data.GetValueString(newValue),
+            Configuration.PopUpTextColor,
+            Configuration.PopUpIconTmp,
            false);

        if (OptionBehaviour is NumberOption opt)
@@ -237,7 +240,7 @@ public class ModdedNumberOption : ModdedOption<float>
    }

    /// <summary>
-    /// Implicitly converts the option to an int.
+    /// Implicitly converts the option to an <see langword="int"/>.
    /// </summary>
    /// <param name="option">The option.</param>
    /// <returns>Integer value.</returns>
@@ -4,7 +4,6 @@ using MiraAPI.Networking;
 using MiraAPI.PluginLoading;
 using Reactor.Localization.Utilities;
 using Reactor.Networking.Rpc;
-using Reactor.Utilities;
 using UnityEngine;

 namespace MiraAPI.GameOptions.OptionTypes;
@@ -190,4 +189,10 @@ public abstract class ModdedOption<T> : IModdedOption
    {
        return option.Value;
    }
+
+    /// <inheritdoc />
+    public AbstractOptionGroup ParentGroup { get; set; }
+
+    /// <inheritdoc />
+    public virtual OptionNotifConfiguration Configuration => new(ParentGroup);
 }
@@ -9,7 +9,7 @@ using Object = UnityEngine.Object;
 namespace MiraAPI.GameOptions.OptionTypes;

 /// <summary>
-/// An option for selecting an ingame player. It returns an index of the values list, NOT A PLAYER ID. To get a player out of this, index the Values list.
+/// An option for selecting an ingame player. It returns an index of the values list, NOT A PLAYER ID. To get a player out of this, index the <see cref="Values"/> list.
 /// </summary>
 public class ModdedPlayerOption : ModdedOption<int>
 {
@@ -91,9 +91,9 @@ public class ModdedPlayerOption : ModdedOption<int>
    }

    /// <summary>
-    /// Returns a player from the value. If AllowNone is enabled and none is enabled this will return null.
+    /// Returns a player from the value. If <see cref="AllowNone"/> is enabled and none is enabled this will return <see langword="null"/>.
    /// </summary>
-    /// <returns>A player or null if chosen none.</returns>
+    /// <returns>A player or <see langword="null"/> if chosen none.</returns>
    public NetworkedPlayerInfo? GetPlayerValue()
    {
        return Value < 0 ? null : Values[Value];
@@ -126,7 +126,13 @@ public class ModdedPlayerOption : ModdedOption<int>
    /// <inheritdoc />
    protected override void OnValueChanged(int newValue)
    {
-        HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, Data.GetValueString(newValue), false);
+        ModdedOptionsManager.AddSettingsChangeMessage(
+            HudManager.Instance.Notifier,
+            StringName,
+            Data.GetValueString(newValue),
+            Configuration.PopUpTextColor,
+            Configuration.PopUpIconTmp,
+            false);
        if (!OptionBehaviour)
        {
            return;
@@ -71,7 +71,13 @@ public class ModdedToggleOption : ModdedOption<bool>
    /// <inheritdoc />
    protected override void OnValueChanged(bool newValue)
    {
-        HudManager.Instance.Notifier.AddSettingsChangeMessage(StringName, newValue ? "On" : "Off", false);
+        ModdedOptionsManager.AddSettingsChangeMessage(
+            HudManager.Instance.Notifier,
+            StringName,
+            newValue ? "On" : "Off",
+            Configuration.PopUpTextColor,
+            Configuration.PopUpIconTmp,
+            false);
        if (!OptionBehaviour)
        {
            return;
@@ -1,7 +1,7 @@
 namespace MiraAPI.Hud;

 /// <summary>
-/// The location of the custom button on the screen.
+/// The location of the <see cref="CustomActionButton"/> on the screen.
 /// </summary>
 public enum ButtonLocation
 {
@@ -1,7 +1,7 @@
 namespace MiraAPI.Hud;

 /// <summary>
-/// The uses mode for custom buttons.
+/// The uses mode for <see cref="CustomActionButton"/>s.
 /// </summary>
 public enum ButtonUsesMode
 {
@@ -7,7 +7,6 @@ using MiraAPI.LocalSettings;
 using MiraAPI.Patches;
 using MiraAPI.Utilities;
 using MiraAPI.Utilities.Assets;
-using Reactor.Utilities;
 using Rewired;
 using TMPro;
 using UnityEngine;
@@ -18,7 +17,7 @@ using Object = UnityEngine.Object;
 namespace MiraAPI.Hud;

 /// <summary>
-/// Class for making custom action buttons. More customizable than the default Action/Ability buttons in the base game.
+/// Class for making custom action buttons. More customizable than the default <see cref="ActionButton"/>/<see cref="AbilityButton"/>s in the base game.
 /// </summary>
 public abstract class CustomActionButton
 {
@@ -54,7 +53,7 @@ public abstract class CustomActionButton
    public virtual string CooldownTimerFormatString => "0";

    /// <summary>
-    /// Gets a value indicating whether the button has an effect ability. By default true if <see cref="EffectDuration"/> is greater than 0.
+    /// Gets a value indicating whether the button has an effect ability. By default <see langword="true"/> if <see cref="EffectDuration"/> is greater than 0.
    /// </summary>
    public virtual bool HasEffect => EffectDuration > 0;

@@ -79,17 +78,17 @@ public abstract class CustomActionButton
    public virtual ButtonUsesMode UsesMode => ButtonUsesMode.PerGame;

    /// <summary>
-    /// Gets the keybind for this button. If null, no keybind will be added.
+    /// Gets the keybind for this button. If <see langword="null"/>, no keybind will be added.
    /// </summary>
    public virtual BaseKeybind? Keybind => null;

    /// <summary>
-    /// Gets the button's text outline color.
+    /// Gets the button's text outline <see cref="Color"/>.
    /// </summary>
    public virtual Color TextOutlineColor => Color.clear;

    /// <summary>
-    /// Gets or sets the location of the button on the screen.
+    /// Gets or sets the <see cref="ButtonLocation"/> on the screen.
    /// </summary>
    public virtual ButtonLocation Location { get; set; } = ButtonLocation.BottomLeft;

@@ -119,12 +118,12 @@ public abstract class CustomActionButton
    public float Timer { get; set; }

    /// <summary>
-    /// Gets or sets the button object in game. This is created by Mira API automatically.
+    /// Gets or sets the <see cref="ActionButton"/> object in game. This is created by Mira API automatically.
    /// </summary>
    public ActionButton? Button { get; set; }

    /// <summary>
-    /// Gets the gameObject used for the keybind icon.
+    /// Gets the <see cref="GameObject"/> used for the keybind icon.
    /// </summary>
    public GameObject? KeybindIcon { get; private set; }

@@ -316,18 +315,18 @@ public abstract class CustomActionButton
    }

    /// <summary>
-    /// A utility function to change the outline color of the button's text.
+    /// A utility function to change the outline <see cref="Color"/> of the button's text.
    /// </summary>
-    /// <param name="color">The new color.</param>
+    /// <param name="color">The new <see cref="Color"/>.</param>
    public virtual void SetTextOutline(Color color)
    {
        Button?.buttonLabelText.SetOutlineColor(color);
    }

    /// <summary>
-    /// A utility function to override the sprite of the button.
+    /// A utility function to override the <see cref="UnityEngine.Sprite"/> of the button.
    /// </summary>
-    /// <param name="sprite">The new sprite to override with.</param>
+    /// <param name="sprite">The new <see cref="UnityEngine.Sprite"/> to override with.</param>
    public virtual void OverrideSprite(Sprite sprite)
    {
        if (Button != null)
@@ -415,7 +414,7 @@ public abstract class CustomActionButton
    }

    /// <summary>
-    /// A utility function that runs with the local PlayerControl's FixedUpdate if the button is enabled.
+    /// A utility function that runs with the local player's <see cref="PlayerControl.FixedUpdate"/> if the button is enabled.
    /// </summary>
    /// <param name="playerControl">the local PlayerControl.</param>
    protected virtual void FixedUpdate(PlayerControl playerControl)
@@ -429,10 +428,10 @@ public abstract class CustomActionButton

    /// <summary>
    /// This method determines if the button should be active or not.
-    /// True means the button is active, false means the button is disabled.
+    /// <see langword="true"/> means the button is active, <see langword="false"/> means the button is disabled.
    /// </summary>
-    /// <param name="role">The role of the local player.</param>
-    /// <returns>True if the button is enabled, false otherwise.</returns>
+    /// <param name="role">The <see cref="RoleBehaviour"/> of the local player.</param>
+    /// <returns><see langword="true"/> if the button is enabled, <see langword="false"/> otherwise.</returns>
    public abstract bool Enabled(RoleBehaviour? role);

    /// <summary>
@@ -445,7 +444,7 @@ public abstract class CustomActionButton

    /// <summary>
    /// Returns a value indicating whether the effect can be ended early by the player.
-    /// Always false by default.
+    /// Always <see langword="false"/> by default.
    /// </summary>
    /// <returns>Can the effect be canceled.</returns>
    public virtual bool IsEffectCancellable() => false;
@@ -473,12 +472,12 @@ public abstract class CustomActionButton
    }

    /// <summary>
-    /// This method is called on the HudManager.SetHudActive method. It determines whether the button should be visible or not.
-    /// The default behavior is to show the button if the <paramref name="visible"/> parameter and the <see cref="Enabled"/> method return true.
+    /// This method is called on the <see cref="HudManager.SetHudActive(PlayerControl, RoleBehaviour, bool)"/> method. It determines whether the button should be visible or not.
+    /// The default behavior is to show the button if the <paramref name="visible"/> parameter and the <see cref="Enabled"/> method return <see langword="true"/>.
    /// It can be overridden for custom behavior.
    /// </summary>
-    /// <param name="visible">Passed in from HudManager.SetHudActive, should hud be active.</param>
-    /// <param name="role">Passed in from HudManager.SetHudActive, the current role of the player.</param>
+    /// <param name="visible">Passed in from <see cref="HudManager.SetHudActive(PlayerControl, RoleBehaviour, bool)"/>, should hud be active.</param>
+    /// <param name="role">Passed in from <see cref="HudManager.SetHudActive(PlayerControl, RoleBehaviour, bool)"/>, the current role of the player.</param>
    public virtual void SetActive(bool visible, RoleBehaviour role)
    {
        Button?.ToggleVisible(visible && Enabled(role));
@@ -522,7 +521,7 @@ public abstract class CustomActionButton
    }

    /// <summary>
-    /// This method is called on the PlayerControl.FixedUpdate method. It is a wrapper for the <see cref="FixedUpdate"/> method.
+    /// This method is called on the <see cref="PlayerControl.FixedUpdate"/> method. It is a wrapper for the <see cref="FixedUpdate"/> method.
    /// By default, it handles the cooldown and effect timers, and sets the button to enabled or disabled.
    /// It can be overridden for custom behavior.
    /// </summary>
@@ -580,39 +579,39 @@ public abstract class CustomActionButton
 }

 /// <summary>
-/// Custom action button that has a target object.
+/// Custom action button that has a target <typeparamref name="T"/>.
 /// </summary>
 /// <typeparam name="T">The type of the target object.</typeparam>
 public abstract class CustomActionButton<T> : CustomActionButton where T : MonoBehaviour
 {
    /// <summary>
-    /// Gets or sets the target object of the button.
+    /// Gets or sets the target <typeparamref name="T"/> of the button.
    /// </summary>
    public T? Target { get; set; }

    /// <summary>
-    /// Gets the distance the player must be from the target object to use the button.
+    /// Gets the distance the player must be from the target <typeparamref name="T"/> to use the button.
    /// </summary>
    public virtual float Distance => PlayerControl.LocalPlayer.Data.Role.GetAbilityDistance();

    /// <summary>
-    /// Determines if the target object is valid.
+    /// Determines if the target <typeparamref name="T"/> is valid.
    /// </summary>
-    /// <param name="target">The target object being checked.</param>
-    /// <returns>True if the target object is valid, false otherwise.</returns>
+    /// <param name="target">The target <typeparamref name="T"/> being checked.</param>
+    /// <returns><see langword="true"/> if the target <typeparamref name="T"/> is valid, <see langword="false"/> otherwise.</returns>
    public virtual bool IsTargetValid(T? target)
    {
        return target != null;
    }

    /// <summary>
-    /// The method used to get the target object.
+    /// The method used to get the target <typeparamref name="T"/>.
    /// </summary>
-    /// <returns>The target object or null if it isn't found.</returns>
+    /// <returns>The target <typeparamref name="T"/> or <see langword="null"/> if it isn't found.</returns>
    public abstract T? GetTarget();

    /// <summary>
-    /// Sets the outline of the target object.
+    /// Sets the outline of the target <typeparamref name="T"/>.
    /// </summary>
    /// <param name="active">Should the outline be active.</param>
    public abstract void SetOutline(bool active);
@@ -4,17 +4,16 @@ using System.Collections.ObjectModel;
 using System.Reflection;
 using MiraAPI.Events.Mira;
 using MiraAPI.PluginLoading;
-using UnityEngine;

 namespace MiraAPI.Hud;

 /// <summary>
-/// Custom button manager for handling custom buttons.
+/// Custom button manager for handling <see cref="CustomActionButton"/>s.
 /// </summary>
 public static class CustomButtonManager
 {
    /// <summary>
-    /// Gets a list of all registered custom buttons.
+    /// Gets a list of all registered custom <see cref="CustomActionButton"/>s.
    /// </summary>
    public static ReadOnlyCollection<CustomActionButton> Buttons { get; internal set; } = new([]);

@@ -4,7 +4,7 @@ using System.Linq;
 namespace MiraAPI.Hud;

 /// <summary>
-/// A utility class to get the instance of a custom action button.
+/// A utility class to get the instance of a <see cref="CustomActionButton"/>.
 /// </summary>
 /// <typeparam name="T">The type of the button you are trying to access.</typeparam>
 public static class CustomButtonSingleton<T> where T : CustomActionButton
@@ -12,7 +12,7 @@ public static class CustomButtonSingleton<T> where T : CustomActionButton
    private static T? _instance;

    /// <summary>
-    /// Gets the instance of the button.
+    /// Gets the instance of the <typeparamref name="T"/> button.
    /// </summary>
    [SuppressMessage("Design", "CA1000:Do not declare static members on generic types", Justification = "This is a utility class to get the instance of a custom action button.")]
    public static T Instance => _instance ??= CustomButtonManager.CustomButtons.OfType<T>().Single();
@@ -15,9 +15,9 @@ using UnityEngine.Events;
 namespace MiraAPI.Hud;

 /// <summary>
-/// Custom Player Menu using the ShapeshifterPanel as a base.
+/// Custom Player Menu using the <see cref="ShapeshifterPanel"/> as a base.
 /// </summary>
-/// <param name="il2CppPtr">Used by Il2Cpp. Do not use constructor, this is a MonoBehaviour.</param>
+/// <param name="il2CppPtr">Used by Il2Cpp. Do not use constructor, this is a <see cref="MonoBehaviour"/>.</param>
 [RegisterInIl2Cpp]
 [SuppressMessage("Design", "CA1051:Do not declare visible instance fields", Justification = "Unity Convention")]
 [SuppressMessage("StyleCop.CSharp.NamingRules", "SA1307:Accessible fields should begin with upper-case letter", Justification = "Unity Convention")]
@@ -34,9 +34,9 @@ public class CustomPlayerMenu(IntPtr il2CppPtr) : Minigame(il2CppPtr)
    public List<ShapeshifterPanel> potentialVictims;

    /// <summary>
-    /// Creates a CustomPlayerMenu.
+    /// Creates a <see cref="CustomPlayerMenu"/>.
    /// </summary>
-    /// <returns>New CustomPlayerMenu object.</returns>
+    /// <returns>New <see cref="CustomPlayerMenu"/> object.</returns>
    public static CustomPlayerMenu Create()
    {
        var shapeShifterRole = RoleManager.Instance.GetRole(RoleTypes.Shapeshifter);
@@ -84,7 +84,7 @@ public class CustomPlayerMenu(IntPtr il2CppPtr) : Minigame(il2CppPtr)
    /// Begins/opens the custom player menu.
    /// </summary>
    /// <param name="playerMatch">Function to determine if player should show in the custom menu.</param>
-    /// <param name="onClick">Onclick action for player.</param>
+    /// <param name="onClick"><see cref="PassiveButton.OnClick"/> action for player.</param>
    [HideFromIl2Cpp]
    public void Begin(Func<PlayerControl, bool> playerMatch, Action<PlayerControl?> onClick)
    {
@@ -96,7 +96,7 @@ public class CustomPlayerMenu(IntPtr il2CppPtr) : Minigame(il2CppPtr)
            onClick(null);
        }));

-        DestroyableSingleton<DebugAnalytics>.Instance.Analytics.MinigameOpened(PlayerControl.LocalPlayer.Data, TaskType);
+        DebugAnalytics.Instance.Analytics.MinigameOpened(PlayerControl.LocalPlayer.Data, TaskType);
        var list = PlayerControl.AllPlayerControls.ToArray().Where(playerMatch).ToList();
        potentialVictims = [];
        var list2 = new Il2CppSystem.Collections.Generic.List<UiElement>();
@@ -1,12 +1,11 @@
 using System.Linq;
 using HarmonyLib;
-using Reactor.Utilities.Extensions;
 using UnityEngine;

 namespace MiraAPI.Hud;

 /// <summary>
-/// Custom action button that has multiple target objects.
+/// <see cref="CustomActionButton"/> that has multiple target objects.
 /// </summary>
 /// <typeparam name="T">The type of the target objects.</typeparam>
 public abstract class MultiTargetButton<T> : CustomActionButton where T : MonoBehaviour
@@ -36,8 +35,11 @@ public abstract class MultiTargetButton<T> : CustomActionButton where T : MonoBe
    /// <returns>The list of target objects.</returns>
    public abstract T[] GetTargets();

-    /// <inheritdoc cref="CustomActionButton{T}.SetOutline"/>
-    /// <param name="target">The target object to set the oultine.</param>
+    /// <summary>
+    /// Sets the outline of the target <typeparamref name="T"/>.
+    /// </summary>
+    /// <param name="target">The target <typeparamref name="T"/> to set the oultine.</param>
+    /// <param name="active">Should the outline be active.</param>
    public abstract void SetOutline(T target, bool active);

    /// <inheritdoc cref="CustomActionButton{T}.CanUse"/>
@@ -14,7 +14,7 @@ public class BaseKeybind
    public InputAction? RewiredInputAction { get; internal set; }

    /// <summary>
-    /// Gets the unique identifier for this keybind. Used in Rewired.
+    /// Gets or sets the unique identifier for this keybind. Used in Rewired.
    /// </summary>
    public string Id { get; protected set; }

@@ -3,18 +3,17 @@ using System.Collections.Generic;
 using System.Linq;
 using Il2CppInterop.Runtime.Attributes;
 using MiraAPI.Utilities;
-using Reactor.Utilities;
 using Rewired;

 namespace MiraAPI.Keybinds;

 /// <summary>
-/// Lets you register and manage mod keybinds with conflict checks and rebinding support.
+/// Lets you register and manage mod <see cref="MiraKeybind"/>s with conflict checks and rebinding support.
 /// </summary>
 public static class KeybindManager
 {
    /// <summary>
-    /// Gets a list of all registered keybinds.
+    /// Gets a list of all registered <see cref="MiraKeybind"/>s.
    /// </summary>
    public static List<MiraKeybind> Keybinds { get; } = new();

@@ -49,7 +48,7 @@ public static class KeybindManager
    }

    /// <summary>
-    /// Returns all conflicts where keybinds use the same key.
+    /// Returns all conflicts where <see cref="MiraKeybind"/>s use the same key.
    /// </summary>
    /// <returns>A list of pairs of keybinds that conflict.</returns>
    public static Dictionary<KeyboardKeyCode, List<MiraKeybind>> GetConflicts()
@@ -77,11 +76,11 @@ public static class KeybindManager
    }

    /// <summary>
-    /// Returns all keybinds for a specified keycode.
+    /// Returns all <see cref="MiraKeybind"/>s for a specified keycode.
    /// </summary>
    /// <param name="keyCode">The key to look for.</param>
    /// /// <param name="exclusiveCheck">Should only exlusive keybinds be present.</param>
-    /// <returns>The list of keybinds.</returns>
+    /// <returns>The list of <see cref="MiraKeybind"/>s.</returns>
    public static MiraKeybind[] GetKeybindsForKey(KeyboardKeyCode keyCode, bool exclusiveCheck = false)
    {
        var all = new List<MiraKeybind>();
@@ -14,9 +14,9 @@ public static class KeybindUtils
    public static InputManager_Base? RewiredInputManager { get; internal set; }

    /// <summary>
-    /// Returns the currently assigned keycode of a keybind.
+    /// Returns the currently assigned keycode of a <see cref="BaseKeybind"/>.
    /// </summary>
-    /// <param name="keybind">The keybind to get the keycode from.</param>
+    /// <param name="keybind">The <see cref="BaseKeybind"/> to get the keycode from.</param>
    /// <returns>The currently assigned keycode.</returns>
    public static KeyboardKeyCode GetKeycodeByKeybind(BaseKeybind keybind)
    {
@@ -29,7 +29,7 @@ public static class KeybindUtils
    }

    /// <summary>
-    /// Gets the keycode for an action with ReInput.
+    /// Gets the keycode for an action with <see cref="ReInput"/>.
    /// </summary>
    /// <param name="actionId">The action ID.</param>
    /// <returns>The keyboard keycode.</returns>
@@ -39,7 +39,7 @@ public static class KeybindUtils
    }

    /// <summary>
-    /// Gets a <see cref="ActionElementMap"/> by id with ReInput.
+    /// Gets a <see cref="ActionElementMap"/> by id with <see cref="ReInput"/>.
    /// </summary>
    /// <param name="actionId">The action ID.</param>
    /// <returns>The keyboard keycode.</returns>
@@ -65,7 +65,7 @@ public static class KeybindUtils
    /// <param name="exclude">The KeyCode to skip during the search.</param>
    /// <returns>
    /// The first available KeyCode not currently used by any registered keybind,
-    /// or KeyCode.None if none are available.
+    /// or <see cref="KeyboardKeyCode.None"/> if none are available.
    /// </returns>
    public static KeyboardKeyCode FindAvailableKey(KeyboardKeyCode exclude)
    {
@@ -3,7 +3,7 @@
 namespace MiraAPI.Keybinds;

 /// <summary>
-/// Class containing all default keybinds.
+/// Class containing all default <see cref="MiraKeybind"/>s.
 /// Recommended for cross-mod compatibility.
 /// </summary>
 [RegisterCustomKeybinds]
@@ -19,8 +19,8 @@ public class MiraKeybind : BaseKeybind
    public KeyboardKeyCode DefaultKey { get; }

    /// <summary>
-    /// Gets the modifier keys assigned to this keybind.
-    /// Due to Rewired limitations, there can only be 3 modifier keys.
+    /// Gets the <see cref="ModifierKey"/>s assigned to this keybind.
+    /// Due to Rewired limitations, there can only be 3 <see cref="ModifierKey"/>s.
    /// </summary>
    public ModifierKey[] ModifierKeys { get; }

@@ -36,7 +36,7 @@ public class MiraKeybind : BaseKeybind
    /// </summary>
    /// <param name="name">The name of the keybind.</param>
    /// <param name="defaultKeycode">The default keycode.</param>
-    /// <param name="modifierKeys">Up to 3 optional modifier keys.</param>
+    /// <param name="modifierKeys">Up to 3 optional <see cref="ModifierKey"/>s.</param>
    /// <param name="exclusive">Is exclusive.</param>
    public MiraKeybind(
        string name,
@@ -3,7 +3,7 @@
 namespace MiraAPI.Keybinds;

 /// <summary>
-/// Used to mark a class for custom keybinds registration.
+/// Used to mark a class for <see cref="MiraKeybind"/>s registration.
 /// </summary>
 [AttributeUsage(AttributeTargets.Class)]
 public class RegisterCustomKeybindsAttribute : Attribute;
@@ -1,4 +1,4 @@
-using Rewired;
+using System.Globalization;

 namespace MiraAPI.Keybinds;

@@ -19,6 +19,6 @@ public class VanillaKeybind : BaseKeybind
    public VanillaKeybind(int id)
    {
        RewiredInputAction = KeybindUtils.GetInputActionById(id);
-        Id = RewiredInputAction != null ? RewiredInputAction.name : id.ToString();
+        Id = RewiredInputAction != null ? RewiredInputAction.name : id.ToString(CultureInfo.InvariantCulture);
    }
 }
@@ -1,15 +1,15 @@
 namespace MiraAPI.Keybinds;

 /// <summary>
-/// Singleton for getting a vanilla keybind by <see cref="ActionButton"/>.
+/// Singleton for getting a <see cref="VanillaKeybind"/> by <see cref="ActionButton"/>.
 /// </summary>
-/// <typeparam name="T">ActionButton type.</typeparam>
+/// <typeparam name="T"><see cref="AccountButton"/> type.</typeparam>
 public static class VanillaKeybinding<T> where T : ActionButton
 {
    private static VanillaKeybind? _instance;

    /// <summary>
-    /// Gets the instance of the option group.
+    /// Gets the instance of the <see cref="VanillaKeybind"/>.
    /// </summary>
 #pragma warning disable CA1000
    public static VanillaKeybind Instance => _instance ??= KeybindManager.VanillaKeybinds[typeof(T)];
@@ -5,9 +5,9 @@ using MiraAPI.LocalSettings.SettingTypes;
 namespace MiraAPI.LocalSettings.Attributes;

 /// <summary>
-/// Creates an enum setting for the <see cref="ConfigEntry{T}"/>.
+/// Creates a <see cref="LocalEnumSetting"/> for the <see cref="ConfigEntry{T}"/>.
 /// </summary>
-/// <param name="names">Optional custom enum names.</param>
+/// <param name="names">Optional custom <see langword="enum"/> names.</param>
 /// <inheritdoc/>
 [AttributeUsage(AttributeTargets.Property)]
 public class LocalEnumSettingAttribute(
@@ -6,7 +6,7 @@ using MiraAPI.Utilities;
 namespace MiraAPI.LocalSettings.Attributes;

 /// <summary>
-/// Creates a number setting for the <see cref="ConfigEntry{T}"/>.
+/// Creates a <see cref="LocalNumberSetting"/> for the <see cref="ConfigEntry{T}"/>.
 /// </summary>
 /// <param name="min">Minimum range.</param>
 /// <param name="max">Maximum range.</param>
@@ -15,10 +15,10 @@ public abstract class LocalSettingAttribute(
    ) : Attribute
 {
    /// <summary>
-    /// Returns the created setting object.
+    /// Returns the created <see cref="ILocalSetting"/> object.
    /// </summary>
    /// <param name="tab">Gets the tab where the setting is located.</param>
    /// <param name="configEntryBase">Gets the config entry the setting is attached to.</param>
-    /// <returns>The created class.</returns>
+    /// <returns>The created <see cref="ILocalSetting"/>.</returns>
    public abstract ILocalSetting CreateSetting(Type tab, ConfigEntryBase configEntryBase);
 }
@@ -1,5 +1,4 @@
 using System;
-using BepInEx.Configuration;

 namespace MiraAPI.LocalSettings.Attributes;

@@ -6,7 +6,7 @@ using MiraAPI.Utilities;
 namespace MiraAPI.LocalSettings.Attributes;

 /// <summary>
-/// Creates a slider setting for the <see cref="ConfigEntry{T}"/>.
+/// Creates a <see cref="LocalSliderSetting"/> for the <see cref="ConfigEntry{T}"/>.
 /// </summary>
 /// <inheritdoc/>
 /// <param name="min">Minimum range.</param>
@@ -5,7 +5,7 @@ using MiraAPI.LocalSettings.SettingTypes;
 namespace MiraAPI.LocalSettings.Attributes;

 /// <summary>
-/// Creates a toggle setting for the <see cref="ConfigEntry{T}"/>.
+/// Creates a <see cref="LocalToggleSetting"/> for the <see cref="ConfigEntry{T}"/>.
 /// </summary>
 /// <inheritdoc/>
 [AttributeUsage(AttributeTargets.Property)]
@@ -19,7 +19,7 @@ public interface ILocalSetting
    string Description { get; }

    /// <summary>
-    /// Gets the setting's gameobject.
+    /// Gets the setting's <see cref="GameObject"/>.
    /// </summary>
    GameObject? Setting { get; }

@@ -31,12 +31,12 @@ public interface ILocalSetting
    /// <summary>
    /// Used to create the setting.
    /// </summary>
-    /// <param name="toggle">Toggle template.</param>
-    /// <param name="slider">Slider template.</param>
-    /// <param name="parent">The parent of the setting.</param>
+    /// <param name="toggle"><see cref="ToggleButtonBehaviour"/> template.</param>
+    /// <param name="slider"><see cref="SlideBar"/> template.</param>
+    /// <param name="parent">The parent <see cref="Transform"/> of the setting.</param>
    /// <param name="offset">The offset.</param>
    /// <param name="order">The order.</param>
    /// <param name="last">Whether it's the last on the row.</param>
-    /// <returns>The created setting.</returns>
+    /// <returns>The created setting's <see cref="GameObject"/>.</returns>
    GameObject? CreateOption(ToggleButtonBehaviour toggle, SlideBar slider, Transform parent, ref float offset, ref int order, bool last);
 }
@@ -1,6 +1,5 @@
 using System;
 using MiraAPI.Utilities;
-using Reactor.Localization.Utilities;
 using Reactor.Utilities.Extensions;
 using TMPro;
 using UnityEngine;
@@ -10,7 +9,7 @@ using Object = UnityEngine.Object;
 namespace MiraAPI.LocalSettings;

 /// <summary>
-/// Represents a local settings button.
+/// Represents a <see cref="LocalSettingsTab"/> button.
 /// </summary>
 public class LocalSettingsButton(string text, Action onClick)
 {
@@ -25,7 +24,7 @@ public class LocalSettingsButton(string text, Action onClick)
    public Action OnClick { get; set; } = onClick;

    /// <summary>
-    /// Gets the tab instance this button belongs to.
+    /// Gets the <see cref="LocalSettingsTab"/> instance this button belongs to.
    /// </summary>
    public LocalSettingsTab? Tab { get; internal set; }

@@ -2,18 +2,17 @@
 using System.Collections.Generic;
 using System.Reflection;
 using BepInEx.Unity.IL2CPP;
-using MiraAPI.GameOptions;
-using Reactor.Utilities;

 namespace MiraAPI.LocalSettings;

 /// <summary>
-/// Manages local settings.
+/// Manages <see cref="LocalSettingsTab"/>s.
 /// </summary>
 public static class LocalSettingsManager
 {
    internal static readonly Dictionary<Type, LocalSettingsTab> TypeToTab = [];
    internal static readonly List<LocalSettingsTab> Tabs = [];
+    internal static readonly List<LocalSettingsTab> AvailableTabs = [];

    internal static bool RegisterTab(Type type, BasePlugin pluginInfo)
    {
@@ -29,6 +28,10 @@ public static class LocalSettingsManager
        }

        Tabs.Add(tab);
+        if (tab.ShouldCreateButton)
+        {
+            AvailableTabs.Add(tab);
+        }
        TypeToTab.Add(type, tab);

        typeof(LocalSettingsTabSingleton<>).MakeGenericType(type)
@@ -23,7 +23,7 @@ public abstract class LocalSettingsTab(ConfigFile config)
    public abstract string TabName { get; }

    /// <summary>
-    /// Gets the tab appearance.
+    /// Gets the tab's <see cref="LocalSettingTabAppearance"/>.
    /// </summary>
    public virtual LocalSettingTabAppearance TabAppearance { get; } = new();

@@ -38,7 +38,7 @@ public abstract class LocalSettingsTab(ConfigFile config)
    protected virtual bool ShouldCreateLabels => true;

    /// <summary>
-    /// Gets the mod's config file. Automatically found in the plugin loader.
+    /// Gets the mod's <see cref="ConfigFile"/>. Automatically found in the plugin loader.
    /// </summary>
    public ConfigFile Config { get; } = config ?? throw new ArgumentNullException(nameof(config));

@@ -48,12 +48,12 @@ public abstract class LocalSettingsTab(ConfigFile config)
    public TabGroup? TabButton { get; internal set; }

    /// <summary>
-    /// Gets the list of settings.
+    /// Gets the list of <see cref="ILocalSetting"/>s.
    /// </summary>
    public List<ILocalSetting> Settings { get; } = [];

    /// <summary>
-    /// Gets the list of buttons.
+    /// Gets the list of <see cref="LocalSettingsButton"/>s.
    /// </summary>
    public List<LocalSettingsButton> Buttons { get; } = [];

@@ -4,93 +4,93 @@ using UnityEngine;
 namespace MiraAPI.LocalSettings;

 /// <summary>
-/// Struct for modifying tab appearance.
+/// Struct for modifying <see cref="LocalSettingsTab"/> appearance.
 /// Defines how the settings look.
 /// </summary>
 public record struct LocalSettingTabAppearance()
 {
    /// <summary>
-    /// Gets or sets main color of the tab.
+    /// Gets or sets the main <see cref="Color"/> of the <see cref="LocalSettingsTab"/>.
    /// </summary>
    public Color TabColor { get; set; } = Color.white;

    /// <summary>
-    /// Gets or sets tab button icon. No icon by default.
+    /// Gets or sets the <see cref="LocalSettingsTab"/> button icon. No icon by default.
    /// </summary>
    public LoadableAsset<Sprite>? TabIcon { get; set; }

    /// <summary>
-    /// Gets or sets color of the tab button.
+    /// Gets or sets the <see cref="Color"/> of the <see cref="LocalSettingsTab"/> button.
    /// </summary>
    public Color TabButtonColor { get; set; } = Color.white;

    /// <summary>
-    /// Gets or sets a value indicating whether the icon should be hidden when tab button is hovered.
+    /// Gets or sets a value indicating whether the icon should be hidden when the <see cref="LocalSettingsTab"/> button is hovered.
    /// </summary>
    public bool HideIconOnHover { get; set; } = true;

    /// <summary>
-    /// Gets or sets hover color of the tab button.
+    /// Gets or sets the hover <see cref="Color"/> of the <see cref="LocalSettingsTab"/> button.
    /// </summary>
    public Color TabButtonHoverColor { get; set; } = Palette.AcceptedGreen;

    /// <summary>
-    /// Gets or sets active color of the tab button.
+    /// Gets or sets the active <see cref="Color"/> of the <see cref="LocalSettingsTab"/> button.
    /// </summary>
    public Color TabButtonActiveColor { get; set; } = Palette.AcceptedGreen;

    /// <summary>
-    /// Gets or sets hover color of toggles.
+    /// Gets or sets the hover <see cref="Color"/> of <see cref="SettingTypes.LocalToggleSetting"/>s.
    /// </summary>
    public Color ToggleHoverColor { get; set; } = Palette.AcceptedGreen;

    /// <summary>
-    /// Gets or sets active color of toggles.
+    /// Gets or sets the active <see cref="Color"/> of <see cref="SettingTypes.LocalToggleSetting"/>s.
    /// </summary>
    public Color ToggleActiveColor { get; set; } = Palette.AcceptedGreen;

    /// <summary>
-    /// Gets or sets inactive color of toggles.
+    /// Gets or sets the inactive <see cref="Color"/> of <see cref="SettingTypes.LocalToggleSetting"/>s.
    /// </summary>
    public Color ToggleInactiveColor { get; set; } = Color.red;

    /// <summary>
-    /// Gets or sets color of number buttons.
+    /// Gets or sets the <see cref="Color"/> of <see cref="SettingTypes.LocalNumberSetting"/> buttons.
    /// </summary>
    public Color NumberColor { get; set; } = Color.white;

    /// <summary>
-    /// Gets or sets hover color of number buttons.
+    /// Gets or sets the hover <see cref="Color"/> of <see cref="SettingTypes.LocalNumberSetting"/> buttons.
    /// </summary>
    public Color NumberHoverColor { get; set; } = Palette.AcceptedGreen;

    /// <summary>
-    /// Gets or sets color of sliders.
+    /// Gets or sets the <see cref="Color"/> of <see cref="SettingTypes.LocalSliderSetting"/>s.
    /// </summary>
    public Color SliderColor { get; set; } = Color.white;

    /// <summary>
-    /// Gets or sets hover color of sliders.
+    /// Gets or sets the hover <see cref="Color"/> of <see cref="SettingTypes.LocalSliderSetting"/>s.
    /// </summary>
    public Color SliderHoverColor { get; set; } = Palette.AcceptedGreen;

    /// <summary>
-    /// Gets or sets color of enum buttons.
+    /// Gets or sets the <see cref="Color"/> of <see cref="SettingTypes.LocalEnumSetting"/> buttons.
    /// </summary>
    public Color EnumColor { get; set; } = Color.white;

    /// <summary>
-    /// Gets or sets hover color of enum buttons.
+    /// Gets or sets the hover <see cref="Color"/> of <see cref="SettingTypes.LocalEnumSetting"/> buttons.
    /// </summary>
    public Color EnumHoverColor { get; set; } = Palette.AcceptedGreen;

    /// <summary>
-    /// Gets or sets color of buttons.
+    /// Gets or sets the <see cref="Color"/> of buttons.
    /// </summary>
    public Color ButtonColor { get; set; } = Color.white;

    /// <summary>
-    /// Gets or sets hover color of buttons.
+    /// Gets or sets the hover <see cref="Color"/> of buttons.
    /// </summary>
    public Color ButtonHoverColor { get; set; } = Palette.AcceptedGreen;
 }
@@ -3,7 +3,7 @@
 namespace MiraAPI.LocalSettings;

 /// <summary>
-/// Singleton for local settings tabs.
+/// Singleton for <see cref="LocalSettingsTab"/>s.
 /// </summary>
 /// <typeparam name="T">The settings tab type.</typeparam>
 public static class LocalSettingsTabSingleton<T> where T : LocalSettingsTab
@@ -11,7 +11,7 @@ public static class LocalSettingsTabSingleton<T> where T : LocalSettingsTab
    private static T? _instance;

    /// <summary>
-    /// Gets the instance of the setting tab.
+    /// Gets the instance of the <typeparamref name="T"/> setting tab.
    /// </summary>
 #pragma warning disable CA1000
    public static T Instance => _instance ??= LocalSettingsManager.Tabs.OfType<T>().Single();
@@ -11,17 +11,17 @@ using Object = UnityEngine.Object;
 namespace MiraAPI.LocalSettings.SettingTypes;

 /// <summary>
-/// Local setting class for enums.
+/// Local setting class for <see langword="enum"/>s.
 /// </summary>
 public class LocalEnumSetting : LocalSettingBase<int>
 {
    /// <summary>
-    /// Gets the enum type of the setting.
+    /// Gets the <see cref="Enum"/> type of the setting.
    /// </summary>
    public Type EnumType { get; }

    /// <summary>
-    /// Gets the enum values.
+    /// Gets the <see langword="enum"/> values.
    /// </summary>
    public string[] Values { get; }

@@ -29,8 +29,8 @@ public class LocalEnumSetting : LocalSettingBase<int>
    /// Initializes a new instance of the <see cref="LocalEnumSetting"/> class.
    /// </summary>
    /// <inheritdoc/>
-    /// <param name="enumType">The enum type.</param>
-    /// <param name="values">The optional values array to replace the enum names.</param>
+    /// <param name="enumType">The <see cref="Enum"/> type.</param>
+    /// <param name="values">The optional values array to replace the <see langword="enum"/> names.</param>
    public LocalEnumSetting(
        Type tab,
        ConfigEntryBase configEntry,
@@ -43,6 +43,12 @@ public abstract class LocalSettingBase<T> : ILocalSetting
    /// <summary>
    /// Creates an instance of the setting.
    /// </summary>
+    /// <param name="toggle">Toggle option to create.</param>
+    /// <param name="slider">Slider option to create.</param>
+    /// <param name="parent">The parent options menu.</param>
+    /// <param name="offset">the Y Offset for the option in the menu.</param>
+    /// <param name="order">The order of the option.</param>
+    /// <param name="last">Whether the option is the last in a row.</param>
    /// <returns>The created setting.</returns>
    public abstract GameObject CreateOption(ToggleButtonBehaviour toggle, SlideBar slider, Transform parent, ref float offset, ref int order, bool last);

@@ -56,9 +62,9 @@ public abstract class LocalSettingBase<T> : ILocalSetting
    }

    /// <summary>
-    /// Gets the value of the config entry, cast to the setting type.
+    /// Gets the value of the config entry, cast to <typeparamref name="T"/>.
    /// </summary>
-    /// <returns>The value.</returns>
+    /// <returns>The <typeparamref name="T"/> value.</returns>
    public virtual T GetValue()
    {
        return (T)ConfigEntry.BoxedValue;
@@ -9,7 +9,7 @@ using UnityEngine;
 namespace MiraAPI;

 /// <summary>
-/// Mira API Config File Handler.
+/// Mira API <see cref="ConfigFile"/> Handler.
 /// </summary>
 public class MiraApiSettings(ConfigFile config) : LocalSettingsTab(config)
 {
@@ -17,8 +17,8 @@ public static class ModCompatibility
    /// <summary>
    /// Checks if the Submerged mod is loaded.
    /// </summary>
-    /// <param name="submergedAssembly">Submerged mod assembly if loaded, null otherwise.</param>
-    /// <returns>True if the Submerged mod is loaded, false otherwise.</returns>
+    /// <param name="submergedAssembly">Submerged mod assembly if loaded, <see langword="null"/> otherwise.</param>
+    /// <returns><see langword="true"/> if the Submerged mod is loaded, <see langword="false"/> otherwise.</returns>
    public static bool SubmergedLoaded([NotNullWhen(true)] out Assembly? submergedAssembly)
    {
        var result = IL2CPPChainloader.Instance.Plugins.TryGetValue(SubmergedId, out var plugin);
@@ -1,10 +1,10 @@
 namespace MiraAPI.Modifiers;

 /// <summary>
-/// Represents the assignment configuration for a game modifier.
+/// Represents the assignment configuration for a <see cref="Types.GameModifier"/>.
 /// </summary>
-/// <param name="DefaultAmount">The default amount of players that can have this modifier in a game.</param>
-/// <param name="DefaultChance">The default chance of the modifier being assigned to a player.</param>
-/// <param name="CreateAmountOption">Whether Mira should create an amount option for the modifier.</param>
-/// <param name="CreateChanceOption">Whether Mira should create a chance option for the modifier.</param>
+/// <param name="DefaultAmount">The default amount of players that can have this <see cref="Types.GameModifier"/> in a game.</param>
+/// <param name="DefaultChance">The default chance of the <see cref="Types.GameModifier"/> being assigned to a player.</param>
+/// <param name="CreateAmountOption">Whether Mira should create an amount option for the <see cref="Types.GameModifier"/>.</param>
+/// <param name="CreateChanceOption">Whether Mira should create a chance option for the <see cref="Types.GameModifier"/>.</param>
 public record struct AssignmentConfiguration(int DefaultAmount, int DefaultChance, bool CreateAmountOption, bool CreateChanceOption);
Author	SHA1	Message	Date
Atony	840761787f	Merge pull request #97 from All-Of-Us-Mods/dev MiraAPI 0.4.3	2026-08-06 18:29:35 -05:00
Atony	615d527c86	Merge branch 'master' into dev	2026-08-06 18:25:58 -05:00
Atony	7628a41d86	Adjust tab count + text	2026-08-06 17:50:25 -05:00
XtraCube	63d1003b2b	fix role scroll issues	2026-08-05 15:08:58 -04:00
Atony	0645c32cca	Add tmp sprite todo comment	2026-08-05 13:39:43 -05:00
Atony	8beabb20a2	Bump version	2026-08-05 12:19:10 -05:00
Atony	3f28d70308	Fix errors every time role options are opened	2026-08-05 12:18:36 -05:00
Atony	b919c55ef1	Fix advanced role settings being unscrollable	2026-08-05 11:55:30 -05:00
XtraCube	55a2161876	get rid of field warning	2026-08-04 00:04:13 -04:00
XtraCube	4ca2249fbd	options patches overhaul	2026-08-04 00:01:21 -04:00
Atony	fc94c8e67e	Bump version	2026-08-02 20:13:16 -05:00
Atony	83e550c1f2	Merge pull request #96 from All-Of-Us-Mods/dev MiraAPI 0.4.2	2026-08-02 20:11:59 -05:00
Atony	edee889ffe	Fix hidden local tabs breaking the menu	2026-07-30 23:15:24 -05:00
Atony	8c5aee4beb	Fix vanilla roles tab being broken	2026-07-26 11:56:21 -05:00
Atony	30a39fa223	Add DisplayOnOptionsMenu for mira api mods	2026-07-26 11:12:28 -05:00
Atony	228ed9711a	Add mod name abbreviation	2026-07-26 11:05:13 -05:00
Atony	7c085b1072	Add modifier post assignment-check	2026-07-25 18:03:29 -05:00
Atony	8750e5c894	Reorder modifier validity checks	2026-07-25 17:20:14 -05:00
XtraCube	1b40b1c5e4	attempt to improve gc behavior	2026-07-20 20:23:38 -04:00
XtraCube	0a0ad74419	improve GC collection	2026-07-20 20:02:29 -04:00
XtraCube	992bdbcbf8	cleanup usings	2026-07-20 19:10:06 -04:00
XtraCube	f9721a8d69	improve stability and FPS on 17.4+	2026-07-20 19:06:52 -04:00
XtraCube	e541840da9	improve lag issues in settings menu on 17.4	2026-07-20 16:35:52 -04:00
Atony	eb18d82d8e	Allow overriding configuration on modded option	2026-07-17 21:34:10 -05:00
Atony	7afd899e56	Improve example options	2026-07-17 15:47:53 -05:00
Atony	5cccc192b1	Add support for better option notfs	2026-07-17 15:07:40 -05:00
Atony	9d7e41a3c9	Fix duplicated Populate Results Event	2026-07-09 23:03:02 -05:00
Atony	662b52f78d	Allow populated votes to be modified	2026-07-09 22:57:59 -05:00
Atony	dac1d82d5c	Reduce heavy garbage collection temporarily	2026-07-09 22:57:31 -05:00
Atony	1b718092ee	Move GC clearing out of coroutines	2026-07-08 18:13:34 -05:00
Atony	3eb0a4fdb3	Fix some instant crashing Happens very quickly on practice mode when spam switching tasks	2026-07-08 17:31:20 -05:00
Atony	850e82155c	Improve tmp offsets	2026-07-01 23:39:57 -05:00
Atony	ff30d5fdd6	Add tmp sprite scaling support	2026-07-01 20:30:44 -05:00
Atony	2eecba2e51	Add TMP icon support for roles	2026-07-01 19:57:29 -05:00
Atony	84321f290e	Fix game option checks	2026-06-30 16:25:53 -05:00
Atony	d8d3cc202a	Merge pull request #94 from All-Of-Us-Mods/dev MiraAPI v0.4.1	2026-06-29 09:22:38 -05:00
Atony	e08e7e5f4b	Merge branch 'master' into dev	2026-06-29 09:22:03 -05:00
Atony	a5f0ed5975	Bump version	2026-06-29 09:13:24 -05:00
Atony	d1f5e56cb9	Merge pull request #93 from TheDavSmasher/documentation-improvement Documentation improvement	2026-06-29 09:12:15 -05:00
Atony	127e3f600e	Fix misc warnings	2026-06-29 09:05:35 -05:00
Atony	47e02d3dcf	Add documentation for menu categories	2026-06-29 08:47:21 -05:00
Atony	f53e4fdc38	Add more option documentation	2026-06-29 08:44:56 -05:00
Atony	b1f0ec6da3	Fix settings button breaking	2026-06-28 21:15:30 -05:00
Atony	d0d5056e39	Fix hat tab being severely broken on v17.4	2026-06-28 20:30:28 -05:00
Atony	57e3f20cba	Improve role option garbage collection further	2026-06-27 21:00:57 -05:00
David Higueros	7fdfd506e0	Added missing method cref	2026-06-23 21:18:05 -06:00
David Higueros	edf61e722f	Updated added method	2026-06-23 21:17:43 -06:00
David Higueros	791daa08ad	Merge branch 'dev' into documentation-improvement	2026-06-23 21:08:22 -06:00
David Higueros	e4d2509895	Added href tags for links	2026-06-23 21:01:45 -06:00
David Higueros	62c8e27535	Fixed annotations with double > annotations	2026-06-23 20:55:47 -06:00
David Higueros	8852c014ab	Replaced true, false, and null with langword annotations	2026-06-23 20:54:23 -06:00
David Higueros	adb9a2823d	Updated docstrings to reference classes, fields, and methods directly	2026-06-23 20:43:32 -06:00
Atony	ff658db6f1	Remove destroyable singletons	2026-06-20 15:08:22 -05:00
Atony	750e00d06d	Run GC when destroying multiple objects	2026-06-20 14:53:45 -05:00
Atony	3a5a397846	Only run gc when using v17.4	2026-06-20 14:28:08 -05:00
David Higueros	c846109d07	Changed to use obsolete annotation	2026-06-19 17:07:31 -06:00
Atony	e3b0eb68c0	Temporary measures for clearing up memory leaks	2026-06-12 18:03:13 -05:00
amber	90921ff786	Remove UseVanillaVentButton as it's unnecessary	2026-06-11 22:37:10 -04:00
amber	c1d0bb5d26	Seperate vanilla vent data receiving from the actual button	2026-06-11 22:34:27 -04:00
Atony	c59ed8eaa6	Fix screenshake within options menu	2026-05-31 09:17:26 -05:00
Atony	d2fafc3650	Fix errors in How to Play menu	2026-05-04 09:55:37 -05:00
Atony	0c0157fed2	Add soft-support for Corsac Cosmetics	2026-05-04 07:43:53 -05:00
Atony	90bf402cbc	Fix UI resizing with the top right buttons	2026-05-03 11:57:04 -05:00