8.12

EXILED/EXILED.props

@@ -15,7 +15,7 @@
 
   <PropertyGroup>
     <!-- This is the global version and is used for all projects that don't have a version -->
-    <Version Condition="$(Version) == ''">8.12.0-rc.3</Version>
+    <Version Condition="$(Version) == ''">8.12.0</Version>
     <!-- Enables public beta warning via the PUBLIC_BETA constant -->
     <PublicBeta>false</PublicBeta>
 

EXILED/Exiled.API/Enums/LockerType.cs

@@ -0,0 +1,50 @@
+// -----------------------------------------------------------------------
+// <copyright file="LockerType.cs" company="Exiled Team">
+// Copyright (c) Exiled Team. All rights reserved.
+// Licensed under the CC BY-SA 3.0 license.
+// </copyright>
+// -----------------------------------------------------------------------
+
+namespace Exiled.API.Enums
+{
+    /// <summary>
+    /// Unique identifier for different types of <see cref="Features.Lockers.Locker"/>s.
+    /// </summary>
+    public enum LockerType
+    {
+        /// <summary>
+        /// The pedestal used by SCP items.
+        /// </summary>
+        Pedestal,
+
+        /// <summary>
+        /// Large weapon locker.
+        /// </summary>
+        LargeGun,
+
+        /// <summary>
+        /// Locker for rifles, known as a rifle rack.
+        /// </summary>
+        RifleRack,
+
+        /// <summary>
+        /// Miscellaneous locker for various items.
+        /// </summary>
+        Misc,
+
+        /// <summary>
+        /// Locker that contains medkits.
+        /// </summary>
+        Medkit,
+
+        /// <summary>
+        /// Locker that contains adrenaline.
+        /// </summary>
+        Adrenaline,
+
+        /// <summary>
+        /// Unknow type of locker.
+        /// </summary>
+        Unknow,
+    }
+}

EXILED/Exiled.API/Enums/ScenesType.cs

@@ -0,0 +1,47 @@
+// -----------------------------------------------------------------------
+// <copyright file="ScenesType.cs" company="Exiled Team">
+// Copyright (c) Exiled Team. All rights reserved.
+// Licensed under the CC BY-SA 3.0 license.
+// </copyright>
+// -----------------------------------------------------------------------
+
+namespace Exiled.API.Enums
+{
+    /// <summary>
+    /// Unique identifier for the different types of Scenes the client and server can load.
+    /// </summary>
+    public enum ScenesType
+    {
+        /// <summary>
+        /// The facility itself.
+        /// </summary>
+        Facility,
+
+        /// <summary>
+        /// The current main menu.
+        /// ! Will cause crash when trying joining servers !
+        /// </summary>
+        NewMainMenu,
+
+        /// <summary>
+        /// The old main menu.
+        /// </summary>
+        MainMenuRemastered,
+
+        /// <summary>
+        /// The old server list.
+        /// </summary>
+        FastMenu,
+
+        /// <summary>
+        /// The loading Screen.
+        /// ! Will cause crash when trying joining servers !
+        /// </summary>
+        PreLoader,
+
+        /// <summary>
+        /// A black menu before loading the <see cref="NewMainMenu"/>.
+        /// </summary>
+        Loader,
+    }
+}

EXILED/Exiled.API/Enums/SpawnLocationType.cs

@@ -4,9 +4,10 @@
 // Licensed under the CC BY-SA 3.0 license.
 // </copyright>
 // -----------------------------------------------------------------------
-
 namespace Exiled.API.Enums
 {
+    using System;
+
     /// <summary>
     /// All of the valid spawn location types.
     /// </summary>
@@ -150,6 +151,7 @@ public enum SpawnLocationType
         /// <summary>
         /// Inside a random locker on the map.
         /// </summary>
+        [Obsolete("Use LockerSpawnPoint instead")]
         InsideLocker,
     }
 }

EXILED/Exiled.API/Extensions/LockerExtensions.cs

