refactor: improve server start

Author: FllipEis

api/build.gradle.kts

@@ -26,9 +26,9 @@ dependencies {
 
 tasks.named<ShadowJar>("shadowJar") {
     mergeServiceFiles()
-    
+
     val versionPath = project.version.toString().replace(".", "_").replace("-", "_")
-    
+
     relocate("io.nats", "app.simplecloud.api.shaded.v${versionPath}.nats")
     relocate("com.google", "app.simplecloud.api.shaded.v${versionPath}.google")
     relocate("build.buf", "app.simplecloud.api.shaded.v${versionPath}.buf")
@@ -39,11 +39,11 @@ tasks.named<ShadowJar>("shadowJar") {
     relocate("org.intellij", "app.simplecloud.api.shaded.v${versionPath}.intellij")
     relocate("org.jetbrains", "app.simplecloud.api.shaded.v${versionPath}.jetbrains")
     relocate("kotlin", "app.simplecloud.api.shaded.v${versionPath}.kotlin")
-    
+
     relocate("google", "app.simplecloud.api.shaded.v${versionPath}.google")
     relocate("native", "app.simplecloud.api.shaded.v${versionPath}.native")
     relocate("core", "app.simplecloud.api.shaded.v${versionPath}.core")
-    
+
     archiveClassifier.set("")
 }
 
@@ -75,11 +75,13 @@ openApiGenerate {
     modelPackage.set("app.simplecloud.api.web.models")
     packageName.set("app.simplecloud.api.web")
 
-    configOptions.set(mapOf(
-        "library" to "okhttp-gson",
-        "serializationLibrary" to "gson",
-        "useJakartaEe" to "true"
-    ))
+    configOptions.set(
+        mapOf(
+            "library" to "okhttp-gson",
+            "serializationLibrary" to "gson",
+            "useJakartaEe" to "true"
+        )
+    )
 }
 
 tasks.compileJava {
@@ -106,7 +108,7 @@ publishing {
             artifact(tasks.named<ShadowJar>("shadowJar")) {
                 classifier = ""
             }
-            
+
             artifact(tasks.named<Jar>("javadocJar"))
             artifact(tasks.named<Jar>("sourcesJar"))
 

api/src/main/java/app/simplecloud/api/CloudApi.java

@@ -7,27 +7,27 @@
 
 /**
  * Main entry point for the SimpleCloud API.
- * 
+ *
  * <p>This interface provides access to manage server groups, individual servers,
  * and subscribe to system events. Use the static factory methods to create an instance.
- * 
+ *
  * <p>Example usage:
  * <pre>{@code
  * CloudApi api = CloudApi.create(CloudApiOptions.builder()
  *     .networkId("your-network-id")
  *     .networkSecret("your-secret")
  *     .build());
- * 
+ *
  * // Manage server groups
  * api.group().getAllGroups().thenAccept(groups -> {
  *     groups.forEach(group -> System.out.println(group.getName()));
  * });
- * 
+ *
  * // Query servers
  * api.server().getAllServers().thenAccept(servers -> {
  *     System.out.println("Active servers: " + servers.size());
  * });
- * 
+ *
  * // Subscribe to events
  * Subscription sub = api.event().group().onCreated(event -> {
  *     System.out.println("Group created: " + event.getServerGroupId());
@@ -38,15 +38,15 @@ public interface CloudApi {
 
     /**
      * Creates a CloudAPI instance with default options.
-     * 
+     *
      * <p>Default options are loaded from environment variables:
      * <ul>
      *   <li>SIMPLECLOUD_NETWORK_ID (default: "default")</li>
      *   <li>SIMPLECLOUD_NETWORK_SECRET (default: "")</li>
      *   <li>SIMPLECLOUD_NATS_URL (default: "nats://localhost:4222")</li>
      *   <li>SIMPLECLOUD_CONTROLLER_URL (default: "http://localhost:1337")</li>
      * </ul>
-     * 
+     *
      * @return a new CloudApi instance
      */
     static CloudApi create() {
@@ -55,7 +55,7 @@ static CloudApi create() {
 
     /**
      * Creates a CloudAPI instance with custom options.
-     * 
+     *
      * @param options the configuration options for the API client
      * @return a new CloudApi instance
      */
@@ -65,28 +65,28 @@ static CloudApi create(CloudApiOptions options) {
 
     /**
      * Returns the group management API.
-     * 
+     *
      * <p>Use this to create, read, update, and delete server groups.
-     * 
+     *
      * @return the group API
      */
     GroupApi group();
 
     /**
      * Returns the server management API.
-     * 
+     *
      * <p>Use this to query running servers, start new instances, and stop servers.
-     * 
+     *
      * @return the server API
      */
     ServerApi server();
 
     /**
      * Returns the event subscription API.
-     * 
+     *
      * <p>Use this to subscribe to real-time events for groups, servers,
      * persistent servers, and blueprints.
-     * 
+     *
      * @return the event API
      */
     EventApi event();

api/src/main/java/app/simplecloud/api/blueprint/Blueprint.java

@@ -6,88 +6,88 @@
 
 /**
  * Represents a server blueprint configuration.
- * 
+ *
  * <p>Blueprints are reusable templates that define the base software configuration
  * for server instances, including the Minecraft version, server software type,
  * runtime environment, and workflow steps to execute during server lifecycle.
  */
 public interface Blueprint {
-    
+
     /**
      * Returns the unique identifier of this blueprint.
-     * 
+     *
      * @return the blueprint ID
      */
     String getBlueprintId();
-    
+
     /**
      * Returns the human-readable name of this blueprint.
-     * 
+     *
      * @return the blueprint name
      */
     String getName();
-    
+
     /**
      * Returns the configurator used to set up this blueprint.
-     * 
+     *
      * @return the configurator name, or null if not set
      */
     @Nullable String getConfigurator();
-    
+
     /**
      * Returns the Minecraft version this blueprint is configured for.
-     * 
+     *
      * @return the Minecraft version, or null if not applicable
      */
     @Nullable String getMinecraftVersion();
-    
+
     /**
      * Returns the server software type (e.g., "paper", "spigot", "velocity").
-     * 
+     *
      * @return the server software, or null if not set
      */
     @Nullable String getServerSoftware();
-    
+
     /**
      * Returns the download URL for the server software.
-     * 
+     *
      * @return the server URL, or null if not set
      */
     @Nullable String getServerUrl();
-    
+
     /**
      * Returns the specific version of the server software.
-     * 
+     *
      * @return the software version, or null if not set
      */
     @Nullable String getSoftwareVersion();
-    
+
     /**
      * Returns the runtime configuration for servers using this blueprint.
-     * 
+     *
      * <p>Defines the runtime type (e.g., Java) and associated configuration.
-     * 
+     *
      * @return the runtime config, or null if not set
      */
     @Nullable RuntimeConfig getRuntimeConfig();
-    
+
     /**
      * Returns the workflow steps to execute during server lifecycle events.
-     * 
+     *
      * @return the list of workflow step IDs, or null if none defined
      */
     @Nullable List<String> getWorkflowSteps();
-    
+
     /**
      * Returns the timestamp when this blueprint was created (ISO 8601 format).
-     * 
+     *
      * @return the creation timestamp
      */
     String getCreatedAt();
-    
+
     /**
      * Returns the timestamp when this blueprint was last updated (ISO 8601 format).
-     * 
+     *
      * @return the update timestamp
      */
     String getUpdatedAt();

api/src/main/java/app/simplecloud/api/blueprint/RuntimeConfig.java

@@ -32,3 +32,4 @@ public void setWith(@Nullable Map<String, Object> with) {
     }
 }
 
+

api/src/main/java/app/simplecloud/api/blueprint/RuntimeType.java

@@ -4,16 +4,24 @@
  * Represents the runtime type for server execution.
  */
 public enum RuntimeType {
-    /** Java runtime environment. */
+    /**
+     * Java runtime environment.
+     */
     JAVA,
-    
-    /** Node.js runtime environment. */
+
+    /**
+     * Node.js runtime environment.
+     */
     NODE,
-    
-    /** Python runtime environment. */
+
+    /**
+     * Python runtime environment.
+     */
     PYTHON,
-    
-    /** Docker container runtime. */
+
+    /**
+     * Docker container runtime.
+     */
     DOCKER
 }
 

api/src/main/java/app/simplecloud/api/event/EventApi.java

@@ -7,7 +7,7 @@
 
 /**
  * API for subscribing to real-time system events.
- * 
+ *
  * <p>Provides access to event streams for various system entities.
  * All event subscriptions return a {@link Subscription} that must be
  * closed when no longer needed to prevent resource leaks.
@@ -16,28 +16,28 @@ public interface EventApi {
 
     /**
      * Returns the event API for server group events.
-     * 
+     *
      * @return the group event API
      */
     GroupEventApi group();
 
     /**
      * Returns the event API for server instance events.
-     * 
+     *
      * @return the server event API
      */
     ServerEventApi server();
 
     /**
      * Returns the event API for persistent server events.
-     * 
+     *
      * @return the persistent server event API
      */
     PersistentServerEventApi persistentServer();
 
     /**
      * Returns the event API for blueprint events.
-     * 
+     *
      * @return the blueprint event API
      */
     BlueprintEventApi blueprint();

api/src/main/java/app/simplecloud/api/event/Subscription.java

@@ -2,23 +2,23 @@
 
 /**
  * Represents an active event subscription.
- * 
+ *
  * <p>Subscriptions must be closed when no longer needed to release resources.
  * This interface implements {@link AutoCloseable} for use in try-with-resources.
  */
 public interface Subscription extends AutoCloseable {
 
     /**
      * Unsubscribes from the event stream.
-     * 
+     *
      * <p>After calling this method, the handler will no longer receive events.
      * This method is idempotent and can be called multiple times safely.
      */
     void unsubscribe();
 
     /**
      * Closes the subscription by calling {@link #unsubscribe()}.
-     * 
+     *
      * <p>This method allows subscriptions to be used in try-with-resources statements.
      */
     @Override