Launch a new client process
This operation launches a new daemon-managed real Minecraft Java client process. This is not a selector, retry, or reuse operation. Before calling it in an existing daemon or workspace, call GET /clients and GET /clients/{id} to reuse a suitable client. If replacing a failed attempt, stop the old client with POST /clients/{id}:stop first. Creating fresh timestamped ids for retries leaves multiple Minecraft clients running.
This operation launches a new daemon-managed real Minecraft Java client process. This is not a selector, retry, or reuse operation. Before calling it in an existing daemon or workspace, call GET /clients and GET /clients/{id} to reuse a suitable client. If replacing a failed attempt, stop the old client with POST /clients/{id}:stop first. Creating fresh timestamped ids for retries leaves multiple Minecraft clients running.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/clients" \ -H "Content-Type: application/json" \ -d '{ "id": "string", "loader": "FABRIC" }'{ "id": "string", "instance": { "id": "string", "version": { "id": "string" }, "loader": "string", "files": { "root": "string", "gameRoot": "string", "runtimeRoot": "string", "cache": "string", "mods": "string", "config": "string", "saves": "string", "resourcePacks": "string", "shaderPacks": "string", "screenshots": "string", "logs": "string", "artifacts": "string" } }, "profile": { "kind": "string", "name": "string" }, "presentation": { "window": "NONE", "audio": "MUTED" }, "state": "string"}{ "code": "string", "message": "string"}Send client RPC POST
Sends a JSON-RPC-style control or query request to an existing client. Use this for generic query, invoke, subscribe, and unsubscribe flows when the generated API advertises the target shape.
Inspect a client process GET
Inspects one existing daemon-managed client process. Prefer this when a client id is already known; it does not launch a new client.