@@ -0,0 +1,43 @@
+// -----------------------------------------------------------------------
+// <copyright file="LockerExtensions.cs" company="Exiled Team">
+// Copyright (c) Exiled Team. All rights reserved.
+// Licensed under the CC BY-SA 3.0 license.
+// </copyright>
+// -----------------------------------------------------------------------
+
+namespace Exiled.API.Extensions
+{
+    using System;
+
+    using Exiled.API.Enums;
+    using MapGeneration.Distributors;
+
+    /// <summary>
+    /// A set of extensions for <see cref="Enums.LockerType"/>.
+    /// </summary>
+    public static class LockerExtensions
+    {
+        /// <summary>
+        /// Gets the <see cref="LockerType"/> from the given <see cref="Locker"/> object.
+        /// </summary>
+        /// <param name="locker">The <see cref="Locker"/> to check.</param>
+        /// <returns>The corresponding <see cref="LockerType"/>.</returns>
+        public static LockerType GetLockerType(this Locker locker) => locker.name.GetLockerTypeByName();
+
+        /// <summary>
+        /// Gets the <see cref="LockerType"/> by name.
+        /// </summary>
+        /// <param name="name">The name to check.</param>
+        /// <returns>The corresponding <see cref="LockerType"/>.</returns>
+        public static LockerType GetLockerTypeByName(this string name) => name.Replace("(Clone)", string.Empty) switch
+        {
+            "Scp500PedestalStructure Variant" => LockerType.Pedestal,
+            "LargeGunLockerStructure" => LockerType.LargeGun,
+            "RifleRackStructure" => LockerType.RifleRack,
+            "MiscLocker" => LockerType.Misc,
+            "RegularMedkitStructure" => LockerType.Medkit,
+            "AdrenalineMedkitStructure" => LockerType.Adrenaline,
+            _ => LockerType.Unknow,
+        };
+    }
+}

EXILED/Exiled.API/Extensions/MirrorExtensions.cs

@@ -15,6 +15,7 @@ namespace Exiled.API.Extensions
     using System.Reflection.Emit;
     using System.Text;
 
+    using Exiled.API.Enums;
     using Features;
     using Features.Pools;
 
@@ -270,6 +271,15 @@ public static void ChangeAppearance(this Player player, RoleTypeId type, IEnumer
                 writer.WriteByte(unitId);
             }
 
