relativeX, Y and Z player properties, TPRelative

Author: Tosoks67

Helpers/Extensions/PlayerExtensions.cs

@@ -0,0 +1,12 @@
+using LabApi.Features.Wrappers;
+using UnityEngine;
+
+namespace SER.Helpers.Extensions;
+
+public static class PlayerExtensions
+{
+    public static Vector3 RelativeRoomPosition(this Player player)
+    {
+        return player.Room == null ? new(0,0,0) : player.Room.Transform.InverseTransformPoint(player.Position) - new Vector3(0, player.Scale.y + 0.01f, 0);
+    }
+}

MethodSystem/Methods/TeleportMethods/TPRelativeMethod.cs

@@ -0,0 +1,34 @@
+using SER.ArgumentSystem.Arguments;
+using SER.ArgumentSystem.BaseArguments;
+using SER.Helpers.Extensions;
+using SER.MethodSystem.BaseMethods;
+using UnityEngine;
+
+namespace SER.MethodSystem.Methods.TeleportMethods;
+
+// ReSharper disable once InconsistentNaming
+public class TPRelativeMethod : SynchronousMethod
+{
+    public override string Description => "Teleports players to relative coordinates of a room.";
+
+    public override Argument[] ExpectedArguments { get; } =
+    [
+        new PlayersArgument("players"),
+        new RoomArgument("room"),
+        new FloatArgument("relative x"),
+        new FloatArgument("relative y"),
+        new FloatArgument("relative z")
+    ];
+    
+    public override void Execute()
+    {
+        var players = Args.GetPlayers("players");
+        var room = Args.GetRoom("room");
+        var pos = room.Transform.TransformPoint(new(
+            Args.GetFloat("relative x"),
+            Args.GetFloat("relative y"),
+            Args.GetFloat("relative z")));
+
+        players.ForEach(plr => plr.Position = pos + new Vector3(0, plr.Scale.y + 0.01f, 0));
+    }
+}

TokenSystem/Tokens/ExpressionTokens/PlayerExpressionToken.cs

@@ -61,6 +61,9 @@ public enum PlayerProperty
         SizeY,
         SizeZ,
         AccessTier,
+        RelativeX,
+        RelativeY,
+        RelativeZ,
     }
 
     public abstract class Info
@@ -166,7 +169,10 @@ public class Info<T>(Func<Player, T> handler, string? description) : Info
                 else return -1;
             }
             else return -1;
-        }, "Returns the player's Access Tier Level if they are SCP-079, otherwise returns -1")
+        }, "Returns the player's Access Tier Level if they are SCP-079, otherwise returns -1"),
+        [PlayerProperty.RelativeX] = new Info<NumberValue>(plr => (decimal)plr.RelativeRoomPosition().x, "Returns the player's x relative to the current room or 0 if in no room"),
+        [PlayerProperty.RelativeY] = new Info<NumberValue>(plr => (decimal)plr.RelativeRoomPosition().y, "Returns the player's y relative to the current room or 0 if in no room"),
+        [PlayerProperty.RelativeZ] = new Info<NumberValue>(plr => (decimal)plr.RelativeRoomPosition().z, "Returns the player's z relative to the current room or 0 if in no room"),
     };
 
     protected override IParseResult InternalParse(BaseToken[] tokens)