Skip to main content

​
Quick Start

This guide will get you up and running with the MCMP Java SDK in just a few minutes.

​
Prerequisites

Java 11+

Ensure you have Java 11 or higher installed

MCMP Account

Sign up for a free account at mcmp.app

​
Step 1: Add Dependency

Add the MCMP Java SDK to your project: Maven: 
<dependency>
    <groupId>com.mcmp</groupId>
    <artifactId>mcmp-java-sdk</artifactId>
    <version>1.0.0</version>
</dependency>
Gradle: 
implementation 'com.mcmp:mcmp-java-sdk:1.0.0'

​
Step 2: Get Your API Key

  1. Sign in to mcmp.app
  2. Go to Settings → API Keys
  3. Click Generate New Key
  4. Copy your API key

​
Step 3: Create Your First Server

import com.mcmp.sdk.McmpClient;
import com.mcmp.sdk.models.Server;
import com.mcmp.sdk.models.ServerType;
import com.mcmp.sdk.models.ServerVersion;

public class QuickStart {
    public static void main(String[] args) {
        // Initialize the client
        McmpClient client = McmpClient.builder()
            .apiKey("your-api-key-here")
            .build();
        
        try {
            // Create a new server
            Server server = client.servers().create()
                .name("My First Server")
                .type(ServerType.PAPER)
                .version(ServerVersion.V1_21_1)
                .build();
            
            System.out.println("Created server: " + server.getId());
            
            // Start the server
            client.servers().start(server.getId());
            System.out.println("Server started!");
            
            // Check server status
            var status = client.servers().getStatus(server.getId());
            System.out.println("Server status: " + status.getState());
            
        } catch (Exception e) {
            System.err.println("Error: " + e.getMessage());
        }
    }
}

​
Step 4: Run Your Code

Compile and run your Java application: 
javac -cp "mcmp-java-sdk-1.0.0.jar:." QuickStart.java
java -cp "mcmp-java-sdk-1.0.0.jar:." QuickStart

​
What’s Next?

Server Management

Learn to manage server lifecycle, configuration, and monitoring

Player Analytics

Track player behavior and engagement metrics

Plugin Integration

Integrate with Bukkit/Spigot/Paper plugins

Advanced Features

Explore advanced SDK capabilities

​
Common Examples

​
List All Servers

// List all your servers
List<Server> servers = client.servers().list();

for (Server server : servers) {
    System.out.println("Server: " + server.getName());
    System.out.println("ID: " + server.getId());
    System.out.println("Status: " + server.getStatus());
    System.out.println("---");
}

​
Execute Server Commands

// Execute a command on your server
String result = client.servers().executeCommand(server.getId(), "list")
    .getOutput();
System.out.println("Online players: " + result);

​
Monitor Server Performance

// Get server performance metrics
var metrics = client.servers().getMetrics(server.getId());

System.out.println("CPU Usage: " + metrics.getCpuUsage() + "%");
System.out.println("Memory Usage: " + metrics.getMemoryUsage() + "MB");
System.out.println("Players Online: " + metrics.getPlayerCount());

​
Troubleshooting

Make sure your API key is correct and has the necessary permissions.
Check that you have sufficient resources and the server type/version is supported.
Verify your network connection and that the MCMP API is accessible.

​
Next Steps

1

Authentication

Learn about different authentication methods
2

Server Management

Master server lifecycle management
3

Advanced Features

Explore advanced SDK capabilities