{"id":15086003,"url":"https://github.com/telecter/cmd-launcher","last_synced_at":"2026-01-16T18:03:11.067Z","repository":{"id":227732933,"uuid":"772266554","full_name":"telecter/cmd-launcher","owner":"telecter","description":"A minimal command line Minecraft launcher + API with in-built support for mod loaders.","archived":false,"fork":false,"pushed_at":"2026-01-15T21:29:27.000Z","size":55544,"stargazers_count":19,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-16T00:13:09.443Z","etag":null,"topics":["cli","go","minecraft","minecraft-launcher"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/telecter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-03-14T21:17:39.000Z","updated_at":"2026-01-15T21:29:31.000Z","dependencies_parsed_at":"2024-05-12T22:30:36.304Z","dependency_job_id":"fad9b203-3e35-4bb8-ae45-ffc974564f76","html_url":"https://github.com/telecter/cmd-launcher","commit_stats":null,"previous_names":["telectr/minecraft-launcher","telectr/cmd-launcher","telecter/cmd-launcher"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/telecter/cmd-launcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telecter%2Fcmd-launcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telecter%2Fcmd-launcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telecter%2Fcmd-launcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telecter%2Fcmd-launcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/telecter","download_url":"https://codeload.github.com/telecter/cmd-launcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/telecter%2Fcmd-launcher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28480513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["cli","go","minecraft","minecraft-launcher"],"created_at":"2024-09-25T07:02:51.559Z","updated_at":"2026-01-16T18:03:11.060Z","avatar_url":"https://github.com/telecter.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"docs/icon.png\" width=\"180\"\u003e\n\n# cmd-launcher\n\nA minimal command line Minecraft launcher.  \nEN | [DE](README_de.md)\n\n[![Build](https://github.com/telecter/cmd-launcher/actions/workflows/build.yml/badge.svg)](https://github.com/telecter/cmd-launcher/actions/workflows/build.yml)\n![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/telecter/cmd-launcher)\n[![Go Reference](https://pkg.go.dev/badge/github.com/telecter/cmd-launcher.svg)](https://pkg.go.dev/github.com/telecter/cmd-launcher)\n\n- [Installation](#installation)\n  - [Building from source](#building-from-source)\n- [Usage](#usage)\n  - [Creating an instance](#creating-an-instance)\n  - [Starting the game](#starting-the-game)\n  - [Authentication](#authentication)\n  - [Instance Configuration](#instance-configuration)\n  - [Search](#search)\n\n[API Documentation](docs/API.md)\n\n## Installation\n\n### Binaries\nYou can download prebuilt binaries from the Releases tab here on GitHub.  \nBuilds of the latest commit are available at [nightly.link](https://nightly.link/telecter/cmd-launcher/workflows/build/main).\n\n### Via go install\nMake sure you have [Go](https://go.dev) installed.\n\n**To install the latest version, run:**\n\n```bash\ngo install github.com/telecter/cmd-launcher@latest\n```\n\nReplace `latest` with `main` for the latest commit.\n\n### Building from source\n\n1. Clone the repository: `git clone https://github.com/telecter/cmd-launcher`\n2. In the source directory, run `go run .` to compile and run the launcher.\n3. Once you are ready, compile the executable with `go build .`\n\n## Usage\n\nUse the `--help` flag to get the usage information of any command.\n\n### Instances\n\n**Creating an instance**  \nTo create a new instance, use the `inst create` command.  \nYou can use the `--loader, -l` flag to set the mod loader. Forge, NeoForge, Fabric, and Quilt are all supported. If you want to select a specific version of the loader, use the `--loader-version` flag. Otherwise, the latest applicable version is chosen.\n\nUse the `--version, -v` flag to set the game version. If no value is supplied, the latest release is used. Acceptable values also include `release` or `snapshot` for the latest of either.\n\nWhen starting the game, the launcher will attempt to download a Java runtime from Mojang. If it can't find a suitable one, you will need to set one manually in the instance configuration.\n\n```sh\ncmd-launcher inst create -v 1.21.8 -l fabric CoolInstance\n```\n\n**Deleting instances**  \nIf you want to delete an instance, use the `inst delete` command followed by the instance name.\n\n### Starting the Game\n\n\u003e [!IMPORTANT]\n\u003e This launcher has not been tested for versions \u003c 1.14. It may not work, but I am working on fixing these issues.\n\nTo start Minecraft, simply run the `start` command followed by the name of the instance you want to start.\n\n```bash\ncmd-launcher start CoolInstance\n```\n\nTo set game options and override instance configuration, you can set specific flags on the `start` command. These can be viewed in the help text.\n\n**Verbosity**  \nTo increase the verbosity of the launcher, use the `--verbosity` flag. It can be set to either:\n\n- `info` - default, no extra logging\n- `extra` - more information when starting the game\n- `debug` - debug information useful for debugging the launcher\n\n### Authentication\n\nIf you want to play the game in online mode, you will need to add a Microsoft account.\n\nTo do this, use the `auth login` command. As part of Microsoft's OAuth2 flow, the default web browser will be opened to complete the authentication. This can be avoided with the `--no-browser` flag.  \nThe launcher will automatically attempt to start the game in online mode if there is an account present.\n\nTo play in offline mode, just pass the `-u, --username \u003cusername\u003e` flag to the `start` command\nto set your username and the game will automatically launch in offline mode.\n\nYou can log out via the `auth logout` command.\n\n### Instance Configuration\n\nTo change configuration values for an instance, navigate to the instance directory and open the `instance.toml` file.\n\nConfigurable values are:\n\n- Game version\n- Mod loader and version (if not vanilla)\n- Window resolution\n- Java executable path (if empty, a Mojang-provided Java runtime will be downloaded)\n- Custom JAR path to use instead of downloading the normal client JAR\n- Extra Java args\n- Minimum and maximum memory\n\nAs mentioned previously, these values can be overriden with command line flags.\n\n**Example `instance.toml` file**\n\n```toml\ngame_version = '1.21.8'\nmod_loader = 'fabric'\nmod_loader_version = '0.16.14'\n\n[config]\n# Path to a Java executable. If blank, a Mojang-provided JVM will be downloaded.\njava = '/usr/bin/java'\n# Extra arguments to pass to the JVM\njava_args = ''\n# Path to a custom JAR to use instead of the normal Minecraft client\ncustom_jar = ''\n# Minimum game memory, in MB\nmin_memory = 512\n# Maximum game memory, in MB\nmax_memory = 4096\n\n# Game window resolution\n[config.resolution]\nwidth = 1708\nheight = 960\n\n```\n\n### Search\n\nThe `search` command can search for Minecraft or mod loader versions. It defaults to searching for game versions, but can also be used to search for Fabric, Quilt, and Forge versions.\n\n```bash\ncmd-launcher search [\u003cquery\u003e] [--kind {versions, fabric, quilt, forge}]\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelecter%2Fcmd-launcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftelecter%2Fcmd-launcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftelecter%2Fcmd-launcher/lists"}