feat(common): 添加新的API

hamster-ball-common/src/main/java/cn/hamster3/mc/plugin/ball/common/api/BallAPI.java

@@ -740,9 +740,10 @@ public abstract class BallAPI {
     /**
      * 获取玩家的UUID
      *
-     * @param playerName 玩家名次
+     * @param playerName 玩家名称
      * @return 玩家的UUID
      */
+    @Nullable
     public UUID getPlayerUUID(String playerName) {
         BallPlayerInfo info = getPlayerInfo(playerName);
         if (info == null) {
@@ -751,17 +752,49 @@ public abstract class BallAPI {
         return info.getUuid();
     }
 
+    /**
+     * 获取玩家的UUID
+     *
+     * @param playerName   玩家名称
+     * @param defaultValue 如果未找到玩家信息则返回该值
+     * @return 玩家的UUID
+     */
+    @NotNull
+    public UUID getPlayerUUID(String playerName, @NotNull UUID defaultValue) {
+        BallPlayerInfo info = getPlayerInfo(playerName);
+        if (info == null) {
+            return defaultValue;
+        }
+        return info.getUuid();
+    }
+
     /**
      * 获取玩家名称
      *
      * @param uuid 玩家的 UUID
      * @return 如果数据不存在，则返回字符串形式的 "null"
      */
-    @NotNull
+    @Nullable
     public String getPlayerName(@NotNull UUID uuid) {
         BallPlayerInfo info = getPlayerInfo(uuid);
         if (info == null) {
-            return "null";
+            return null;
+        }
+        return info.getName();
+    }
+
+    /**
+     * 获取玩家名称
+     *
+     * @param uuid         玩家的 UUID
+     * @param defaultValue 如果未找到玩家信息则返回该值
+     * @return 玩家名称
+     */
+    @NotNull
+    public String getPlayerName(@NotNull UUID uuid, @NotNull String defaultValue) {
+        BallPlayerInfo info = getPlayerInfo(uuid);
+        if (info == null) {
+            return defaultValue;
         }
         return info.getName();
     }