Portable Generator Rework (#19302)

Content.Shared/Power/Generator/PowerSwitchableGeneratorComponent.cs

@@ -0,0 +1,61 @@
+using Robust.Shared.Audio;
+using Robust.Shared.GameStates;
+using Robust.Shared.Serialization;
+
+namespace Content.Shared.Power.Generator;
+
+/// <summary>
+/// Enables a generator to switch between HV and MV output.
+/// </summary>
+/// <remarks>
+/// Must have <c>CableDeviceNode</c>s for both <see cref="NodeOutputMV"/> and <see cref="NodeOutputHV"/>, and also a <c>PowerSupplierComponent</c>.
+/// </remarks>
+[RegisterComponent, NetworkedComponent, AutoGenerateComponentState]
+[Access(typeof(SharedPowerSwitchableGeneratorSystem))]
+public sealed partial class PowerSwitchableGeneratorComponent : Component
+{
+    /// <summary>
+    /// Which output the portable generator is currently connected to.
+    /// </summary>
+    [DataField("activeOutput")]
+    [AutoNetworkedField]
+    public PowerSwitchableGeneratorOutput ActiveOutput { get; set; }
+
+    /// <summary>
+    /// Sound that plays when the output is switched.
+    /// </summary>
+    /// <returns></returns>
+    [DataField("switchSound")]
+    public SoundSpecifier? SwitchSound { get; set; }
+
+    /// <summary>
+    /// Which node is the MV output?
+    /// </summary>
+    [DataField("nodeOutputMV")]
+    public string NodeOutputMV { get; set; } = "output_mv";
+
+    /// <summary>
+    /// Which node is the HV output?
+    /// </summary>
+    [DataField("nodeOutputHV")]
+    public string NodeOutputHV { get; set; } = "output_hv";
+}
+
+/// <summary>
+/// Possible power output for power-switchable generators.
+/// </summary>
+/// <seealso cref="PowerSwitchableGeneratorComponent"/>
+[Serializable, NetSerializable]
+public enum PowerSwitchableGeneratorOutput : byte
+{
+    /// <summary>
+    /// The generator is set to connect to a high-voltage power network.
+    /// </summary>
+    HV,
+
+    /// <summary>
+    /// The generator is set to connect to a medium-voltage power network.
+    /// </summary>
+    MV
+}
+