Ornithe Installer: Difference between revisions

From Ornithe Wiki
Jump to navigation Jump to search
m fix typo
m Fix help formatting
 
(2 intermediate revisions by 2 users not shown)
Line 10: Line 10:
* an extensive CLI
* an extensive CLI


=== Gui ===
=== GUI ===
[[File:Screenshot 20250421 191013.png|alt=Screenshot of the installer GUI, with the "Client" page selected. All options are at their default values. No Minecraft version is selected, the loader is set to "Fabric Loader" with version 0.16.4. The install location is "~/.minecraft", and "Generate Profile" is checked.|thumb|Installer GUI on the "Client" page]]
[[File:Screenshot 20250421 191013.png|alt=Screenshot of the installer GUI, with the "Client" page selected. All options are at their default values. No Minecraft version is selected, the loader is set to "Fabric Loader" with version 0.16.4. The install location is "~/.minecraft", and "Generate Profile" is checked.|thumb|Installer GUI on the "Client" page]]
The GUI is a convenient way to quickly install ornithe on a desktop computer.
The GUI is a convenient way to quickly install ornithe on a desktop computer.
Line 36: Line 36:
           Server installation
           Server installation
   game-versions, --list-game-versions
   game-versions, --list-game-versions
           List supported game versions
           List supported game versions. Arguments: [--show-snapshots, --show-historical]
   loader-versions, --list-loader-versions
   loader-versions, --list-loader-versions
           List available loader versions
           List available loader versions. Arguments: [--show-betas, --loader-type]
  intermediary-generations, --intermediary-generations
          List the latest & stable intermediary (Calamus) generations
   help
   help
           Print this message or the help of the given subcommand(s)
           Print this message or the help of the given subcommand(s)
Line 50: Line 52:
   
   
  Options:
  Options:
-d, --dir <DIR>                    Installation directory [default: ~/.minecraft]
  -d, --dir <DIR>                    Installation directory [default: ~/.minecraft]
   -p, --generate-profile <VALUE>    Whether to generate a launch profile [default: true] [possible values: true, false]
   -p, --generate-profile <VALUE>    Whether to generate a launch profile [default: true] [possible values: true, false]
      --gen <GENERATION>            The Intermediary Generation (Calamus)
   -m, --minecraft-version <VERSION>  Minecraft version to use
   -m, --minecraft-version <VERSION>  Minecraft version to use
       --loader-type <TYPE>          Loader type to use [default: fabric] [possible values: fabric, quilt]
       --loader-type <TYPE>          Loader type to use [default: fabric] [possible values: fabric, quilt]
Line 65: Line 68:
   -z, --generate-zip <VALUE>        Whether to generate an instance zip instead of installing into the directory [default: true] [possible values: true, false]
   -z, --generate-zip <VALUE>        Whether to generate an instance zip instead of installing into the directory [default: true] [possible values: true, false]
   -c, --copy-profile-path <VALUE>    Whether to copy the path of the generated profile to the clipboard [default: false] [possible values: true, false]
   -c, --copy-profile-path <VALUE>    Whether to copy the path of the generated profile to the clipboard [default: false] [possible values: true, false]
      --gen <GENERATION>            The Intermediary Generation (Calamus)
   -m, --minecraft-version <VERSION>  Minecraft version to use
   -m, --minecraft-version <VERSION>  Minecraft version to use
       --loader-type <TYPE>          Loader type to use [default: fabric] [possible values: fabric, quilt]
       --loader-type <TYPE>          Loader type to use [default: fabric] [possible values: fabric, quilt]
Line 81: Line 85:
   -d, --dir <DIR>                    Installation directory [default: ./server]
   -d, --dir <DIR>                    Installation directory [default: ./server]
       --download-minecraft          Whether to download the minecraft server jar
       --download-minecraft          Whether to download the minecraft server jar
      --gen <GENERATION>            The Intermediary Generation (Calamus)
   -m, --minecraft-version <VERSION>  Minecraft version to use
   -m, --minecraft-version <VERSION>  Minecraft version to use
       --loader-type <TYPE>          Loader type to use [default: fabric] [possible values: fabric, quilt]
       --loader-type <TYPE>          Loader type to use [default: fabric] [possible values: fabric, quilt]

Latest revision as of 21:34, 29 January 2026

The Ornithe Installer serves a few purposes:

  • Installing a profile into the vanilla (official) launcher
  • Generating an instance for MultiMC or MultiMC-based launchers
  • Installing (& optionally starting) a server

