Wiki article

Getting Started

The first useful path through sora.rs is account creation, server linking, and a test Studio asset.

Create an account
Install SoraStudio.jar
Claim a server
Save a Studio asset

1. Create the account root

Sign in with Discord from the header or dashboard. That account becomes the root record for Minecraft UUIDs, linked servers, premium licenses, and Studio assets.

2. Start a server link from Minecraft

SoraStudio.jar 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 website dashboard.

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

3. Confirm ownership on sora.rs

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

4. Use Studio with a linked server

Open Studio after signing in. Saved assets can be attached to a linked server, then fetched by SoraStudio.jar through the plugin asset API.

Plugin API reference

The live MVP API includes health checks, server linking, license validation, and server-side Studio asset reads.

GET /api/plugin/v1/healthPOST /api/plugin/v1/server-linkPOST /api/plugin/v1/license-checkGET /api/plugin/v1/studio-assets