Begin teams ig

.editorconfig

@@ -1 +0,0 @@
-[*.{cs,vb}]

.github/workflows/main.yaml

@@ -1,51 +0,0 @@
-name: CI
-
-on: ["workflow_dispatch", "push", "pull_request"]
-
-jobs:
-  build:
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: true
-
-      - uses: actions/cache@v4
-        with:
-          path: |
-            ~/.nuget/packages
-            ~/.cache/bepinex
-          key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json') }}
-          restore-keys: |
-            ${{ runner.os }}-nuget-
-
-      - name: Setup .NET
-        uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: 8.0.x
-
-      - name: Run the Cake script
-        uses: cake-build/cake-action@v2
-        with:
-          verbosity: Diagnostic
-
-      - uses: actions/upload-artifact@v4
-        with:
-          name: MiraAPI.dll
-          path: MiraAPI/bin/Release/net6.0/MiraAPI.dll
-
-      - uses: actions/upload-artifact@v4
-        with:
-          name: AllOfUs.MiraAPI.nupkg
-          path: MiraAPI/bin/Release/AllOfUs.MiraAPI.*.nupkg
-          
-      - uses: softprops/action-gh-release@v2
-        if: github.ref_type == 'tag'
-        with:
-          draft: true
-          files: MiraAPI/bin/Release/net6.0/MiraAPI.dll
-          
-      - name: Push NuGet package
-        if: github.ref_type == 'tag'
-        run: |
-          dotnet nuget push MiraAPI/bin/Release/AllOfUs.MiraAPI.*.nupkg --source https://api.nuget.org/v3/index.json --api-key ${{ secrets.NUGET_API_KEY }}

.gitignore

@@ -3,7 +3,5 @@
 .vs/
 obj/
 bin/
-.qodo/
 
-*.user
-*.lock.json
+*.user

AmongUs.props

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

Directory.Build.props

@@ -1,45 +0,0 @@
-<Project>
-    <PropertyGroup>
-        <TargetFramework>net6.0</TargetFramework>
-        <LangVersion>latest</LangVersion>
-        <DebugType>embedded</DebugType>
-        <Nullable>enable</Nullable>
-        <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
-
-        <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
-
-        <VersionPrefix>0.3.0</VersionPrefix>
-        <VersionSuffix>dev</VersionSuffix>
-
-        <Authors>All Of Us, XtraCube, Angxl</Authors>
-        <Company>All Of Us</Company>
-        <RepositoryType>git</RepositoryType>
-        <RepositoryUrl>https://github.com/All-Of-Us-Mods/MiraAPI</RepositoryUrl>
-        <PackageLicenseExpression>LGPL-2.1-or-later</PackageLicenseExpression>
-
-        <!-- SourceLink -->
-        <EmbedUntrackedSources>true</EmbedUntrackedSources>
-        <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
-        <ContinuousIntegrationBuild Condition="'$(GITHUB_ACTIONS)' == 'true'">true</ContinuousIntegrationBuild>
-    </PropertyGroup>
-
-    <PropertyGroup>
-        <EnableNETAnalyzers>true</EnableNETAnalyzers>
-        <AnalysisLevel>latest</AnalysisLevel>
-        <AnalysisMode>recommended</AnalysisMode>
-        <EnforceCodeStyleInBuild>true</EnforceCodeStyleInBuild>
-    </PropertyGroup>
-
-    <ItemGroup>
-        <PackageReference Include="StyleCop.Analyzers" Version="1.2.0-beta.556" PrivateAssets="all" />
-        <AdditionalFiles Include="$(MSBuildThisFileDirectory)\stylecop.json" Link="stylecop.json" Visible="false" />
-
-        <PackageReference Include="SonarAnalyzer.CSharp" Version="10.7.0.110445">
-            <PrivateAssets>all</PrivateAssets>
-            <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
-        </PackageReference>
-    </ItemGroup>
-    <PropertyGroup>
-        <CodeAnalysisRuleSet>$(MSBuildThisFileDirectory)\stylecop.ruleset</CodeAnalysisRuleSet>
-    </PropertyGroup>
-</Project>

MiraAPI.Example/Buttons/ExampleButton.cs

@@ -0,0 +1,26 @@
+using MiraAPI.Hud;
+using MiraAPI.Utilities.Assets;
+using Reactor.Utilities;
+using UnityEngine;
+
+namespace MiraAPI.Example.Buttons;
+
+[RegisterButton]
+public class ExampleButton : CustomActionButton
+{
+    public override string Name => "Example Button";
+    public override float Cooldown => 5f;
+    public override float EffectDuration => 0f;
+    public override int MaxUses => 5;
+    public override LoadableAsset<Sprite> Sprite { get; } = ExampleAssets.ExampleButton;
+    
+    protected override void OnClick()
+    {
+        Logger<ExamplePlugin>.Info("Example button clicked!");
+    }
+
+    public override bool Enabled(RoleBehaviour role)
+    {
+        return true;
+    }
+}

MiraAPI.Example/Buttons/Freezer/FreezeButton.cs

@@ -1,48 +0,0 @@
-using MiraAPI.Example.Modifiers.Freezer;
-using MiraAPI.Example.Options.Roles;
-using MiraAPI.Example.Roles;
-using MiraAPI.GameOptions;
-using MiraAPI.Hud;
-using MiraAPI.Keybinds;
-using MiraAPI.Modifiers;
-using MiraAPI.Utilities;
-using MiraAPI.Utilities.Assets;
-using UnityEngine;
-
-namespace MiraAPI.Example.Buttons.Freezer;
-
-public class FreezeButton : CustomActionButton<PlayerControl>
-{
-    public override string Name => "Freeze";
-
-    public override float Cooldown => OptionGroupSingleton<FreezerRoleSettings>.Instance.FreezeDuration;
-    public override bool PauseTimerInVent => true;
-
-    public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
-    public override MiraKeybind? Keybind => MiraGlobalKeybinds.PrimaryAbility;
-
-    protected override void OnClick()
-    {
-        Target?.RpcAddModifier<FreezeModifier>();
-    }
-
-    public override PlayerControl? GetTarget()
-    {
-        return PlayerControl.LocalPlayer.GetClosestPlayer(true, Distance);
-    }
-
-    public override void SetOutline(bool active)
-    {
-        Target?.cosmetics.SetOutline(active, new Il2CppSystem.Nullable<Color>(Palette.Blue));
-    }
-
-    public override bool IsTargetValid(PlayerControl? target)
-    {
-        return true;
-    }
-
-    public override bool Enabled(RoleBehaviour? role)
-    {
-        return role is FreezerRole;
-    }
-}

MiraAPI.Example/Buttons/MeetingButton.cs

@@ -1,47 +0,0 @@
-using MiraAPI.Example.Modifiers;
-using MiraAPI.Hud;
-using MiraAPI.Keybinds;
-using MiraAPI.Modifiers;
-using MiraAPI.Utilities.Assets;
-using UnityEngine;
-
-namespace MiraAPI.Example.Buttons;
-
-public class MeetingButton : CustomActionButton
-{
-    public override string Name => "Call Meeting";
-
-    public override float Cooldown => 15;
-
-    public override int MaxUses => 3;
-
-    public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
-    public override MiraKeybind? Keybind => MiraGlobalKeybinds.ModifierPrimaryAbility;
-
-    public override bool Enabled(RoleBehaviour? role)
-    {
-        return PlayerControl.LocalPlayer != null && PlayerControl.LocalPlayer.HasModifier<CaptainModifier>();
-    }
-
-    protected override void OnClick()
-    {
-        var bt = ShipStatus.Instance.EmergencyButton;
-
-        PlayerControl.LocalPlayer.NetTransform.Halt();
-        var minigame = Object.Instantiate(bt.MinigamePrefab, Camera.main!.transform, false);
-
-        var taskAdderGame = minigame as TaskAdderGame;
-        if (taskAdderGame != null)
-        {
-            taskAdderGame.SafePositionWorld = bt.SafePositionLocal + (Vector2)bt.transform.position;
-        }
-
-        minigame.transform.localPosition = new Vector3(0f, 0f, -50f);
-        minigame.Begin(null);
-
-        if (UsesLeft == 0 && PlayerControl.LocalPlayer.HasModifier<CaptainModifier>())
-        {
-            PlayerControl.LocalPlayer.RpcRemoveModifier<CaptainModifier>();
-        }
-    }
-}

MiraAPI.Example/Buttons/NeutralKillerButton.cs

@@ -1,27 +0,0 @@
-using MiraAPI.Example.GameOver;
-using MiraAPI.Example.Roles;
-using MiraAPI.GameEnd;
-using MiraAPI.Hud;
-using MiraAPI.Keybinds;
-using MiraAPI.Utilities.Assets;
-using UnityEngine;
-
-namespace MiraAPI.Example.Buttons;
-
-public class NeutralKillerButton : CustomActionButton
-{
-    public override string Name => "Win Game";
-    public override float Cooldown => 0f;
-    public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
-    public override MiraKeybind Keybind => ExampleKeybinds.NeutralWinKeybind;
-
-    protected override void OnClick()
-    {
-        CustomGameOver.Trigger<NeutralKillerGameOver>([PlayerControl.LocalPlayer.Data]);
-    }
-
-    public override bool Enabled(RoleBehaviour? role)
-    {
-        return role is NeutralKillerRole;
-    }
-}

MiraAPI.Example/Buttons/Teleporter/TeleportButton.cs

