From 32dd4edc084562e5d6c0215bd6b0f4f91c4571dc Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Tue, 3 Nov 2026 00:34:29 -0500 Subject: [PATCH 01/12] remove translation id boilerplate --- MiraAPI.Example/ExampleColors.cs | 16 +- MiraAPI/Colors/CustomColor.cs | 155 +++++++++++---- MiraAPI/Colors/PaletteManager.cs | 2 + .../Colors/RegisterCustomColorsAttribute.cs | 16 +- MiraAPI/Colors/VariableColor.cs | 182 ++++++++++++++++-- MiraAPI/PluginLoading/MiraPluginManager.cs | 9 +- 6 files changed, 309 insertions(+), 71 deletions(-) diff --git a/MiraAPI.Example/ExampleColors.cs b/MiraAPI.Example/ExampleColors.cs index 297a370e..0b9c4b6e 100644 --- a/MiraAPI.Example/ExampleColors.cs +++ b/MiraAPI.Example/ExampleColors.cs @@ -5,20 +5,14 @@ using UnityEngine; namespace MiraAPI.Example; -[RegisterCustomColors] +[RegisterCustomColors("color.")] public static class ExampleColors { - public static CustomColor Cerulean { get; } = new("color.cerulean", new Color(0.0f, 0.48f, 0.65f)) - { - ColorBrightness = CustomColorBrightness.Lighter, - }; + public static CustomColor Cerulean { get; } = new("cerulean", new Color(0.0f, 0.48f, 0.65f), CustomColorBrightness.Lighter); - public static CustomColor Rose { get; } = new("color.rose", new Color(0.98f, 0.26f, 0.62f)); + public static CustomColor Rose { get; } = new("rose", new Color(0.98f, 0.26f, 0.62f)); - public static CustomColor Gold { get; } = new("color.gold", new Color(1.0f, 0.84f, 0.0f)); + public static CustomColor Gold { get; } = new("gold", new Color(1.0f, 0.84f, 0.0f)); - public static VariableColor Rainbow { get; } = new("color.rainbow", t => new HsbColor(MathUtilities.PingPong(t, 1f, 0.3f), 1f, 1f)) - { - ColorBrightness = CustomColorBrightness.Lighter, - }; + public static VariableColor Rainbow { get; } = new("rainbow", t => new HsbColor(MathUtilities.PingPong(t, 1f, 0.3f), 1f, 1f), CustomColorBrightness.Lighter); } diff --git a/MiraAPI/Colors/CustomColor.cs b/MiraAPI/Colors/CustomColor.cs index f3c38395..836c1fec 100644 --- a/MiraAPI/Colors/CustomColor.cs +++ b/MiraAPI/Colors/CustomColor.cs @@ -1,4 +1,5 @@ -using System.Diagnostics.CodeAnalysis; +using System; +using System.Diagnostics.CodeAnalysis; using MiraAPI.Translation; using MiraAPI.Utilities; using UnityEngine; @@ -8,45 +9,41 @@ namespace MiraAPI.Colors; /// /// Represents a custom color with a main color and a shadow color. /// -/// The name of the option. +/// The name of the option as a value. +/// The name of the option as a value. /// The main color. /// The shadow color. +/// The brightness type of the color. [SuppressMessage("StyleCop.CSharp.MaintainabilityRules", "SA1401:Fields should be private", Justification = "Internal code.")] -[SuppressMessage("StyleCop.CSharp.LayoutRules", "SA1513:Closing brace should be followed by blank line", Justification = "Looks weird.")] -public class CustomColor(StringNames name, Color32 mainColor, Color32 shadowColor) +public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, Color32 shadowColor, CustomColorBrightness brightness) { - /// - /// Gets or sets the main color. - /// - public Color32 MainColor - { - get; - set - { - field = value; - InternalMainColor = value; - } - } - = mainColor; + private StringNames? name = nameId; + private CustomColorBrightness colorBrightness = brightness; /// - /// Gets or sets the shadow color. + /// Gets the main color. /// - public Color32 ShadowColor - { - get; - set - { - field = value; - InternalShadowColor = value; - } - } - = shadowColor; + public Color32 MainColor { get; } = mainColor; /// - /// Gets or sets the name of the color. + /// Gets the shadow color. /// - public StringNames Name { get; set; } = name; + public Color32 ShadowColor { get; } = shadowColor; + + /// + /// Gets the name of the color. + /// + public StringNames Name + { + get + { + if (!name.HasValue && !string.IsNullOrEmpty(RawId)) + name = MiraLocaleManager.GetOrCreateLocaleString(RawId); + + return name.GetValueOrDefault(); + } + internal set => name = value; + } /// /// Gets the id of the color. @@ -54,28 +51,104 @@ public class CustomColor(StringNames name, Color32 mainColor, Color32 shadowColo public int ColorId { get; internal set; } = -1; /// - /// Gets or sets whether the color is lighter or darker. Can be used to help with colorblind stuff. + /// Gets or sets whether the color is lighter or darker. /// - public CustomColorBrightness ColorBrightness { get; set; } = CustomColorBrightness.Darker; + public CustomColorBrightness ColorBrightness + { + get => colorBrightness; + [Obsolete("Use the constructor to set ColorBrightness instead. This will be removed in a future version.")] + set => colorBrightness = value; + } + internal string? RawId = rawId; internal Color InternalMainColor = mainColor; internal Color InternalShadowColor = shadowColor; - /// - public CustomColor(StringNames name, Color32 mainColor) - : this(name, mainColor, mainColor.DarkenAbsolute(60)) + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + /// The shadow color. + /// The brightness type of the color. + public CustomColor(StringNames nameId, Color32 mainColor, Color32 shadowColor, CustomColorBrightness brightness) + : this(nameId, null, mainColor, shadowColor, brightness) { } - /// - public CustomColor(string name, Color32 mainColor) - : this(name, mainColor, mainColor.DarkenAbsolute(60)) + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + /// The brightness type of the color. + public CustomColor(StringNames nameId, Color32 mainColor, CustomColorBrightness brightness) + : this(nameId, null, mainColor, mainColor.DarkenAbsolute(60), brightness) { } - /// - public CustomColor(string name, Color32 mainColor, Color32 shadowColor) - : this(MiraLocaleManager.GetOrCreateLocaleString(name), mainColor, shadowColor) + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + /// The shadow color. + /// The brightness type of the color. + public CustomColor(string rawId, Color32 mainColor, Color32 shadowColor, CustomColorBrightness brightness) + : this(null, rawId, mainColor, shadowColor, brightness) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + /// The brightness type of the color. + public CustomColor(string rawId, Color32 mainColor, CustomColorBrightness brightness) + : this(null, rawId, mainColor, mainColor.DarkenAbsolute(60), brightness) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + /// The shadow color. + public CustomColor(StringNames nameId, Color32 mainColor, Color32 shadowColor) + : this(nameId, null, mainColor, shadowColor, CustomColorBrightness.Darker) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + public CustomColor(StringNames nameId, Color32 mainColor) + : this(nameId, null, mainColor, mainColor.DarkenAbsolute(60), CustomColorBrightness.Darker) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + /// The shadow color. + public CustomColor(string rawId, Color32 mainColor, Color32 shadowColor) + : this(null, rawId, mainColor, shadowColor, CustomColorBrightness.Darker) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The main color. + public CustomColor(string rawId, Color32 mainColor) + : this(null, rawId, mainColor, mainColor.DarkenAbsolute(60), CustomColorBrightness.Darker) { } } diff --git a/MiraAPI/Colors/PaletteManager.cs b/MiraAPI/Colors/PaletteManager.cs index 760822fc..b05c30fd 100644 --- a/MiraAPI/Colors/PaletteManager.cs +++ b/MiraAPI/Colors/PaletteManager.cs @@ -50,7 +50,9 @@ public static class PaletteManager var colors = CustomColors.Select(x => x.MainColor).ToArray(); var shadowColors = CustomColors.Select(x => x.ShadowColor).ToArray(); var stringNames = CustomColors.Select(x => x.Name).ToArray(); + var newColorId = originalLength; + foreach (var color in CustomColors) { color.ColorId = newColorId++; diff --git a/MiraAPI/Colors/RegisterCustomColorsAttribute.cs b/MiraAPI/Colors/RegisterCustomColorsAttribute.cs index 63565829..899957c9 100644 --- a/MiraAPI/Colors/RegisterCustomColorsAttribute.cs +++ b/MiraAPI/Colors/RegisterCustomColorsAttribute.cs @@ -6,4 +6,18 @@ namespace MiraAPI.Colors; /// Used to mark a class for registration. /// [AttributeUsage(AttributeTargets.Class)] -public class RegisterCustomColorsAttribute : Attribute; +public class RegisterCustomColorsAttribute(string idPrefix) : Attribute +{ + /// + /// Gets the translation ID prefix for all of the colors within the container type. + /// + public string IdPrefix { get; } = idPrefix; + + /// + /// Initializes a new instance of the class. + /// + public RegisterCustomColorsAttribute() + : this(string.Empty) + { + } +} diff --git a/MiraAPI/Colors/VariableColor.cs b/MiraAPI/Colors/VariableColor.cs index 84a38358..7c61e1d5 100644 --- a/MiraAPI/Colors/VariableColor.cs +++ b/MiraAPI/Colors/VariableColor.cs @@ -1,6 +1,5 @@ using System; using MiraAPI.LocalSettings; -using MiraAPI.Translation; using MiraAPI.Utilities; using UnityEngine; @@ -9,40 +8,189 @@ namespace MiraAPI.Colors; /// /// Represents a dynamic custom color that changes over time. /// -/// The name of the color. +/// The name of the option as a value. +/// The name of the option as a value. /// The function to evaluate the dynamic main color. /// The function to evaluate the dynamic shadow color. /// The static main color used when dynamic colors are disabled. /// The static shadow color used when dynamic colors are disabled. /// The default time that is used to automatically fill in the static colors when the latter is not provided. -public sealed class VariableColor(StringNames name, Func mainEvaluator, Func? shadowEvaluator, Color32? mainColor = null, Color32? shadowColor = null, float defaultTime = 0f) - : CustomColor(name, mainColor ?? mainEvaluator(defaultTime), shadowColor ?? shadowEvaluator?.Invoke(defaultTime) ?? (mainColor ?? mainEvaluator(defaultTime)).DarkenAbsolute(60)) +/// The brightness type of the color. +public sealed class VariableColor( + StringNames? nameId, + string? rawId, + Func mainEvaluator, + Func? shadowEvaluator, + Color32? mainColor, + Color32? shadowColor, + float defaultTime, + CustomColorBrightness brightness) + : CustomColor( + nameId, + rawId, + mainColor ?? mainEvaluator(defaultTime), + shadowColor ?? shadowEvaluator?.Invoke(defaultTime) ?? (mainColor ?? mainEvaluator(defaultTime)).DarkenAbsolute(60), + brightness) { /// - /// Gets or sets a delegate that takes in a time value and returns the dynamic main color. + /// Gets a delegate that takes in a time value and returns the dynamic main color. /// - public Func MainEvaluator { get; set; } = mainEvaluator; + public Func MainEvaluator { get; } = mainEvaluator; /// - /// Gets or sets a delegate that takes in a time value and returns the dynamic shadow color. + /// Gets a delegate that takes in a time value and returns the dynamic shadow color. /// - public Func ShadowEvaluator { get; set; } = shadowEvaluator ?? (t => mainEvaluator(t).DarkenAbsolute(0.24f)); + public Func ShadowEvaluator { get; } = shadowEvaluator ?? (t => mainEvaluator(t).DarkenAbsolute(0.24f)); - /// - public VariableColor(StringNames name, Func mainEvaluator, Color32? mainColor = null, float defaultTime = 0f) - : this(name, mainEvaluator, null, mainColor, null, defaultTime) + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The function to evaluate the dynamic shadow color. + /// The static main color used when dynamic colors are disabled. + /// The static shadow color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// The brightness type of the color. + public VariableColor( + StringNames nameId, + Func mainEvaluator, + Func? shadowEvaluator, + CustomColorBrightness brightness, + Color32? mainColor = null, + Color32? shadowColor = null, + float defaultTime = 0f) + : this(nameId, null, mainEvaluator, shadowEvaluator, mainColor, shadowColor, defaultTime, brightness) { } - /// - public VariableColor(string name, Func mainEvaluator, Color32? mainColor = null, float defaultTime = 0f) - : this(name, mainEvaluator, null, mainColor, null, defaultTime) + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The static main color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// The brightness type of the color. + public VariableColor( + StringNames nameId, + Func mainEvaluator, + CustomColorBrightness brightness, + Color32? mainColor = null, + float defaultTime = 0f) + : this(nameId, null, mainEvaluator, null, mainColor, null, defaultTime, brightness) { } - /// - public VariableColor(string name, Func mainEvaluator, Func? shadowEvaluator, Color32? mainColor = null, Color32? shadowColor = null, float defaultTime = 0f) - : this(MiraLocaleManager.GetOrCreateLocaleString(name), mainEvaluator, shadowEvaluator, mainColor, shadowColor, defaultTime) + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The function to evaluate the dynamic shadow color. + /// The static main color used when dynamic colors are disabled. + /// The static shadow color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// The brightness type of the color. + public VariableColor( + string rawId, + Func mainEvaluator, + Func? shadowEvaluator, + CustomColorBrightness brightness, + Color32? mainColor = null, + Color32? shadowColor = null, + float defaultTime = 0f) + : this(null, rawId, mainEvaluator, shadowEvaluator, mainColor, shadowColor, defaultTime, brightness) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The static main color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// The brightness type of the color. + public VariableColor( + string rawId, + Func mainEvaluator, + CustomColorBrightness brightness, + Color32? mainColor = null, + float defaultTime = 0f) + : this(null, rawId, mainEvaluator, null, mainColor, null, defaultTime, brightness) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The function to evaluate the dynamic shadow color. + /// The static main color used when dynamic colors are disabled. + /// The static shadow color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + public VariableColor( + StringNames nameId, + Func mainEvaluator, + Func? shadowEvaluator, + Color32? mainColor = null, + Color32? shadowColor = null, + float defaultTime = 0f) + : this(nameId, null, mainEvaluator, shadowEvaluator, mainColor, shadowColor, defaultTime, CustomColorBrightness.Darker) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The static main color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + public VariableColor( + StringNames nameId, + Func mainEvaluator, + Color32? mainColor = null, + float defaultTime = 0f) + : this(nameId, null, mainEvaluator, null, mainColor, null, defaultTime, CustomColorBrightness.Darker) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The function to evaluate the dynamic shadow color. + /// The static main color used when dynamic colors are disabled. + /// The static shadow color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + public VariableColor( + string rawId, + Func mainEvaluator, + Func? shadowEvaluator, + Color32? mainColor = null, + Color32? shadowColor = null, + float defaultTime = 0f) + : this(null, rawId, mainEvaluator, shadowEvaluator, mainColor, shadowColor, defaultTime, CustomColorBrightness.Darker) + { + } + + /// + /// Initializes a new instance of the class. + /// + /// The name of the option as a value. + /// The function to evaluate the dynamic main color. + /// The static main color used when dynamic colors are disabled. + /// The default time that is used to automatically fill in the static colors when the latter is not provided. + public VariableColor( + string rawId, + Func mainEvaluator, + Color32? mainColor = null, + float defaultTime = 0f) + : this(null, rawId, mainEvaluator, null, mainColor, null, defaultTime, CustomColorBrightness.Darker) { } diff --git a/MiraAPI/PluginLoading/MiraPluginManager.cs b/MiraAPI/PluginLoading/MiraPluginManager.cs index 3214b099..9d4b47dd 100644 --- a/MiraAPI/PluginLoading/MiraPluginManager.cs +++ b/MiraAPI/PluginLoading/MiraPluginManager.cs @@ -305,7 +305,9 @@ public sealed class MiraPluginManager { try { - if (type.GetCustomAttribute() == null) + var attribute = type.GetCustomAttribute(); + + if (attribute == null) { return; } @@ -329,6 +331,11 @@ public sealed class MiraPluginManager continue; } + if (!string.IsNullOrEmpty(color.RawId)) + { + color.Name = MiraLocaleManager.GetOrCreateLocaleString(attribute.IdPrefix + color.RawId); + } + PaletteManager.CustomColors.Add(color); if (color is VariableColor) From f93fcc16e96a18c7b381290c599c9441e3b9a241 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Tue, 3 Nov 2026 09:21:38 -0500 Subject: [PATCH 02/12] deprecate some constructors --- MiraAPI.Example/ExampleColors.cs | 4 ++-- MiraAPI/Colors/CustomColor.cs | 4 ++++ MiraAPI/PluginLoading/MiraPluginManager.cs | 2 +- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/MiraAPI.Example/ExampleColors.cs b/MiraAPI.Example/ExampleColors.cs index 0b9c4b6e..88710683 100644 --- a/MiraAPI.Example/ExampleColors.cs +++ b/MiraAPI.Example/ExampleColors.cs @@ -10,9 +10,9 @@ public static class ExampleColors { public static CustomColor Cerulean { get; } = new("cerulean", new Color(0.0f, 0.48f, 0.65f), CustomColorBrightness.Lighter); - public static CustomColor Rose { get; } = new("rose", new Color(0.98f, 0.26f, 0.62f)); + public static CustomColor Rose { get; } = new("rose", new Color(0.98f, 0.26f, 0.62f), CustomColorBrightness.Lighter); - public static CustomColor Gold { get; } = new("gold", new Color(1.0f, 0.84f, 0.0f)); + public static CustomColor Gold { get; } = new("gold", new Color(1.0f, 0.84f, 0.0f), CustomColorBrightness.Lighter); public static VariableColor Rainbow { get; } = new("rainbow", t => new HsbColor(MathUtilities.PingPong(t, 1f, 0.3f), 1f, 1f), CustomColorBrightness.Lighter); } diff --git a/MiraAPI/Colors/CustomColor.cs b/MiraAPI/Colors/CustomColor.cs index 836c1fec..fa3df61c 100644 --- a/MiraAPI/Colors/CustomColor.cs +++ b/MiraAPI/Colors/CustomColor.cs @@ -116,6 +116,7 @@ public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, /// The name of the option as a value. /// The main color. /// The shadow color. + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(StringNames nameId, Color32 mainColor, Color32 shadowColor) : this(nameId, null, mainColor, shadowColor, CustomColorBrightness.Darker) { @@ -126,6 +127,7 @@ public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, /// /// The name of the option as a value. /// The main color. + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(StringNames nameId, Color32 mainColor) : this(nameId, null, mainColor, mainColor.DarkenAbsolute(60), CustomColorBrightness.Darker) { @@ -137,6 +139,7 @@ public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, /// The name of the option as a value. /// The main color. /// The shadow color. + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(string rawId, Color32 mainColor, Color32 shadowColor) : this(null, rawId, mainColor, shadowColor, CustomColorBrightness.Darker) { @@ -147,6 +150,7 @@ public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, /// /// The name of the option as a value. /// The main color. + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(string rawId, Color32 mainColor) : this(null, rawId, mainColor, mainColor.DarkenAbsolute(60), CustomColorBrightness.Darker) { diff --git a/MiraAPI/PluginLoading/MiraPluginManager.cs b/MiraAPI/PluginLoading/MiraPluginManager.cs index 9d4b47dd..ad12098b 100644 --- a/MiraAPI/PluginLoading/MiraPluginManager.cs +++ b/MiraAPI/PluginLoading/MiraPluginManager.cs @@ -331,7 +331,7 @@ public sealed class MiraPluginManager continue; } - if (!string.IsNullOrEmpty(color.RawId)) + if (!string.IsNullOrEmpty(color.RawId) && !string.IsNullOrEmpty(attribute.IdPrefix)) { color.Name = MiraLocaleManager.GetOrCreateLocaleString(attribute.IdPrefix + color.RawId); } From d7abb1dcb844333901dd272fec67410ce4d69859 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Tue, 3 Nov 2026 09:30:31 -0500 Subject: [PATCH 03/12] clear warnings --- MiraAPI/Colors/CustomColor.cs | 5 ++++- MiraAPI/Colors/RegisterCustomColorsAttribute.cs | 1 + 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/MiraAPI/Colors/CustomColor.cs b/MiraAPI/Colors/CustomColor.cs index fa3df61c..6dc3a5fa 100644 --- a/MiraAPI/Colors/CustomColor.cs +++ b/MiraAPI/Colors/CustomColor.cs @@ -42,7 +42,10 @@ public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, return name.GetValueOrDefault(); } - internal set => name = value; + internal set + { + name = value; + } } /// diff --git a/MiraAPI/Colors/RegisterCustomColorsAttribute.cs b/MiraAPI/Colors/RegisterCustomColorsAttribute.cs index 899957c9..b7c96206 100644 --- a/MiraAPI/Colors/RegisterCustomColorsAttribute.cs +++ b/MiraAPI/Colors/RegisterCustomColorsAttribute.cs @@ -5,6 +5,7 @@ namespace MiraAPI.Colors; /// /// Used to mark a class for registration. /// +/// The group translation ID prefix to attach to color names before registration. [AttributeUsage(AttributeTargets.Class)] public class RegisterCustomColorsAttribute(string idPrefix) : Attribute { From acfb7fb9b8025e94c51a1ddd0ac27e4292205013 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Wed, 4 Nov 2026 01:44:01 -0500 Subject: [PATCH 04/12] use new extension --- MiraAPI/PluginLoading/MiraPluginManager.cs | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/MiraAPI/PluginLoading/MiraPluginManager.cs b/MiraAPI/PluginLoading/MiraPluginManager.cs index 78a39267..bed8d283 100644 --- a/MiraAPI/PluginLoading/MiraPluginManager.cs +++ b/MiraAPI/PluginLoading/MiraPluginManager.cs @@ -312,9 +312,7 @@ public sealed class MiraPluginManager { try { - var attribute = type.GetCustomAttribute(); - - if (attribute == null) + if (!type.TryGetCustomAttribute(out var attribute)) { return false; } From 61761052833d2a984f3623a4d084d31946b99b4f Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Fri, 6 Nov 2026 17:55:23 -0500 Subject: [PATCH 05/12] leverage inheritdoc --- MiraAPI/Colors/CustomColor.cs | 56 ++++-------------------- MiraAPI/Colors/VariableColor.cs | 76 ++++----------------------------- 2 files changed, 16 insertions(+), 116 deletions(-) diff --git a/MiraAPI/Colors/CustomColor.cs b/MiraAPI/Colors/CustomColor.cs index 6dc3a5fa..d9225e25 100644 --- a/MiraAPI/Colors/CustomColor.cs +++ b/MiraAPI/Colors/CustomColor.cs @@ -67,92 +67,52 @@ public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, internal Color InternalMainColor = mainColor; internal Color InternalShadowColor = shadowColor; - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. - /// The shadow color. - /// The brightness type of the color. + /// public CustomColor(StringNames nameId, Color32 mainColor, Color32 shadowColor, CustomColorBrightness brightness) : this(nameId, null, mainColor, shadowColor, brightness) { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. - /// The brightness type of the color. + /// public CustomColor(StringNames nameId, Color32 mainColor, CustomColorBrightness brightness) : this(nameId, null, mainColor, mainColor.DarkenAbsolute(60), brightness) { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. - /// The shadow color. - /// The brightness type of the color. + /// public CustomColor(string rawId, Color32 mainColor, Color32 shadowColor, CustomColorBrightness brightness) : this(null, rawId, mainColor, shadowColor, brightness) { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. - /// The brightness type of the color. + /// public CustomColor(string rawId, Color32 mainColor, CustomColorBrightness brightness) : this(null, rawId, mainColor, mainColor.DarkenAbsolute(60), brightness) { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. - /// The shadow color. + /// [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(StringNames nameId, Color32 mainColor, Color32 shadowColor) : this(nameId, null, mainColor, shadowColor, CustomColorBrightness.Darker) { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. + /// [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(StringNames nameId, Color32 mainColor) : this(nameId, null, mainColor, mainColor.DarkenAbsolute(60), CustomColorBrightness.Darker) { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. - /// The shadow color. + /// [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(string rawId, Color32 mainColor, Color32 shadowColor) : this(null, rawId, mainColor, shadowColor, CustomColorBrightness.Darker) { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The main color. + /// [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public CustomColor(string rawId, Color32 mainColor) : this(null, rawId, mainColor, mainColor.DarkenAbsolute(60), CustomColorBrightness.Darker) diff --git a/MiraAPI/Colors/VariableColor.cs b/MiraAPI/Colors/VariableColor.cs index 7c61e1d5..b3ff8ad1 100644 --- a/MiraAPI/Colors/VariableColor.cs +++ b/MiraAPI/Colors/VariableColor.cs @@ -42,16 +42,7 @@ public sealed class VariableColor( /// public Func ShadowEvaluator { get; } = shadowEvaluator ?? (t => mainEvaluator(t).DarkenAbsolute(0.24f)); - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The function to evaluate the dynamic shadow color. - /// The static main color used when dynamic colors are disabled. - /// The static shadow color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. - /// The brightness type of the color. + /// public VariableColor( StringNames nameId, Func mainEvaluator, @@ -64,14 +55,7 @@ public sealed class VariableColor( { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The static main color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. - /// The brightness type of the color. + /// public VariableColor( StringNames nameId, Func mainEvaluator, @@ -82,16 +66,7 @@ public sealed class VariableColor( { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The function to evaluate the dynamic shadow color. - /// The static main color used when dynamic colors are disabled. - /// The static shadow color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. - /// The brightness type of the color. + /// public VariableColor( string rawId, Func mainEvaluator, @@ -104,14 +79,7 @@ public sealed class VariableColor( { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The static main color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. - /// The brightness type of the color. + /// public VariableColor( string rawId, Func mainEvaluator, @@ -122,15 +90,7 @@ public sealed class VariableColor( { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The function to evaluate the dynamic shadow color. - /// The static main color used when dynamic colors are disabled. - /// The static shadow color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// public VariableColor( StringNames nameId, Func mainEvaluator, @@ -142,13 +102,7 @@ public sealed class VariableColor( { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The static main color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// public VariableColor( StringNames nameId, Func mainEvaluator, @@ -158,15 +112,7 @@ public sealed class VariableColor( { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The function to evaluate the dynamic shadow color. - /// The static main color used when dynamic colors are disabled. - /// The static shadow color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// public VariableColor( string rawId, Func mainEvaluator, @@ -178,13 +124,7 @@ public sealed class VariableColor( { } - /// - /// Initializes a new instance of the class. - /// - /// The name of the option as a value. - /// The function to evaluate the dynamic main color. - /// The static main color used when dynamic colors are disabled. - /// The default time that is used to automatically fill in the static colors when the latter is not provided. + /// public VariableColor( string rawId, Func mainEvaluator, From 8bdcf44a32c4ff2c198988642b12ca470d96dc28 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Sat, 7 Nov 2026 02:57:36 -0500 Subject: [PATCH 06/12] deduplicate code + simplify getters --- MiraAPI/Colors/CustomColor.cs | 4 +- .../Colors/RegisterCustomColorsAttribute.cs | 2 +- MiraAPI/Colors/VariableColor.cs | 4 +- .../Events/Mira/MiraButtonCancelledEvent.cs | 4 +- MiraAPI/Events/Mira/MiraButtonClickEvent.cs | 6 +- MiraAPI/Events/Mira/UiButtonPostResetEvent.cs | 4 +- MiraAPI/Events/MiraEventWrapper.cs | 4 +- MiraAPI/Events/RegisterEventAttribute.cs | 2 +- .../Vanilla/Gameplay/AfterMurderEvent.cs | 12 ++-- .../Vanilla/Gameplay/BeforeGameEndEvent.cs | 2 +- .../Vanilla/Gameplay/BeforeMurderEvent.cs | 8 +-- .../Vanilla/Gameplay/BeforeRoundStartEvent.cs | 2 +- .../Events/Vanilla/Gameplay/GameEndEvent.cs | 2 +- .../Vanilla/Gameplay/IntroBeginEvent.cs | 2 +- .../Events/Vanilla/Gameplay/IntroEndEvent.cs | 2 +- .../Vanilla/Gameplay/IntroRoleRevealEvent.cs | 2 +- .../Vanilla/Gameplay/RoundStartEvent.cs | 2 +- .../Events/Vanilla/Gameplay/SetRoleEvent.cs | 4 +- .../Gameplay/VanillaButtonCancelledEvent.cs | 4 +- .../Gameplay/VanillaButtonClickEvent.cs | 10 +-- MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs | 2 +- .../Vanilla/Map/PlayerOpenSabotageEvent.cs | 2 +- .../Events/Vanilla/Map/UpdateSystemEvent.cs | 6 +- .../Events/Vanilla/Meeting/EjectionEvent.cs | 2 +- .../Events/Vanilla/Meeting/EndMeetingEvent.cs | 2 +- .../Events/Vanilla/Meeting/ReportBodyEvent.cs | 6 +- .../Vanilla/Meeting/StartMeetingEvent.cs | 2 +- .../Vanilla/Meeting/Voting/AfterVoteEvent.cs | 4 +- .../Vanilla/Meeting/Voting/BeforeVoteEvent.cs | 4 +- .../Meeting/Voting/CheckForEndVotingEvent.cs | 2 +- .../Vanilla/Meeting/Voting/DummyVoteEvent.cs | 4 +- .../Vanilla/Meeting/Voting/HandleVoteEvent.cs | 12 ++-- .../Meeting/Voting/MeetingSelectEvent.cs | 4 +- .../Meeting/Voting/PopulateResultsEvent.cs | 2 +- .../Meeting/Voting/ProcessVotesEvent.cs | 2 +- .../Meeting/Voting/VotingCompleteEvent.cs | 2 +- .../Vanilla/Player/CompleteHnsTaskEvent.cs | 6 +- .../Vanilla/Player/CompleteTaskEvent.cs | 4 +- .../Events/Vanilla/Player/PlayerDeathEvent.cs | 6 +- .../Events/Vanilla/Player/PlayerJoinEvent.cs | 2 +- .../Events/Vanilla/Player/PlayerLeaveEvent.cs | 4 +- .../Events/Vanilla/Usables/EnterVentEvent.cs | 4 +- .../Events/Vanilla/Usables/ExitVentEvent.cs | 4 +- .../Events/Vanilla/Usables/PlayerUseEvent.cs | 2 +- MiraAPI/GameOptions/CollectionBuilder.cs | 4 +- MiraAPI/GameOptions/ModdedOptionsManager.cs | 2 +- .../GameOptions/OptionTypes/ModdedOption.cs | 2 +- MiraAPI/Hud/MultiTargetButton.cs | 2 +- MiraAPI/Keybinds/MiraKeybind.cs | 4 +- .../SettingTypes/LocalEnumSetting.cs | 2 +- .../SettingTypes/LocalSliderSetting.cs | 4 +- .../MeetingAbilities/TargetedMeetingButton.cs | 2 +- MiraAPI/Networking/NetData.cs | 4 +- MiraAPI/Networking/SyncOptionsRpc.cs | 47 +++++++++----- MiraAPI/Networking/SyncRoleOptionsRpc.cs | 64 ------------------- MiraAPI/Patches/RoleGuidePatches.cs | 12 ++-- MiraAPI/Presets/OptionPreset.cs | 8 +-- MiraAPI/Utilities/GuideOptionsPatches.cs | 12 ++-- 58 files changed, 147 insertions(+), 194 deletions(-) delete mode 100644 MiraAPI/Networking/SyncRoleOptionsRpc.cs diff --git a/MiraAPI/Colors/CustomColor.cs b/MiraAPI/Colors/CustomColor.cs index d9225e25..156bb3b5 100644 --- a/MiraAPI/Colors/CustomColor.cs +++ b/MiraAPI/Colors/CustomColor.cs @@ -23,12 +23,12 @@ public class CustomColor(StringNames? nameId, string? rawId, Color32 mainColor, /// /// Gets the main color. /// - public Color32 MainColor { get; } = mainColor; + public Color32 MainColor => mainColor; /// /// Gets the shadow color. /// - public Color32 ShadowColor { get; } = shadowColor; + public Color32 ShadowColor => shadowColor; /// /// Gets the name of the color. diff --git a/MiraAPI/Colors/RegisterCustomColorsAttribute.cs b/MiraAPI/Colors/RegisterCustomColorsAttribute.cs index b7c96206..eecba2b5 100644 --- a/MiraAPI/Colors/RegisterCustomColorsAttribute.cs +++ b/MiraAPI/Colors/RegisterCustomColorsAttribute.cs @@ -12,7 +12,7 @@ public class RegisterCustomColorsAttribute(string idPrefix) : Attribute /// /// Gets the translation ID prefix for all of the colors within the container type. /// - public string IdPrefix { get; } = idPrefix; + public string IdPrefix => idPrefix; /// /// Initializes a new instance of the class. diff --git a/MiraAPI/Colors/VariableColor.cs b/MiraAPI/Colors/VariableColor.cs index b3ff8ad1..6a6eae1c 100644 --- a/MiraAPI/Colors/VariableColor.cs +++ b/MiraAPI/Colors/VariableColor.cs @@ -35,12 +35,12 @@ public sealed class VariableColor( /// /// Gets a delegate that takes in a time value and returns the dynamic main color. /// - public Func MainEvaluator { get; } = mainEvaluator; + public Func MainEvaluator => mainEvaluator; /// /// Gets a delegate that takes in a time value and returns the dynamic shadow color. /// - public Func ShadowEvaluator { get; } = shadowEvaluator ?? (t => mainEvaluator(t).DarkenAbsolute(0.24f)); + public Func ShadowEvaluator => shadowEvaluator ?? (t => mainEvaluator(t).DarkenAbsolute(0.24f)); /// public VariableColor( diff --git a/MiraAPI/Events/Mira/MiraButtonCancelledEvent.cs b/MiraAPI/Events/Mira/MiraButtonCancelledEvent.cs index 6973c4f0..5ac4e910 100644 --- a/MiraAPI/Events/Mira/MiraButtonCancelledEvent.cs +++ b/MiraAPI/Events/Mira/MiraButtonCancelledEvent.cs @@ -13,7 +13,7 @@ public sealed class MiraButtonCancelledEvent(T button) : MiraEvent /// /// Gets the whose click was cancelled. /// - public T Button { get; } = button; + public T Button => button; } /// @@ -25,5 +25,5 @@ public sealed class MiraButtonCancelledEvent(CustomActionButton button) : MiraEv /// /// Gets the whose click was cancelled. /// - public CustomActionButton Button { get; } = button; + public CustomActionButton Button => button; } diff --git a/MiraAPI/Events/Mira/MiraButtonClickEvent.cs b/MiraAPI/Events/Mira/MiraButtonClickEvent.cs index 72237d24..9105aa0a 100644 --- a/MiraAPI/Events/Mira/MiraButtonClickEvent.cs +++ b/MiraAPI/Events/Mira/MiraButtonClickEvent.cs @@ -14,12 +14,12 @@ public class MiraButtonClickEvent(T button, MiraButtonClickEvent genericClick /// /// Gets the that was clicked. /// - public T Button { get; } = button; + public T Button => button; /// /// Gets the generic that is invoked before this button-specific event. /// - public MiraButtonClickEvent GenericClickEvent { get; } = genericClickEvent; + public MiraButtonClickEvent GenericClickEvent => genericClickEvent; } /// @@ -31,5 +31,5 @@ public class MiraButtonClickEvent(CustomActionButton button) : MiraCancelableEve /// /// Gets the that was clicked. /// - public CustomActionButton Button { get; } = button; + public CustomActionButton Button => button; } diff --git a/MiraAPI/Events/Mira/UiButtonPostResetEvent.cs b/MiraAPI/Events/Mira/UiButtonPostResetEvent.cs index 38c17555..0e5f2c0b 100644 --- a/MiraAPI/Events/Mira/UiButtonPostResetEvent.cs +++ b/MiraAPI/Events/Mira/UiButtonPostResetEvent.cs @@ -12,10 +12,10 @@ public class UiButtonPostResetEvent(GameObject topUiRow, GameObject secondUiRow) /// /// Gets the parent for the very top UI row. /// - public GameObject MainTopUiRow { get; } = topUiRow; + public GameObject MainTopUiRow => topUiRow; /// /// Gets the parent for the second top UI row. /// - public GameObject SecondTopUiRow { get; } = secondUiRow; + public GameObject SecondTopUiRow => secondUiRow; } diff --git a/MiraAPI/Events/MiraEventWrapper.cs b/MiraAPI/Events/MiraEventWrapper.cs index 2a2c410a..469a98d3 100644 --- a/MiraAPI/Events/MiraEventWrapper.cs +++ b/MiraAPI/Events/MiraEventWrapper.cs @@ -12,10 +12,10 @@ public class MiraEventWrapper(Delegate eventHandler, int priority) /// /// Gets the event handler delegate. /// - public Delegate EventHandler { get; } = eventHandler; + public Delegate EventHandler => eventHandler; /// /// Gets the priority of the handler. Lower values are called first. /// - public int Priority { get; } = priority; + public int Priority => priority; } diff --git a/MiraAPI/Events/RegisterEventAttribute.cs b/MiraAPI/Events/RegisterEventAttribute.cs index 062f30ec..494d7689 100644 --- a/MiraAPI/Events/RegisterEventAttribute.cs +++ b/MiraAPI/Events/RegisterEventAttribute.cs @@ -12,5 +12,5 @@ public class RegisterEventAttribute(int priority = 0) : Attribute /// /// Gets the priority of the event. Lower values are called first. /// - public int Priority { get; } = priority; + public int Priority => priority; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/AfterMurderEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/AfterMurderEvent.cs index 1ca09d67..640f4ce3 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/AfterMurderEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/AfterMurderEvent.cs @@ -14,33 +14,33 @@ public class AfterMurderEvent(PlayerControl source, PlayerControl target, Player /// /// Gets the that killed the . /// - public PlayerControl Source { get; } = source; + public PlayerControl Source => source; /// /// Gets the that was killed. /// - public PlayerControl Target { get; } = target; + public PlayerControl Target => target; /// /// Gets the that was framed, if any. /// - public PlayerControl? Framed { get; } = framed; + public PlayerControl? Framed => framed; /// /// Gets a value indicating whether the murder was done indirectly. /// This is commonly used to prevent the from being killed. /// - public bool IsIndirectAttack { get; } = isIndirect; + public bool IsIndirectAttack => isIndirect; /// /// Gets a value indicating whether the murder was able to bypass protective roles or general defense, such as . /// - public bool IgnoreDefense { get; } = ignoreDefense; + public bool IgnoreDefense => ignoreDefense; /// /// Gets the 's , if it exists. /// - public DeadBody? DeadBody { get; } = deadBody; + public DeadBody? DeadBody => deadBody; /// /// Initializes a new instance of the class. diff --git a/MiraAPI/Events/Vanilla/Gameplay/BeforeGameEndEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/BeforeGameEndEvent.cs index 0b96741f..603f35d3 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/BeforeGameEndEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/BeforeGameEndEvent.cs @@ -9,5 +9,5 @@ public class BeforeGameEndEvent(GameOverReason reason) : MiraCancelableEvent /// /// Gets the reason for the game end. /// - public GameOverReason Reason { get; } = reason; + public GameOverReason Reason => reason; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/BeforeMurderEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/BeforeMurderEvent.cs index 61dd2648..c2bdf0dd 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/BeforeMurderEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/BeforeMurderEvent.cs @@ -17,22 +17,22 @@ public sealed class BeforeMurderEvent(PlayerControl source, PlayerControl target /// /// Gets the that is killing the . /// - public PlayerControl Source { get; } = source; + public PlayerControl Source => source; /// /// Gets the that is being killed. /// - public PlayerControl Target { get; } = target; + public PlayerControl Target => target; /// /// Gets the that is being framed, if any. /// - public PlayerControl? Framed { get; } = framed; + public PlayerControl? Framed => framed; /// /// Gets whether the murder was meant to be done in a meeting, via an enum. /// - public MeetingCheck InMeeting { get; } = inMeeting; + public MeetingCheck InMeeting => inMeeting; /// /// Gets or sets a value indicating whether the murder is done indirectly. diff --git a/MiraAPI/Events/Vanilla/Gameplay/BeforeRoundStartEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/BeforeRoundStartEvent.cs index 841f24dc..80067b74 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/BeforeRoundStartEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/BeforeRoundStartEvent.cs @@ -9,5 +9,5 @@ public class BeforeRoundStartEvent(bool triggeredByIntro) : MiraCancelableEvent /// /// Gets a value indicating whether the event was triggered by the or . /// - public bool TriggeredByIntro { get; } = triggeredByIntro; + public bool TriggeredByIntro => triggeredByIntro; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/GameEndEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/GameEndEvent.cs index 5d94b4b0..783f7bcd 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/GameEndEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/GameEndEvent.cs @@ -9,5 +9,5 @@ public class GameEndEvent(EndGameManager manager) : MiraEvent /// /// Gets the instance. /// - public EndGameManager EndGameManager { get; } = manager; + public EndGameManager EndGameManager => manager; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/IntroBeginEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/IntroBeginEvent.cs index b381390a..72215e21 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/IntroBeginEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/IntroBeginEvent.cs @@ -9,5 +9,5 @@ public class IntroBeginEvent(IntroCutscene introCutscene) : MiraEvent /// /// Gets the instance. /// - public IntroCutscene IntroCutscene { get; } = introCutscene; + public IntroCutscene IntroCutscene => introCutscene; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/IntroEndEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/IntroEndEvent.cs index bdd64bd8..246e232c 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/IntroEndEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/IntroEndEvent.cs @@ -9,5 +9,5 @@ public class IntroEndEvent(IntroCutscene introCutscene) : MiraEvent /// /// Gets the instance. /// - public IntroCutscene IntroCutscene { get; } = introCutscene; + public IntroCutscene IntroCutscene => introCutscene; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/IntroRoleRevealEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/IntroRoleRevealEvent.cs index 417e96b2..37ec4853 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/IntroRoleRevealEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/IntroRoleRevealEvent.cs @@ -9,5 +9,5 @@ public class IntroRoleRevealEvent(IntroCutscene introCutscene) : MiraEvent /// /// Gets the instance. /// - public IntroCutscene IntroCutscene { get; } = introCutscene; + public IntroCutscene IntroCutscene => introCutscene; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/RoundStartEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/RoundStartEvent.cs index e9356ed7..7a6db14a 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/RoundStartEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/RoundStartEvent.cs @@ -10,5 +10,5 @@ public class RoundStartEvent(bool triggeredByIntro) : MiraEvent /// /// Gets a value indicating whether the event was triggered by the or . /// - public bool TriggeredByIntro { get; } = triggeredByIntro; + public bool TriggeredByIntro => triggeredByIntro; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/SetRoleEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/SetRoleEvent.cs index f20996ac..a1bea90d 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/SetRoleEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/SetRoleEvent.cs @@ -12,10 +12,10 @@ public class SetRoleEvent(PlayerControl player, RoleTypes role) : MiraEvent /// /// Gets the whose role was changed. /// - public PlayerControl Player { get; } = player; + public PlayerControl Player => player; /// /// Gets the role that the player was set to. /// - public RoleTypes Role { get; } = role; + public RoleTypes Role => role; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonCancelledEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonCancelledEvent.cs index 73200808..e4826a01 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonCancelledEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonCancelledEvent.cs @@ -13,7 +13,7 @@ public sealed class VanillaButtonCancelledEvent(T button) : MiraEvent /// /// Gets the Vanilla whose click was cancelled. /// - public T Button { get; } = button; + public T Button => button; } /// @@ -25,5 +25,5 @@ public sealed class VanillaButtonCancelledEvent(AbilityButton button) : MiraEven /// /// Gets the Vanilla whose click was cancelled. /// - public AbilityButton Button { get; } = button; + public AbilityButton Button => button; } diff --git a/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonClickEvent.cs b/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonClickEvent.cs index cd7028ae..4e87c87b 100644 --- a/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonClickEvent.cs +++ b/MiraAPI/Events/Vanilla/Gameplay/VanillaButtonClickEvent.cs @@ -14,12 +14,12 @@ public sealed class VanillaButtonClickEvent(T button, VanillaButtonClickEvent /// /// Gets the vanilla that was clicked. /// - public T Button { get; } = button; + public T Button => button; /// /// Gets the generic that is invoked before this button-specific event. /// - public VanillaButtonClickEvent GenericClickEvent { get; } = genericClickEvent; + public VanillaButtonClickEvent GenericClickEvent => genericClickEvent; } /// @@ -33,15 +33,15 @@ public sealed class VanillaButtonClickEvent(AbilityButton button, PlayerControl? /// /// Gets the Vanilla that was clicked. /// - public AbilityButton Button { get; } = button; + public AbilityButton Button => button; /// /// Gets the target , if any, of the Vanilla that was clicked. /// - public PlayerControl? PlayerTarget { get; } = playerTarget; + public PlayerControl? PlayerTarget => playerTarget; /// /// Gets the target , if any, of the Vanilla that was clicked. /// - public Vent? VentTarget { get; } = ventTarget; + public Vent? VentTarget => ventTarget; } diff --git a/MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs b/MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs index d0ce1ccc..86241e97 100644 --- a/MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs +++ b/MiraAPI/Events/Vanilla/Map/CloseDoorsEvent.cs @@ -9,5 +9,5 @@ public class CloseDoorsEvent(SystemTypes room) : MiraCancelableEvent /// /// Gets the room that the doors were closed in. /// - public SystemTypes Room { get; } = room; + public SystemTypes Room => room; } diff --git a/MiraAPI/Events/Vanilla/Map/PlayerOpenSabotageEvent.cs b/MiraAPI/Events/Vanilla/Map/PlayerOpenSabotageEvent.cs index 4e9327ff..d342b321 100644 --- a/MiraAPI/Events/Vanilla/Map/PlayerOpenSabotageEvent.cs +++ b/MiraAPI/Events/Vanilla/Map/PlayerOpenSabotageEvent.cs @@ -9,5 +9,5 @@ public class PlayerOpenSabotageEvent(MapBehaviour mapBehaviour) : MiraCancelable /// /// Gets the . /// - public MapBehaviour MapBehaviour { get; } = mapBehaviour; + public MapBehaviour MapBehaviour => mapBehaviour; } diff --git a/MiraAPI/Events/Vanilla/Map/UpdateSystemEvent.cs b/MiraAPI/Events/Vanilla/Map/UpdateSystemEvent.cs index b1382e56..e39b29d7 100644 --- a/MiraAPI/Events/Vanilla/Map/UpdateSystemEvent.cs +++ b/MiraAPI/Events/Vanilla/Map/UpdateSystemEvent.cs @@ -11,15 +11,15 @@ public class UpdateSystemEvent(SystemTypes systemType, PlayerControl player, byt /// /// Gets the type of system that will be updated. /// - public SystemTypes SystemType { get; } = systemType; + public SystemTypes SystemType => systemType; /// /// Gets the that is updating the system. /// - public PlayerControl Player { get; } = player; + public PlayerControl Player => player; /// /// Gets the byte amount the system is being updated by. /// - public byte Amount { get; } = amount; + public byte Amount => amount; } diff --git a/MiraAPI/Events/Vanilla/Meeting/EjectionEvent.cs b/MiraAPI/Events/Vanilla/Meeting/EjectionEvent.cs index 5c0eaeff..e2203ca9 100644 --- a/MiraAPI/Events/Vanilla/Meeting/EjectionEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/EjectionEvent.cs @@ -9,5 +9,5 @@ public class EjectionEvent(ExileController controller) : MiraEvent /// /// Gets the instance. /// - public ExileController ExileController { get; } = controller; + public ExileController ExileController => controller; } diff --git a/MiraAPI/Events/Vanilla/Meeting/EndMeetingEvent.cs b/MiraAPI/Events/Vanilla/Meeting/EndMeetingEvent.cs index da6642fc..ad958ede 100644 --- a/MiraAPI/Events/Vanilla/Meeting/EndMeetingEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/EndMeetingEvent.cs @@ -9,5 +9,5 @@ public class EndMeetingEvent(MeetingHud meetingHud) : MiraEvent /// /// Gets the instance. /// - public MeetingHud MeetingHud { get; } = meetingHud; + public MeetingHud MeetingHud => meetingHud; } diff --git a/MiraAPI/Events/Vanilla/Meeting/ReportBodyEvent.cs b/MiraAPI/Events/Vanilla/Meeting/ReportBodyEvent.cs index 139aa77d..891d61b4 100644 --- a/MiraAPI/Events/Vanilla/Meeting/ReportBodyEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/ReportBodyEvent.cs @@ -12,15 +12,15 @@ public class ReportBodyEvent(PlayerControl reporter, NetworkedPlayerInfo? target /// /// Gets the player that is reporting the body. /// - public PlayerControl Reporter { get; } = reporter; + public PlayerControl Reporter => reporter; /// /// Gets the player that is being reported. Will be for emergency meeting. /// - public NetworkedPlayerInfo? Target { get; } = target; + public NetworkedPlayerInfo? Target => target; /// /// Gets the that is being reported. Will be for emergency meeting. /// - public DeadBody? Body { get; } = body; + public DeadBody? Body => body; } diff --git a/MiraAPI/Events/Vanilla/Meeting/StartMeetingEvent.cs b/MiraAPI/Events/Vanilla/Meeting/StartMeetingEvent.cs index a38b3c6c..ce373eb7 100644 --- a/MiraAPI/Events/Vanilla/Meeting/StartMeetingEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/StartMeetingEvent.cs @@ -10,5 +10,5 @@ public class StartMeetingEvent(MeetingHud meetingHud) : MiraEvent /// /// Gets the instance. /// - public MeetingHud MeetingHud { get; } = meetingHud; + public MeetingHud MeetingHud => meetingHud; } diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/AfterVoteEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/AfterVoteEvent.cs index 34df3f9d..c6610f79 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/AfterVoteEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/AfterVoteEvent.cs @@ -10,10 +10,10 @@ public class AfterVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter) /// /// Gets the instance of the voter's . /// - public PlayerVoteArea VoteArea { get; } = playerVoteArea; + public PlayerVoteArea VoteArea => playerVoteArea; /// /// Gets the player who voted. /// - public PlayerControl Player { get; } = voter; + public PlayerControl Player => voter; } diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/BeforeVoteEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/BeforeVoteEvent.cs index 9d21b716..b666d490 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/BeforeVoteEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/BeforeVoteEvent.cs @@ -10,10 +10,10 @@ public class BeforeVoteEvent(PlayerVoteArea playerVoteArea, PlayerControl voter) /// /// Gets the instance of the voter's . /// - public PlayerVoteArea VoteArea { get; } = playerVoteArea; + public PlayerVoteArea VoteArea => playerVoteArea; /// /// Gets the player who voted. /// - public PlayerControl Player { get; } = voter; + public PlayerControl Player => voter; } diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/CheckForEndVotingEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/CheckForEndVotingEvent.cs index 656ef44f..c6212dcc 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/CheckForEndVotingEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/CheckForEndVotingEvent.cs @@ -9,7 +9,7 @@ public class CheckForEndVotingEvent(bool isVotingComplete) : MiraCancelableEvent /// /// Gets a value indicating whether default voting logic determines that voting is complete. /// - public bool IsVotingComplete { get; } = isVotingComplete; + public bool IsVotingComplete => isVotingComplete; /// /// Gets or sets a value indicating whether the voting should be forced to end, regardless of the default logic. diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/DummyVoteEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/DummyVoteEvent.cs index 1bb0bc84..febf84cc 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/DummyVoteEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/DummyVoteEvent.cs @@ -13,12 +13,12 @@ public class DummyVoteEvent(DummyBehaviour dummy) : MiraCancelableEvent /// /// Gets the dummy that needs to vote. /// - public DummyBehaviour Dummy { get; } = dummy; + public DummyBehaviour Dummy => dummy; /// /// Gets the instance of the dummy's . /// - public PlayerVoteData VoteData { get; } = dummy.myPlayer.GetVoteData(); + public PlayerVoteData VoteData => dummy.myPlayer.GetVoteData(); /// /// Gets or sets a value indicating whether the dummy can vote to skip the meeting. diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/HandleVoteEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/HandleVoteEvent.cs index 5d3008d6..f9592cb5 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/HandleVoteEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/HandleVoteEvent.cs @@ -17,18 +17,18 @@ public class HandleVoteEvent(PlayerVoteData playerVoteData, byte targetId, bool /// /// Gets the instance of the voter's . /// - public PlayerVoteData VoteData { get; } = playerVoteData; + public PlayerVoteData VoteData => playerVoteData; + + /// + /// Gets the player id of the target. + /// + public byte TargetId => targetId; /// /// Gets the player who voted. /// public PlayerControl Player { get; } = playerVoteData.Owner; - /// - /// Gets the player id of the target. - /// - public byte TargetId { get; } = targetId; - /// /// Gets the of the target. /// diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/MeetingSelectEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/MeetingSelectEvent.cs index aff24f7f..3042a1a2 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/MeetingSelectEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/MeetingSelectEvent.cs @@ -13,12 +13,12 @@ public class MeetingSelectEvent(PlayerVoteData playerVoteData, int targetId, boo /// /// Gets the instance of the voter's . /// - public PlayerVoteData VoteData { get; } = playerVoteData; + public PlayerVoteData VoteData => playerVoteData; /// /// Gets the player id of the target. /// - public int TargetId { get; } = targetId; + public int TargetId => targetId; /// /// Gets the of the target. diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/PopulateResultsEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/PopulateResultsEvent.cs index 3914722f..bc49cb4a 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/PopulateResultsEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/PopulateResultsEvent.cs @@ -15,5 +15,5 @@ public class PopulateResultsEvent(List votes) : MiraCancelableEvent /// /// Gets a list of networked s. /// - public List Votes { get; } = votes; + public List Votes => votes; } diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/ProcessVotesEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/ProcessVotesEvent.cs index 40a7f1a5..0c0abdbf 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/ProcessVotesEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/ProcessVotesEvent.cs @@ -27,7 +27,7 @@ public class ProcessVotesEvent(List votes, NetworkedPlayerInfo? exil /// /// Gets the list of s that are being processed. /// - public List Votes { get; } = votes; + public List Votes => votes; /// /// Gets or sets a value indicating whether an overruling was done. Normally set by judge but can be overwritten. diff --git a/MiraAPI/Events/Vanilla/Meeting/Voting/VotingCompleteEvent.cs b/MiraAPI/Events/Vanilla/Meeting/Voting/VotingCompleteEvent.cs index 52d4c369..b601fbdc 100644 --- a/MiraAPI/Events/Vanilla/Meeting/Voting/VotingCompleteEvent.cs +++ b/MiraAPI/Events/Vanilla/Meeting/Voting/VotingCompleteEvent.cs @@ -9,5 +9,5 @@ public class VotingCompleteEvent(MeetingHud meetingHud) : MiraEvent /// /// Gets the instance. /// - public MeetingHud MeetingHud { get; } = meetingHud; + public MeetingHud MeetingHud => meetingHud; } diff --git a/MiraAPI/Events/Vanilla/Player/CompleteHnsTaskEvent.cs b/MiraAPI/Events/Vanilla/Player/CompleteHnsTaskEvent.cs index 7528fc15..c21f6a49 100644 --- a/MiraAPI/Events/Vanilla/Player/CompleteHnsTaskEvent.cs +++ b/MiraAPI/Events/Vanilla/Player/CompleteHnsTaskEvent.cs @@ -11,15 +11,15 @@ public class CompleteHnsTaskEvent(HideAndSeekManager hnsManager, PlayerControl p /// /// Gets the instance of the . /// - public PlayerControl Player { get; } = player; + public PlayerControl Player => player; /// /// Gets the instance of the that the player completed. /// - public PlayerTask Task { get; } = task; + public PlayerTask Task => task; /// /// Gets the instance of the attached to the game. /// - public HideAndSeekManager HnsManager { get; } = hnsManager; + public HideAndSeekManager HnsManager => hnsManager; } diff --git a/MiraAPI/Events/Vanilla/Player/CompleteTaskEvent.cs b/MiraAPI/Events/Vanilla/Player/CompleteTaskEvent.cs index 95b24304..642e04d2 100644 --- a/MiraAPI/Events/Vanilla/Player/CompleteTaskEvent.cs +++ b/MiraAPI/Events/Vanilla/Player/CompleteTaskEvent.cs @@ -10,10 +10,10 @@ public class CompleteTaskEvent(PlayerControl player, PlayerTask task) : MiraEven /// /// Gets the instance of the . /// - public PlayerControl Player { get; } = player; + public PlayerControl Player => player; /// /// Gets the instance of the that the player completed. /// - public PlayerTask Task { get; } = task; + public PlayerTask Task => task; } diff --git a/MiraAPI/Events/Vanilla/Player/PlayerDeathEvent.cs b/MiraAPI/Events/Vanilla/Player/PlayerDeathEvent.cs index b03d2aa1..4a3e2869 100644 --- a/MiraAPI/Events/Vanilla/Player/PlayerDeathEvent.cs +++ b/MiraAPI/Events/Vanilla/Player/PlayerDeathEvent.cs @@ -11,15 +11,15 @@ public class PlayerDeathEvent(PlayerControl player, DeathReason reason, DeadBody /// /// Gets the player who died. /// - public PlayerControl Player { get; } = player; + public PlayerControl Player => player; /// /// Gets the reason the player died. /// - public DeathReason DeathReason { get; } = reason; + public DeathReason DeathReason => reason; /// /// Gets the associated with the player, if any. /// - public DeadBody? DeadBody { get; } = deadBody; + public DeadBody? DeadBody => deadBody; } diff --git a/MiraAPI/Events/Vanilla/Player/PlayerJoinEvent.cs b/MiraAPI/Events/Vanilla/Player/PlayerJoinEvent.cs index 5f664723..18229e9e 100644 --- a/MiraAPI/Events/Vanilla/Player/PlayerJoinEvent.cs +++ b/MiraAPI/Events/Vanilla/Player/PlayerJoinEvent.cs @@ -11,5 +11,5 @@ public class PlayerJoinEvent(ClientData data) : MiraEvent /// /// Gets the player who joined. /// - public ClientData ClientData { get; } = data; + public ClientData ClientData => data; } diff --git a/MiraAPI/Events/Vanilla/Player/PlayerLeaveEvent.cs b/MiraAPI/Events/Vanilla/Player/PlayerLeaveEvent.cs index 1af8bdea..63446cb8 100644 --- a/MiraAPI/Events/Vanilla/Player/PlayerLeaveEvent.cs +++ b/MiraAPI/Events/Vanilla/Player/PlayerLeaveEvent.cs @@ -12,10 +12,10 @@ public class PlayerLeaveEvent(ClientData data, DisconnectReasons reason) : MiraE /// /// Gets the player who left. /// - public ClientData ClientData { get; } = data; + public ClientData ClientData => data; /// /// Gets the reason why the player left. /// - public DisconnectReasons Reason { get; } = reason; + public DisconnectReasons Reason => reason; } diff --git a/MiraAPI/Events/Vanilla/Usables/EnterVentEvent.cs b/MiraAPI/Events/Vanilla/Usables/EnterVentEvent.cs index 4d6eaaa0..85af54a9 100644 --- a/MiraAPI/Events/Vanilla/Usables/EnterVentEvent.cs +++ b/MiraAPI/Events/Vanilla/Usables/EnterVentEvent.cs @@ -10,10 +10,10 @@ public class EnterVentEvent(PlayerControl player, Vent? vent) : MiraCancelableEv /// /// Gets the that is entering the . /// - public PlayerControl Player { get; } = player; + public PlayerControl Player => player; /// /// Gets the that the is entering. /// - public Vent? Vent { get; } = vent; + public Vent? Vent => vent; } diff --git a/MiraAPI/Events/Vanilla/Usables/ExitVentEvent.cs b/MiraAPI/Events/Vanilla/Usables/ExitVentEvent.cs index 3c0782e0..4612bf6a 100644 --- a/MiraAPI/Events/Vanilla/Usables/ExitVentEvent.cs +++ b/MiraAPI/Events/Vanilla/Usables/ExitVentEvent.cs @@ -10,10 +10,10 @@ public class ExitVentEvent(PlayerControl player, Vent? vent) : MiraCancelableEve /// /// Gets the that is exiting the . /// - public PlayerControl Player { get; } = player; + public PlayerControl Player => player; /// /// Gets the that the is exiting. /// - public Vent? Vent { get; } = vent; + public Vent? Vent => vent; } diff --git a/MiraAPI/Events/Vanilla/Usables/PlayerUseEvent.cs b/MiraAPI/Events/Vanilla/Usables/PlayerUseEvent.cs index a23ce0e8..b2893a59 100644 --- a/MiraAPI/Events/Vanilla/Usables/PlayerUseEvent.cs +++ b/MiraAPI/Events/Vanilla/Usables/PlayerUseEvent.cs @@ -9,7 +9,7 @@ public class PlayerUseEvent(IUsable usable) : MiraCancelableEvent /// /// Gets the instance of that was used. /// - public IUsable Usable { get; } = usable; + public IUsable Usable => usable; /// /// Gets a value indicating whether the is a , , or . diff --git a/MiraAPI/GameOptions/CollectionBuilder.cs b/MiraAPI/GameOptions/CollectionBuilder.cs index 99d42d9e..103030b3 100644 --- a/MiraAPI/GameOptions/CollectionBuilder.cs +++ b/MiraAPI/GameOptions/CollectionBuilder.cs @@ -3,6 +3,6 @@ namespace System.Runtime.CompilerServices; [AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Interface, Inherited = false)] internal sealed class CollectionBuilderAttribute(Type builderType, string methodName) : Attribute { - public Type BuilderType { get; } = builderType; - public string MethodName { get; } = methodName; + public Type BuilderType => builderType; + public string MethodName => methodName; } diff --git a/MiraAPI/GameOptions/ModdedOptionsManager.cs b/MiraAPI/GameOptions/ModdedOptionsManager.cs index 0fb10bb3..677f43ee 100644 --- a/MiraAPI/GameOptions/ModdedOptionsManager.cs +++ b/MiraAPI/GameOptions/ModdedOptionsManager.cs @@ -365,7 +365,7 @@ public static class ModdedOptionsManager while (chunks.Count > 0) { - Rpc.Instance.SendTo(PlayerControl.LocalPlayer, targetId, new MiraOptionNetData(false, chunks.Dequeue())); + Rpc.Instance.SendTo(PlayerControl.LocalPlayer, targetId, new MiraOptionNetData(false, chunks.Dequeue())); } } diff --git a/MiraAPI/GameOptions/OptionTypes/ModdedOption.cs b/MiraAPI/GameOptions/OptionTypes/ModdedOption.cs index b8959420..622006c4 100644 --- a/MiraAPI/GameOptions/OptionTypes/ModdedOption.cs +++ b/MiraAPI/GameOptions/OptionTypes/ModdedOption.cs @@ -162,7 +162,7 @@ public abstract class ModdedOption : IModdedOption entry.Value = _value; } - Rpc.Instance.Send(PlayerControl.LocalPlayer, new MiraOptionNetData(true, [GetNetData()]), true); + Rpc.Instance.Send(PlayerControl.LocalPlayer, new MiraOptionNetData(true, [GetNetData()]), true); } OnValueChanged(_value); diff --git a/MiraAPI/Hud/MultiTargetButton.cs b/MiraAPI/Hud/MultiTargetButton.cs index 6f931e7e..ec12a346 100644 --- a/MiraAPI/Hud/MultiTargetButton.cs +++ b/MiraAPI/Hud/MultiTargetButton.cs @@ -22,7 +22,7 @@ public abstract class MultiTargetButton : CustomActionButton /// /// Gets the maximum amount of targets the button can have. /// - public virtual int MaxTargets { get; } = int.MaxValue; + public virtual int MaxTargets => int.MaxValue; /// public virtual bool IsTargetValid(T target) diff --git a/MiraAPI/Keybinds/MiraKeybind.cs b/MiraAPI/Keybinds/MiraKeybind.cs index ef466b52..3153f37c 100644 --- a/MiraAPI/Keybinds/MiraKeybind.cs +++ b/MiraAPI/Keybinds/MiraKeybind.cs @@ -15,7 +15,7 @@ public class MiraKeybind(string name, KeyboardKeyCode? defaultKeycode, ModifierK /// /// Gets name of the keybind. /// - public string Name { get; } = name; + public string Name => name; /// /// Gets the default keycode of this keybind. @@ -37,7 +37,7 @@ public class MiraKeybind(string name, KeyboardKeyCode? defaultKeycode, ModifierK /// Gets a value indicating whether this keybind should be checked for conflicts with other exclusive keybinds using the same key. /// Active exclusive controller bindings take priority over vanilla actions during gameplay. /// - public bool Exclusive { get; } = exclusive; + public bool Exclusive => exclusive; internal string? SourcePluginName { get; set; } diff --git a/MiraAPI/LocalSettings/SettingTypes/LocalEnumSetting.cs b/MiraAPI/LocalSettings/SettingTypes/LocalEnumSetting.cs index 5fcbb081..61d995cc 100644 --- a/MiraAPI/LocalSettings/SettingTypes/LocalEnumSetting.cs +++ b/MiraAPI/LocalSettings/SettingTypes/LocalEnumSetting.cs @@ -31,7 +31,7 @@ public class LocalEnumSetting( /// /// Gets the type of the setting. /// - public Type EnumType { get; } = enumType; + public Type EnumType => enumType; /// /// Gets the values. diff --git a/MiraAPI/LocalSettings/SettingTypes/LocalSliderSetting.cs b/MiraAPI/LocalSettings/SettingTypes/LocalSliderSetting.cs index 14f1ffe9..2c813bbe 100644 --- a/MiraAPI/LocalSettings/SettingTypes/LocalSliderSetting.cs +++ b/MiraAPI/LocalSettings/SettingTypes/LocalSliderSetting.cs @@ -41,7 +41,7 @@ public class LocalSliderSetting( /// /// Gets a value indicating whether the value should be displayed next to name. /// - public bool DisplayValue { get; } = displayValue; + public bool DisplayValue => displayValue; /// /// Gets a format for the text to use to format the number. @@ -51,7 +51,7 @@ public class LocalSliderSetting( /// /// Gets a value indicating whether the value should be rounded. /// - public bool RoundValue { get; } = roundValue; + public bool RoundValue => roundValue; /// /// Gets the suffix for the number value. diff --git a/MiraAPI/MeetingAbilities/TargetedMeetingButton.cs b/MiraAPI/MeetingAbilities/TargetedMeetingButton.cs index aeeeedd8..0a05c5a0 100644 --- a/MiraAPI/MeetingAbilities/TargetedMeetingButton.cs +++ b/MiraAPI/MeetingAbilities/TargetedMeetingButton.cs @@ -64,7 +64,7 @@ public abstract class TargetedMeetingButton /// /// Gets the for this button. /// - public virtual MeetingButtonUsesMode UsesMode { get; } = MeetingButtonUsesMode.PerGame; + public virtual MeetingButtonUsesMode UsesMode => MeetingButtonUsesMode.PerGame; /// /// Determines if the button is enabled. diff --git a/MiraAPI/Networking/NetData.cs b/MiraAPI/Networking/NetData.cs index aa9a52ee..db8c91c4 100644 --- a/MiraAPI/Networking/NetData.cs +++ b/MiraAPI/Networking/NetData.cs @@ -10,12 +10,12 @@ public readonly struct NetData(uint id, byte[] data) /// /// Gets the ID of the data. /// - public uint Id { get; } = id; + public uint Id => id; /// /// Gets the byte[] data. /// - public byte[] Data { get; } = data; + public byte[] Data => data; /// /// Gets the length of the data in bytes. diff --git a/MiraAPI/Networking/SyncOptionsRpc.cs b/MiraAPI/Networking/SyncOptionsRpc.cs index 9cf83a3d..2c6ee922 100644 --- a/MiraAPI/Networking/SyncOptionsRpc.cs +++ b/MiraAPI/Networking/SyncOptionsRpc.cs @@ -1,27 +1,24 @@ using Hazel; using MiraAPI.GameOptions; +using MiraAPI.Roles; using Reactor.Networking.Attributes; using Reactor.Networking.Rpc; namespace MiraAPI.Networking; +internal readonly struct MiraOptionNetData(bool showNotif, NetData[] data) +{ + public bool ShouldShowNotifications => showNotif; + public NetData[] Data => data; +} + // METHOD RPC DOESN'T WORK WITH THE ARRAYS AND STUFF SO THIS IS HOW WE WILL DO IT FOR NOW -[RegisterCustomRpc((uint)MiraRpc.SyncGameOptions)] -#pragma warning disable SA1515 // Single-line comment should be preceded by blank line (Justification: ReSharper suppression.) -// ReSharper disable once ClassNeverInstantiated.Global (Justification: Instantiated by Reactor.) -internal sealed class SyncOptionsRpc(MiraApiPlugin plugin, uint id) : PlayerCustomRpc(plugin, id) -#pragma warning restore SA1515 // Single-line comment should be preceded by blank line +internal abstract class SyncOptionsRpc(MiraApiPlugin plugin, uint id) : PlayerCustomRpc(plugin, id) { public override RpcLocalHandling LocalHandling => RpcLocalHandling.None; public override void Write(MessageWriter writer, MiraOptionNetData data) { - /*if (data == null) - { - writer.WritePacked(0U); - return; - }*/ - var info = data.Data; writer.Write(data.ShouldShowNotifications); writer.WritePacked((uint)info.Length); @@ -46,14 +43,34 @@ internal sealed class SyncOptionsRpc(MiraApiPlugin plugin, uint id) : PlayerCust return new MiraOptionNetData(shouldShowNotif, data); } +} +[RegisterCustomRpc((uint)MiraRpc.SyncGameOptions)] +#pragma warning disable SA1515 // Single-line comment should be preceded by blank line (Justification: ReSharper suppression.) +// ReSharper disable once ClassNeverInstantiated.Global (Justification: Instantiated by Reactor.) +internal sealed class SyncGameOptionsRpc(MiraApiPlugin plugin, uint id) : SyncOptionsRpc(plugin, id) +#pragma warning restore SA1515 // Single-line comment should be preceded by blank line +{ public override void Handle(PlayerControl innerNetObject, MiraOptionNetData data) { - if (AmongUsClient.Instance.HostId != innerNetObject.OwnerId) + if (AmongUsClient.Instance.HostId == innerNetObject.OwnerId) { - return; + ModdedOptionsManager.HandleSyncOptions(data.ShouldShowNotifications, data.Data ?? []); + } + } +} + +[RegisterCustomRpc((uint)MiraRpc.SyncRoleOptions)] +#pragma warning disable SA1515 // Single-line comment should be preceded by blank line (Justification: ReSharper suppression.) +// ReSharper disable once ClassNeverInstantiated.Global (Justification: Instantiated by Reactor.) +internal sealed class SyncRoleOptionsRpc(MiraApiPlugin plugin, uint id) : SyncOptionsRpc(plugin, id) +#pragma warning restore SA1515 // Single-line comment should be preceded by blank line +{ + public override void Handle(PlayerControl innerNetObject, MiraOptionNetData data) + { + if (AmongUsClient.Instance.HostId == innerNetObject.OwnerId) + { + CustomRoleManager.HandleSyncRoleOptions(data.ShouldShowNotifications, data.Data ?? []); } - - ModdedOptionsManager.HandleSyncOptions(data.ShouldShowNotifications, data.Data ?? []); } } diff --git a/MiraAPI/Networking/SyncRoleOptionsRpc.cs b/MiraAPI/Networking/SyncRoleOptionsRpc.cs deleted file mode 100644 index eb632ed4..00000000 --- a/MiraAPI/Networking/SyncRoleOptionsRpc.cs +++ /dev/null @@ -1,64 +0,0 @@ -using Hazel; -using MiraAPI.Roles; -using Reactor.Networking.Attributes; -using Reactor.Networking.Rpc; - -namespace MiraAPI.Networking; - -internal readonly struct MiraOptionNetData(bool showNotif, NetData[] data) -{ - public bool ShouldShowNotifications { get; } = showNotif; - public NetData[] Data { get; } = data; -} - -[RegisterCustomRpc((uint)MiraRpc.SyncRoleOptions)] -#pragma warning disable SA1515 // Single-line comment should be preceded by blank line (Justification: ReSharper suppression.) -// ReSharper disable once ClassNeverInstantiated.Global (Justification: Instantiated by Reactor.) -internal sealed class SyncRoleOptionsRpc(MiraApiPlugin plugin, uint id) : PlayerCustomRpc(plugin, id) -#pragma warning restore SA1515 // Single-line comment should be preceded by blank line -{ - public override RpcLocalHandling LocalHandling => RpcLocalHandling.None; - - public override void Write(MessageWriter writer, MiraOptionNetData data) - { - /*if (data == null) - { - writer.WritePacked(0U); - return; - }*/ - - var info = data.Data; - writer.Write(data.ShouldShowNotifications); - writer.WritePacked((uint)info.Length); - foreach (var netData in info) - { - writer.WritePacked(netData.Id); - writer.WriteBytesAndSize(netData.Data); - } - } - - public override MiraOptionNetData Read(MessageReader reader) - { - var shouldShowNotif = reader.ReadBoolean(); - var length = reader.ReadPackedUInt32(); - var data = new NetData[length]; - for (var i = 0; i < length; i++) - { - var dataId = reader.ReadPackedUInt32(); - var bytes = reader.ReadBytesAndSize(); - data[i] = new NetData(dataId, bytes); - } - - return new MiraOptionNetData(shouldShowNotif, data); - } - - public override void Handle(PlayerControl innerNetObject, MiraOptionNetData data) - { - if (AmongUsClient.Instance.HostId != innerNetObject.OwnerId) - { - return; - } - - CustomRoleManager.HandleSyncRoleOptions(data.ShouldShowNotifications, data.Data ?? []); - } -} diff --git a/MiraAPI/Patches/RoleGuidePatches.cs b/MiraAPI/Patches/RoleGuidePatches.cs index edaf0910..45254c81 100644 --- a/MiraAPI/Patches/RoleGuidePatches.cs +++ b/MiraAPI/Patches/RoleGuidePatches.cs @@ -962,13 +962,13 @@ public static class RoleGuidePatches private sealed class DetailedPanel(string title, string category, string modId, RoleBehaviour? role, GameModifier? modifier, uint typeId) { + public string Title => title; + public string Category => category; + public string ModId => modId; + public RoleBehaviour? Role => role; + public GameModifier? Modifier => modifier; + public uint TypeId => typeId; public MatchInfoRolePanel? Panel { get; set; } - public string Title { get; } = title; - public string Category { get; } = category; - public string ModId { get; } = modId; - public RoleBehaviour? Role { get; } = role; - public GameModifier? Modifier { get; } = modifier; - public uint TypeId { get; } = typeId; public int Amount { get; set; } public int Chance { get; set; } public float Likelihood { get; set; } diff --git a/MiraAPI/Presets/OptionPreset.cs b/MiraAPI/Presets/OptionPreset.cs index 6ecab1fd..90eb3894 100644 --- a/MiraAPI/Presets/OptionPreset.cs +++ b/MiraAPI/Presets/OptionPreset.cs @@ -18,22 +18,22 @@ public class OptionPreset(string name, MiraPluginInfo plugin, ConfigFile presetC /// /// Gets the name of the preset. /// - public string Name { get; } = name; + public string Name => name; /// /// Gets the plugin associated with the preset. /// - public MiraPluginInfo Plugin { get; } = plugin; + public MiraPluginInfo Plugin => plugin; /// /// Gets the of the plugin associated with the preset. /// - public ConfigFile PluginConfig { get; } = plugin.PluginConfig; + public ConfigFile PluginConfig => plugin.PluginConfig; /// /// Gets the for the preset. /// - public ConfigFile PresetConfig { get; } = presetConfig; + public ConfigFile PresetConfig => presetConfig; /// /// Gets or sets the button associated with the preset in the UI. diff --git a/MiraAPI/Utilities/GuideOptionsPatches.cs b/MiraAPI/Utilities/GuideOptionsPatches.cs index f44626a4..50fd9510 100644 --- a/MiraAPI/Utilities/GuideOptionsPatches.cs +++ b/MiraAPI/Utilities/GuideOptionsPatches.cs @@ -31,13 +31,13 @@ internal sealed class GuideOptionPage( IReadOnlyList modSearchTerms, List entries) { - public AbstractOptionGroup Group { get; } = group; + public AbstractOptionGroup Group => group; public List Groups { get; } = [group]; - public string Title { get; } = title; + public string Title => title; - public LoadableAsset Sprite { get; } = group.Sprite; + public LoadableAsset Sprite => group.Sprite; public int Order { get; set; } = order; @@ -45,13 +45,13 @@ internal sealed class GuideOptionPage( public uint GroupPriority { get; set; } = groupPriority; - public int Columns { get; } = columns; + public int Columns => columns; - public string ModAbbreviation { get; } = modAbbreviation; + public string ModAbbreviation => modAbbreviation; public HashSet ModSearchTerms { get; } = new(modSearchTerms, StringComparer.OrdinalIgnoreCase); - public List Entries { get; } = entries; + public List Entries => entries; } internal static class GuideOptionPages From 1aaaf050ad16693b65b29bc6b8bb3611de289283 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Sat, 7 Nov 2026 03:56:47 -0500 Subject: [PATCH 07/12] reorganise plugin loading code + debug mode stuff and also some minor project cleanup --- MiraAPI/Colors/PaletteManager.cs | 60 +++- MiraAPI/Events/MiraEventManager.cs | 22 ++ MiraAPI/GameModes/CustomGameModeManager.cs | 5 +- MiraAPI/GameOptions/ModdedOptionsManager.cs | 85 +++--- MiraAPI/Hud/CustomButtonManager.cs | 1 + MiraAPI/Keybinds/KeybindManager.cs | 62 +++- .../LocalSettingsButtonAttribute.cs | 4 +- MiraAPI/LocalSettings/LocalSettingsManager.cs | 66 ++++- .../MeetingAbilities/MeetingButtonManager.cs | 4 +- MiraAPI/MiraAPI.csproj | 7 - MiraAPI/MiraApiPlugin.cs | 3 + MiraAPI/Modifiers/ModifierManager.cs | 6 +- MiraAPI/PluginLoading/IMiraPlugin.cs | 5 + MiraAPI/PluginLoading/MiraPluginInfo.cs | 14 +- MiraAPI/PluginLoading/MiraPluginManager.cs | 274 +++--------------- MiraAPI/Roles/CustomRoleManager.cs | 22 +- 16 files changed, 335 insertions(+), 305 deletions(-) diff --git a/MiraAPI/Colors/PaletteManager.cs b/MiraAPI/Colors/PaletteManager.cs index b05c30fd..fb0106a8 100644 --- a/MiraAPI/Colors/PaletteManager.cs +++ b/MiraAPI/Colors/PaletteManager.cs @@ -1,7 +1,11 @@ -using System.Collections.Generic; +using System; +using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.Linq; using HarmonyLib; +using MiraAPI.PluginLoading; +using MiraAPI.Translation; +using MiraAPI.Utilities; using UnityEngine; namespace MiraAPI.Colors; @@ -16,9 +20,8 @@ public static class PaletteManager /// public static CustomColor[] RegisteredColors => [.. CustomColors]; - internal static readonly List CustomColors = []; - internal static readonly HashSet VariableColorNames = []; - + private static readonly List CustomColors = []; + private static readonly HashSet VariableColorNames = []; private static readonly CustomColorBrightness[] ColorBrightnessMap = [ CustomColorBrightness.Darker, // Red @@ -43,6 +46,55 @@ public static class PaletteManager private static int originalLength; + internal static bool RegisterColors(Type type, MiraPluginInfo miraPlugin) + { + if (!type.TryGetCustomAttribute(out var attribute)) + { + return false; + } + + if (!type.IsStatic()) + { + Error($"Color class {type.Name} must be static."); + return false; + } + + foreach (var property in type.GetProperties(MiraPluginManager.DeclaredStaticMembers)) + { + if (!property.PropertyType.IsAssignableTo(typeof(CustomColor))) + { + continue; + } + + if (property.GetValue(null) is not CustomColor color) + { + Error($"Color property {property.Name} in {type.Name} is not a CustomColor."); + continue; + } + + if (!string.IsNullOrEmpty(color.RawId) && !string.IsNullOrEmpty(attribute.IdPrefix)) + { + color.Name = MiraLocaleManager.GetOrCreateLocaleString(attribute.IdPrefix + color.RawId); + } + + CustomColors.Add(color); + + if (color is VariableColor) + VariableColorNames.Add(color.Name); + } + + if (!miraPlugin.DebugMode) + return true; + + foreach (var field in type.GetFields(MiraPluginManager.DeclaredStaticMembers) + .Where(f => !MiraPluginManager.IsAutoPropertyBackingField(f) && f.FieldType.IsAssignableTo(typeof(CustomColor)))) + { + Error($"{field.Name} is a field, not a property. Use properties for colors."); + } + + return true; + } + internal static void RegisterAllColors() { originalLength = Palette.PlayerColors.Length; diff --git a/MiraAPI/Events/MiraEventManager.cs b/MiraAPI/Events/MiraEventManager.cs index a8b34f16..1f4cf74c 100644 --- a/MiraAPI/Events/MiraEventManager.cs +++ b/MiraAPI/Events/MiraEventManager.cs @@ -1,6 +1,8 @@ using System; using System.Collections.Generic; using System.Reflection; +using MiraAPI.PluginLoading; +using MiraAPI.Utilities; namespace MiraAPI.Events; @@ -153,4 +155,24 @@ public static class MiraEventManager return true; } + + internal static void RegisterEvents(Type type) + { + foreach (var method in type.GetMethods(MiraPluginManager.DeclaredStaticMembers)) + { + if (!method.TryGetCustomAttribute(out var eventAttribute)) + continue; + + var parameters = method.GetParameters(); + + if (parameters.Length != 1 || !parameters[0].ParameterType.IsSubclassOf(typeof(MiraEvent))) + { + Error($"Invalid event registration method {method.Name} in {type.Name}"); + continue; + } + + var paramType = parameters[0].ParameterType; + RegisterEventHandler(paramType, method, eventAttribute.Priority); + } + } } diff --git a/MiraAPI/GameModes/CustomGameModeManager.cs b/MiraAPI/GameModes/CustomGameModeManager.cs index acb0f51b..8a74f4f1 100644 --- a/MiraAPI/GameModes/CustomGameModeManager.cs +++ b/MiraAPI/GameModes/CustomGameModeManager.cs @@ -29,13 +29,10 @@ public static class CustomGameModeManager { if (!typeof(AbstractGameMode).IsAssignableFrom(gameModeType)) { - Warning($"{gameModeType.Name} does not inherit CustomGameMode!"); return false; } - var instance = Activator.CreateInstance(gameModeType); - - if (instance is not AbstractGameMode mode) + if (Activator.CreateInstance(gameModeType) is not AbstractGameMode mode) { Error($"Failed to create instance of {gameModeType.Name}"); return false; diff --git a/MiraAPI/GameOptions/ModdedOptionsManager.cs b/MiraAPI/GameOptions/ModdedOptionsManager.cs index 677f43ee..e3c1446f 100644 --- a/MiraAPI/GameOptions/ModdedOptionsManager.cs +++ b/MiraAPI/GameOptions/ModdedOptionsManager.cs @@ -66,25 +66,17 @@ public static class ModdedOptionsManager notif.SettingsChangeMessageLogic(key, item, playSound); } - internal static bool RegisterGroup(Type type) - { - if (TypeToGroup.ContainsKey(type)) - { - Error($"Group {type.Name} already exists."); - return false; - } - - if (Activator.CreateInstance(type) is not AbstractOptionGroup group) - { - return false; - } - - RegisterGroupInternal(group, type); - return true; - } - + [SuppressMessage( + "Major Code Smell", + "S3011:Reflection should not be used to increase accessibility of classes, methods, or fields", + Justification = "Dynamic singleton initialization requires reflection to bypass the private field access modifier because the type is only known at runtime.")] internal static bool RegisterGroup(Type type, MiraPluginInfo pluginInfo) { + if (!type.IsAssignableTo(typeof(AbstractOptionGroup))) + { + return false; + } + if (TypeToGroup.ContainsKey(type)) { Error($"Group {type.Name} already exists."); @@ -110,24 +102,49 @@ public static class ModdedOptionsManager pluginInfo.InternalOptionGroups.Add(group); - RegisterGroupInternal(group, type); - return true; - } - - [SuppressMessage( - "Major Code Smell", - "S3011:Reflection should not be used to increase accessibility of classes, methods, or fields", - Justification = "Dynamic singleton initialization requires reflection to bypass the private field access modifier because the type is only known at runtime.")] - private static void RegisterGroupInternal(AbstractOptionGroup group, Type type) - { Groups.Add(group); TypeToGroup.Add(type, group); typeof(OptionGroupSingleton<>).MakeGenericType(type) .GetField("_instance", BindingFlags.Static | BindingFlags.NonPublic)! .SetValue(null, group); + + foreach (var property in type.GetProperties(MiraPluginManager.DeclaredInstanceMembers)) + { + if (property.PropertyType.IsAssignableTo(typeof(IModdedOption))) + { + RegisterPropertyOption(type, property, pluginInfo); + continue; + } + + if (property.PropertyType.IsAssignableTo(typeof(IModdedOptionList))) + { + RegisterPropertyOptionList(type, property, pluginInfo); + continue; + } + + if (property.TryGetCustomAttribute(out var attribute)) + { + RegisterAttributeOption(type, attribute, property, pluginInfo); + continue; + } + + if (property.TryGetCustomAttribute(out var listAttr)) + { + RegisterAttributeOptionList(type, listAttr, property, pluginInfo); + } + } + + foreach (var field in type.GetFields(MiraPluginManager.DeclaredInstanceMembers) + .Where(f => !MiraPluginManager.IsAutoPropertyBackingField(f) + && (f.FieldType.IsAssignableTo(typeof(IModdedOption)) || f.FieldType.IsAssignableTo(typeof(IModdedOptionList))))) + { + Error($"{field.Name} is a field, not a property. Use properties for options."); + } + + return true; } - internal static void RegisterPropertyOption(Type type, PropertyInfo property, MiraPluginInfo pluginInfo) + private static void RegisterPropertyOption(Type type, PropertyInfo property, MiraPluginInfo pluginInfo) { if (!TypeToGroup.TryGetValue(type, out var group)) { @@ -144,7 +161,7 @@ public static class ModdedOptionsManager RegisterOption(option, group, property.Name, pluginInfo); } - internal static void RegisterAttributeOption( + private static void RegisterAttributeOption( Type type, ModdedOptionAttribute attribute, PropertyInfo property, @@ -209,7 +226,7 @@ public static class ModdedOptionsManager RegisterOption(option, group, property.Name, pluginInfo); } - internal static void RegisterPropertyOptionList(Type type, PropertyInfo property, MiraPluginInfo pluginInfo) + private static void RegisterPropertyOptionList(Type type, PropertyInfo property, MiraPluginInfo pluginInfo) { if (!TypeToGroup.TryGetValue(type, out var group)) { @@ -231,7 +248,7 @@ public static class ModdedOptionsManager } } - internal static void RegisterAttributeOptionList( + private static void RegisterAttributeOptionList( Type type, ModdedOptionListAttribute attribute, PropertyInfo property, @@ -342,7 +359,7 @@ public static class ModdedOptionsManager } } - internal static void RegisterOption( + private static void RegisterOption( IModdedOption option, AbstractOptionGroup group, string propertyName, @@ -363,9 +380,9 @@ public static class ModdedOptionsManager { var chunks = ModdedOptions.Values.Select(option => option.GetNetData()).ChunkNetData(1000); - while (chunks.Count > 0) + while (chunks.TryDequeue(out var netData)) { - Rpc.Instance.SendTo(PlayerControl.LocalPlayer, targetId, new MiraOptionNetData(false, chunks.Dequeue())); + Rpc.Instance.SendTo(PlayerControl.LocalPlayer, targetId, new MiraOptionNetData(false, netData)); } } diff --git a/MiraAPI/Hud/CustomButtonManager.cs b/MiraAPI/Hud/CustomButtonManager.cs index a532f8e0..1e8656ed 100644 --- a/MiraAPI/Hud/CustomButtonManager.cs +++ b/MiraAPI/Hud/CustomButtonManager.cs @@ -45,6 +45,7 @@ public static class CustomButtonManager CustomButtons.Add(button); pluginInfo.InternalButtons.Add(button); + typeof(CustomButtonSingleton<>).MakeGenericType(buttonType) .GetField("_instance", BindingFlags.Static | BindingFlags.NonPublic)! // Suppression message refers to this .SetValue(null, button); diff --git a/MiraAPI/Keybinds/KeybindManager.cs b/MiraAPI/Keybinds/KeybindManager.cs index b3097e14..057b3243 100644 --- a/MiraAPI/Keybinds/KeybindManager.cs +++ b/MiraAPI/Keybinds/KeybindManager.cs @@ -2,6 +2,8 @@ using System; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; using System.Linq; +using MiraAPI.PluginLoading; +using MiraAPI.Translation; using MiraAPI.Utilities; using Rewired; @@ -76,6 +78,48 @@ public static class KeybindManager } } + internal static bool RegisterKeybinds(Type type, IMiraPlugin plugin) + { + if (!type.IsDefined()) + { + return false; + } + + if (!type.IsStatic()) + { + Error($"Keybinds class {type.Name} must be static."); + return false; + } + + foreach (var property in type.GetProperties(MiraPluginManager.DeclaredStaticMembers)) + { + if (property.PropertyType != typeof(MiraKeybind)) + { + continue; + } + + if (property.GetValue(null) is not MiraKeybind keybind) + { + Error($"Keybind property {property.Name} in {type.Name} is not a MiraKeybind."); + continue; + } + + Keybinds.Add(keybind); + keybind.SourcePluginName = plugin.OptionsTitleText.Translate(); + } + + if (!plugin.DebugMode) + return true; + + foreach (var field in type.GetFields(MiraPluginManager.DeclaredStaticMembers) + .Where(f => !MiraPluginManager.IsAutoPropertyBackingField(f) && f.FieldType.IsAssignableTo(typeof(MiraKeybind)))) + { + Error($"{field.Name} is a field, not a property. Use properties for keybinds."); + } + + return true; + } + /// /// Returns all conflicts where s use the same key. /// @@ -89,16 +133,18 @@ public static class KeybindManager if (key == KeyboardKeyCode.None) continue; var all = GetKeybindsForKey(key, true); - if (all.Length > 1) + if (all.Length <= 1) { - if (!conflicts.TryGetValue(key, out var group)) - { - group = []; - conflicts.Add(key, group); - } - - if (!group.Contains(keybind)) group.Add(keybind); + continue; } + + if (!conflicts.TryGetValue(key, out var group)) + { + group = []; + conflicts.Add(key, group); + } + + if (!group.Contains(keybind)) group.Add(keybind); } return conflicts; diff --git a/MiraAPI/LocalSettings/Attributes/LocalSettingsButtonAttribute.cs b/MiraAPI/LocalSettings/Attributes/LocalSettingsButtonAttribute.cs index 83a39556..8c0eb3d4 100644 --- a/MiraAPI/LocalSettings/Attributes/LocalSettingsButtonAttribute.cs +++ b/MiraAPI/LocalSettings/Attributes/LocalSettingsButtonAttribute.cs @@ -6,6 +6,4 @@ namespace MiraAPI.LocalSettings.Attributes; /// Attribute for local setting buttons. /// [AttributeUsage(AttributeTargets.Property)] -public class LocalSettingsButtonAttribute : Attribute -{ -} +public class LocalSettingsButtonAttribute : Attribute; diff --git a/MiraAPI/LocalSettings/LocalSettingsManager.cs b/MiraAPI/LocalSettings/LocalSettingsManager.cs index 4907d8c1..44d77681 100644 --- a/MiraAPI/LocalSettings/LocalSettingsManager.cs +++ b/MiraAPI/LocalSettings/LocalSettingsManager.cs @@ -1,8 +1,13 @@ using System; using System.Collections.Generic; using System.Diagnostics.CodeAnalysis; +using System.Linq; using System.Reflection; +using BepInEx.Configuration; using BepInEx.Unity.IL2CPP; +using MiraAPI.LocalSettings.Attributes; +using MiraAPI.PluginLoading; +using MiraAPI.Utilities; namespace MiraAPI.LocalSettings; @@ -19,9 +24,9 @@ public static class LocalSettingsManager "Major Code Smell", "S3011:Reflection should not be used to increase accessibility of classes, methods, or fields", Justification = "Dynamic singleton initialization requires reflection to bypass the private field access modifier because the type is only known at runtime.")] - internal static bool RegisterTab(Type type, BasePlugin pluginInfo) + internal static bool RegisterLocalTabs(Type type, BasePlugin pluginInfo) { - if (Activator.CreateInstance(type, pluginInfo.Config) is not LocalSettingsTab tab) + if (!type.IsAssignableTo(typeof(LocalSettingsTab))) { return false; } @@ -32,17 +37,64 @@ public static class LocalSettingsManager return false; } - Tabs.Add(tab); - if (tab.ShouldCreateButton) + if (Activator.CreateInstance(type, pluginInfo.Config) is not LocalSettingsTab tabInstance) { - AvailableTabs.Add(tab); + return false; } - TypeToTab.Add(type, tab); + Tabs.Add(tabInstance); + + if (tabInstance.ShouldCreateButton) + { + AvailableTabs.Add(tabInstance); + } + + TypeToTab.Add(type, tabInstance); typeof(LocalSettingsTabSingleton<>).MakeGenericType(type) .GetField("_instance", BindingFlags.Static | BindingFlags.NonPublic)! // Suppression message refers to this - .SetValue(null, tab); + .SetValue(null, tabInstance); + + foreach (var property in type.GetProperties(MiraPluginManager.DeclaredInstanceMembers)) + { + if (property.IsDefined()) + { + if (property.GetValue(tabInstance) is not LocalSettingsButton button) + { + Error($"Option property {property.Name} in {type.Name} has to be a settings button."); + continue; + } + + button.Tab = tabInstance; + tabInstance.Buttons.Add(button); + continue; + } + + if (!property.TryGetCustomAttribute(out var attribute)) + { + continue; + } + + if (!typeof(ConfigEntryBase).IsAssignableFrom(property.PropertyType)) + { + continue; + } + + if (property.GetValue(tabInstance) is not ConfigEntryBase configEntry) + { + Error($"Option property {property.Name} in {type.Name} has to be a config entry."); + continue; + } + + attribute.CreateSetting(type, configEntry); + } + + foreach (var field in type.GetFields(MiraPluginManager.DeclaredInstanceMembers) + .Where(f => !MiraPluginManager.IsAutoPropertyBackingField(f) + && (f.FieldType.IsAssignableTo(typeof(ConfigEntryBase)) || f.FieldType.IsAssignableTo(typeof(LocalSettingsButton))))) + { + Error($"{field.Name} is a field, not a property. Use properties for local settings or buttons."); + } return true; } diff --git a/MiraAPI/MeetingAbilities/MeetingButtonManager.cs b/MiraAPI/MeetingAbilities/MeetingButtonManager.cs index 5ca75d85..92348f5d 100644 --- a/MiraAPI/MeetingAbilities/MeetingButtonManager.cs +++ b/MiraAPI/MeetingAbilities/MeetingButtonManager.cs @@ -13,12 +13,12 @@ namespace MiraAPI.MeetingAbilities; public static class MeetingButtonManager { /// - /// Gets a list if==of all registered . + /// Gets a list of all registered . /// public static List TargetedButtons { get; internal set; } = []; /// - /// Gets a list if==of all registered . + /// Gets a list of all registered . /// public static List UntargetedButtons { get; internal set; } = []; diff --git a/MiraAPI/MiraAPI.csproj b/MiraAPI/MiraAPI.csproj index b6bcb5d2..2d47477a 100644 --- a/MiraAPI/MiraAPI.csproj +++ b/MiraAPI/MiraAPI.csproj @@ -5,7 +5,6 @@ AllOfUs.MiraAPI true true - IDE0031;IDE0032 @@ -16,11 +15,5 @@ - - - - - - diff --git a/MiraAPI/MiraApiPlugin.cs b/MiraAPI/MiraApiPlugin.cs index dc926b2e..7e744781 100644 --- a/MiraAPI/MiraApiPlugin.cs +++ b/MiraAPI/MiraApiPlugin.cs @@ -41,6 +41,9 @@ public partial class MiraApiPlugin : BasePlugin, IMiraPlugin /// public bool DisplayOnOptionsMenu => false; + /// + public bool DebugMode => IsDevBuild; + /// /// Gets a value indicating whether the current device is running Starlight (on mobile). /// diff --git a/MiraAPI/Modifiers/ModifierManager.cs b/MiraAPI/Modifiers/ModifierManager.cs index 935c82e5..f12d2172 100644 --- a/MiraAPI/Modifiers/ModifierManager.cs +++ b/MiraAPI/Modifiers/ModifierManager.cs @@ -72,7 +72,9 @@ public static class ModifierManager TypeToIdModifierMap.Add(modifierType, _nextTypeId); BaseModifier modifier; - if (modifierType.GetConstructor(Type.EmptyTypes) != null) + var ctor = modifierType.GetConstructor(Type.EmptyTypes); + + if (ctor != null) { modifier = (BaseModifier)Activator.CreateInstance(modifierType)!; } @@ -90,7 +92,7 @@ public static class ModifierManager return true; } - if (modifierType.GetConstructor(Type.EmptyTypes) == null) + if (ctor == null) { Error($"Game Modifier {modifierType.FullName} does not have a parameterless constructor!"); return false; diff --git a/MiraAPI/PluginLoading/IMiraPlugin.cs b/MiraAPI/PluginLoading/IMiraPlugin.cs index c77a97e0..f1f9fc30 100644 --- a/MiraAPI/PluginLoading/IMiraPlugin.cs +++ b/MiraAPI/PluginLoading/IMiraPlugin.cs @@ -58,6 +58,11 @@ public interface IMiraPlugin /// string CustomOptionMenuTwoDescription => "Apply game settings for this mod!"; + /// + /// Gets a value indicating whether the plugin is in debug mode. + /// + bool DebugMode => false; + /// /// Gets the for the plugin. /// diff --git a/MiraAPI/PluginLoading/MiraPluginInfo.cs b/MiraAPI/PluginLoading/MiraPluginInfo.cs index ca7812cd..4bbfe363 100644 --- a/MiraAPI/PluginLoading/MiraPluginInfo.cs +++ b/MiraAPI/PluginLoading/MiraPluginInfo.cs @@ -1,5 +1,6 @@ using System.Collections.Generic; using System.Collections.ObjectModel; +using System.Reflection; using BepInEx; using BepInEx.Configuration; using MiraAPI.GameModes; @@ -17,12 +18,13 @@ namespace MiraAPI.PluginLoading; /// public class MiraPluginInfo { - internal MiraPluginInfo(IMiraPlugin miraPlugin, PluginInfo info) + internal MiraPluginInfo(IMiraPlugin miraPlugin, PluginInfo info, Assembly assembly) { MiraPlugin = miraPlugin; PluginConfig = miraPlugin.GetConfigFile(); PluginInfo = info; PluginId = info.Metadata.GUID; + PluginAssembly = assembly; } /// @@ -45,6 +47,16 @@ public class MiraPluginInfo /// public ConfigFile PluginConfig { get; } + /// + /// Gets the plugin's . + /// + public Assembly PluginAssembly { get; } + + /// + /// Gets a value indicating whether the plugin is in debug mode. + /// + public bool DebugMode => MiraPlugin.DebugMode; + /// /// Gets a of this 's s. This is not safe for s with constructors. /// diff --git a/MiraAPI/PluginLoading/MiraPluginManager.cs b/MiraAPI/PluginLoading/MiraPluginManager.cs index e0b7ff38..d0bcaa14 100644 --- a/MiraAPI/PluginLoading/MiraPluginManager.cs +++ b/MiraAPI/PluginLoading/MiraPluginManager.cs @@ -9,24 +9,19 @@ using System.Runtime.CompilerServices; using BepInEx; using BepInEx.Configuration; using BepInEx.Unity.IL2CPP; -using HarmonyLib; using MiraAPI.Colors; using MiraAPI.Events; using MiraAPI.GameEnd; using MiraAPI.GameModes; using MiraAPI.GameOptions; -using MiraAPI.GameOptions.Attributes; using MiraAPI.Hud; using MiraAPI.Keybinds; using MiraAPI.LocalSettings; -using MiraAPI.LocalSettings.Attributes; using MiraAPI.MeetingAbilities; using MiraAPI.Modifiers; using MiraAPI.Presets; using MiraAPI.Roles; -using MiraAPI.Translation; using MiraAPI.Utilities; -using Reactor.Networking; namespace MiraAPI.PluginLoading; @@ -40,10 +35,10 @@ public sealed class MiraPluginManager { } - private const BindingFlags DeclaredInstanceMembers = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.DeclaredOnly; - private const BindingFlags DeclaredStaticMembers = BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.DeclaredOnly; + internal const BindingFlags DeclaredInstanceMembers = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.DeclaredOnly; + internal const BindingFlags DeclaredStaticMembers = BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.DeclaredOnly; - private readonly Dictionary _registeredPlugins = []; + private readonly Dictionary _registeredPlugins = []; internal MiraPluginInfo[] RegisteredPlugins { get; private set; } = []; internal MiraPluginInfo[] RegisteredPluginsWithOptions { get; private set; } = []; @@ -104,7 +99,7 @@ public sealed class MiraPluginManager private MiraPluginInfo RegisterPlugin(Assembly assembly, IMiraPlugin plugin, PluginInfo pluginInfo, BasePlugin basePlugin, bool isMira) { - var info = new MiraPluginInfo(plugin, pluginInfo); + var info = new MiraPluginInfo(plugin, pluginInfo, assembly); var roles = new List(); var oldConfigSetting = info.PluginConfig.SaveOnConfigSet; @@ -117,7 +112,7 @@ public sealed class MiraPluginManager info.InternalOptionGroups.Sort((x, y) => x.GroupPriority.CompareTo(y.GroupPriority)); QueuedRoleRegistrations.Add(info, roles); - _registeredPlugins.Add(assembly, info); + _registeredPlugins.Add(pluginInfo.Metadata.GUID, info); info.SavePublicCollections(); PresetManager.CreateDefaultPreset(info); @@ -126,12 +121,13 @@ public sealed class MiraPluginManager return info; } - private static bool IsAutoPropertyBackingField(FieldInfo field) + internal static bool IsAutoPropertyBackingField(FieldInfo field) { return field.IsDefined(false) && - field.Name.Contains(">k__BackingField", StringComparison.Ordinal); + field.Name.Contains(">k__BackingField", StringComparison.Ordinal); } + [SuppressMessage("Minor Code Smell", "S3626:Jump statements should not be redundant", Justification = "Code consistency.")] private static void ProcessAssemblyTypes(Assembly assembly, MiraPluginInfo info, BasePlugin basePlugin, IMiraPlugin plugin, List roles, bool isMira) { foreach (var type in assembly.GetTypes()) @@ -141,21 +137,30 @@ public sealed class MiraPluginManager RegisterEvents(type); - if (RegisterModifier(type, info)) - continue; - if (RegisterOptions(type, info)) continue; if (RegisterLocalTabs(type, basePlugin)) continue; + if (RegisterColors(type, info)) + continue; + if (RegisterRole(type, info, roles)) continue; + if (RegisterModifier(type, info)) + continue; + if (RegisterButton(type, info)) continue; + if (RegisterKeybinds(type, plugin)) + continue; + + if (RegisterGameModeAttribute(type, info)) + continue; + if (RegisterGameOver(type)) continue; @@ -164,37 +169,18 @@ public sealed class MiraPluginManager if (RegisterTargetedMeetingAbility(type, info)) continue; - - if (RegisterGameModeAttribute(type, info)) - continue; - - if (!RegisterColorClasses(type)) - RegisterKeybinds(type, plugin); } } private static void RegisterEvents(Type type) { - foreach (var method in AccessTools.GetDeclaredMethods(type)) + try { - if (!method.TryGetCustomAttribute(out var eventAttribute)) - continue; - - if (!method.IsStatic) - { - Error($"Event method {method.Name} in {type.Name} must be static."); - continue; - } - - var parameters = method.GetParameters(); - if (parameters.Length != 1 || !parameters[0].ParameterType.IsSubclassOf(typeof(MiraEvent))) - { - Error($"Invalid event registration method {method.Name} in {type.Name}"); - continue; - } - - var paramType = parameters[0].ParameterType; - MiraEventManager.RegisterEventHandler(paramType, method, eventAttribute.Priority); + MiraEventManager.RegisterEvents(type); + } + catch (Exception e) + { + Error($"Failed to register events in {type.Name}: {e}"); } } @@ -205,7 +191,7 @@ public sealed class MiraPluginManager /// A . public static MiraPluginInfo? GetPluginByGuid(string pluginId) { - return Instance._registeredPlugins.Values.FirstOrDefault(plugin => plugin.PluginId == pluginId); + return Instance._registeredPlugins.GetValueOrDefault(pluginId); } private static bool RegisterGameOver(Type type) @@ -225,54 +211,7 @@ public sealed class MiraPluginManager { try { - if (!type.IsAssignableTo(typeof(AbstractOptionGroup))) - { - return false; - } - - if (!ModdedOptionsManager.RegisterGroup(type, pluginInfo)) - { - return false; - } - - foreach (var property in type.GetProperties(DeclaredInstanceMembers)) - { - if (property.IsDefined()) - continue; - - if (property.PropertyType.IsAssignableTo(typeof(IModdedOption))) - { - ModdedOptionsManager.RegisterPropertyOption(type, property, pluginInfo); - continue; - } - - if (property.PropertyType.IsAssignableTo(typeof(IModdedOptionList))) - { - ModdedOptionsManager.RegisterPropertyOptionList(type, property, pluginInfo); - continue; - } - - var attribute = property.GetCustomAttribute(); - if (attribute != null) - { - ModdedOptionsManager.RegisterAttributeOption(type, attribute, property, pluginInfo); - continue; - } - - var listAttr = property.GetCustomAttribute(); - if (listAttr != null) - { - ModdedOptionsManager.RegisterAttributeOptionList(type, listAttr, property, pluginInfo); - } - } - - foreach (var field in type.GetFields(DeclaredInstanceMembers) - .Where(f => !IsAutoPropertyBackingField(f) && (f.FieldType.IsAssignableTo(typeof(IModdedOption)) || f.FieldType.IsAssignableTo(typeof(IModdedOptionList))))) - { - Error($"{field.Name} is a field, not a property. Use properties for options."); - } - - return true; + return ModdedOptionsManager.RegisterGroup(type, pluginInfo); } catch (Exception e) { @@ -286,19 +225,7 @@ public sealed class MiraPluginManager { try { - if (!(typeof(RoleBehaviour).IsAssignableFrom(type) && typeof(ICustomRole).IsAssignableFrom(type))) - { - return false; - } - - if (!ModList.GetById(pluginInfo.PluginId).IsRequiredOnAllClients) - { - Error("Custom roles are only supported on all clients."); - return false; - } - - roles.Add(type); - return true; + return CustomRoleManager.RegisterRole(type, pluginInfo, roles); } catch (Exception e) { @@ -308,51 +235,11 @@ public sealed class MiraPluginManager return false; } - private static bool RegisterColorClasses(Type type) + private static bool RegisterColors(Type type, MiraPluginInfo miraPlugin) { try { - if (!type.TryGetCustomAttribute(out var attribute)) - { - return false; - } - - if (!type.IsStatic()) - { - Error($"Color class {type.Name} must be static."); - return false; - } - - foreach (var property in type.GetProperties(DeclaredStaticMembers)) - { - if (!property.PropertyType.IsAssignableTo(typeof(CustomColor))) - { - continue; - } - - if (property.GetValue(null) is not CustomColor color) - { - Error($"Color property {property.Name} in {type.Name} is not a CustomColor."); - continue; - } - - if (!string.IsNullOrEmpty(color.RawId) && !string.IsNullOrEmpty(attribute.IdPrefix)) - { - color.Name = MiraLocaleManager.GetOrCreateLocaleString(attribute.IdPrefix + color.RawId); - } - - PaletteManager.CustomColors.Add(color); - - if (color is VariableColor) - PaletteManager.VariableColorNames.Add(color.Name); - } - - foreach (var field in type.GetFields(DeclaredStaticMembers).Where(f => !IsAutoPropertyBackingField(f) && f.FieldType.IsAssignableTo(typeof(CustomColor)))) - { - Error($"{field.Name} is a field, not a property. Use properties for colors."); - } - - return true; + return PaletteManager.RegisterColors(type, miraPlugin); } catch (Exception e) { @@ -371,8 +258,9 @@ public sealed class MiraPluginManager catch (Exception e) { Error($"Failed to register modifier {type.Name}: {e}"); - return false; } + + return false; } private static bool RegisterButton(Type type, MiraPluginInfo pluginInfo) @@ -393,8 +281,7 @@ public sealed class MiraPluginManager { try { - if (typeof(AbstractGameMode).IsAssignableFrom(type)) - return CustomGameModeManager.RegisterGameMode(type, pluginInfo); + return CustomGameModeManager.RegisterGameMode(type, pluginInfo); } catch (Exception e) { @@ -408,55 +295,7 @@ public sealed class MiraPluginManager { try { - if (!type.IsAssignableTo(typeof(LocalSettingsTab))) - { - return false; - } - - if (!LocalSettingsManager.RegisterTab(type, pluginInfo)) - { - return false; - } - - if (!LocalSettingsManager.TypeToTab.TryGetValue(type, out var tabInstance)) - { - return false; - } - - foreach (var property in type.GetProperties(DeclaredInstanceMembers)) - { - if (property.IsDefined() && - property.PropertyType.IsAssignableTo(typeof(LocalSettingsButton))) - { - var button = property.GetValue(tabInstance) as LocalSettingsButton; - button!.Tab = tabInstance; - tabInstance.Buttons.Add(button); - continue; - } - - if (!typeof(ConfigEntryBase).IsAssignableFrom(property.PropertyType)) - { - continue; - } - - if (property.GetValue(tabInstance) is not ConfigEntryBase configEntry) - { - Error($"Option property {property.Name} in {type.Name} has to be a config entry."); - continue; - } - - if (property.TryGetCustomAttribute(out var attribute)) - { - attribute.CreateSetting(type, configEntry); - } - } - - foreach (var field in type.GetFields(DeclaredInstanceMembers).Where(f => !IsAutoPropertyBackingField(f) && f.FieldType.IsAssignableTo(typeof(ConfigEntryBase)) && f.IsDefined())) - { - Error($"{field.Name} is a field, not a property. Use properties for local settings."); - } - - return true; + return LocalSettingsManager.RegisterLocalTabs(type, pluginInfo); } catch (Exception e) { @@ -466,47 +305,18 @@ public sealed class MiraPluginManager return false; } - private static void RegisterKeybinds(Type type, IMiraPlugin plugin) + private static bool RegisterKeybinds(Type type, IMiraPlugin plugin) { try { - if (!type.IsDefined()) - { - return; - } - - if (!type.IsStatic()) - { - Error($"Keybinds class {type.Name} must be static."); - return; - } - - foreach (var property in type.GetProperties(DeclaredStaticMembers)) - { - if (property.PropertyType != typeof(MiraKeybind)) - { - continue; - } - - if (property.GetValue(null) is not MiraKeybind keybind) - { - Error($"Keybind property {property.Name} in {type.Name} is not a MiraKeybind."); - continue; - } - - KeybindManager.Keybinds.Add(keybind); - keybind.SourcePluginName = plugin.OptionsTitleText.Translate(); - } - - foreach (var field in type.GetFields(DeclaredStaticMembers).Where(f => !IsAutoPropertyBackingField(f) && f.FieldType.IsAssignableTo(typeof(MiraKeybind)))) - { - Error($"{field.Name} is a field, not a property. Use properties for keybinds."); - } + return KeybindManager.RegisterKeybinds(type, plugin); } catch (Exception e) { Error($"Failed to register keybind class {type.Name}: {e}"); } + + return false; } private static bool RegisterMeetingAbility(Type type, MiraPluginInfo info) @@ -518,8 +328,9 @@ public sealed class MiraPluginManager catch (Exception e) { Error($"Failed to register meeting ability {type.Name}: {e}"); - return false; } + + return false; } private static bool RegisterTargetedMeetingAbility(Type type, MiraPluginInfo info) @@ -531,7 +342,8 @@ public sealed class MiraPluginManager catch (Exception e) { Error($"Failed to register targeted meeting ability {type.Name}: {e}"); - return false; } + + return false; } } diff --git a/MiraAPI/Roles/CustomRoleManager.cs b/MiraAPI/Roles/CustomRoleManager.cs index d9325e6a..a2a0164f 100644 --- a/MiraAPI/Roles/CustomRoleManager.cs +++ b/MiraAPI/Roles/CustomRoleManager.cs @@ -10,6 +10,7 @@ using MiraAPI.PluginLoading; using MiraAPI.Translation; using MiraAPI.Utilities; using MiraAPI.Utilities.Assets; +using Reactor.Networking; using Reactor.Networking.Rpc; using Reactor.Utilities.Extensions; using TMPro; @@ -118,6 +119,23 @@ public static class CustomRoleManager pluginInfo.PluginConfig.SaveOnConfigSet = oldConfigSetting; } + internal static bool RegisterRole(Type type, MiraPluginInfo miraPlugin, List roles) + { + if (!(typeof(RoleBehaviour).IsAssignableFrom(type) && typeof(ICustomRole).IsAssignableFrom(type))) + { + return false; + } + + if (!ModList.GetById(miraPlugin.PluginId).IsRequiredOnAllClients) + { + Error("Custom roles are only supported on all clients."); + return false; + } + + roles.Add(type); + return true; + } + private static RoleBehaviour? RegisterRole(Type roleType, MiraPluginInfo parentMod) { if (!(typeof(RoleBehaviour).IsAssignableFrom(roleType) && typeof(ICustomRole).IsAssignableFrom(roleType))) @@ -278,9 +296,9 @@ public static class CustomRoleManager .Select(x => ((ICustomRole)x).GetNetData()) .ChunkNetData(1000); - while (data.Count > 0) + while (data.TryDequeue(out var netData)) { - Rpc.Instance.SendTo(PlayerControl.LocalPlayer, targetId, new MiraOptionNetData(false, data.Dequeue())); + Rpc.Instance.SendTo(PlayerControl.LocalPlayer, targetId, new MiraOptionNetData(false, netData)); } } From 94d68a34e3a788505054d1f55c3e8161cf272802 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Sat, 7 Nov 2026 15:47:22 -0500 Subject: [PATCH 08/12] improve registration behaviour --- MiraAPI/Colors/PaletteManager.cs | 6 ----- MiraAPI/Events/MiraEventManager.cs | 11 ++++++++- MiraAPI/Events/RegisterEventsAttribute.cs | 9 ++++++++ MiraAPI/GameEnd/GameOverManager.cs | 8 +------ MiraAPI/GameModes/CustomGameModeManager.cs | 6 ----- MiraAPI/Keybinds/KeybindManager.cs | 6 ----- MiraAPI/Modifiers/ModifierManager.cs | 7 +++--- MiraAPI/PluginLoading/IMiraPlugin.cs | 15 ++++++++++++- MiraAPI/PluginLoading/MiraPluginManager.cs | 26 +++++++++++----------- 9 files changed, 51 insertions(+), 43 deletions(-) create mode 100644 MiraAPI/Events/RegisterEventsAttribute.cs diff --git a/MiraAPI/Colors/PaletteManager.cs b/MiraAPI/Colors/PaletteManager.cs index fb0106a8..837e6bc2 100644 --- a/MiraAPI/Colors/PaletteManager.cs +++ b/MiraAPI/Colors/PaletteManager.cs @@ -53,12 +53,6 @@ public static class PaletteManager return false; } - if (!type.IsStatic()) - { - Error($"Color class {type.Name} must be static."); - return false; - } - foreach (var property in type.GetProperties(MiraPluginManager.DeclaredStaticMembers)) { if (!property.PropertyType.IsAssignableTo(typeof(CustomColor))) diff --git a/MiraAPI/Events/MiraEventManager.cs b/MiraAPI/Events/MiraEventManager.cs index 1f4cf74c..8b48de3f 100644 --- a/MiraAPI/Events/MiraEventManager.cs +++ b/MiraAPI/Events/MiraEventManager.cs @@ -156,8 +156,17 @@ public static class MiraEventManager return true; } - internal static void RegisterEvents(Type type) + internal static void RegisterEvents(Type type, IMiraPlugin miraPlugin) { + if (miraPlugin.ForceRegisterEvents) + { + Warning("For optimisation reasons, MiraAPI no longer automatically searches every type for events. Please use RegisterEventsAttribute moving forward."); + } + else if (!type.IsDefined()) + { + return; + } + foreach (var method in type.GetMethods(MiraPluginManager.DeclaredStaticMembers)) { if (!method.TryGetCustomAttribute(out var eventAttribute)) diff --git a/MiraAPI/Events/RegisterEventsAttribute.cs b/MiraAPI/Events/RegisterEventsAttribute.cs new file mode 100644 index 00000000..8b8a0184 --- /dev/null +++ b/MiraAPI/Events/RegisterEventsAttribute.cs @@ -0,0 +1,9 @@ +using System; + +namespace MiraAPI.Events; + +/// +/// Register a container of s. +/// +[AttributeUsage(AttributeTargets.Method)] +public class RegisterEventContainerAttribute : Attribute; diff --git a/MiraAPI/GameEnd/GameOverManager.cs b/MiraAPI/GameEnd/GameOverManager.cs index f536c49b..0a6288d8 100644 --- a/MiraAPI/GameEnd/GameOverManager.cs +++ b/MiraAPI/GameEnd/GameOverManager.cs @@ -14,13 +14,7 @@ public static class GameOverManager private static int nextId = Enum.GetNames().Length; - /// - /// Register a . - /// - /// Type of the . - /// Thrown when the type is not a subclass of , is abstract, or does not have a parameterless constructor. - /// if the game over was registered successfully, otherwise. - public static bool RegisterGameOver(Type gameOverType) + internal static bool RegisterGameOver(Type gameOverType) { if (!typeof(CustomGameOver).IsAssignableFrom(gameOverType)) { diff --git a/MiraAPI/GameModes/CustomGameModeManager.cs b/MiraAPI/GameModes/CustomGameModeManager.cs index 8a74f4f1..b6e90e39 100644 --- a/MiraAPI/GameModes/CustomGameModeManager.cs +++ b/MiraAPI/GameModes/CustomGameModeManager.cs @@ -19,12 +19,6 @@ public static class CustomGameModeManager return ++lastId; } - /// - /// Register gamemode from type. - /// - /// Type of gamemode class, should inherit from . - /// The custom plugin info of the mod. - /// Whether the gamemode was successfully registered. internal static bool RegisterGameMode(Type gameModeType, MiraPluginInfo pluginInfo) { if (!typeof(AbstractGameMode).IsAssignableFrom(gameModeType)) diff --git a/MiraAPI/Keybinds/KeybindManager.cs b/MiraAPI/Keybinds/KeybindManager.cs index 057b3243..1d71254a 100644 --- a/MiraAPI/Keybinds/KeybindManager.cs +++ b/MiraAPI/Keybinds/KeybindManager.cs @@ -85,12 +85,6 @@ public static class KeybindManager return false; } - if (!type.IsStatic()) - { - Error($"Keybinds class {type.Name} must be static."); - return false; - } - foreach (var property in type.GetProperties(MiraPluginManager.DeclaredStaticMembers)) { if (property.PropertyType != typeof(MiraKeybind)) diff --git a/MiraAPI/Modifiers/ModifierManager.cs b/MiraAPI/Modifiers/ModifierManager.cs index f12d2172..aa6c5120 100644 --- a/MiraAPI/Modifiers/ModifierManager.cs +++ b/MiraAPI/Modifiers/ModifierManager.cs @@ -68,8 +68,9 @@ public static class ModifierManager return false; } - IdToTypeModifierMap.Add(GetNextTypeId(), modifierType); - TypeToIdModifierMap.Add(modifierType, _nextTypeId); + var id = GetNextTypeId(); + IdToTypeModifierMap.Add(id, modifierType); + TypeToIdModifierMap.Add(modifierType, id); BaseModifier modifier; var ctor = modifierType.GetConstructor(Type.EmptyTypes); @@ -105,7 +106,7 @@ public static class ModifierManager PrioritiesToIdsMap[priority] = list = []; } - list.Add(_nextTypeId); + list.Add(id); return true; } diff --git a/MiraAPI/PluginLoading/IMiraPlugin.cs b/MiraAPI/PluginLoading/IMiraPlugin.cs index f1f9fc30..4ffb044d 100644 --- a/MiraAPI/PluginLoading/IMiraPlugin.cs +++ b/MiraAPI/PluginLoading/IMiraPlugin.cs @@ -1,6 +1,8 @@ -using System.Globalization; +using System; +using System.Globalization; using System.Linq; using BepInEx.Configuration; +using MiraAPI.Events; namespace MiraAPI.PluginLoading; @@ -63,6 +65,17 @@ public interface IMiraPlugin /// bool DebugMode => false; + /// + /// Gets a value indicating whether the plugin relies on the legacy global event scanning system. + /// + /// + /// This property defaults to true to maintain backwards compatibility. + /// To upgrade your mod, apply the to any class + /// containing events, and then override this property to return . + /// + [Obsolete("Global event scanning is deprecated. Add [RegisterEventContainer] to your event classes and override this property to false.")] + bool ForceRegisterEvents => true; + /// /// Gets the for the plugin. /// diff --git a/MiraAPI/PluginLoading/MiraPluginManager.cs b/MiraAPI/PluginLoading/MiraPluginManager.cs index d0bcaa14..e3f6ffa3 100644 --- a/MiraAPI/PluginLoading/MiraPluginManager.cs +++ b/MiraAPI/PluginLoading/MiraPluginManager.cs @@ -49,6 +49,16 @@ public sealed class MiraPluginManager internal static ConfigFile MiraApiConfig { get; private set; } = null!; internal static MiraPluginInfo MiraApiPluginInfo { get; private set; } = null!; + /// + /// Get a mira plugin by its GUID. + /// + /// The plugin GUID. + /// A . + public static MiraPluginInfo? GetPluginByGuid(string pluginId) + { + return Instance._registeredPlugins.GetValueOrDefault(pluginId); + } + internal void Initialize(BasePlugin miraApiPlugin, IMiraPlugin apiPlugin) { CustomGameModeManager.RegisterDefaultMode(); @@ -135,7 +145,7 @@ public sealed class MiraPluginManager if ((isMira && type.IsAbstract) || type.IsDefined()) continue; - RegisterEvents(type); + RegisterEvents(type, plugin); if (RegisterOptions(type, info)) continue; @@ -172,11 +182,11 @@ public sealed class MiraPluginManager } } - private static void RegisterEvents(Type type) + private static void RegisterEvents(Type type, IMiraPlugin miraPlugin) { try { - MiraEventManager.RegisterEvents(type); + MiraEventManager.RegisterEvents(type, miraPlugin); } catch (Exception e) { @@ -184,16 +194,6 @@ public sealed class MiraPluginManager } } - /// - /// Get a mira plugin by its GUID. - /// - /// The plugin GUID. - /// A . - public static MiraPluginInfo? GetPluginByGuid(string pluginId) - { - return Instance._registeredPlugins.GetValueOrDefault(pluginId); - } - private static bool RegisterGameOver(Type type) { try From 623cde27ee76d96094d032cf25261064e5f117f7 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Sat, 7 Nov 2026 15:53:09 -0500 Subject: [PATCH 09/12] fix log spam lol --- MiraAPI/Events/MiraEventManager.cs | 6 +----- MiraAPI/PluginLoading/MiraPluginManager.cs | 5 +++++ 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/MiraAPI/Events/MiraEventManager.cs b/MiraAPI/Events/MiraEventManager.cs index 8b48de3f..299a4b8d 100644 --- a/MiraAPI/Events/MiraEventManager.cs +++ b/MiraAPI/Events/MiraEventManager.cs @@ -158,11 +158,7 @@ public static class MiraEventManager internal static void RegisterEvents(Type type, IMiraPlugin miraPlugin) { - if (miraPlugin.ForceRegisterEvents) - { - Warning("For optimisation reasons, MiraAPI no longer automatically searches every type for events. Please use RegisterEventsAttribute moving forward."); - } - else if (!type.IsDefined()) + if (!miraPlugin.ForceRegisterEvents && !type.IsDefined()) { return; } diff --git a/MiraAPI/PluginLoading/MiraPluginManager.cs b/MiraAPI/PluginLoading/MiraPluginManager.cs index e3f6ffa3..737ee2eb 100644 --- a/MiraAPI/PluginLoading/MiraPluginManager.cs +++ b/MiraAPI/PluginLoading/MiraPluginManager.cs @@ -140,6 +140,11 @@ public sealed class MiraPluginManager [SuppressMessage("Minor Code Smell", "S3626:Jump statements should not be redundant", Justification = "Code consistency.")] private static void ProcessAssemblyTypes(Assembly assembly, MiraPluginInfo info, BasePlugin basePlugin, IMiraPlugin plugin, List roles, bool isMira) { + if (plugin.ForceRegisterEvents) + { + Warning("For optimisation reasons, MiraAPI no longer automatically searches every type for events. Please use RegisterEventsAttribute moving forward."); + } + foreach (var type in assembly.GetTypes()) { if ((isMira && type.IsAbstract) || type.IsDefined()) From 9557892dafba86038b50fe3b30adc780fe346595 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Sat, 7 Nov 2026 16:42:18 -0500 Subject: [PATCH 10/12] use newer event stuff + fix attribute --- MiraAPI.Example/ExampleEventHandlers.cs | 1 + MiraAPI.Example/ExamplePlugin.cs | 3 +++ MiraAPI/Events/RegisterEventsAttribute.cs | 2 +- MiraAPI/MiraApiPlugin.cs | 6 +++--- MiraAPI/VanillaEvents/JudgeEvents.cs | 10 +++------- MiraAPI/VanillaEvents/UiResetEvents.cs | 21 +++++++++------------ 6 files changed, 20 insertions(+), 23 deletions(-) diff --git a/MiraAPI.Example/ExampleEventHandlers.cs b/MiraAPI.Example/ExampleEventHandlers.cs index c14710a9..65265ad1 100644 --- a/MiraAPI.Example/ExampleEventHandlers.cs +++ b/MiraAPI.Example/ExampleEventHandlers.cs @@ -14,6 +14,7 @@ using Reactor.Utilities; namespace MiraAPI.Example; +[RegisterEventContainer] public static class ExampleEventHandlers { public static void Initialize() diff --git a/MiraAPI.Example/ExamplePlugin.cs b/MiraAPI.Example/ExamplePlugin.cs index eadc271d..57812ded 100644 --- a/MiraAPI.Example/ExamplePlugin.cs +++ b/MiraAPI.Example/ExamplePlugin.cs @@ -26,6 +26,9 @@ public partial class ExamplePlugin : BasePlugin, IMiraPlugin public string OptionsTitleText { get; } = "Mira API\nExample Mod"; public string CustomOptionMenuNameTwo { get; } = "Example Options"; + /// + public bool ForceRegisterEvents => false; + public ConfigFile GetConfigFile() { return Config; diff --git a/MiraAPI/Events/RegisterEventsAttribute.cs b/MiraAPI/Events/RegisterEventsAttribute.cs index 8b8a0184..9e6a1e63 100644 --- a/MiraAPI/Events/RegisterEventsAttribute.cs +++ b/MiraAPI/Events/RegisterEventsAttribute.cs @@ -5,5 +5,5 @@ namespace MiraAPI.Events; /// /// Register a container of s. /// -[AttributeUsage(AttributeTargets.Method)] +[AttributeUsage(AttributeTargets.Class)] public class RegisterEventContainerAttribute : Attribute; diff --git a/MiraAPI/MiraApiPlugin.cs b/MiraAPI/MiraApiPlugin.cs index 7e744781..633145be 100644 --- a/MiraAPI/MiraApiPlugin.cs +++ b/MiraAPI/MiraApiPlugin.cs @@ -8,7 +8,6 @@ using MiraAPI.Patches; using MiraAPI.Patches.Roles; using MiraAPI.PluginLoading; using MiraAPI.Translation; -using MiraAPI.VanillaEvents; using Reactor; using Reactor.Localization; using Reactor.Networking; @@ -44,6 +43,9 @@ public partial class MiraApiPlugin : BasePlugin, IMiraPlugin /// public bool DebugMode => IsDevBuild; + /// + public bool ForceRegisterEvents => false; + /// /// Gets a value indicating whether the current device is running Starlight (on mobile). /// @@ -96,8 +98,6 @@ public partial class MiraApiPlugin : BasePlugin, IMiraPlugin "Dictates the unit of distance used in numeric option displays representing a distance."); Harmony.PatchAll(); RoleOptionsCollectionPatch.PatchRoleMethods(Harmony); - UiResetEvents.Initialize(); - JudgeEvents.Initialize(); ReactorCredits.Register("Mira API", Version, IsDevBuild, ReactorCredits.AlwaysShow); diff --git a/MiraAPI/VanillaEvents/JudgeEvents.cs b/MiraAPI/VanillaEvents/JudgeEvents.cs index 6cfd5263..5a4b9fcd 100644 --- a/MiraAPI/VanillaEvents/JudgeEvents.cs +++ b/MiraAPI/VanillaEvents/JudgeEvents.cs @@ -4,15 +4,11 @@ using MiraAPI.Roles; namespace MiraAPI.VanillaEvents; +[RegisterEventContainer] internal static class JudgeEvents { - public static void Initialize() - { - // This is required because MiraAPI isn't an IMiraPlugin (besides in the gamemodes branch) - MiraEventManager.RegisterEventHandler(ProcessVotesEventHandler, -1000); - } - - private static void ProcessVotesEventHandler(ProcessVotesEvent @event) + [RegisterEvent(-1000)] + public static void ProcessVotesEventHandler(ProcessVotesEvent @event) { if (!MeetingHud.Instance.TryGetWinningOverrule( out var judgeOverrule, diff --git a/MiraAPI/VanillaEvents/UiResetEvents.cs b/MiraAPI/VanillaEvents/UiResetEvents.cs index 84d00225..37574f1e 100644 --- a/MiraAPI/VanillaEvents/UiResetEvents.cs +++ b/MiraAPI/VanillaEvents/UiResetEvents.cs @@ -5,17 +5,11 @@ using MiraAPI.LocalSettings; namespace MiraAPI.VanillaEvents; +[RegisterEventContainer] internal static class UiResetEvents { - public static void Initialize() - { - MiraEventManager.RegisterEventHandler(ResetButtonParents); - MiraEventManager.RegisterEventHandler(PlaceWikiButton, -900); - MiraEventManager.RegisterEventHandler(PlaceSubmergedButton, -800); - MiraEventManager.RegisterEventHandler(PlaceModifierUi, -700); - } - - private static void ResetButtonParents(UiButtonResetEvent _) + [RegisterEvent] + public static void ResetButtonParents(UiButtonResetEvent _) { var wikiButton = MiraHudHelper.VanillaMatchInfoButton; var subButton = MiraHudHelper.SubmergedFloorButton; @@ -36,7 +30,8 @@ internal static class UiResetEvents } } - private static void PlaceWikiButton(UiButtonPostResetEvent @event) + [RegisterEvent(-900)] + public static void PlaceWikiButton(UiButtonPostResetEvent @event) { var wikiButton = MiraHudHelper.VanillaMatchInfoButton; if (!wikiButton) @@ -50,7 +45,8 @@ internal static class UiResetEvents wikiButton.transform.SetParent(opts.WikiOnBottomRow.Value ? secondRow.transform : firstRow.transform); } - private static void PlaceSubmergedButton(UiButtonPostResetEvent @event) + [RegisterEvent(-800)] + public static void PlaceSubmergedButton(UiButtonPostResetEvent @event) { var subButton = MiraHudHelper.SubmergedFloorButton; if (!subButton) @@ -62,7 +58,8 @@ internal static class UiResetEvents subButton.transform.SetParent(secondRow.transform); } - private static void PlaceModifierUi(UiButtonPostResetEvent @event) + [RegisterEvent(-700)] + public static void PlaceModifierUi(UiButtonPostResetEvent @event) { var modDisplay = MiraHudHelper.ModifierDisplayOnRight ? MiraHudHelper.ModifierDisplayObject : null!; if (!modDisplay) From 32caa8fd71fa2aa45f2c170f432c52716ce6463d Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Sat, 7 Nov 2026 16:48:13 -0500 Subject: [PATCH 11/12] undo a getter + deprecate some constructors --- MiraAPI/Colors/VariableColor.cs | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/MiraAPI/Colors/VariableColor.cs b/MiraAPI/Colors/VariableColor.cs index 6a6eae1c..4f178471 100644 --- a/MiraAPI/Colors/VariableColor.cs +++ b/MiraAPI/Colors/VariableColor.cs @@ -40,7 +40,7 @@ public sealed class VariableColor( /// /// Gets a delegate that takes in a time value and returns the dynamic shadow color. /// - public Func ShadowEvaluator => shadowEvaluator ?? (t => mainEvaluator(t).DarkenAbsolute(0.24f)); + public Func ShadowEvaluator { get; } = shadowEvaluator ?? (t => mainEvaluator(t).DarkenAbsolute(0.24f)); /// public VariableColor( @@ -91,6 +91,7 @@ public sealed class VariableColor( } /// + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public VariableColor( StringNames nameId, Func mainEvaluator, @@ -103,6 +104,7 @@ public sealed class VariableColor( } /// + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public VariableColor( StringNames nameId, Func mainEvaluator, @@ -113,6 +115,7 @@ public sealed class VariableColor( } /// + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public VariableColor( string rawId, Func mainEvaluator, @@ -125,6 +128,7 @@ public sealed class VariableColor( } /// + [Obsolete("Use the constructor that takes in a CustomColorBrightness parameter. This will be removed in a future version.")] public VariableColor( string rawId, Func mainEvaluator, From 7c6cc32b34982ac18ec11474f1f41ad77e4a7754 Mon Sep 17 00:00:00 2001 From: Az <56699741+AlchlcDvl@users.noreply.github.com> Date: Sun, 8 Nov 2026 01:20:17 -0500 Subject: [PATCH 12/12] use `InstanceExists` --- MiraAPI/MiraApiSettings.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/MiraAPI/MiraApiSettings.cs b/MiraAPI/MiraApiSettings.cs index ce722351..f8ae2c1e 100644 --- a/MiraAPI/MiraApiSettings.cs +++ b/MiraAPI/MiraApiSettings.cs @@ -110,7 +110,7 @@ public class MiraApiSettings(ConfigFile config) : LocalSettingsTab(config) /// The coroutine that resizes the UI. public static IEnumerator CoResizeSettingsUI() { - while (!HudManager.Instance || !MiraHudHelper.UiGrid || !MiraHudHelper.ExtraUiGrid) + while (!HudManager.InstanceExists || !MiraHudHelper.UiGrid || !MiraHudHelper.ExtraUiGrid) { yield return null; }