v0.2.2 - Add getPlayer()

Author: TechnicallyCoded

build.gradle

@@ -3,7 +3,7 @@ plugins {
 }
 
 group 'com.tcoded'
-version '0.2.1'
+version '0.2.2'
 
 java {
     sourceCompatibility = JavaVersion.VERSION_17

src/main/java/com/tcoded/folialib/impl/FoliaImplementation.java

@@ -11,8 +11,10 @@
 import org.bukkit.Location;
 import org.bukkit.World;
 import org.bukkit.entity.Entity;
+import org.bukkit.entity.Player;
 import org.bukkit.plugin.java.JavaPlugin;
 
+import java.util.UUID;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.TimeUnit;
 
@@ -194,4 +196,22 @@ public void cancelAllTasks() {
         this.globalRegionScheduler.cancelTasks(plugin);
         this.asyncScheduler.cancelTasks(plugin);
     }
+
+    @Override
+    public Player getPlayer(String name) {
+        // This is thread-safe in folia
+        return this.plugin.getServer().getPlayer(name);
+    }
+
+    @Override
+    public Player getPlayerExact(String name) {
+        // This is thread-safe in folia
+        return this.plugin.getServer().getPlayerExact(name);
+    }
+
+    @Override
+    public Player getPlayer(UUID uuid) {
+        // This is thread-safe in folia
+        return this.plugin.getServer().getPlayer(uuid);
+    }
 }

src/main/java/com/tcoded/folialib/impl/ServerImplementation.java

@@ -4,7 +4,9 @@
 import com.tcoded.folialib.wrapper.WrappedTask;
 import org.bukkit.Location;
 import org.bukkit.entity.Entity;
+import org.bukkit.entity.Player;
 
+import java.util.UUID;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.TimeUnit;
 
@@ -177,4 +179,25 @@ public interface ServerImplementation {
      * Cancel all tasks
      */
     void cancelAllTasks();
+
+    /**
+     * Get a player by name (approximately)
+     * @param name Name of the player
+     * @return Player instance
+     */
+    Player getPlayer(String name);
+
+    /**
+     * Get a player by name (exactly)
+     * @param name Name of the player
+     * @return Player instance
+     */
+    Player getPlayerExact(String name);
+
+    /**
+     * Get a player by UUID
+     * @param uuid UUID of the player
+     * @return Player instance
+     */
+    Player getPlayer(UUID uuid);
 }

src/main/java/com/tcoded/folialib/impl/SpigotImplementation.java

@@ -7,11 +7,14 @@
 import com.tcoded.folialib.wrapper.task.WrappedBukkitTask;
 import org.bukkit.Location;
 import org.bukkit.entity.Entity;
+import org.bukkit.entity.Player;
 import org.bukkit.plugin.java.JavaPlugin;
 import org.bukkit.scheduler.BukkitScheduler;
 import org.jetbrains.annotations.NotNull;
 
+import java.util.UUID;
 import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutionException;
 import java.util.concurrent.TimeUnit;
 
 public class SpigotImplementation implements ServerImplementation {
@@ -167,4 +170,59 @@ public void cancelTask(WrappedTask task) {
     public void cancelAllTasks() {
         this.scheduler.cancelTasks(plugin);
     }
+
+    @Override
+    public Player getPlayer(String name) {
+        // Already on the main thread
+        if (this.plugin.getServer().isPrimaryThread()) {
+            return this.plugin.getServer().getPlayer(name);
+        }
+        // Not on the main thread, we need to wait until the next tick
+        else {
+            try {
+                return this.scheduler.callSyncMethod(plugin, () -> this.plugin.getServer().getPlayer(name)).get();
+            } catch (InterruptedException | ExecutionException e) {
+                e.printStackTrace();
+            }
+        }
+        // Fallback to null
+        return null;
+    }
+
+    @Override
+    public Player getPlayerExact(String name) {
+        // Already on the main thread
+        if (this.plugin.getServer().isPrimaryThread()) {
+            return this.plugin.getServer().getPlayerExact(name);
+        }
+        // Not on the main thread, we need to wait until the next tick
+        else {
+            try {
+                return this.scheduler.callSyncMethod(plugin, () -> this.plugin.getServer().getPlayerExact(name)).get();
+            } catch (InterruptedException | ExecutionException e) {
+                e.printStackTrace();
+            }
+        }
+        // Fallback to null
+        return null;
+    }
+
+    @SuppressWarnings("DuplicatedCode")
+    @Override
+    public Player getPlayer(UUID uuid) {
+        // Already on the main thread
+        if (this.plugin.getServer().isPrimaryThread()) {
+            return this.plugin.getServer().getPlayer(uuid);
+        }
+        // Not on the main thread, we need to wait until the next tick
+        else {
+            try {
+                return this.scheduler.callSyncMethod(plugin, () -> this.plugin.getServer().getPlayer(uuid)).get();
+            } catch (InterruptedException | ExecutionException e) {
+                e.printStackTrace();
+            }
+        }
+        // Fallback to null
+        return null;
+    }
 }