Add player functions

Author: ShaneBeee

src/main/java/com/github/skriptdev/skript/api/hytale/utils/PlayerUtils.java

@@ -5,6 +5,7 @@
 import com.hypixel.hytale.component.spatial.SpatialResource;
 import com.hypixel.hytale.math.vector.Location;
 import com.hypixel.hytale.math.vector.Vector3d;
+import com.hypixel.hytale.server.core.NameMatching;
 import com.hypixel.hytale.server.core.entity.entities.Player;
 import com.hypixel.hytale.server.core.modules.entity.EntityModule;
 import com.hypixel.hytale.server.core.universe.PlayerRef;
@@ -86,6 +87,10 @@ public static List<PlayerRef> getPlayerRefs(@Nullable World world) {
         return store.getComponent(reference, PlayerRef.getComponentType());
     }
 
+    public static @Nullable PlayerRef getPlayerRef(String name) {
+        return Universe.get().getPlayerByUsername(name, NameMatching.EXACT_IGNORE_CASE);
+    }
+
     /**
      * Get a Player from a PlayerRef.
      *

src/main/java/com/github/skriptdev/skript/plugin/elements/functions/DefaultFunctions.java

@@ -1,5 +1,6 @@
 package com.github.skriptdev.skript.plugin.elements.functions;
 
+import com.github.skriptdev.skript.api.hytale.utils.PlayerUtils;
 import com.github.skriptdev.skript.api.skript.registration.SkriptRegistration;
 import com.hypixel.hytale.math.shape.Box;
 import com.hypixel.hytale.math.vector.Location;
@@ -8,9 +9,11 @@
 import com.hypixel.hytale.math.vector.Vector3i;
 import com.hypixel.hytale.protocol.packets.worldmap.ContextMenuItem;
 import com.hypixel.hytale.server.core.asset.type.item.config.Item;
+import com.hypixel.hytale.server.core.entity.entities.Player;
 import com.hypixel.hytale.server.core.inventory.ItemStack;
 import com.hypixel.hytale.server.core.inventory.container.ItemContainer;
 import com.hypixel.hytale.server.core.inventory.container.SimpleItemContainer;
+import com.hypixel.hytale.server.core.universe.PlayerRef;
 import com.hypixel.hytale.server.core.universe.Universe;
 import com.hypixel.hytale.server.core.universe.world.World;
 import io.github.syst3ms.skriptparser.util.SkriptDate;
@@ -26,6 +29,7 @@ public static void register(SkriptRegistration reg) {
         dateTimeFunctions(reg);
         itemFunctions(reg);
         mathFunctions(reg);
+        playerFunctions(reg);
         positionFunctions(reg);
         serverFunctions(reg);
     }
@@ -211,6 +215,40 @@ private static void mathFunctions(SkriptRegistration reg) {
             .register();
     }
 
+    private static void playerFunctions(SkriptRegistration reg) {
+        reg.newJavaFunction("player", Player.class, true)
+            .parameter("name", String.class)
+            .parameter("world", World.class)
+            .executeSingle(params -> {
+                String name = (String) params[0][0];
+                World world = (World) params[1][0];
+
+                for (PlayerRef playerRef : world.getPlayerRefs()) {
+                    if (playerRef.getUsername().equals(name)) {
+                        return PlayerUtils.getPlayer(playerRef, world);
+                    }
+                }
+                return null;
+            })
+            .name("Player")
+            .description("Returns the player with the given name in the given world.")
+            .examples("set {_player} to player(\"ShaneBee\", world(\"default\"))")
+            .since("INSERT VERSION")
+            .register();
+
+        reg.newJavaFunction("playerRef", PlayerRef.class, true)
+            .parameter("name", String.class)
+            .executeSingle(params -> {
+                String name = (String) params[0][0];
+                return PlayerUtils.getPlayerRef(name);
+            })
+            .name("PlayerRef")
+            .description("Returns the PlayerRef with the given name.")
+            .examples("set {_ref} to playerRef(\"ShaneBee\")")
+            .since("INSERT VERSION")
+            .register();
+    }
+
     private static void positionFunctions(SkriptRegistration reg) {
         reg.newJavaFunction("box", Box.class, true)
             .parameter("x1", Number.class)