@@ -1,89 +0,0 @@
-using System.Collections;
-using MiraAPI.Example.Options.Roles;
-using MiraAPI.Example.Roles;
-using MiraAPI.GameOptions;
-using MiraAPI.Hud;
-using MiraAPI.Keybinds;
-using MiraAPI.Utilities.Assets;
-using Reactor.Utilities;
-using UnityEngine;
-
-namespace MiraAPI.Example.Buttons.Teleporter;
-
-public class TeleportButton : CustomActionButton
-{
-    public override string Name => "Teleport";
-
-    public override float Cooldown => OptionGroupSingleton<TeleporterOptions>.Instance.TeleportCooldown.Value;
-
-    public override float EffectDuration => OptionGroupSingleton<TeleporterOptions>.Instance.TeleportDuration;
-    public override int MaxUses => 2;
-
-    public override LoadableAsset<Sprite> Sprite => ExampleAssets.TeleportButton;
-    public override Color TextOutlineColor => new Color32(221, 176, 152, 255);
-    public static bool IsZoom { get; private set; }
-    public override MiraKeybind? Keybind => MiraGlobalKeybinds.PrimaryAbility;
-
-    public override bool Enabled(RoleBehaviour? role)
-    {
-        return role is TeleporterRole;
-    }
-
-    protected override void OnClick()
-    {
-        Coroutines.Start(ZoomOutCoroutine());
-    }
-
-    public override void OnEffectEnd()
-    {
-        Coroutines.Start(ZoomInCoroutine());
-    }
-
-    protected override void FixedUpdate(PlayerControl playerControl)
-    {
-        base.FixedUpdate(playerControl);
-
-        if (!EffectActive) return;
-
-        if (Input.GetKey(KeyCode.Mouse0))
-        {
-            playerControl.NetTransform.RpcSnapTo(Camera.main.ScreenToWorldPoint(Input.mousePosition));
-            ResetCooldownAndOrEffect();
-        }
-    }
-
-    private static IEnumerator ZoomOutCoroutine()
-    {
-        HudManager.Instance.ShadowQuad.gameObject.SetActive(false);
-        IsZoom = true;
-        var zoomDistance = OptionGroupSingleton<TeleporterOptions>.Instance.ZoomDistance;
-        for (var ft = Camera.main!.orthographicSize; ft < zoomDistance; ft += 0.3f)
-        {
-            Camera.main.orthographicSize = MeetingHud.Instance ? 3f : ft;
-            ResolutionManager.ResolutionChanged.Invoke((float)Screen.width / Screen.height, Screen.width, Screen.height, Screen.fullScreen);
-            foreach (var cam in Camera.allCameras) cam.orthographicSize = Camera.main.orthographicSize;
-            yield return null;
-        }
-
-        foreach (var cam in Camera.allCameras) cam.orthographicSize = zoomDistance;
-        ResolutionManager.ResolutionChanged.Invoke((float)Screen.width / Screen.height, Screen.width, Screen.height, Screen.fullScreen);
-    }
-
-    private static IEnumerator ZoomInCoroutine()
-    {
-        for (var ft = Camera.main!.orthographicSize; ft > 3f; ft -= 0.3f)
-        {
-            Camera.main.orthographicSize = MeetingHud.Instance ? 3f : ft;
-            ResolutionManager.ResolutionChanged.Invoke((float)Screen.width / Screen.height, Screen.width, Screen.height, Screen.fullScreen);
-            foreach (var cam in Camera.allCameras) cam.orthographicSize = Camera.main.orthographicSize;
-
-            yield return null;
-        }
-
-        foreach (var cam in Camera.allCameras) cam.orthographicSize = 3f;
-        HudManager.Instance.ShadowQuad.gameObject.SetActive(true);
-        IsZoom = false;
-
-        ResolutionManager.ResolutionChanged.Invoke((float)Screen.width / Screen.height, Screen.width, Screen.height, Screen.fullScreen);
-    }
-}

MiraAPI.Example/Buttons/ThinkButton.cs

@@ -1,35 +0,0 @@
-using MiraAPI.Hud;
-using MiraAPI.Utilities.Assets;
-using UnityEngine;
-
-namespace MiraAPI.Example.Buttons;
-
-public class ThinkButton : CustomActionButton
-{
-    public override string Name => "Think";
-    public override float Cooldown => 15f;
-    public override float EffectDuration => 10f;
-    public override int MaxUses => 1;
-    public override ButtonUsesMode UsesMode => ButtonUsesMode.PerRound;
-    public override LoadableAsset<Sprite> Sprite => ExampleAssets.ExampleButton;
-    protected override void OnClick()
-    {
-        // This button does absolutely nothing besides changing its text
-        Button!.OverrideText("Thinking...");
-    }
-
-    public override void OnEffectEnd()
-    {
-        Button!.OverrideText("Think");
-    }
-
-    public override bool IsEffectCancellable()
-    {
-        return true;
-    }
-
-    public override bool Enabled(RoleBehaviour? role)
-    {
-        return role != null && role.IsImpostor;
-    }
-}

MiraAPI.Example/ExampleAssets.cs

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

MiraAPI.Example/ExampleColors.cs

@@ -1,17 +0,0 @@
-using MiraAPI.Colors;
-using UnityEngine;
-
-namespace MiraAPI.Example;
-
-[RegisterCustomColors]
-public static class ExampleColors
-{
-    public static CustomColor Cerulean { get; } = new("Cerulean", new Color(0.0f, 0.48f, 0.65f))
-    {
-        ColorBrightness = CustomColorBrightness.Lighter,
-    };
-
-    public static CustomColor Rose { get; } = new("Rose", new Color(0.98f, 0.26f, 0.62f));
-
-    public static CustomColor Gold { get; } = new("Gold", new Color(1.0f, 0.84f, 0.0f));
-}

MiraAPI.Example/ExampleEventHandlers.cs

@@ -1,98 +0,0 @@
-using System.Linq;
-using MiraAPI.Events;
-using MiraAPI.Events.Mira;
-using MiraAPI.Events.Vanilla.Gameplay;
-using MiraAPI.Events.Vanilla.Map;
-using MiraAPI.Events.Vanilla.Meeting;
-using MiraAPI.Events.Vanilla.Meeting.Voting;
-using MiraAPI.Events.Vanilla.Player;
-using MiraAPI.Example.Buttons.Freezer;
-using MiraAPI.Example.Roles;
-using MiraAPI.Utilities;
-using Reactor.Utilities;
-
-namespace MiraAPI.Example;
-
-public static class ExampleEventHandlers
-{
-    public static void Initialize()
-    {
-        // You can register event handlers with the MiraEventManager class.
-        var handle = MiraEventManager.RegisterEventHandler<BeforeMurderEvent>(@event =>
-        {
-            Logger<ExamplePlugin>.Info($"{@event.Source.Data.PlayerName} is about to kill {@event.Target.Data.PlayerName}");
-        });
-
-        MiraEventManager.RegisterEventHandler<AfterMurderEvent>(@event =>
-        {
-            Logger<ExamplePlugin>.Info($"{@event.Source.Data.PlayerName} has killed {@event.Target.Data.PlayerName}");
-        });
-
-        MiraEventManager.RegisterEventHandler<CompleteTaskEvent>(@event =>
-        {
-            Logger<ExamplePlugin>.Info($"{@event.Player.Data.PlayerName} completed {@event.Task.TaskType.ToString()}");
-        });
-
-        // You can also unregister event handlers using the handle returned from RegisterEventHandler.
-        MiraEventManager.UnregisterEventHandler(handle);
-    }
-
-    // If you want to add extra votes to a player, do something like this.
-    [RegisterEvent]
-    public static void StartMeetingEvent(StartMeetingEvent _)
-    {
-        foreach (var plr in PlayerControl.AllPlayerControls.ToArray().Where(player => player.Data.Role is MayorRole))
-        {
-            plr.GetVoteData().IncreaseRemainingVotes(1);
-        }
-    }
-
-    // Example of using the Voting API to make a role similar to the Prosecutor from Town of Us.
-    [RegisterEvent(15)]
-    public static void HandleVoteEvent(HandleVoteEvent @event)
-    {
-        if (@event.VoteData.Owner.Data.Role is not NeutralKillerRole) return;
-
-        @event.VoteData.SetRemainingVotes(0);
-
-        for (var i = 0; i < 5; i++)
-        {
-            @event.VoteData.VoteForPlayer(@event.TargetId);
-        }
-
-        foreach (var plr in PlayerControl.AllPlayerControls.ToArray().Where(player => player != @event.VoteData.Owner))
-        {
-            plr.GetVoteData().Votes.Clear();
-            plr.GetVoteData().VotesRemaining = 0;
-        }
-
-        @event.Cancel();
-    }
-
-    // Events can be registered using an attribute as well.
-    [RegisterEvent]
-    public static void UpdateSystemEventHandler(UpdateSystemEvent @event)
-    {
-        Logger<ExamplePlugin>.Error(@event.SystemType.ToString());
-    }
-
-    // Example event handler
-    [RegisterEvent(1)]
-    public static void FreezeButtonClickHandler(MiraButtonClickEvent<FreezeButton> @event)
-    {
-        Logger<ExamplePlugin>.Warning("Freeze button clicked!");
-
-        if (PlayerControl.LocalPlayer.Data.PlayerName != "stupid") return;
-
-        @event.Cancel();
-        @event.Button.SetTimer(15f);
-    }
-
-    // Example event handler
-    [RegisterEvent]
-    public static void FreezeButtonCancelledHandler(MiraButtonCancelledEvent<FreezeButton> @event)
-    {
-        Logger<ExamplePlugin>.Warning("Freeze button cancelled!");
-        @event.Button.OverrideName("Freeze Canceled");
-    }
-}

MiraAPI.Example/ExampleKeybinds.cs

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

MiraAPI.Example/ExampleLocalSetings.cs

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

MiraAPI.Example/ExamplePlugin.cs

@@ -1,5 +1,4 @@
-using System.Linq;
-using BepInEx;
+using BepInEx;
 using BepInEx.Configuration;
 using BepInEx.Unity.IL2CPP;
 using HarmonyLib;
@@ -10,7 +9,7 @@ using Reactor.Networking.Attributes;
 
 namespace MiraAPI.Example;
 
-[BepInAutoPlugin("mira.example", "MiraExampleMod")]
+[BepInAutoPlugin("mira.example", "MiraAPIExample")]
 [BepInProcess("Among Us.exe")]
 [BepInDependency(ReactorPlugin.Id)]
 [BepInDependency(MiraApiPlugin.Id)]
@@ -18,11 +17,9 @@ namespace MiraAPI.Example;
 public partial class ExamplePlugin : BasePlugin, IMiraPlugin
 {
     public Harmony Harmony { get; } = new(Id);
-    public string OptionsTitleText => "Mira API\nExample Mod";
     public ConfigFile GetConfigFile() => Config;
     public override void Load()
     {
-        ExampleEventHandlers.Initialize();
         Harmony.PatchAll();
     }
-}
+}

MiraAPI.Example/GameOver/NeutralKillerGameOver.cs