+            if (roleBase is ZombieRole)
+            {
+                if (player.Role.Base is not ZombieRole)
+                    isRisky = true;
+
+                writer.WriteUShort((ushort)Mathf.Clamp(Mathf.CeilToInt(player.MaxHealth), ushort.MinValue, ushort.MaxValue));
+                writer.WriteBool(true);
+            }
+
             if (roleBase is FpcStandardRoleBase fpc)
             {
                 if (player.Role.Base is not FpcStandardRoleBase playerfpc)
@@ -283,14 +293,6 @@ public static void ChangeAppearance(this Player player, RoleTypeId type, IEnumer
                 writer.WriteUShort(value);
             }
 
-            if (roleBase is ZombieRole)
-            {
-                if (player.Role.Base is not ZombieRole)
-                    isRisky = true;
-
-                writer.WriteUShort((ushort)Mathf.Clamp(Mathf.CeilToInt(player.MaxHealth), ushort.MinValue, ushort.MaxValue));
-            }
-
             foreach (Player target in playersToAffect)
             {
                 if (target != player || !isRisky)
@@ -355,6 +357,111 @@ public static void MessageTranslated(this Player player, string words, string tr
             }
         }
 
+        /// <summary>
+        /// Moves object for the player.
+        /// </summary>
+        /// <param name="player">Target to send.</param>
+        /// <param name="identity">The <see cref="Mirror.NetworkIdentity"/> to move.</param>
+        /// <param name="pos">The position to change.</param>
+        public static void MoveNetworkIdentityObject(this Player player, NetworkIdentity identity, Vector3 pos)
+        {
+            identity.gameObject.transform.position = pos;
+            ObjectDestroyMessage objectDestroyMessage = new()
+            {
+                netId = identity.netId,
+            };
+
+            player.Connection.Send(objectDestroyMessage, 0);
+            SendSpawnMessageMethodInfo?.Invoke(null, new object[] { identity, player.Connection });
+        }
+
+        /// <summary>
+        /// Sends to the player a Fake Change Scene.
+        /// </summary>
+        /// <param name="player">The player to send the Scene.</param>
+        /// <param name="newSceneName">The new Scene the client will load.</param>
+        public static void SendFakeSceneLoading(this Player player, ScenesType newSceneName)
+        {
+            SceneMessage message = new()
+            {
+                sceneName = newSceneName.ToString(),
+            };
+
+            player.Connection.Send(message);
+        }
+
+        /// <summary>
+        /// Emulation of the method SCP:SL uses to change scene.
+        /// </summary>
+        /// <param name="scene">The new Scene the client will load.</param>
+        public static void ChangeSceneToAllClients(ScenesType scene)
+        {
+            SceneMessage message = new()
+            {
+                sceneName = scene.ToString(),
+            };
+
+            NetworkServer.SendToAll(message);
+        }
+
+        /// <summary>
+        /// Scales an object for the specified player.
+        /// </summary>
+        /// <param name="player">Target to send.</param>
+        /// <param name="identity">The <see cref="Mirror.NetworkIdentity"/> to scale.</param>
+        /// <param name="scale">The scale the object needs to be set to.</param>
+        public static void ScaleNetworkIdentityObject(this Player player, NetworkIdentity identity, Vector3 scale)
+        {
+            identity.gameObject.transform.localScale = scale;
+            ObjectDestroyMessage objectDestroyMessage = new()
+            {
+                netId = identity.netId,
+            };
+
+            player.Connection.Send(objectDestroyMessage, 0);
+            SendSpawnMessageMethodInfo?.Invoke(null, new object[] { identity, player.Connection });
+        }
+
+        /// <summary>
+        /// Moves object for all the players.
+        /// </summary>
+        /// <param name="identity">The <see cref="NetworkIdentity"/> to move.</param>
+        /// <param name="pos">The position to change.</param>
+        public static void MoveNetworkIdentityObject(this NetworkIdentity identity, Vector3 pos)
+        {
+            identity.gameObject.transform.position = pos;
+            ObjectDestroyMessage objectDestroyMessage = new()
+            {
+                netId = identity.netId,
+            };
+
+            foreach (Player ply in Player.List)
+            {
+                ply.Connection.Send(objectDestroyMessage, 0);
+                SendSpawnMessageMethodInfo?.Invoke(null, new object[] { identity, ply.Connection });
+            }
+        }
+
+        /// <summary>
+        /// Scales an object for all players.
+        /// </summary>
+        /// <param name="identity">The <see cref="Mirror.NetworkIdentity"/> to scale.</param>
+        /// <param name="scale">The scale the object needs to be set to.</param>
+        public static void ScaleNetworkIdentityObject(this NetworkIdentity identity, Vector3 scale)
+        {
+            identity.gameObject.transform.localScale = scale;
+            ObjectDestroyMessage objectDestroyMessage = new()
+            {
+                netId = identity.netId,
+            };
+
+            foreach (Player ply in Player.List)
+            {
+                ply.Connection.Send(objectDestroyMessage, 0);
+                SendSpawnMessageMethodInfo?.Invoke(null, new object[] { identity, ply.Connection });
+            }
+        }
+
         /// <summary>
         /// Send fake values to client's <see cref="SyncVarAttribute"/>.
         /// </summary>
@@ -363,6 +470,7 @@ public static void MessageTranslated(this Player player, string words, string tr
         /// <param name="targetType"><see cref="NetworkBehaviour"/>'s type.</param>
         /// <param name="propertyName">Property name starting with Network.</param>
         /// <param name="value">Value of send to target.</param>
+        [Obsolete("Use overload with type-template instead.")]
         public static void SendFakeSyncVar(this Player target, NetworkIdentity behaviorOwner, Type targetType, string propertyName, object value)
         {
             if (!target.IsConnected)
@@ -386,6 +494,38 @@ void CustomSyncVarGenerator(NetworkWriter targetWriter)
             }
         }
 
+        /// <summary>
+        /// Send fake values to client's <see cref="SyncVarAttribute"/>.
+        /// </summary>
+        /// <typeparam name="T">Target SyncVar property type.</typeparam>
+        /// <param name="target">Target to send.</param>
+        /// <param name="behaviorOwner"><see cref="NetworkIdentity"/> of object that owns <see cref="NetworkBehaviour"/>.</param>
+        /// <param name="targetType"><see cref="NetworkBehaviour"/>'s type.</param>
+        /// <param name="propertyName">Property name starting with Network.</param>
+        /// <param name="value">Value of send to target.</param>
+        public static void SendFakeSyncVar<T>(this Player target, NetworkIdentity behaviorOwner, Type targetType, string propertyName, T value)
+        {
+            if (!target.IsConnected)
+                return;
+
+            NetworkWriterPooled writer = NetworkWriterPool.Get();
+            NetworkWriterPooled writer2 = NetworkWriterPool.Get();
+            MakeCustomSyncWriter(behaviorOwner, targetType, null, CustomSyncVarGenerator, writer, writer2);
+            target.Connection.Send(new EntityStateMessage
+            {
+                netId = behaviorOwner.netId,
+                payload = writer.ToArraySegment(),
+            });
+
+            NetworkWriterPool.Return(writer);
+            NetworkWriterPool.Return(writer2);
+            void CustomSyncVarGenerator(NetworkWriter targetWriter)
+            {
+                targetWriter.WriteULong(SyncVarDirtyBits[$"{targetType.Name}.{propertyName}"]);
+                WriterExtensions[typeof(T)]?.Invoke(null, new object[2] { targetWriter, value });
+            }
+        }
+
         /// <summary>
         /// Force resync to client's <see cref="SyncVarAttribute"/>.
         /// </summary>