add get by numerical & by group

Author: InvalidJoker

api/src/main/java/app/simplecloud/api/internal/server/ServerApiImpl.java

@@ -58,6 +58,55 @@ public CompletableFuture<Server> getServerById(String id) {
         });
     }
 
+    @Override
+    public CompletableFuture<Server> getServerByNumericalId(String groupName, int numericalId) {
+        return CompletableFuture.supplyAsync(() -> {
+            try {
+                ServerQuery query = ServerQuery.create()
+                        .filterByServerGroupName(groupName)
+                        .filterByNumericalId(numericalId);
+                ModelsListServersResponse serversResponse = executeQuery(query);
+
+                List<ModelsServerSummary> servers = serversResponse.getServers();
+                if (servers == null) {
+                    return null;
+                }
+
+                for (ModelsServerSummary summary : servers) {
+                    if (summary.getNumericalId() != null && summary.getNumericalId() == numericalId) {
+                        return new ServerImpl(summary);
+                    }
+                }
+                throw new RuntimeException("Server not found in group " + groupName + " with numerical ID " + numericalId);
+
+            } catch (ApiException e) {
+                throw new RuntimeException(e);
+            }
+        });
+    }
+
+    @Override
+    public CompletableFuture<List<Server>> getServersByGroup(String groupName) {
+        return CompletableFuture.supplyAsync(() -> {
+            try {
+                ServerQuery query = ServerQuery.create()
+                        .filterByServerGroupName(groupName);
+                ModelsListServersResponse serversResponse = executeQuery(query);
+
+                List<ModelsServerSummary> servers = serversResponse.getServers();
+                if (servers == null) {
+                    return List.of();
+                }
+
+                return servers.stream()
+                        .<Server>map(ServerImpl::new)
+                        .toList();
+            } catch (ApiException e) {
+                throw new RuntimeException(e);
+            }
+        });
+    }
+
     @Override
     public CompletableFuture<List<Server>> getAllServers(@Nullable ServerQuery query) {
         return CompletableFuture.supplyAsync(() -> {

api/src/main/java/app/simplecloud/api/server/ServerApi.java

@@ -22,6 +22,23 @@ public interface ServerApi {
      */
     CompletableFuture<Server> getServerById(String id);
 
+    /**
+     * Retrieves a server by its numerical ID.
+     *
+     * @param groupName the name of the server group
+     * @param numericalId the numerical server ID
+     * @return a CompletableFuture that completes with the server, or fails if not found
+     */
+    CompletableFuture<Server> getServerByNumericalId(String groupName, int numericalId);
+
+    /**
+     * Retrieves all servers belonging to a specific group.
+     *
+     * @param groupName the name of the server group
+     * @return a CompletableFuture that completes with a list of servers in the specified group
+     */
+    CompletableFuture<List<Server>> getServersByGroup(String groupName);
+
     /**
      * Retrieves all servers, optionally filtered by a query.
      *