@@ -1,21 +0,0 @@
-using MiraAPI.Example.Roles;
-using MiraAPI.GameEnd;
-using MiraAPI.Utilities;
-using UnityEngine;
-
-namespace MiraAPI.Example.GameOver;
-
-public class NeutralKillerGameOver : CustomGameOver
-{
-    public override bool VerifyCondition(PlayerControl playerControl, NetworkedPlayerInfo[] winners)
-    {
-        return winners is [{ Role: NeutralKillerRole }];
-    }
-
-    public override void AfterEndGameSetup(EndGameManager endGameManager)
-    {
-        endGameManager.WinText.text = "Outcast Killer Wins!";
-        endGameManager.WinText.color = Color.magenta;
-        endGameManager.BackgroundBar.material.SetColor(ShaderID.Color, Color.magenta);
-    }
-}

MiraAPI.Example/MiraAPI.Example.csproj

@@ -1,17 +1,37 @@
- <Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 	<PropertyGroup>
-		<Version>1.0.0</Version>
+		<TargetFramework>net6.0</TargetFramework>
+		<LangVersion>latest</LangVersion>
+		<DebugType>embedded</DebugType>
+
+		<VersionPrefix>1.0.0</VersionPrefix>
+		<VersionSuffix>dev</VersionSuffix>
 		<Description>Example mod for Mira API</Description>
 		<Authors>Angxl, XtraCube</Authors>
 	</PropertyGroup>
+	
+	<ItemGroup>
+		<PackageReference Include="Reactor" Version="2.3.0" />
+		<PackageReference Include="BepInEx.Unity.IL2CPP" Version="6.0.0-be.697" Private="false" ExcludeAssets="runtime;native" />
+		<PackageReference Include="Iced" Version="1.21.0" />
+		<PackageReference Include="AmongUs.GameLibs.Steam" Version="2024.8.13" PrivateAssets="all" />
+
+		<PackageReference Include="BepInEx.AutoPlugin" Version="1.1.0" PrivateAssets="all" />
+		<PackageReference Include="BepInEx.IL2CPP.MSBuild" Version="2.1.0-rc.1" PrivateAssets="all" ExcludeAssets="runtime">
+			<IncludeAssets>compile; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+		</PackageReference>
+	</ItemGroup>
 
 	<ItemGroup>
 		<ProjectReference Include="..\MiraAPI\MiraAPI.csproj" />
 	</ItemGroup>
 
-	 <ItemGroup>
-		 <EmbeddedResource Include="Resources\**\*.*" />
-	 </ItemGroup>
+	<ItemGroup>
+		<EmbeddedResource Include="Resources\ExampleButton.png" />
+		<EmbeddedResource Include="Resources\FortniteBanner.jpeg" />
+	</ItemGroup>
 
-	<Import Project="..\AmongUs.props" />
+	<Target Name="Copy" AfterTargets="Build" Condition="'$(AmongUs)' != ''">
+		<Copy SourceFiles="$(TargetPath)" DestinationFolder="$(AmongUs)/BepInEx/plugins/" UseSymboliclinksIfPossible="true" />
+	</Target>
 </Project>

MiraAPI.Example/MiraDebugWindow.cs

@@ -1,27 +0,0 @@
-using System;
-using Il2CppInterop.Runtime.Attributes;
-using Reactor.Utilities.Attributes;
-using Reactor.Utilities.ImGui;
-using UnityEngine;
-
-namespace MiraAPI.Example;
-
-[RegisterInIl2Cpp]
-public class MiraDebugWindow(IntPtr cppPtr) : MonoBehaviour(cppPtr)
-{
-    [HideFromIl2Cpp]
-    public DragWindow DebuggingWindow { get; } = new(
-        new Rect(10, 10, 0, 0),
-        "MIRA API DEBUGGING",
-        () =>
-        {
-        })
-    {
-        Enabled = true,
-    };
-
-    public void OnGUI()
-    {
-        DebuggingWindow.OnGUI();
-    }
-}

MiraAPI.Example/ModifierExample.cs

@@ -0,0 +1,8 @@
+namespace MiraAPI.Example;
+
+public class ModifierExample
+{
+    //name, role specific, etc
+
+    // mono behaviour stuff here (ModdedPlayerModifier inherits monobehaviour)
+}

MiraAPI.Example/Modifiers/CaptainModifier.cs

@@ -1,34 +0,0 @@
-using MiraAPI.Example.Options.Modifiers;
-using MiraAPI.GameOptions;
-using MiraAPI.Modifiers;
-using MiraAPI.Modifiers.Types;
-using MiraAPI.Utilities.Assets;
-using UnityEngine;
-
-namespace MiraAPI.Example.Modifiers;
-
-public class CaptainModifier : GameModifier
-{
-    public override string ModifierName => "Captain";
-    public override LoadableAsset<Sprite>? ModifierIcon => ExampleAssets.CallMeetingButton;
-
-    public override void OnDeath(DeathReason reason)
-    {
-        Player.RemoveModifier(this);
-    }
-
-    public override string GetDescription()
-    {
-        return $"You can call a meeting from anywhere on the map.";
-    }
-
-    public override int GetAssignmentChance()
-    {
-        return (int)OptionGroupSingleton<CaptainModifierSettings>.Instance.Chance;
-    }
-
-    public override int GetAmountPerGame()
-    {
-        return (int)OptionGroupSingleton<CaptainModifierSettings>.Instance.Amount;
-    }
-}

MiraAPI.Example/Modifiers/Freezer/FreezeModifier.cs

@@ -1,41 +0,0 @@
-using Il2CppSystem;
-using MiraAPI.Example.Roles;
-using MiraAPI.Modifiers.Types;
-using UnityEngine;
-
-namespace MiraAPI.Example.Modifiers.Freezer;
-
-public class FreezeModifier : TimedModifier
-{
-    public override string ModifierName => "Freezed";
-    public override bool HideOnUi => false;
-    public override float Duration => 15f;
-    public override bool AutoStart => true;
-    public override bool RemoveOnComplete => true;
-
-    public override void OnActivate()
-    {
-        if (Player.AmOwner)
-        {
-            Player.moveable = false;
-        }
-    }
-
-    public override void FixedUpdate()
-    {
-        base.FixedUpdate();
-
-        if (Player.AmOwner || PlayerControl.LocalPlayer.Data.Role is FreezerRole)
-        {
-            Player.cosmetics.SetOutline(true, new Nullable<Color>(Palette.LightBlue));
-        }
-    }
-
-    public override void OnTimerComplete()
-    {
-        if (Player.AmOwner)
-        {
-            Player.moveable = true;
-        }
-    }
-}

MiraAPI.Example/Modifiers/HighPriorityModifier.cs

@@ -1,28 +0,0 @@
-using MiraAPI.Modifiers.Types;
-
-namespace MiraAPI.Example.Modifiers;
-
-public class HighPriorityModifier : GameModifier
-{
-    public override string ModifierName => "High Priority";
-
-    public override string GetDescription()
-    {
-        return "You are high priority! Idrk what this means either tbh...";
-    }
-
-    public override int GetAssignmentChance()
-    {
-        return 100;
-    }
-
-    public override int GetAmountPerGame()
-    {
-        return 1;
-    }
-
-    public override int Priority()
-    {
-        return 100;
-    }
-}

MiraAPI.Example/Options/ExampleOptions.cs

@@ -1,31 +1,33 @@
 using MiraAPI.GameOptions;
 using MiraAPI.GameOptions.Attributes;
-using MiraAPI.Utilities;
 using UnityEngine;
 
 namespace MiraAPI.Example.Options;
 
 public class ExampleOptions : AbstractOptionGroup
 {
-    public override string GroupName => "Example Options 1";
-    public override Color GroupColor => Color.green;
+    public override string GroupName => "General Group";
+    public override Color GroupColor => Color.red;
 
-    [ModdedToggleOption("Toggle Opt 1")]
-    public bool ToggleOpt { get; set; } = false;
+    [ModdedToggleOption("Use Thing")]
+    public bool UseThing { get; set; } = false;
 
-    [ModdedToggleOption("Toggle Opt 2")]
-    public bool ToggleOpt2 { get; set; } = true;
+    [ModdedToggleOption("Use another thing")]
+    public bool UseAnotherThing { get; set; } = true;
 
-    [ModdedNumberOption("Number Opt", min: 0, max: 10, increment: .25f, formatString: "0.00", suffixType: MiraNumberSuffixes.Percent)]
-    public float NumberOpt { get; set; } = 4f;
+    [ModdedNumberOption("Sussy level", min: 0, max: 10)]
+    public float SussyLevel { get; set; } = 4f;
 
-    [ModdedEnumOption("Best API", typeof(BestApi), ["Mira API", "Mitochondria", "Reactor"])]
-    public BestApi Opt { get; set; } = BestApi.MiraAPI;
+    [ModdedStringOption("Sus choices", ["hello", "hello 2", "hello 3"])]
+    public int SusChoices { get; set; } = 2;
+
+    [ModdedEnumOption("Enum test", typeof(TestEnum))]
+    public TestEnum EnumTest { get; set; } = TestEnum.Bye;
 }
 
-public enum BestApi
+public enum TestEnum
 {
-    MiraAPI,
-    Mitochondria,
-    Reactor,
-}
+    Hello,
+    Hi,
+    Bye
+}

MiraAPI.Example/Options/ExampleOptions2.cs

@@ -1,33 +1,27 @@
 using MiraAPI.GameOptions;
 using MiraAPI.GameOptions.OptionTypes;
-using Reactor.Utilities;
 
 namespace MiraAPI.Example.Options;
 
 public class ExampleOptions2 : AbstractOptionGroup
 {
-    public override string GroupName => "Example Options 2";
-
-    public override uint GroupPriority => 0; // This group will be displayed first. The default value is uint.MaxValue.
-
-    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);
-
-    public ModdedToggleOption ToggleOpt2 { get; } = new("Toggle Option 2", false)
-    {
-        Visible = () => OptionGroupSingleton<ExampleOptions2>.Instance.ToggleOpt1, // implicit cast from ModdedToggleOption to bool
-    };
-
-    public ModdedEnumOption<TestingData> EnumOpt { get; } = new("Enum Opt", 0)
-    {
-        ChangedEvent = x => Logger<ExamplePlugin>.Info($"changed Enum Opt to {x}"),
-    };
+    public override string GroupName => "Example 2";
+    
+    public ModdedToggleOption UseThing { get; } = new("Use Thingy 5", false);
+    
+    public ModdedToggleOption UseThing2 { get; } = new("Use Thingy 6", false);
+    
+    public ModdedStringOption Sussy { get; } = new("Sussy", 0, ["Sussy 1", "Sussy 2", "Sussy 3"]);
+    
+    public ModdedEnumOption SussyEnum { get; } = new("Sussy Enum", 0, typeof(SussyEnum));
+    
+    public ModdedNumberOption YeezyLevel { get; } = new("Yeezy Level", 50, 0, 100, 25, NumberSuffixes.Multiplier);
 }
 
