Make some changes to role registration for sounds

MiraAPI.Example/Roles/ChameleonRole.cs

@@ -1,4 +1,6 @@
-using MiraAPI.Roles;
+using AmongUs.GameOptions;
+using MiraAPI.Roles;
+using MiraAPI.Utilities;
 using TMPro;
 using UnityEngine;
 
@@ -12,9 +14,10 @@ public class ChameloenRole : CrewmateRole, ICustomRole
     public Color RoleColor => Palette.AcceptedGreen;
     public ModdedRoleTeams Team => ModdedRoleTeams.Crewmate;
 
-    public CustomRoleConfiguration Configuration => new CustomRoleConfiguration(this)
+    public CustomRoleConfiguration Configuration => new(this)
     {
         OptionsScreenshot = ExampleAssets.Banner,
+        IntroSound = CustomRoleUtils.GetIntroSound(RoleTypes.Shapeshifter),
     };
 
     public void PlayerControlFixedUpdate(PlayerControl playerControl)

MiraAPI/Patches/Roles/GameStartupPatch.cs

@@ -1,4 +1,5 @@
 using HarmonyLib;
+using MiraAPI.PluginLoading;
 using MiraAPI.Roles;
 
 namespace MiraAPI.Patches.Roles;
@@ -21,6 +22,14 @@ public static class GameStartupPatch
         }
 
         _runOnce = true;
+
+        if (MiraPluginManager.Instance.QueuedRoleRegistrations.Count <= 0) return;
+        foreach (var queue in MiraPluginManager.Instance.QueuedRoleRegistrations)
+        {
+            CustomRoleManager.RegisterRoleTypes(queue.Value, queue.Key);
+        }
+
+        MiraPluginManager.Instance.QueuedRoleRegistrations.Clear();
         CustomRoleManager.RegisterInRoleManager();
     }
 }

MiraAPI/Patches/Roles/RoleBehaviourPatch.cs

@@ -22,4 +22,4 @@ public static class RoleBehaviourPatch
         __result = behaviour.RoleColor;
         return false;
     }
-}
+}

MiraAPI/PluginLoading/MiraPluginManager.cs

@@ -27,7 +27,7 @@ public sealed class MiraPluginManager
     private readonly Dictionary<Assembly, MiraPluginInfo> _registeredPlugins = [];
 
     internal MiraPluginInfo[] RegisteredPlugins() => [.. _registeredPlugins.Values];
-
+    internal Dictionary<MiraPluginInfo, List<Type>> QueuedRoleRegistrations { get; } = new();
     internal static MiraPluginManager Instance { get; private set; } = new();
 
     internal void Initialize()
@@ -97,7 +97,7 @@ public sealed class MiraPluginManager
             }
 
             info.OptionGroups.Sort((x, y) => x.GroupPriority.CompareTo(y.GroupPriority));
-            CustomRoleManager.RegisterRoleTypes(roles, info);
+            QueuedRoleRegistrations.Add(info, roles);
 
             _registeredPlugins.Add(assembly, info);
             Logger<MiraApiPlugin>.Info($"Registering mod {pluginInfo.Metadata.GUID} with Mira API.");

MiraAPI/Roles/CustomRoleConfiguration.cs

@@ -34,6 +34,9 @@ public record struct CustomRoleConfiguration
         TasksCountForProgress = role.Team is ModdedRoleTeams.Crewmate;
         HideSettings = roleBehaviour?.IsDead == true;
         ShowInFreeplay = roleBehaviour?.IsDead == false;
+        IntroSound = role.Team is ModdedRoleTeams.Crewmate
+            ? CustomRoleManager.CrewmateIntroSound
+            : CustomRoleManager.ImpostorIntroSound;
     }
 
     /// <summary>

MiraAPI/Roles/CustomRoleManager.cs

@@ -7,6 +7,7 @@ using Il2CppInterop.Runtime.Injection;
 using MiraAPI.Networking;
 using MiraAPI.PluginLoading;
 using MiraAPI.Utilities;
+using MiraAPI.Utilities.Assets;
 using Reactor.Localization.Utilities;
 using Reactor.Networking.Rpc;
 using Reactor.Utilities;
@@ -23,6 +24,18 @@ namespace MiraAPI.Roles;
 /// </summary>
 public static class CustomRoleManager
 {
+    /// <summary>
+    /// The default Among Us Crewmate Intro Sound.
+    /// </summary>
+    public static readonly LoadableAsset<AudioClip> CrewmateIntroSound =
+        CustomRoleUtils.GetIntroSound(RoleTypes.Crewmate)!;
+
+    /// <summary>
+    /// The default Among Us Impostor Intro Sound.
+    /// </summary>
+    public static readonly LoadableAsset<AudioClip> ImpostorIntroSound =
+        CustomRoleUtils.GetIntroSound(RoleTypes.Impostor)!;
+
     internal static readonly Dictionary<ushort, RoleBehaviour> CustomRoles = [];
     internal static readonly Dictionary<Type, ushort> RoleIds = [];
 

MiraAPI/Roles/CustomRoleUtils.cs

@@ -3,6 +3,7 @@ using System.Globalization;
 using System.Linq;
 using System.Text;
 using AmongUs.GameOptions;
+using MiraAPI.Utilities.Assets;
 using UnityEngine;
 
 namespace MiraAPI.Roles;
@@ -46,4 +47,16 @@ public static class CustomRoleUtils
         taskStringBuilder.AppendLine(CultureInfo.InvariantCulture, $"{role.RoleLongDescription}");
         return taskStringBuilder;
     }
+
+    /// <summary>
+    /// Returns an intro sound from a role.
+    /// </summary>
+    /// <param name="roleType">The role type.</param>
+    /// <returns>The intro sound.</returns>
+    public static LoadableAsset<AudioClip>? GetIntroSound(RoleTypes roleType)
+    {
+        var role = RoleManager.Instance.AllRoles.FirstOrDefault(role => role.Role == roleType);
+        if (role is ICustomRole customRole) return customRole.Configuration.IntroSound;
+        return new PreloadedAsset<AudioClip>(role!.IntroSound);
+    }
 }

MiraAPI/Utilities/Assets/PreloadedAsset.cs

@@ -0,0 +1,19 @@
+using System;
+
+namespace MiraAPI.Utilities.Assets;
+
+/// <summary>
+/// An implementation for creating loadable assets from preloaded assets.
+/// </summary>
+/// <inheritdoc cref="LoadableAsset{T}"/>
+/// <inheritdoc />
+public class PreloadedAsset<T>(T asset) : LoadableAsset<T> where T : UnityEngine.Object
+{
+    private readonly T loadedAsset = asset ?? throw new ArgumentNullException(nameof(asset));
+
+    /// <inheritdoc />
+    public override T LoadAsset()
+    {
+        return loadedAsset;
+    }
+}

MiraAPI/Utilities/Helpers.cs

@@ -1,17 +1,9 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.Globalization;
-using System.IO;
 using System.Linq;
-using System.Text;
-using AmongUs.GameOptions;
-using HarmonyLib;
-using MiraAPI.Roles;
-using Reactor.Utilities;
-using Reactor.Utilities.Extensions;
 using TMPro;
 using UnityEngine;
-using UnityEngine.TextCore;
 using Object = UnityEngine.Object;
 
 namespace MiraAPI.Utilities;