For this, two different UIs are offered:

  • an egui-based GUI
  • an extensive CLI

GUI

Screenshot of the installer GUI, with the "Client" page selected. All options are at their default values. No Minecraft version is selected, the loader is set to "Fabric Loader" with version 0.16.4. The install location is "~/.minecraft", and "Generate Profile" is checked.
Installer GUI on the "Client" page

The GUI is a convenient way to quickly install ornithe on a desktop computer.

All operations are done in a graphical way, the general behavior mimicking the old,

java-based installers of Fabric & Quilt.

Cli

The CLI is an easy-to-use and intuitive interface when a graphical environment is not available.

The CLI features all options present in the GUI and additionally includes the ability to not only install,

but also directly launch a modded server. This allows the installer to serve as a server bootstrap.

Help:

Usage: ornithe-installer-rs [COMMAND]

Commands:
 client, --client
         Client installation for the official launcher
 mmc, --mmc
         Generate an instance for MultiMC/PrismLauncher [aliases: prism]
 server, --server
         Server installation
 game-versions, --list-game-versions
         List supported game versions. Arguments: [--show-snapshots, --show-historical]
 loader-versions, --list-loader-versions
         List available loader versions. Arguments: [--show-betas, --loader-type]
 intermediary-generations, --intermediary-generations
         List the latest & stable intermediary (Calamus) generations
 help
         Print this message or the help of the given subcommand(s)

Options:
 -h, --help     Print help
 -V, --version  Print version

Client subcommand:

Usage: ornithe-installer-rs {client|--client} [OPTIONS] --minecraft-version <VERSION>

Options:
 -d, --dir <DIR>                    Installation directory [default: ~/.minecraft]
 -p, --generate-profile <VALUE>     Whether to generate a launch profile [default: true] [possible values: true, false]
     --gen <GENERATION>             The Intermediary Generation (Calamus)
 -m, --minecraft-version <VERSION>  Minecraft version to use
     --loader-type <TYPE>           Loader type to use [default: fabric] [possible values: fabric, quilt]
     --loader-version <VERSION>     Loader version to use [default: latest]
 -h, --help                         Print help

Mmc subcommand:

Usage: ornithe-installer-rs {mmc|--mmc} [OPTIONS] --minecraft-version <VERSION>

Options:
 -d, --dir <DIR>                    Output directory [default: .]
 -z, --generate-zip <VALUE>         Whether to generate an instance zip instead of installing into the directory [default: true] [possible values: true, false]
 -c, --copy-profile-path <VALUE>    Whether to copy the path of the generated profile to the clipboard [default: false] [possible values: true, false]
     --gen <GENERATION>             The Intermediary Generation (Calamus)
 -m, --minecraft-version <VERSION>  Minecraft version to use
     --loader-type <TYPE>           Loader type to use [default: fabric] [possible values: fabric, quilt]
     --loader-version <VERSION>     Loader version to use [default: latest]
 -h, --help                         Print help

Server subcommand:

Usage: ornithe-installer-rs {server|--server} [OPTIONS] --minecraft-version <VERSION> [COMMAND]

Commands:
 run   Install and run the server
 help  Print this message or the help of the given subcommand(s)

Options:
 -d, --dir <DIR>                    Installation directory [default: ./server]
     --download-minecraft           Whether to download the minecraft server jar
     --gen <GENERATION>             The Intermediary Generation (Calamus)
 -m, --minecraft-version <VERSION>  Minecraft version to use
     --loader-type <TYPE>           Loader type to use [default: fabric] [possible values: fabric, quilt]
     --loader-version <VERSION>     Loader version to use [default: latest]
 -h, --help                         Print help

Run subcommand (only in combination with Server):

Usage: ornithe-installer-rs server --minecraft-version <VERSION> run [OPTIONS]

Options:
     --args <ARGS>  Java arguments to pass to the server (before the server jar)
     --java <PATH>  The java binary to use to run the server
 -h, --help         Print help

Legacy Java installer

Ornithe also still offers a legacy java-based installer. Forked from the Quilt installer, it is extended with ornithe-specific features such as loader type selection and MultiMC instance generation.

The older ornithe installer, on the client tab. All options are set to their default values: Minecraft version 1.14.4, Launcher type official, Loader type fabric, Loader version 0.16.4, Install location ~/.minecraft. The "Generate profile" checkbox is checked.
The older ornithe installer, on the client tab.