-public enum TestingData : ulong
+public enum SussyEnum
 {
-    Happy,
-    Sad,
-    Neutral,
-}
+    Sussy,
+    Baka,
+    Imposter,
+    Kanye
+}

MiraAPI.Example/Options/Modifiers/CaptainModifierSettings.cs

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

MiraAPI.Example/Options/Modifiers/FreezeModifierSettings.cs

@@ -1,13 +0,0 @@
-using MiraAPI.Example.Modifiers.Freezer;
-using MiraAPI.GameOptions;
-using MiraAPI.GameOptions.Attributes;
-
-namespace MiraAPI.Example.Options.Modifiers;
-
-public class FreezeModifierSettings : AbstractOptionGroup<FreezeModifier>
-{
-    public override string GroupName => "Freeze";
-
-    [ModdedToggleOption("Use Color")]
-    public bool UseColor { get; set; } = true;
-}

MiraAPI.Example/Options/Modifiers/GeneralModifierOptions.cs

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

MiraAPI.Example/Options/Roles/CustomRole2Settings.cs

@@ -0,0 +1,16 @@
+using System;
+using MiraAPI.Example.Roles;
+using MiraAPI.GameOptions;
+using MiraAPI.GameOptions.Attributes;
+
+namespace MiraAPI.Example.Options.Roles;
+
+public class CustomRole2Settings : AbstractOptionGroup
+{
+    public override string GroupName => "Custom Role";
+
+    public override Type AdvancedRole => typeof(CustomRole2);
+    
+    [ModdedToggleOption("Teleportation ability")] public bool Teleport { get; set; } = true;
+
+}

MiraAPI.Example/Options/Roles/CustomRoleSettings.cs

@@ -0,0 +1,16 @@
+using System;
+using MiraAPI.Example.Roles;
+using MiraAPI.GameOptions;
+using MiraAPI.GameOptions.Attributes;
+
+namespace MiraAPI.Example.Options.Roles;
+
+public class CustomRoleSettings : AbstractOptionGroup
+{
+    public override string GroupName => "Custom Role";
+
+    public override Type AdvancedRole => typeof(CustomRole);
+    
+    [ModdedNumberOption("Testing level", min: 3, max: 9)] public float TestingLevel { get; set; } = 4;
+
+}

MiraAPI.Example/Options/Roles/FreezerRoleSettings.cs

@@ -1,17 +0,0 @@
-using MiraAPI.Example.Roles;
-using MiraAPI.GameOptions;
-using MiraAPI.GameOptions.Attributes;
-using MiraAPI.Utilities;
-
-namespace MiraAPI.Example.Options.Roles;
-
-public class FreezerRoleSettings : AbstractOptionGroup<FreezerRole>
-{
-    public override string GroupName => "Custom Role";
-
-    [ModdedNumberOption("Freeze Duration", 1, 15, 1, MiraNumberSuffixes.Seconds)]
-    public float FreezeDuration { get; set; } = 5;
-
-    [ModdedNumberOption("Freeze Uses", 1, 5)]
-    public float FreezeUses { get; set; } = 1;
-}

MiraAPI.Example/Options/Roles/TeleporterOptions.cs

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

MiraAPI.Example/Roles/ChameleonRole.cs

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

MiraAPI.Example/Roles/CustomRole.cs

@@ -0,0 +1,17 @@
+using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.Roles;
+
+[RegisterCustomRole]
+public class CustomRole : ImpostorRole, ICustomRole
+{
+    public string RoleName => "fortnite killer";
+    public string RoleLongDescription => "ok so your objective is to eliminate everyone with your fortnite tactical shotgun, good luck";
+    public string RoleDescription => RoleLongDescription;
+    public Color RoleColor => Palette.Black;
+    public ModdedRoleTeams Team => ModdedRoleTeams.Impostor;
+    public LoadableAsset<Sprite> OptionsScreenshot => ExampleAssets.Banner;
+    
+}

MiraAPI.Example/Roles/CustomRole2.cs

@@ -0,0 +1,17 @@
+using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.Roles;
+
+[RegisterCustomRole]
+public class CustomRole2 : CrewmateRole, ICustomRole
+{
+    public string RoleName => "fortnite defender";
+    public string RoleLongDescription => "ok so your objective is to save everyone from the fortnite killer";
+    public string RoleDescription => RoleLongDescription;
+    public Color RoleColor => Palette.AcceptedGreen;
+    public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
+    public LoadableAsset<Sprite> OptionsScreenshot => ExampleAssets.Banner;
+    
+}

MiraAPI.Example/Roles/CustomRole3.cs

@@ -0,0 +1,17 @@
+using MiraAPI.Roles;
+using MiraAPI.Utilities.Assets;
+using UnityEngine;
+
+namespace MiraAPI.Example.Roles;
+
+[RegisterCustomRole]
+public class CustomRole3 : CrewmateRole, ICustomRole
+{
+    public string RoleName => "fortnite helper";
+    public string RoleLongDescription => "ok so your objective is to help";
+    public string RoleDescription => RoleLongDescription;
+    public Color RoleColor => Palette.Brown;
+    public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
+    public LoadableAsset<Sprite> OptionsScreenshot => ExampleAssets.Banner;
+
+}

MiraAPI.Example/Roles/FreezerRole.cs

@@ -1,19 +0,0 @@
-using MiraAPI.Roles;
-using UnityEngine;
-
-namespace MiraAPI.Example.Roles;
-
-public class FreezerRole : ImpostorRole, ICustomRole
-{
-    public string RoleName => "Freezer";
-    public string RoleLongDescription => "Freeze another player for a duration of time.";
-    public string RoleDescription => RoleLongDescription;
-    public Color RoleColor => Palette.Blue;
-    public ModdedRoleTeams Team => ModdedRoleTeams.Impostor;
-
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
-    {
-        OptionsScreenshot = ExampleAssets.Banner,
-        MaxRoleCount = 2,
-    };
-}

MiraAPI.Example/Roles/MayorRole.cs

@@ -1,14 +0,0 @@
-using MiraAPI.Roles;
-using UnityEngine;
-
-namespace MiraAPI.Example.Roles;
-
-public class MayorRole : CrewmateRole, ICustomRole
-{
-    public string RoleName => "Mayor";
-    public string RoleLongDescription => "You get extra votes!";
-    public string RoleDescription => RoleLongDescription;
-    public Color RoleColor => new Color32(221, 176, 152, 255);
-    public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
-    public CustomRoleConfiguration Configuration => new(this);
-}

MiraAPI.Example/Roles/NeutralKillerRole.cs

@@ -1,41 +0,0 @@
-using Il2CppInterop.Runtime.Attributes;
-using MiraAPI.Example.GameOver;
-using MiraAPI.GameEnd;
-using MiraAPI.Roles;
-using UnityEngine;
-
-namespace MiraAPI.Example.Roles;
-
-public class NeutralKillerRole : ImpostorRole, ICustomRole
-{
-    public string RoleName => "Outcast Killer";
-    public string RoleDescription => "Outcast who can kill.";
-    public string RoleLongDescription => RoleDescription;
-    public Color RoleColor => Color.magenta;
-    public ModdedRoleTeams Team => ModdedRoleTeams.Custom;
-
-    public CustomRoleConfiguration Configuration => new(this)
-    {
-        UseVanillaKillButton = true,
-        CanGetKilled = true,
-        CanUseVent = true,
-    };
-
-    public RoleOptionsGroup RoleOptionsGroup { get; } = new("Outcast", Color.gray);
-
-    [HideFromIl2Cpp]
-    public TeamIntroConfiguration? IntroConfiguration { get; } = new(
-        Color.gray,
-        "OUTCAST",
-        "You are an Outcast. You do not have a team.");
-
-    public override void SpawnTaskHeader(PlayerControl playerControl)
-    {
-        // remove existing task header.
-    }
-
-    public override bool DidWin(GameOverReason gameOverReason)
-    {
-        return gameOverReason == CustomGameOver.GameOverReason<NeutralKillerGameOver>();
-    }
-}

MiraAPI.Example/Roles/TeleporterRole.cs

@@ -1,26 +0,0 @@
-using MiraAPI.Roles;
-using UnityEngine;
-
-namespace MiraAPI.Example.Roles;
-
-public class TeleporterRole : CrewmateRole, ICustomRole
-{
-    public string RoleName => "Teleporter";
-    public string RoleLongDescription => "Zoom out and teleport across the map!";
-    public string RoleDescription => RoleLongDescription;
-    public Color RoleColor => new Color32(221, 176, 152, 255);
-    public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
-
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
-    {
-        OptionsScreenshot = ExampleAssets.Banner,
-        CanModifyChance = false,
-        DefaultChance = 73,
-        DefaultRoleCount = 4,
-    };
-
-    public bool CanLocalPlayerSeeRole(PlayerControl player)
-    {
-        return true;
-    }
-}

MiraAPI/Colors/CustomColor.cs

@@ -1,65 +0,0 @@
-using MiraAPI.Utilities;
-using Reactor.Localization.Utilities;
-using UnityEngine;
-
-namespace MiraAPI.Colors;
-
-/// <summary>
-/// Represents a custom color with a main color and a shadow color.
-/// </summary>
-/// <param name="name">The name of the option.</param>
-/// <param name="mainColor">The main color.</param>
-/// <param name="shadowColor">The shadow color.</param>
-public sealed class CustomColor(StringNames name, Color32 mainColor, Color32 shadowColor)
-{
-    /// <summary>
-    /// Gets or sets the main color.
-    /// </summary>
-    public Color32 MainColor { get; set; } = mainColor;
-
-    /// <summary>
-    /// Gets or sets the shadow color.
-    /// </summary>
-    public Color32 ShadowColor { get; set; } = shadowColor;
-
-    /// <summary>
-    /// Gets or sets the name of the color.
-    /// </summary>
-    public StringNames Name { get; set; } = name;
-
-    /// <summary>
-    /// Gets or sets whether the color is lighter or darker. Can be used to help with colorblind stuff.
-    /// </summary>
-    public CustomColorBrightness ColorBrightness { get; set; } = CustomColorBrightness.Darker;
-
-    /// <inheritdoc />
-    public CustomColor(StringNames name, Color32 mainColor) : this(name, mainColor, mainColor.GetShadowColor(60))
-    {
-    }
-
-    /// <inheritdoc />
-    public CustomColor(string name, Color32 mainColor) : this(name, mainColor, mainColor.GetShadowColor(60))
-    {
-    }
-
-    /// <inheritdoc />
-    public CustomColor(string name, Color32 mainColor, Color32 shadowColor) : this(CustomStringName.CreateAndRegister(name), mainColor, shadowColor)
-    {
-    }
-}
-
-/// <summary>
-/// Can be used to help with colorblind stuff.
-/// </summary>
-public enum CustomColorBrightness
-{
-    /// <summary>
-    /// A lighter color.
-    /// </summary>
-    Lighter,
-
-    /// <summary>
-    /// A darker color.
-    /// </summary>
-    Darker,
-}

