LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

portablemc

Cross-platform command-line Minecraft launcher

TLDR

Start the latest release
$ portablemc start
copy
Start a specific version
$ portablemc start [1.16.5]
copy
Search available versions
$ portablemc search
copy
Search release channel, limit results
$ portablemc search --channel release -l[10]
copy
Start offline with a username
$ portablemc start -u [MyUsername]
copy
Log in with a Microsoft account
$ portablemc auth login
copy
List authenticated accounts
$ portablemc auth list
copy
Start with an authenticated account
$ portablemc start -u [username] -a
copy

SYNOPSIS

portablemc *command* [*options*] [*args*]

DESCRIPTION

portablemc is a cross-platform command-line utility for installing and launching Minecraft quickly and reliably. It supports official Mojang versions and installs popular mod loaders seamlessly, including Forge, NeoForge, Fabric, Quilt, LegacyFabric, and Babric.It can run offline or with a Microsoft account, browse supported versions, download game files in parallel, locate a compatible system Java runtime (falling back to Mojang-provided runtimes when needed), and apply known launch fixes. Output verbosity and machine-readable modes are available for scripting.Install via release binaries, cargo install portablemc-cli, AUR packages (portablemc / portablemc-bin), or nixpkgs.

PARAMETERS

start [*version*]

Install (if needed) and launch a game version. \-u sets the username; \-a uses an authenticated account. See portablemc start --help for JVM, directory, and loader options.
search
List or search supported versions. --channel filters (for example release); -l limits result count.
auth login
Authenticate a Microsoft account for online play.
auth list
List stored authenticated accounts.
Use portablemc --help and subcommand --help for the full flag set of your installed version.

INSTALL

nix profile install nixpkgs#portablemc
copy

CAVEATS

Online play requires a valid Microsoft account flow. Some unsupported architectures may need extra flags. Mod loader installs depend on upstream loader availability. Network access is required for first-time downloads.

SEE ALSO

java(1), minecraft(1)

RESOURCES

Copied to clipboard
Kai