Wiki article

Getting Started

The first useful path through sora.rs is account creation and server linking.

Create an account
Start the bridge plugin
Claim a server

1. Create the account root

Sign in with Discord from the header or account page. That account becomes the root record for Minecraft UUIDs, connected servers, and premium licenses.

2. Start a server link from Minecraft

The bridge plugin calls the server-link API with its server UUID, display name, and plugin version. The API returns a short-lived claim token that the server owner enters on the account page.

  • Endpoint: POST /api/plugin/v1/server-link
  • Token lifetime: 15 minutes
  • Claim surface: Account > Server links

3. Confirm ownership on sora.rs

After the token is claimed, the account page creates an active connected server and issues an API key for the plugin. The key is shown once and should be stored by the plugin configuration.

Plugin API reference

The live MVP API includes health checks, server linking, and license validation.

GET /api/plugin/v1/healthPOST /api/plugin/v1/server-linkPOST /api/plugin/v1/license-check