MiraAPI/Colors/PaletteManager.cs

@@ -1,32 +0,0 @@
-using System.Collections.Generic;
-using System.Linq;
-using HarmonyLib;
-
-namespace MiraAPI.Colors;
-
-/// <summary>
-/// Used to register and track custom colors.
-/// </summary>
-public static class PaletteManager
-{
-    /// <summary>
-    /// Gets all registered custom colors.
-    /// </summary>
-    public static CustomColor[] RegisteredColors => [.. CustomColors];
-
-    internal static readonly List<CustomColor> CustomColors = [];
-
-    internal static void RegisterAllColors()
-    {
-        var colors = CustomColors.Select(x => x.MainColor).ToArray();
-        var shadowColors = CustomColors.Select(x => x.ShadowColor).ToArray();
-        var stringNames = CustomColors.Select(x => x.Name).ToArray();
-
-        Palette.PlayerColors = Palette.PlayerColors.ToArray().AddRangeToArray(colors);
-        Palette.ShadowColors = Palette.ShadowColors.ToArray().AddRangeToArray(shadowColors);
-        Palette.ColorNames = Palette.ColorNames.ToArray().AddRangeToArray(stringNames);
-
-        Palette.TextColors = Palette.TextColors.ToArray().AddRangeToArray(colors);
-        Palette.TextOutlineColors = Palette.TextOutlineColors.ToArray().AddRangeToArray(shadowColors);
-    }
-}

MiraAPI/Colors/RegisterCustomColorsAttribute.cs

@@ -1,9 +0,0 @@
-using System;
-
-namespace MiraAPI.Colors;
-
-/// <summary>
-/// Used to mark a class for custom colors registration.
-/// </summary>
-[AttributeUsage(AttributeTargets.Class)]
-public class RegisterCustomColorsAttribute : Attribute;

MiraAPI/Events/Mira/MiraButtonCancelledEvent.cs

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

MiraAPI/Events/Mira/MiraButtonClickEvent.cs

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

MiraAPI/Events/MiraCancelableEvent.cs

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

MiraAPI/Events/MiraEvent.cs

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

MiraAPI/Events/MiraEventHandle.cs

@@ -1,22 +0,0 @@
-using System;
-
-namespace MiraAPI.Events;
-
-/// <summary>
-/// Event handle to use when unregistering an event.
-/// </summary>
-public class MiraEventHandle
-{
-    /// <summary>
-    /// Gets the type of event.
-    /// </summary>
-    public Type EventType { get; }
-
-    internal MiraEventWrapper EventWrapper { get; }
-
-    internal MiraEventHandle(Type type, MiraEventWrapper eventWrapper)
-    {
-        EventType = type;
-        EventWrapper = eventWrapper;
-    }
-}

MiraAPI/Events/MiraEventManager.cs

@@ -1,152 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Reflection;
-using Reactor.Utilities;
-
-namespace MiraAPI.Events;
-
-/// <summary>
-/// Mira Event manager.
-/// </summary>
-public static class MiraEventManager
-{
-    private static readonly Dictionary<Type, List<MiraEventWrapper>> EventWrappers = [];
-
-    /// <summary>
-    /// Invoke an event.
-    /// </summary>
-    /// <param name="eventInstance">The event instance.</param>
-    /// <typeparam name="T">Type of Event.</typeparam>
-    /// <returns>If there was an event handler invoked for this event, return true. Otherwise, return false.</returns>
-    public static bool InvokeEvent<T>(T eventInstance) where T : MiraEvent
-    {
-        EventWrappers.TryGetValue(typeof(T), out var handlers);
-        if (handlers == null || handlers.Count == 0)
-        {
-            return false;
-        }
-
-        foreach (var handler in handlers)
-        {
-            try
-            {
-                ((Action<T>)handler.EventHandler).Invoke(eventInstance);
-            }
-            catch (Exception ex)
-            {
-                Logger<MiraApiPlugin>.Error($"Error invoking event handler for {typeof(T).Name}: {ex.ToString()}");
-            }
-        }
-
-        return true;
-    }
-
-    /// <summary>
-    /// Invoke an event and use a specific type to find the handlers.
-    /// </summary>
-    /// <param name="eventInstance">The event instance.</param>
-    /// <param name="type">The type to use for handler lookup.</param>
-    /// <returns>If there was an event handler invoked for this event, return true. Otherwise, return false.</returns>
-    public static bool InvokeEvent(MiraEvent eventInstance, Type type)
-    {
-        EventWrappers.TryGetValue(type, out var handlers);
-        if (handlers == null || handlers.Count == 0)
-        {
-            return false;
-        }
-
-        foreach (var handler in handlers)
-        {
-            try
-            {
-                handler.EventHandler.DynamicInvoke(eventInstance);
-            }
-            catch (Exception ex)
-            {
-                Logger<MiraApiPlugin>.Error($"Error invoking event handler for {type.Name}: {ex.ToString()}");
-            }
-        }
-
-        return true;
-    }
-
-    /// <summary>
-    /// Register an event.
-    /// </summary>
-    /// <param name="type">The type of event.</param>
-    /// <param name="methodInfo">The 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>
-    public static MiraEventHandle RegisterEventHandler(Type type, MethodInfo methodInfo, int priority = 0)
-    {
-        if (!type.IsSubclassOf(typeof(MiraEvent)))
-        {
-            throw new InvalidOperationException($"Type must be a subclass of MiraEvent: {type.FullName}");
-        }
-
-        EventWrappers.TryAdd(type, []);
-        var handlers = EventWrappers[type];
-
-        var @delegate = Delegate.CreateDelegate(typeof(Action<>).MakeGenericType(type), methodInfo);
-        var eventWrapper = new MiraEventWrapper(@delegate, priority);
-
-        var index = handlers.BinarySearch(eventWrapper, Comparer<MiraEventWrapper>.Create((a, b) => a.Priority.CompareTo(b.Priority)));
-
-        if (index < 0)
-        {
-            index = ~index;
-        }
-
-        handlers.Insert(index, eventWrapper);
-        return new MiraEventHandle(type, eventWrapper);
-    }
-
-    /// <summary>
-    /// Register an event.
-    /// </summary>
-    /// <param name="handler">The callback method/handler for the event.</param>
-    /// <param name="priority">The priority of the event handler. Lower values are called first.</param>
-    /// <typeparam name="T">Type of event.</typeparam>
-    /// <returns>An event handle 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), []);
-
-        var handlers = EventWrappers[typeof(T)];
-        var eventWrapper = new MiraEventWrapper(handler, priority);
-
-        var index = handlers.BinarySearch(eventWrapper, Comparer<MiraEventWrapper>.Create((a, b) => a.Priority.CompareTo(b.Priority)));
-
-        if (index < 0)
-        {
-            index = ~index;
-        }
-
-        handlers.Insert(index, eventWrapper);
-        return new MiraEventHandle(typeof(T), eventWrapper);
-    }
-
-    /// <summary>
-    /// Unregister an event using the event handle.
-    /// </summary>
-    /// <param name="eventHandle">A handle to the event.</param>
-    /// <returns>True if the event was unregistered successfully, false otherwise.</returns>
-    public static bool UnregisterEventHandler(MiraEventHandle eventHandle)
-    {
-        if (!EventWrappers.TryGetValue(eventHandle.EventType, out var handlers))
-        {
-            return false;
-        }
-
-        if (!handlers.Remove(eventHandle.EventWrapper))
-        {
-            return false;
-        }
-
-        if (handlers.Count == 0)
-        {
-            EventWrappers.Remove(eventHandle.EventType);
-        }
-        return true;
-    }
-}

MiraAPI/Events/MiraEventWrapper.cs

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

MiraAPI/Events/RegisterEventAttribute.cs

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

MiraAPI/Events/Vanilla/Gameplay/AfterMurderEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/BeforeGameEndEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/BeforeMurderEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/BeforeRoundStartEvent.cs

@@ -1,21 +0,0 @@
-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.
-/// </summary>
-public class BeforeRoundStartEvent : MiraCancelableEvent
-{
-    /// <summary>
-    /// Gets a value indicating whether the event was triggered by the IntroCutscene or ExileController.
-    /// </summary>
-    public bool TriggeredByIntro { get; }
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="BeforeRoundStartEvent"/> class.
-    /// </summary>
-    /// <param name="triggeredByIntro">Whether the event was triggered by the intro or not.</param>
-    public BeforeRoundStartEvent(bool triggeredByIntro)
-    {
-        TriggeredByIntro = triggeredByIntro;
-    }
-}

MiraAPI/Events/Vanilla/Gameplay/GameEndEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/IntroBeginEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/IntroEndEvent.cs

@@ -1,12 +0,0 @@
-namespace MiraAPI.Events.Vanilla.Gameplay;
-
-/// <summary>
-/// The event that is invoked when the intro cutscene has finished playing.
-/// </summary>
-public class IntroEndEvent(IntroCutscene introCutscene) : MiraEvent
-{
-    /// <summary>
-    /// Gets the instance of the IntroCutscene.
-    /// </summary>
-    public IntroCutscene IntroCutscene { get; } = introCutscene;
-}

MiraAPI/Events/Vanilla/Gameplay/IntroRoleRevealEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/RoundStartEvent.cs

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

MiraAPI/Events/Vanilla/Gameplay/SetRoleEvent.cs

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

MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs

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

MiraAPI/Events/Vanilla/Map/PlayerOpenSabotageEvent.cs

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

MiraAPI/Events/Vanilla/Map/UpdateSystemEvent.cs

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

MiraAPI/Events/Vanilla/Meeting/EjectionEvent.cs

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

MiraAPI/Events/Vanilla/Meeting/EndMeetingEvent.cs

