{"openapi":"3.1.0","info":{"title":"Jace Store Launcher API","version":"1","description":"Read-only, public, CORS-enabled API for Minecraft launchers to browse, install and update content from the store."},"servers":[{"url":"https://jace-store-deb.vercel.app/api/launcher/v1"}],"paths":{"/meta":{"get":{"summary":"Types, loaders, categories and game versions for filter UI","responses":{"200":{"description":"Metadata"}}}},"/search":{"get":{"summary":"Search Minecraft content","parameters":[{"name":"q","in":"query","required":false,"description":"Search text","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Comma list of: mod, resourcepack, shader, datapack, modpack, plugin, world, bedrock_addon, bedrock_texture, bedrock_world, bedrock_skin, bedrock_template","schema":{"type":"string"}},{"name":"loader","in":"query","required":false,"description":"Comma list, any match","schema":{"type":"string"}},{"name":"game_version","in":"query","required":false,"description":"Minecraft version (Java or Bedrock numbering, matching the type)","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Comma list, any match","schema":{"type":"string"}},{"name":"edition","in":"query","required":false,"description":"Which Minecraft when no type is given. Default java","schema":{"type":"string","enum":["java","bedrock","all"]}},{"name":"sort","in":"query","required":false,"description":"Sort order","schema":{"type":"string","enum":["downloads","updated","newest","title"]}},{"name":"page","in":"query","required":false,"description":"1-based page","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"1-50, default 20","schema":{"type":"integer"}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}}}}},"/featured":{"get":{"summary":"Popular, recently updated and newest projects","parameters":[{"name":"type","in":"query","required":false,"description":"Comma list of types","schema":{"type":"string"}},{"name":"edition","in":"query","required":false,"description":"java (default), bedrock or all","schema":{"type":"string","enum":["java","bedrock","all"]}},{"name":"limit","in":"query","required":false,"description":"1-30","schema":{"type":"integer"}}],"responses":{"200":{"description":"Rows"}}}},"/project/{slug}":{"get":{"summary":"Project details with the featured version","parameters":[{"name":"slug","in":"path","required":true,"description":"Project slug or id","schema":{"type":"string"}}],"responses":{"200":{"description":"Project"},"404":{"description":"Not found or not Minecraft content"}}}},"/project/{slug}/versions":{"get":{"summary":"Versions, filterable for an instance","parameters":[{"name":"slug","in":"path","required":true,"description":"Project slug or id","schema":{"type":"string"}},{"name":"loader","in":"query","required":false,"description":"Instance loader, e.g. fabric, neoforge, iris","schema":{"type":"string"}},{"name":"game_version","in":"query","required":false,"description":"Minecraft version, e.g. 1.21.1","schema":{"type":"string"}},{"name":"channel","in":"query","required":false,"description":"release = releases only, beta = releases + betas, omit = all","schema":{"type":"string","enum":["release","beta","alpha"]}}],"responses":{"200":{"description":"Versions","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Version"}}}}}}}},"/project/{slug}/resolve":{"get":{"summary":"Best version + file + install path for an instance","parameters":[{"name":"slug","in":"path","required":true,"description":"Project slug or id","schema":{"type":"string"}},{"name":"loader","in":"query","required":false,"description":"Instance loader, e.g. fabric, neoforge, iris","schema":{"type":"string"}},{"name":"game_version","in":"query","required":false,"description":"Minecraft version, e.g. 1.21.1","schema":{"type":"string"}},{"name":"channel","in":"query","required":false,"description":"release = releases only, beta = releases + betas, omit = all","schema":{"type":"string","enum":["release","beta","alpha"]}}],"responses":{"200":{"description":"Resolved install"},"404":{"description":"No compatible version"}}}},"/updates":{"post":{"summary":"Identify installed files by hash and check for updates","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["hashes"],"properties":{"hashes":{"type":"array","items":{"type":"string"}},"algorithm":{"type":"string","enum":["sha1","sha512"]},"loader":{"type":"string"},"game_version":{"type":"string"},"channel":{"type":"string"}}}}}},"responses":{"200":{"description":"{ results: { <hash>: { project, current_version, update_available, latest_version, latest_file } } }"}}}}},"components":{"schemas":{"File":{"type":"object","properties":{"id":{"type":"string"},"filename":{"type":"string"},"label":{"type":["string","null"]},"primary":{"type":"boolean"},"external":{"type":"boolean"},"size":{"type":["integer","null"]},"hashes":{"type":["object","null"],"properties":{"sha1":{"type":"string"},"sha512":{"type":"string"}}},"url":{"type":"string","description":"Counts the download and redirects"},"direct_url":{"type":"string"}}},"Version":{"type":"object","properties":{"id":{"type":"string"},"project_id":{"type":"string"},"name":{"type":"string"},"version_number":{"type":"string"},"channel":{"type":"string"},"loaders":{"type":"array","items":{"type":"string"}},"game_versions":{"type":"array","items":{"type":"string"}},"changelog":{"type":"string"},"downloads":{"type":"integer"},"published_at":{"type":"string"},"files":{"type":"array","items":{"$ref":"#/components/schemas/File"}}}},"Hit":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"type":{"type":"string","enum":["mod","resourcepack","shader","datapack","modpack","plugin","world","bedrock_addon","bedrock_texture","bedrock_world","bedrock_skin","bedrock_template"]},"edition":{"type":"string","enum":["java","bedrock"]},"title":{"type":"string"},"summary":{"type":"string"},"icon_url":{"type":["string","null"]},"author":{"type":["string","null"]},"downloads":{"type":"integer"},"categories":{"type":"array","items":{"type":"string"}},"loaders":{"type":"array","items":{"type":"string"}},"game_versions":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"page_url":{"type":"string"}}},"SearchResult":{"type":"object","properties":{"hits":{"type":"array","items":{"$ref":"#/components/schemas/Hit"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"},"pages":{"type":"integer"}}}}}}