feat: add Adventure and Player API integration

Author: FllipEis

api/build.gradle.kts

@@ -16,12 +16,17 @@ java {
 dependencies {
     implementation(rootProject.libs.jnats)
     implementation(rootProject.libs.controller.proto)
+    implementation(rootProject.libs.player.proto)
+    implementation(rootProject.libs.adventure.proto)
     implementation(rootProject.libs.okhttp)
     implementation(rootProject.libs.okhttp.logging)
     implementation(rootProject.libs.gson)
     implementation(rootProject.libs.gson.fire)
     implementation(rootProject.libs.jakarta.annotation)
     implementation(rootProject.libs.javax.annotation)
+
+    implementation(rootProject.libs.adventure.api)
+    implementation(rootProject.libs.adventure.gson)
 }
 
 tasks.named<ShadowJar>("shadowJar") {
@@ -47,8 +52,8 @@ tasks.named<ShadowJar>("shadowJar") {
     archiveClassifier.set("")
 }
 
-tasks.named("jar") {
-    enabled = false
+tasks.named<Jar>("jar") {
+    archiveClassifier.set("thin")
 }
 
 sourceSets {

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

@@ -3,6 +3,7 @@
 import app.simplecloud.api.event.EventApi;
 import app.simplecloud.api.group.GroupApi;
 import app.simplecloud.api.internal.CloudApiImpl;
+import app.simplecloud.api.player.PlayerApi;
 import app.simplecloud.api.server.ServerApi;
 
 /**
@@ -91,5 +92,22 @@ static CloudApi create(CloudApiOptions options) {
      */
     EventApi event();
 
+    /**
+     * Returns the player management API.
+     *
+     * <p>Use this to query online players, send messages, kick, connect, etc.
+     * Players implement Adventure's Audience interface for sending content.
+     *
+     * @return the player API
+     */
+    PlayerApi player();
+
+    /**
+     * Returns the network ID this API is connected to.
+     *
+     * @return the network ID
+     */
+    String getNetworkId();
+
 }
 

api/src/main/java/app/simplecloud/api/internal/CloudApiImpl.java

@@ -7,6 +7,8 @@
 import app.simplecloud.api.internal.event.EventApiImpl;
 import app.simplecloud.api.internal.group.GroupApiImpl;
 import app.simplecloud.api.internal.server.ServerApiImpl;
+import app.simplecloud.api.internal.player.PlayerApiImpl;
+import app.simplecloud.api.player.PlayerApi;
 import app.simplecloud.api.server.ServerApi;
 import io.nats.client.Connection;
 import io.nats.client.Nats;
@@ -22,6 +24,7 @@ public class CloudApiImpl implements CloudApi {
     private final ServerApi serverApi;
     private final GroupApi groupApi;
     private final EventApi eventApi;
+    private final PlayerApi playerApi;
 
     public CloudApiImpl(CloudApiOptions options) {
         this.options = options;
@@ -40,6 +43,7 @@ public CloudApiImpl(CloudApiOptions options) {
         this.serverApi = new ServerApiImpl(options);
         this.groupApi = new GroupApiImpl(options);
         this.eventApi = new EventApiImpl(natsClient, options.getNetworkId());
+        this.playerApi = new PlayerApiImpl(options, natsClient);
     }
 
     @Override
@@ -57,5 +61,25 @@ public EventApi event() {
         return eventApi;
     }
 
+    @Override
+    public PlayerApi player() {
+        return playerApi;
+    }
+
+    /**
+     * Returns the underlying NATS connection.
+     * This is for internal use by integration modules.
+     *
+     * @return the NATS connection
+     */
+    public Connection getNatsConnection() {
+        return natsClient;
+    }
+
+    @Override
+    public String getNetworkId() {
+        return options.getNetworkId();
+    }
+
 }