@@ -1,12 +0,0 @@
-namespace MiraAPI.Events.Vanilla.Meeting;
-
-/// <summary>
-/// The event that is invoked when the meeting has ended.
-/// </summary>
-public class EndMeetingEvent(MeetingHud meetingHud) : MiraEvent
-{
-    /// <summary>
-    /// Gets the MeetingHud instance.
-    /// </summary>
-    public MeetingHud MeetingHud { get; } = meetingHud;
-}

MiraAPI/Events/Vanilla/Meeting/ReportBodyEvent.cs

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

MiraAPI/Events/Vanilla/Meeting/StartMeetingEvent.cs

@@ -1,22 +0,0 @@
-namespace MiraAPI.Events.Vanilla.Meeting;
-
-/// <summary>
-/// The event that is invoked when a meeting is called. This event is not cancelable.
-/// This event is called after Mira resets votes, so if you plan on adding votes to a specific player, do it with this event.
-/// </summary>
-public class StartMeetingEvent : MiraEvent
-{
-    /// <summary>
-    /// Gets the 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>
-    public StartMeetingEvent(MeetingHud meetingHud)
-    {
-        MeetingHud = meetingHud;
-    }
-}

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

@@ -1,30 +0,0 @@
-using MiraAPI.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.
-/// </summary>
-public class AfterVoteEvent : MiraEvent
-{
-    /// <summary>
-    /// Gets the instance of the voter's vote data.
-    /// </summary>
-    public PlayerVoteArea VoteArea { get; }
-
-    /// <summary>
-    /// Gets the player who voted.
-    /// </summary>
-    public PlayerControl Player { get; }
-
-    /// <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="voter">The player who voted.</param>
-    public AfterVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter)
-    {
-        VoteArea = playerVoteArea;
-        Player = voter;
-    }
-}

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

@@ -1,30 +0,0 @@
-using MiraAPI.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.
-/// </summary>
-public class BeforeVoteEvent : MiraCancelableEvent
-{
-    /// <summary>
-    /// Gets the instance of the voter's vote data.
-    /// </summary>
-    public PlayerVoteArea VoteArea { get; }
-
-    /// <summary>
-    /// Gets the player who voted.
-    /// </summary>
-    public PlayerControl Player { get; }
-
-    /// <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="voter">The player who voted.</param>
-    public BeforeVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter)
-    {
-        VoteArea = playerVoteArea;
-        Player = voter;
-    }
-}

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

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

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

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

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

@@ -1,50 +0,0 @@
-using MiraAPI.Voting;
-
-namespace MiraAPI.Events.Vanilla.Meeting.Voting;
-
-/// <summary>
-/// The event that is invoked when Mira handles a vote. This is invoked before Mira's behaviour, so be cautious.
-/// If you intend on adding custom vote behaviour, cancel the event and do so.
-/// If you are NOT canceling the event, keep in mind that Mira automatically removes a vote and adds the suspect to the VotedPlayers list after this event is invoked.
-/// </summary>
-public class HandleVoteEvent : MiraCancelableEvent
-{
-    /// <summary>
-    /// Gets the instance of the voter's vote data.
-    /// </summary>
-    public PlayerVoteData VoteData { get; }
-
-    /// <summary>
-    /// Gets the player who voted.
-    /// </summary>
-    public PlayerControl Player { get; }
-
-    /// <summary>
-    /// Gets the player id of the target.
-    /// </summary>
-    public byte TargetId { get; }
-
-    /// <summary>
-    /// Gets a value indicating whether to prevent the vote from commencing.
-    /// </summary>
-    public bool PreventVote { get; }
-
-    /// <summary>
-    /// Gets the player info 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="targetId">The target's playerId.</param>
-    public HandleVoteEvent(PlayerVoteData playerVoteData, byte targetId)
-    {
-        VoteData = playerVoteData;
-        Player = playerVoteData.Owner;
-        TargetId = targetId;
-        PreventVote = false;
-        TargetPlayerInfo = GameData.Instance.GetPlayerById(targetId);
-    }
-}

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

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

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

@@ -1,25 +0,0 @@
-using System.Collections.Generic;
-using MiraAPI.Voting;
-
-namespace MiraAPI.Events.Vanilla.Meeting.Voting;
-
-/// <summary>
-/// Called in 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.
-    /// </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>
-    public PopulateResultsEvent(List<CustomVote> votes)
-    {
-        Votes = votes;
-    }
-}

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

@@ -1,48 +0,0 @@
-using System.Collections.Generic;
-using System.Linq;
-using MiraAPI.Voting;
-
-namespace MiraAPI.Events.Vanilla.Meeting.Voting;
-
-/// <summary>
-/// Ran after calculating votes and before displaying the results. Only ran on the host.
-/// </summary>
-/// <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>
-public class ProcessVotesEvent(List<CustomVote> votes, NetworkedPlayerInfo? exiledPlayer = null) : MiraEvent
-{
-    private readonly List<CustomVote> _originalVotes = [.. votes];
-
-    private NetworkedPlayerInfo? _exiledPlayer = exiledPlayer;
-
-    /// <summary>
-    /// Gets a value indicating whether the exiled player has been modified by the event.
-    /// </summary>
-    public bool ExiledPlayerModified { get; private set; }
-
-    /// <summary>
-    /// Gets a value indicating whether the votes have been modified by the event.
-    /// </summary>
-    public bool VotesModified => !Votes.SequenceEqual(_originalVotes);
-
-    /// <summary>
-    /// Gets the list of votes 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.
-    /// </summary>
-    public NetworkedPlayerInfo? ExiledPlayer
-    {
-        get => _exiledPlayer;
-        set
-        {
-            _exiledPlayer = value;
-            ExiledPlayerModified = true;
-        }
-    }
-}

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

@@ -1,13 +0,0 @@
-namespace MiraAPI.Events.Vanilla.Meeting.Voting;
-
-/// <summary>
-/// The event that is invoked when the voting phase of a meeting is complete.
-/// </summary>
-/// <param name="meetingHud">The MeetingHud instance.</param>
-public class VotingCompleteEvent(MeetingHud meetingHud) : MiraEvent
-{
-    /// <summary>
-    /// Gets the MeetingHud instance.
-    /// </summary>
-    public MeetingHud MeetingHud { get; } = meetingHud;
-}

MiraAPI/Events/Vanilla/Player/CompleteTaskEvent.cs

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

MiraAPI/Events/Vanilla/Player/PlayerDeathEvent.cs

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

MiraAPI/Events/Vanilla/Player/PlayerJoinEvent.cs

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

MiraAPI/Events/Vanilla/Player/PlayerLeaveEvent.cs

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

MiraAPI/Events/Vanilla/Usables/EnterVentEvent.cs

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

MiraAPI/Events/Vanilla/Usables/ExitVentEvent.cs

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

MiraAPI/Events/Vanilla/Usables/PlayerCanUseEvent.cs

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

MiraAPI/Events/Vanilla/Usables/PlayerUseEvent.cs

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

MiraAPI/GameEnd/CustomGameOver.cs

@@ -1,78 +0,0 @@
-using System.Collections.Generic;
-using MiraAPI.Networking;
-using Reactor.Networking.Rpc;
-
-namespace MiraAPI.GameEnd;
-
-/// <summary>
-/// Custom Game Over.
-/// </summary>
-public abstract class CustomGameOver
-{
-    /// <summary>
-    /// Gets the current CustomGameOver.
-    /// </summary>
-    public static CustomGameOver? Instance { get; internal set; }
-
-    /// <summary>
-    /// Verifies if the condition for this CustomGameOver is met.
-    /// </summary>
-    /// <param name="playerControl">The 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>
-    public virtual bool VerifyCondition(PlayerControl playerControl, NetworkedPlayerInfo[] winners)
-    {
-        return true;
-    }
-
-    /// <summary>
-    /// Runs before the base game calls 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>
-    public virtual bool BeforeEndGameSetup(EndGameManager endGameManager)
-    {
-        return true;
-    }
-
-    /// <summary>
-    /// Runs after the base game calls EndGameManager.SetEverythingUp.
-    /// </summary>
-    /// <param name="endGameManager">The EndGameManager instance.</param>
-    public virtual void AfterEndGameSetup(EndGameManager endGameManager)
-    {
-    }
-
-    /// <summary>
-    /// Get the GameOverReason associated with this CustomGameOver.
-    /// </summary>
-    /// <typeparam name="T">Type of the custom game over.</typeparam>
-    /// <returns>The GameOverReason associated with the custom game over.</returns>
-    public static GameOverReason GameOverReason<T>() where T : CustomGameOver
-    {
-        return (GameOverReason)GameOverManager.GetGameOverId<T>();
-    }
-
-    /// <summary>
-    /// Send a custom game over.
-    /// </summary>
-    /// <param name="winners">A collection of winners.</param>
-    /// <typeparam name="T">Type of the custom game over.</typeparam>
-    public static void Trigger<T>(IEnumerable<NetworkedPlayerInfo> winners) where T : CustomGameOver
-    {
-        var reason = GameOverManager.GetGameOverId<T>();
-        var data = new GameOverData(reason, [.. winners]);
-
-        Rpc<CustomGameOverRpc>.Instance.Send(PlayerControl.LocalPlayer, data, true);
-    }
-
-    /// <summary>
-    /// Implicitly convert a CustomGameOver to a GameOverReason.
-    /// </summary>
-    /// <param name="gameOver">The CustomGameOver instance.</param>
-    /// <returns>The GameOverReason associated with the CustomGameOver.</returns>
-    public static implicit operator GameOverReason(CustomGameOver gameOver)
-    {
-        return (GameOverReason)GameOverManager.GetGameOverId(gameOver.GetType());
-    }
-}

MiraAPI/GameEnd/GameOverData.cs

@@ -1,10 +0,0 @@
-using System.Collections.Generic;
-
-namespace MiraAPI.GameEnd;
-
-/// <summary>
-/// Data for a game over.
-/// </summary>
-/// <param name="Reason">Reason for the game over.</param>
-/// <param name="Winners">A collection of winners.</param>
-public record struct GameOverData(int Reason, List<NetworkedPlayerInfo> Winners);

MiraAPI/GameEnd/GameOverManager.cs

