Skip to main content

ephervex launch

Install and launch a client instance, streaming its log to the terminal

Usage and options​

Install and launch a client instance, streaming its log to the terminal.

Exits with a non-zero status when the game exits with an error or from a signal, unless the launch was ended with Ctrl-C, a terminal hangup, a termination signal, or output that is no longer being read. A dry run exits with 0.

Usage: ephervex launch [OPTIONS] <ID>

Arguments:
  <ID>
          The client instance to launch

Options:
      --json
          Emit machine-readable JSON where the command supports it

      --server <SERVER>
          Start or reuse this linked server and connect the client to it. A server this command starts is stopped when the command ends

      --java-path <JAVA_PATH>
          Use this Java runtime instead of the selected one

      --install-java
          Download a managed runtime if nothing installed is compatible

      --alongside <HANDLE>
          Run alongside a launch this instance already has.

          A second client, under a second account, sharing the instance's game directory: its saves, its options and its logs. Fine when both clients join a server. Two clients opening the same singleplayer world is decided by Minecraft's own world lock, not by Ephervex.

      --account <ACCOUNT>
          Play as this account instead of the default one.

          Takes an account id or name, as `ephervex account list` shows them. This applies to one launch and does not change which account is the default.

      --demo
          Start Minecraft in demo mode

      --resolution <WIDTHxHEIGHT>
          Open the game window at this size, as `WIDTHxHEIGHT`

      --dry-run
          Prepare everything and print the command without starting Minecraft.

          Everything is still installed, because a command whose classpath names files that were never downloaded describes a launch that could not run.

      --detach
          Run Minecraft in the background and return once it is running.

          A background process supervises the game, so it keeps running after this command, its terminal, and any Ephervex window have ended. `ephervex running` lists it, and `ephervex instance stop` ends it. With --server, a server this command starts is left running as well.

  -h, --help
          Print help (see a summary with '-h')