{"id":15652051,"url":"https://github.com/jakobdev/minecraft-launcher-lib","last_synced_at":"2025-09-22T06:31:41.032Z","repository":{"id":37474054,"uuid":"227168233","full_name":"JakobDev/minecraft-launcher-lib","owner":"JakobDev","description":"Official Mirror of the Codeberg Repo","archived":false,"fork":false,"pushed_at":"2024-12-21T21:23:39.000Z","size":707,"stargazers_count":37,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-03T04:43:52.122Z","etag":null,"topics":["launcher","microsoft-account","minecraft","minecraft-launcher","python","python3"],"latest_commit_sha":null,"homepage":"https://codeberg.org/JakobDev/minecraft-launcher-lib","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JakobDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-12-10T16:37:00.000Z","updated_at":"2024-12-21T21:21:55.000Z","dependencies_parsed_at":"2023-10-16T09:13:53.672Z","dependency_job_id":"3f0fdb6a-6c2a-44d5-bd1e-9fb2a142ac34","html_url":"https://github.com/JakobDev/minecraft-launcher-lib","commit_stats":{"total_commits":409,"total_committers":11,"mean_commits":37.18181818181818,"dds":0.1124694376528117,"last_synced_commit":"cb2a3e9b1ea419b091a830b001ef81eaf58655b7"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JakobDev%2Fminecraft-launcher-lib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JakobDev%2Fminecraft-launcher-lib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JakobDev%2Fminecraft-launcher-lib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JakobDev%2Fminecraft-launcher-lib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JakobDev","download_url":"https://codeload.github.com/JakobDev/minecraft-launcher-lib/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233828159,"owners_count":18736581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["launcher","microsoft-account","minecraft","minecraft-launcher","python","python3"],"created_at":"2024-10-03T12:41:08.240Z","updated_at":"2025-09-22T06:31:35.695Z","avatar_url":"https://github.com/JakobDev.png","language":"Python","funding_links":["https://ko-fi.com/jakobdev"],"categories":[],"sub_categories":[],"readme":"# minecraft-launcher-lib\n\n![PyPI](https://img.shields.io/pypi/v/minecraft-launcher-lib)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/minecraft-launcher-lib)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/minecraft-launcher-lib)\n![PyPI - License](https://img.shields.io/pypi/l/minecraft-launcher-lib)\n![PyPI - Implementation](https://img.shields.io/pypi/implementation/minecraft-launcher-lib)\n![Read the Docs](https://img.shields.io/readthedocs/minecraft-launcher-lib)\n\nA Python library for creating a custom minecraft launcher. This library containts functions to install and execute minecraft and interacting with mojang accounts.\n\n```python\nimport minecraft_launcher_lib\nimport subprocess\nimport sys\n\n# Set the data for your Azure Application here. For more information look at the documentation.\nCLIENT_ID = \"YOUR CLIENT ID\"\nREDIRECT_URL = \"YOUR REDIRECT URL\"\n\n# Get latest version\nlatest_version = minecraft_launcher_lib.utils.get_latest_version()[\"release\"]\n\n# Get Minecraft directory\nminecraft_directory = minecraft_launcher_lib.utils.get_minecraft_directory()\n\n# Make sure, the latest version of Minecraft is installed\nminecraft_launcher_lib.install.install_minecraft_version(latest_version, minecraft_directory)\n\n# Login\nlogin_url, state, code_verifier = minecraft_launcher_lib.microsoft_account.get_secure_login_data(CLIENT_ID, REDIRECT_URL)\nprint(f\"Please open {login_url} in your browser and copy the url you are redirected into the prompt below.\")\ncode_url = input()\n\n# Get the code from the url\ntry:\n    auth_code = minecraft_launcher_lib.microsoft_account.parse_auth_code_url(code_url, state)\nexcept AssertionError:\n    print(\"States do not match!\")\n    sys.exit(1)\nexcept KeyError:\n    print(\"Url not valid\")\n    sys.exit(1)\n\n# Get the login data\nlogin_data = minecraft_launcher_lib.microsoft_account.complete_login(CLIENT_ID, None, REDIRECT_URL, auth_code, code_verifier)\n\n# Get Minecraft command\noptions = {\n    \"username\": login_data[\"name\"],\n    \"uuid\": login_data[\"id\"],\n    \"token\": login_data[\"access_token\"]\n}\nminecraft_command = minecraft_launcher_lib.command.get_minecraft_command(latest_version, minecraft_directory, options)\n\n# Start Minecraft\nsubprocess.run(minecraft_command, cwd=minecraft_directory)\n```\n\nFeatures:\n- Easy installing\n- Get command to run Minecraft\n- Login to Microsoft account\n- Supports [Forge](https://minecraftforge.net), [Fabric](https://fabricmc.net), [Quilt](https://quiltmc.org) and Liteloader\n- Old versions like alpha or beta supported\n- All functions have type annotations and docstrings\n- Only depents on [requests](https://pypi.org/project/requests)\n- Supports [PyPy](https://www.pypy.org)\n- Full Documention with tutorial online available\n- Supports reading and writing profiles of the Vanilla Launcher\n- Install of [mrpack modpacks](https://docs.modrinth.com/docs/modpacks/format_definition)\n- All public APIs are static typed\n- Examples available\n- OpenSource\n\n[View more examples](https://codeberg.org/JakobDev/minecraft-launcher-lib/src/branch/master/examples)\n\n[Read the documentation](https://minecraft-launcher-lib.readthedocs.io)\n\n[Thanks to tomsik68 who documented how a minecraft launcher works](https://github.com/tomsik68/mclauncher-api/wiki)\n\n[Buy me a coffe](https://ko-fi.com/jakobdev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakobdev%2Fminecraft-launcher-lib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjakobdev%2Fminecraft-launcher-lib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakobdev%2Fminecraft-launcher-lib/lists"}