@@ -1,90 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Diagnostics.CodeAnalysis;
-using Reactor.Utilities;
-
-namespace MiraAPI.GameEnd;
-
-/// <summary>
-/// Manage custom game overs.
-/// </summary>
-public static class GameOverManager
-{
-    private static readonly Dictionary<Type, int> GameOverIds = [];
-    private static readonly Dictionary<int, Type> GameOverTypes = [];
-
-    private static int _nextId = Enum.GetNames<GameOverReason>().Length;
-
-    /// <summary>
-    /// Register a custom game over.
-    /// </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>
-    public static bool RegisterGameOver(Type gameOverType)
-    {
-        if (!typeof(CustomGameOver).IsAssignableFrom(gameOverType))
-        {
-            return false;
-        }
-
-        if (gameOverType.IsAbstract)
-        {
-            Logger<MiraApiPlugin>.Error("The type must not be abstract.");
-            return false;
-        }
-
-        if (gameOverType.GetConstructor(Type.EmptyTypes) == null)
-        {
-            Logger<MiraApiPlugin>.Error("The type must have a parameterless constructor.");
-            return false;
-        }
-
-        GameOverIds.Add(gameOverType, _nextId);
-        GameOverTypes.Add(_nextId, gameOverType);
-        _nextId++;
-        return true;
-    }
-
-    /// <summary>
-    /// Create an instance of a custom game over.
-    /// </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>
-    public static bool TryGetGameOver(int id, [NotNullWhen(true)] out CustomGameOver? customGameOver)
-    {
-        if (GameOverTypes.TryGetValue(id, out var gameOverType))
-        {
-            customGameOver = Activator.CreateInstance(gameOverType) as CustomGameOver;
-            return customGameOver != null;
-        }
-
-        customGameOver = null;
-        return false;
-    }
-
-    /// <summary>
-    /// Get the ID of a custom game over.
-    /// </summary>
-    /// <typeparam name="T">Type of the custom game over.</typeparam>
-    /// <returns>The ID of the custom game over.</returns>
-    public static int GetGameOverId<T>() where T : CustomGameOver
-    {
-        return GetGameOverId(typeof(T));
-    }
-
-    /// <summary>
-    /// Get the ID of a custom game over.
-    /// </summary>
-    /// <param name="gameOverType">Type of the custom game over.</param>
-    /// <returns>The ID of the custom game over.</returns>
-    /// <exception cref="ArgumentException">Thrown when the type is not registered.</exception>
-    public static int GetGameOverId(Type gameOverType)
-    {
-        if (GameOverIds.TryGetValue(gameOverType, out var id))
-            return id;
-
-        throw new ArgumentException($"{gameOverType.FullName} is not a registered custom game over!");
-    }
-}

MiraAPI/GameModes/.editorconfig

@@ -1,2 +0,0 @@
-[*.cs]
-dotnet_diagnostic.CS1591.severity = none

MiraAPI/GameModes/CustomGameMode.cs

@@ -3,82 +3,74 @@
 namespace MiraAPI.GameModes;
 
 /// <summary>
-/// Base class for custom gamemodes.
+/// Base class for custom gamemodes
 /// </summary>
 public abstract class CustomGameMode
 {
     /// <summary>
-    /// Gets the game mode name.
+    /// Game mode name
     /// </summary>
     public abstract string Name { get; }
 
     /// <summary>
-    /// Gets the game mode description.
+    /// Game mode description
     /// </summary>
     public abstract string Description { get; }
 
     /// <summary>
-    /// Gets the game mode ID.
+    /// Game mode ID
     /// </summary>
     public abstract int Id { get; }
 
     /// <summary>
-    /// Called when Intro Cutscene is destroyed.
+    /// Called when Intro Cutscene is destroyed
     /// </summary>
-    public virtual void Initialize()
-    {
-    }
+    public virtual void Initialize() { }
 
     /// <summary>
-    /// Called on HudManager.Start().
+    /// Called on HudManager.Start()
     /// </summary>
-    /// <param name="instance">Instance of HudManager.</param>
-    public virtual void HudStart(HudManager instance)
-    {
-    }
+    /// <param name="instance">Instance of HudManager</param>
+    public virtual void HudStart(HudManager instance) { }
 
     /// <summary>
-    /// Called every frame on HudManager.Update().
+    /// Called every frame on HudManager.Update()
     /// </summary>
-    /// <param name="instance">Instance of HudManager.</param>
-    public virtual void HudUpdate(HudManager instance)
-    {
-    }
+    /// <param name="instance">Instance of HudManager</param>
+    public virtual void HudUpdate(HudManager instance) { }
 
     /// <summary>
-    /// Called when a player is killed.
+    /// Called when a player is killed
     /// </summary>
-    /// <param name="player">PlayerControl that was killed.</param>
-    public virtual void OnDeath(PlayerControl player)
-    {
-    }
+    /// <param name="player">PlayerControl that was killed</param>
+    public virtual void OnDeath(PlayerControl player) { }
 
     /// <summary>
-    /// Calculate Game End logic.
+    /// 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="runOriginal">Should original game end logic be used</param>
+    /// <param name="instance">Instance of LogicGameFlowNormal</param>
     public virtual void CheckGameEnd(out bool runOriginal, LogicGameFlowNormal instance)
     {
         runOriginal = true;
     }
 
     /// <summary>
-    /// Custom role assignment.
+    /// Custom role assignment
     /// </summary>
-    /// <param name="runOriginal">Should original role assignment be used.</param>
-    /// <param name="instance">Instance of LogicRoleSelection.</param>
+    /// <param name="runOriginal">Should original role assignment be used</param>
+    /// <param name="instance">Instance of LogicRoleSelection</param>
     public virtual void AssignRoles(out bool runOriginal, LogicRoleSelectionNormal instance)
     {
         runOriginal = true;
     }
 
     /// <summary>
-    /// Custom murder logic.
+    /// Custom murder logic
     /// </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="runOriginal">Should original murder logic be used</param>
+    /// <param name="result">Result of custom murder logic</param>
+    /// <param name="target">Target player for murder</param>
     public virtual void CanKill(out bool runOriginal, out bool result, PlayerControl target)
     {
         result = false;
@@ -86,69 +78,61 @@ public abstract class CustomGameMode
     }
 
     /// <summary>
-    /// Should Roles Settings be available when this gamemode is selected.
+    /// Should Roles Settings be available when this gamemode is selected?
     /// </summary>
-    /// <returns>True if Role Settings are enabled in this game mode.</returns>
-    public virtual bool AreRoleSettingsEnabled() => true;
+    public virtual bool CanAccessRolesTab() => true;
 
     /// <summary>
-    /// Should Game Settings be available when this gamemode is selected.
+    /// Should Game Settings be available when this gamemode is selected?
     /// </summary>
-    /// <returns>True if Game Settings are enabled in this mode.</returns>
-    public virtual bool AreGameSettingsEnabled() => true;
+    public virtual bool CanAccessSettingsTab() => true;
 
     /// <summary>
-    /// Custom winner selection.
+    /// Custom winner selection
     /// </summary>
-    /// <returns>List of winners or null.</returns>
-    public virtual List<NetworkedPlayerInfo>? CalculateWinners() => null;
+    /// <returns>List of winners</returns>
+    public virtual List<NetworkedPlayerInfo> CalculateWinners() => null;
 
     /// <summary>
-    /// Show gamemode in Intro Cutscene.
+    /// Show gamemode in Intro Cutscene
     /// </summary>
-    /// <returns>True if the game mode should be shown in the intro cutscene.</returns>
-    public virtual bool ShowGameModeIntroCutscene() => false;
+    public virtual bool ShowCustomRoleScreen() => false;
 
     /// <summary>
-    /// Can Admin be used in this gamemode.
+    /// Can Admin be used in this gamemode
     /// </summary>
-    /// <param name="console">Admin Console.</param>
-    /// <returns>True if Admin console is enabled.</returns>
+    /// <param name="console">Admin Console</param>
     public virtual bool CanUseMapConsole(MapConsole console) => true;
 
     /// <summary>
-    /// Can a body be reported in this gamemode.
+    /// Can a body 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 body for reporting</param>
     public virtual bool CanReport(DeadBody body) => true;
 
     /// <summary>
-    /// Can system consoles be used in this gamemode.
+    /// Can system consoles be used in this gamemode
     /// </summary>
-    /// <param name="console">System Console.</param>
-    /// <returns>True if system consoles are enabled in this mode.</returns>
+    /// <param name="console">System Console</param>
     public virtual bool CanUseSystemConsole(SystemConsole console) => true;
 
     /// <summary>
-    /// Can tasks be interacted with in this gamemode.
+    /// 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>
-    public virtual bool CanUseTasks(Console console) => true;
+    /// <param name="console">Task console</param>
+    public virtual bool CanUseConsole(Console console) => true;
 
     /// <summary>
-    /// Should the sabotage map be used when attempting to open sabotage overlay.
+    /// 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">MapBehaviour object</param>
     public virtual bool ShouldShowSabotageMap(MapBehaviour map) => true;
 
     /// <summary>
-    /// Can a player vent in this gamemode.
+    /// Can a player vent in this gamemode
     /// </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>
+    /// <param name="vent">Target vent</param>
+    /// <param name="playerInfo">Player attempting to vent</param>
     public virtual bool CanVent(Vent vent, NetworkedPlayerInfo playerInfo) => true;
-}
+
+}

MiraAPI/GameModes/CustomGameModeManager.cs

@@ -1,19 +1,20 @@
-using System;
+#nullable enable
+using Reactor.Utilities;
+using System;
 using System.Collections.Generic;
 using System.Linq;
-using Reactor.Utilities;
 
 namespace MiraAPI.GameModes;
 
 /// <summary>
