SimpleCloud API Plugin

# Cloud API ! <div align="center"> ] ] ] <br> ] ] ] ] <br> · <br> 🌟 Give us a star — your support means the world to us! </div> <br> > All information about this project can be found in our detailed . This Project aims to provide very easy API access. This project fixes all dependency issues that were present before. Install the platform JAR on the server and use the dependency as described below. > > Paper specific API is very experimental and unstable. Use Spigot API if you are running paper! ## Features - **Easy API Use**: Just add the plugin to your server and include the api as a provided artifact. - **Supported Server Software**: Supports Spigot and forks, Paper, Folia, BungeeCord, Velocity, Fabric, Quilt, and NeoForge. - **Easy API access**: Use every api method we provide, just from one interface. ## Server Installation - Put the Spigot, Paper, Folia, BungeeCord, and Velocity JAR in the server's `plugins` directory. - Put the Fabric/Quilt or NeoForge JAR in the server's `mods` directory. - The shared Fabric/Quilt build requires Fabric API. - Fabric, Quilt, and NeoForge support is server-side only, targets Minecraft 26.2, and does not require clients to install the mod. ## Usage ### Go The standalone Go SDK lives in (go/README.md). It includes the complete Controller REST API plus typed NATS events and does not require a Minecraft plugin runtime. ```go client, err := simplecloud.NewClientFromEnv() if err != nil { log.Fatal(err) } defer client.Close() groups, _, err := client.Groups.List(context.Background(), nil) ``` See the (go/README.md) for installation, configuration, events, and raw endpoint access. ### 1. Depend on `simplecloud-api` ### 2. Use APIs > For always up-to-date artifacts visit or . > Note: If you want to use the dev version, you have to use the . #### Gradle Kotlin ```kt // Use Controller API if you want compileOnly("app.simplecloud.controller:controller-api:VERSION") // Use Player API if you want compileOnly("app.simplecloud.controller:controller-api:VERSION") ``` #### Gradle Groovy ```groovy // Use Controller API if you want compileOnly 'app.simplecloud.controller:controller-api:VERSION' // Use Player API if you want compileOnly 'app.simplecloud.controller:controller-api:VERSION' ``` #### Maven ```xml <dependencies> <!-- Use Controller API if you want --> <dependency> <groupId>app.simplecloud.controller</groupId> <artifactId>controller-api</artifactId> <version>VERSION</version> <scope>provided</scope> </dependency> <!-- Use Player API if you want --> <dependency> <groupId>app.simplecloud.droplet.player</groupId> <artifactId>player-api</artifactId> <version>VERSION</version> <scope>provided</scope> </dependency> </dependencies> ``` ## Contributing Contributions to SimpleCloud are welcome and highly appreciated. However, before you jump right into it, we would like you to read our . ## License This repository is licensed under . <!-- LINK GROUP --> <!-- ✅ PLEASE EDIT --> : https://simplecloud.app/api/banner/Cloud%20API : https://github.com/simplecloudapp/cloud-api/issues/new?labels=bug&projects=template=01_BUG-REPORT.yml&title=%5BBUG%5D+%3Ctitle%3E : https://github.com/simplecloudapp/cloud-api/discussions/new?category=ideas : https://docs.simplecloud.app/api : https://docs.simplecloud.app/contribute : https://modrinth.com/organization/simplecloud : https://repo.simplecloud.app/#/snapshots/app/simplecloud/cloud-api : https://repo.simplecloud.app/#/snapshots/app/simplecloud/api/cloud-api : https://repo.simplecloud.app/#/snapshots/app/simplecloud/cloud-api : https://img.shields.io/maven-central/v/app.simplecloud.api/cloud-api?labelColor=18181b&style=flat-square&color=65a30d&label=Release : https://repo.simplecloud.app/api/badge/latest/snapshots/app/simplecloud/api/cloud-api?name=Dev&style=flat-square&color=0ea5e9 <!-- ⛔ DON'T TOUCH --> : https://opensource.org/licenses/Apache-2.0 : https://repo.simplecloud.app/#/snapshots : https://x.com/simplecloudapp : https://bsky.app/profile/simplecloud.app : https://www.youtube.com/@thesimp