Merge branch 'dev'

Directory.Build.props

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

MiraAPI.Example/Roles/ChameleonRole.cs

@@ -43,4 +43,4 @@ public class ChameloenRole : CrewmateRole, ICustomRole
             }
         }
     }
-}
+}

MiraAPI/Patches/HudManagerPatches.cs

@@ -1,5 +1,6 @@
 using HarmonyLib;
 using MiraAPI.Hud;
+using MiraAPI.Roles;
 using Reactor.Utilities.Extensions;
 using UnityEngine;
 using Object = UnityEngine.Object;

MiraAPI/Patches/Options/NotificationPopperPatch.cs

@@ -18,7 +18,7 @@ public static class NotificationPopperPatch
         [HarmonyArgument(3)] RoleTeamTypes teamType,
         [HarmonyArgument(4)] bool playSound)
     {
-        if (CustomRoleManager.CustomRoles.Values.All(role => role.StringName != key))
+        if (CustomRoleManager.CustomRoles.Values.FirstOrDefault(x=>x.StringName==key) is not ICustomRole customRole)
         {
             return true;
         }
@@ -29,10 +29,12 @@ public static class NotificationPopperPatch
 
         var item = DestroyableSingleton<TranslationController>.Instance.GetString(
             StringNames.LobbyChangeSettingNotificationRole,
-            "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">",
-            text,
-            DestroyableSingleton<TranslationController>.Instance.GetString(key, Array.Empty<Object>()),
-            "</color></font>",
+            string.Concat(
+                "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">",
+                text,
+                DestroyableSingleton<TranslationController>.Instance.GetString(key, Array.Empty<Object>()),
+                "</color></font>"
+            ),
             "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">" + roleCount + "</font>",
             "<font=\"Barlow-Black SDF\" material=\"Barlow-Black Outline\">" + roleChance + "%"
         );

MiraAPI/Patches/Roles/HudManagerPatches.cs

@@ -27,10 +27,11 @@ public static class HudManagerPatches
     {
         var flag = localPlayer.Data != null && localPlayer.Data.IsDead;
 
-        if (role is ICustomRole)
+        if (role is ICustomRole customRole)
         {
             __instance.KillButton.ToggleVisible(isActive && role.CanUseKillButton && !flag);
             __instance.ImpostorVentButton.ToggleVisible(isActive && role.CanVent && !flag);
+            __instance.SabotageButton.gameObject.SetActive(isActive && customRole.CanUseSabotage);
         }
 
         if (_roleTab)

MiraAPI/Patches/Roles/SabotageButtonPatch.cs

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

MiraAPI/Roles/ICustomRole.cs

@@ -77,6 +77,11 @@ public interface ICustomRole
     /// </summary>
     bool CanUseVent => Team == ModdedRoleTeams.Impostor;
 
+    /// <summary>
+    /// Gets a value indicating whether the role can use the sabotage button.
+    /// </summary>
+    bool CanUseSabotage => Team == ModdedRoleTeams.Impostor;
+
     /// <summary>
     /// Gets a value indicating whether the role's tasks count towards task progress.
     /// </summary>

README.md

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