{"openapi":"3.1.0","info":{"title":"UnstableSMP Public Information API","version":"1.0.0","description":"Public, read-only website information. No authentication or registration. Connection instructions are published configuration, not a live Minecraft status result."},"servers":[{"url":"https://unstablesmp.gg"}],"security":[],"paths":{"/api/server-info":{"get":{"operationId":"getServerInfo","summary":"Read UnstableSMP connection instructions and official links","responses":{"200":{"description":"Published connection information","content":{"application/json":{"schema":{"type":"object","required":["name","website","guide","serverAddress","discordInvite","editions","compatibilityNote"],"properties":{"name":{"type":"string"},"website":{"type":"string","format":"uri"},"guide":{"type":"string","format":"uri"},"serverAddress":{"type":"string"},"discordInvite":{"type":"string","format":"uri"},"updated":{"type":"string","format":"date"},"javaVersionGuidance":{"type":"string"},"javaPortDiscovery":{"type":"string"},"bedrockAvailability":{"type":"string","enum":["unconfirmed"]},"compatibilityNote":{"type":"string"},"consoleNote":{"type":"string"},"accountSafety":{"type":"string"},"editions":{"type":"object","required":["java","bedrock"],"properties":{"java":{"$ref":"#/components/schemas/Edition"},"bedrock":{"$ref":"#/components/schemas/Edition"}}}}},"example":{"name":"UnstableSMP","website":"https://unstablesmp.gg","guide":"https://unstablesmp.gg/how-to-join","serverAddress":"play.unstablesmp.gg","discordInvite":"https://discord.com/invite/unstablesmp-official","updated":"2026-09-13","javaVersionGuidance":"Match the version advertised in the Minecraft server list","javaPortDiscovery":"DNS SRV; enter the hostname without an explicit port","bedrockAvailability":"unconfirmed","compatibilityNote":"Check current Discord announcements for supported client versions and maintenance. This response contains published connection instructions, not live Minecraft server status.","editions":{"java":{"name":"Java Edition","devices":"Windows, macOS & Linux","menu":"Multiplayer → Add Server","port":null,"note":"Enter the hostname without a port. Minecraft Java discovers the connection port through the server's DNS SRV record.","steps":[{"title":"Open Minecraft: Java Edition","text":"Sign in through the Minecraft Launcher and launch a version supported by the server. Check Discord announcements if you are unsure which version to use."},{"title":"Choose Multiplayer, then Add Server","text":"Name the saved entry UnstableSMP so you can find it next time."},{"title":"Enter the server address","text":"Paste play.unstablesmp.gg into Server Address. Use the hostname only, without https://, spaces, or a web page path."},{"title":"Save it and join","text":"Select Done, choose UnstableSMP in the server list, and press Join Server. Read the welcome information when you arrive."}]},"bedrock":{"name":"Bedrock Edition","devices":"Minecraft for Windows, phones & tablets","menu":"Play → Servers → Add Server","port":19132,"availability":"unconfirmed","note":"Bedrock access is unconfirmed. The previously published port is 19132; confirm availability and the current port in the official Discord before connecting.","steps":[{"title":"Confirm Bedrock access, then open Minecraft","text":"Check current Bedrock availability, port, and supported version in the official Discord. If access is confirmed, open Minecraft with multiplayer enabled."},{"title":"Open Play, then the Servers tab","text":"Select Add Server on a device that supports custom server entries."},{"title":"Fill in the confirmed server details","text":"Set Server Name to UnstableSMP and Server Address to play.unstablesmp.gg. Enter the currently confirmed port separately; 19132 is the previously published value, not verified availability."},{"title":"Save and connect","text":"Choose Save to keep the entry, or Play to connect. If the connection fails, check the port, version, and current Discord announcements."}]}},"consoleNote":"Console editions do not offer the same custom-server setup as Windows and mobile. If Add Server is missing, these instructions cannot add a custom server on your device. Ask in the official Discord about current supported options.","accountSafety":"No. Keep passwords, one-time sign-in codes, recovery codes, and account tokens private. Use the official Discord invite from this website and check unexpected verification requests before continuing."}}}}}}},"/api/health":{"get":{"operationId":"getWebsiteHealth","summary":"Check website API availability; does not check the Minecraft server","responses":{"200":{"description":"The website handler is responding","content":{"application/json":{"schema":{"type":"object","required":["status","service","minecraftStatus"],"properties":{"status":{"type":"string","const":"ok"},"service":{"type":"string","const":"unstablesmp-website"},"minecraftStatus":{"type":"string","const":"not_checked"}}}}}}}}}},"components":{"schemas":{"Edition":{"type":"object","required":["name","devices","menu","port","note","steps"],"properties":{"name":{"type":"string"},"devices":{"type":"string"},"menu":{"type":"string"},"port":{"type":["integer","null"]},"note":{"type":"string"},"availability":{"type":"string"},"steps":{"type":"array","items":{"type":"object","required":["title","text"],"properties":{"title":{"type":"string"},"text":{"type":"string"}}}}}}}}}