Skip to main content

signInWithMinecraft

Sign a Minecraft player in to one of Crowded Kingdoms' own apps, as a player its organization manages (no Crowded Kingdoms account): the same app token mintManagedPlayerToken returns, refreshed with refreshAppToken. ck-api asks Mojang whether username joined with serverId (minecraftChallenge) and admits the player only on a yes; the player is identified by its Minecraft account, not its name. Refusals: MINECRAFT_VERIFICATION_FAILED (extensions.reason: malformed, forged, expired, not_joined, replayed: start again from minecraftChallenge), MINECRAFT_VERIFICATION_UNAVAILABLE (Mojang did not answer; retryable), TERRITORY_NOT_SUPPORTED (the declared country, or the network's country or region), AGE_REQUIREMENT_NOT_MET (under 13, or under the app's or the country's minimum age; it names no age, and the same Minecraft account is then refused for 24 hours whatever it sends), LEGAL_ACCEPTANCE_REQUIRED (acceptedDocuments misses one in extensions.missingDocuments), and ORG_LEGAL_ACCEPTANCE_REQUIRED for an organization that has not accepted the Org-Managed Players Addendum. The age is checked once Mojang has confirmed the account, and the birth month of its first admitted sign-in stays its own: a later birthDate is ignored. The accepted documents are recorded with method IN_GAME. Public; rate-limited per address.

signInWithMinecraft(
input: SignInWithMinecraftInput!
): AppTokenResponse!

Arguments​

signInWithMinecraft.input ● SignInWithMinecraftInput! non-null input​

Type​

AppTokenResponse object​

A short-lived, app-scoped gameplay token (Overworld portal). Confined to a single app: usable only against that app's Game API + Buddy realtime surface (plus read-only me and same-app refreshAppToken). It CANNOT perform management operations and CANNOT mint tokens for other apps, so a game stack that receives it never gets the player's full identity session.