-/// Manages custom gamemodes.
+/// Manages custom gamemodes
 /// </summary>
 public static class CustomGameModeManager
 {
     /// <summary>
-    /// List of registered gamemodes.
+    /// List of registered gamemodes
     /// </summary>
-    internal static readonly Dictionary<int, CustomGameMode> GameModes = [];
+    public static readonly Dictionary<int, CustomGameMode> GameModes = [];
 
     public static bool IsDefault()
     {
@@ -21,14 +22,14 @@ public static class CustomGameModeManager
     }
 
     /// <summary>
-    /// Gets the current gamemode.
+    /// Current gamemode
     /// </summary>
-    public static CustomGameMode? ActiveMode { get; internal set; } = new DefaultMode();
+    public static CustomGameMode? ActiveMode = new DefaultMode();
 
     /// <summary>
-    /// Set current gamemode.
+    /// Set current gamemode
     /// </summary>
-    /// <param name="id">gamemode ID.</param>
+    /// <param name="id">gamemode ID</param>
     public static void SetGameMode(int id)
     {
         if (GameModes.TryGetValue(id, out var gameMode))
@@ -41,9 +42,9 @@ public static class CustomGameModeManager
     }
 
     /// <summary>
-    /// Register gamemode from type.
+    /// Register gamemode from type 
     /// </summary>
-    /// <param name="gameModeType">Type of gamemode class, should inherit from <see cref="CustomGameMode"/>.</param>
+    /// <param name="gameModeType">Type of gamemode class, should inherit from <see cref="CustomGameMode"/></param>
     internal static void RegisterGameMode(Type gameModeType)
     {
         if (!typeof(CustomGameMode).IsAssignableFrom(gameModeType))
@@ -59,7 +60,7 @@ public static class CustomGameModeManager
             Logger<MiraApiPlugin>.Error($"Failed to create instance of {gameModeType.Name}");
             return;
         }
-
+        
         if (GameModes.Any(x => x.Key == gameMode.Id))
         {
             Logger<MiraApiPlugin>.Error($"ID for gamemode {gameMode.Name} already exists!");
@@ -68,4 +69,4 @@ public static class CustomGameModeManager
 
         GameModes.Add(gameMode.Id, gameMode);
     }
-}
+}

MiraAPI/GameModes/DefaultMode.cs

@@ -1,8 +1,9 @@
 namespace MiraAPI.GameModes;
 
+[RegisterGameMode]
 public class DefaultMode : CustomGameMode
 {
     public override string Name => "Default";
     public override string Description => "Default Among Us GameMode";
     public override int Id => 0;
-}
+}

MiraAPI/GameModes/RegisterGameModeAttribute.cs

@@ -0,0 +1,28 @@
+using System;
+using System.Collections.Generic;
+using System.Reflection;
+
+namespace MiraAPI.GameModes;
+
+[AttributeUsage(AttributeTargets.Class)]
+public class RegisterGameModeAttribute : Attribute
+{
+    private static readonly HashSet<Assembly> RegisteredAssemblies = [];
+
+    internal static void Register(Assembly assembly)
+    {
+        if (!RegisteredAssemblies.Add(assembly))
+        {
+            return;
+        }
+
+        foreach (var type in assembly.GetTypes())
+        {
+            var attribute = type.GetCustomAttribute<RegisterGameModeAttribute>();
+            if (attribute != null)
+            {
+                CustomGameModeManager.RegisterGameMode(type);
+            }
+        }
+    }
+}

MiraAPI/GameOptions/AbstractOptionGroup.cs

@@ -1,65 +1,30 @@
 using System;
 using System.Collections.Generic;
-using System.Collections.ObjectModel;
 using UnityEngine;
 
 namespace MiraAPI.GameOptions;
 
-/// <summary>
-/// Base class for option groups. An option group is a collection of options that are displayed together in the options menu.
-/// </summary>
 public abstract class AbstractOptionGroup
 {
-    internal List<IModdedOption> Options { get; } = [];
-
+    public List<IModdedOption> Options { get; } = [];
+    
     /// <summary>
-    /// Gets a list of the options which are a part of this group.
-    /// </summary>
-    public ReadOnlyCollection<IModdedOption> Children => new(Options);
-
-    /// <summary>
-    /// Gets the name of the group. Visible in options menu.
+    /// The name of the group. Visible in options menu.
     /// </summary>
     public abstract string GroupName { get; }
-
+    
     /// <summary>
-    /// Gets the Optionable type of the group.
-    /// </summary>
-    public virtual Type? OptionableType => null;
-
-    /// <summary>
-    /// Gets a value indicating whether the group should be shown in the modifiers menu.
-    /// </summary>
-    // TODO: make this not a boolean
-    public virtual bool ShowInModifiersMenu => false;
-
-    /// <summary>
-    /// Gets the function that determines whether the group should be visible or not.
+    /// A function that returns whether the group should be visible or not.
     /// </summary>
     public virtual Func<bool> GroupVisible => () => true;
-
+    
     /// <summary>
-    /// Gets the group color. This is used to color the group in the options menu.
+    /// The group color. This is used to color the group in the options menu.
     /// </summary>
-    public virtual Color GroupColor => MiraApiPlugin.DefaultHeaderColor;
-
+    public virtual Color GroupColor => Color.clear;
+    
     /// <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.
+    /// The role the group is associated with. This is used for the advanced role options menu.
     /// </summary>
-    public virtual uint GroupPriority => uint.MaxValue;
-
-    internal bool AllOptionsHidden { get; set; }
-
-    internal CategoryHeaderMasked? Header { get; set; }
-}
-
-/// <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 type of the optionable that this group contains.</typeparam>
-public abstract class AbstractOptionGroup<T> : AbstractOptionGroup where T : IOptionable
-{
-    /// <inheritdoc />
-    public override Type OptionableType => typeof(T);
-}
+    public virtual Type AdvancedRole => null;
+}

MiraAPI/GameOptions/Attributes/ModdedEnumOptionAttribute.cs

@@ -1,34 +1,27 @@
-using System;
+using MiraAPI.GameOptions.OptionTypes;
+using System;
 using System.Reflection;
-using MiraAPI.GameOptions.OptionTypes;
 
 namespace MiraAPI.GameOptions.Attributes;
 
-/// <summary>
-/// Attribute for creating an enum option.
-/// </summary>
-[AttributeUsage(AttributeTargets.Property)]
-public class ModdedEnumOptionAttribute(string title, Type enumType, string[]? values = null)
-    : ModdedOptionAttribute(title)
+public class ModdedEnumOptionAttribute(string title, Type enumType, Type roleType = null)
+    : ModdedOptionAttribute(title, roleType)
 {
-    internal override IModdedOption CreateOption(object? value, PropertyInfo property)
+    internal override IModdedOption CreateOption(object value, PropertyInfo property)
     {
-        var opt = new ModdedEnumOption(Title, (int)(value ?? 0), enumType, values);
+        var opt = new ModdedEnumOption(Title, (int)value, enumType, RoleType);
         return opt;
     }
 
-    /// <inheritdoc />
     public override void SetValue(object value)
     {
-        var opt = HolderOption as ModdedEnumOption;
-        opt?.SetValue((int)value);
+        ModdedEnumOption opt = HolderOption as ModdedEnumOption;
+        opt.SetValue((int)value);
     }
 
-    /// <inheritdoc />
     public override object GetValue()
     {
-        return HolderOption is ModdedEnumOption opt
-            ? Enum.ToObject(enumType, opt.Value)
-            : throw new InvalidOperationException($"HolderOption for option \"{Title}\" with EnumType ${enumType.FullName} is not a ModdedEnumOption");
+        ModdedEnumOption opt = HolderOption as ModdedEnumOption;
+        return Enum.ToObject(enumType, opt.Value);
     }
-}
+}

MiraAPI/GameOptions/Attributes/ModdedNumberOptionAttribute.cs

@@ -1,43 +1,34 @@
-using System;
+using MiraAPI.GameOptions.OptionTypes;
+using System;
 using System.Reflection;
-using MiraAPI.GameOptions.OptionTypes;
-using MiraAPI.Utilities;
 
 namespace MiraAPI.GameOptions.Attributes;
 
-/// <summary>
-/// A number option attribute for the modded options system.
-/// </summary>
-[AttributeUsage(AttributeTargets.Property)]
 public class ModdedNumberOptionAttribute(
     string title,
     float min,
     float max,
     float increment = 1,
-    MiraNumberSuffixes suffixType = MiraNumberSuffixes.None,
-    string? formatString = null,
-    bool zeroInfinity = false)
-    : ModdedOptionAttribute(title)
+    NumberSuffixes suffixType = NumberSuffixes.None,
+    bool zeroInfinity = false,
+    Type roleType = null)
+    : ModdedOptionAttribute(title, roleType)
 {
-    internal override IModdedOption CreateOption(object? value, PropertyInfo property)
+    internal override IModdedOption CreateOption(object value, PropertyInfo property)
     {
-        return new ModdedNumberOption(Title, (float)(value ?? min+increment), min, max, increment, suffixType, formatString, zeroInfinity);
+        var toggleOpt = new ModdedNumberOption(Title, (float)value, min, max, increment, suffixType, zeroInfinity, RoleType);
+        return toggleOpt;
     }
 
-    /// <inheritdoc />
     public override void SetValue(object value)
     {
-        var opt = HolderOption as ModdedNumberOption;
-        opt?.SetValue((float)value);
+        ModdedNumberOption toggleOpt = HolderOption as ModdedNumberOption;
+        toggleOpt.SetValue((float)value);
     }
 
-    /// <inheritdoc />
     public override object GetValue()
     {
-        if (HolderOption is ModdedNumberOption opt)
-        {
-            return opt.Value;
-        }
-        throw new InvalidOperationException($"HolderOption for option \"{Title}\" is not a ModdedNumberOption");
+        ModdedNumberOption toggleOpt = HolderOption as ModdedNumberOption;
+        return toggleOpt.Value;
     }
-}
+}

MiraAPI/GameOptions/Attributes/ModdedOptionAttribute.cs

@@ -3,37 +3,18 @@ using System.Reflection;
 
 namespace MiraAPI.GameOptions.Attributes;
 
-/// <summary>
-/// Represents an attribute that is used to define a modded option.
-/// </summary>
-/// <param name="title">The option title.</param>
-/// <param name="roleType">Optional parameter to specify a role Type.</param>
 [AttributeUsage(AttributeTargets.Property)]
-public abstract class ModdedOptionAttribute(string title, Type? roleType = null) : Attribute
+public abstract class ModdedOptionAttribute(string title, Type roleType = null) : Attribute
 {
-    internal IModdedOption? HolderOption { get; set; }
-
-    /// <summary>
-    /// Gets the title of the option.
-    /// </summary>
+    public IModdedOption HolderOption { get; set; }
+    
     public string Title { get; private set; } = title;
+    
+    protected Type RoleType { get; private set; } = roleType;
 
-    /// <summary>
-    /// Gets the role type of the option.
-    /// </summary>
-    protected Type? RoleType { get; private set; } = roleType;
-
-    /// <summary>
-    /// Sets the value of the option.
-    /// </summary>
-    /// <param name="value">The new value as an 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>
+    public abstract void SetValue(object val);
+    
     public abstract object GetValue();
 
-    internal abstract IModdedOption? CreateOption(object? value, PropertyInfo property);
-}
+    internal abstract IModdedOption CreateOption(object value, PropertyInfo property);
+}