Minecraft-cli

📦 minecraft-cli Documentation

Unofficial 1-Command Minecraft Installer for Linux

🧰 Overview

minecraft-cli is an open-source, unofficial command-line utility designed to make Minecraft installation a breeze on Linux. Whether you're a casual block-breaker or a hardcore modpacker, this tool gets you mining and crafting faster than ever—across any major Linux distribution.

It supports:

• 🟩 Vanilla Minecraft
• 🧵 Fabric Loader
• 🔥 Forge Mod Loader
• 🎮 Launch Profiles
• ⛏️ Modded Instances
• 🐧 Universal Compatibility (Debian, Arch, Fedora, Void, Gentoo—you name it!)

🔗 Project Links

• Repository: github.com/RoyalDecree/minecraft-cli
• License: MIT
• Maintainer: MoNoRi-Chan (The Royal Decree approves this script)

📥 Installation

You only need ONE command to install:

curl -sSL https://yourdomain.com/install-minecraft-cli.sh | bash

This will:

• Install necessary dependencies (e.g., java, curl, jq, unzip)
• Set up config directories in $HOME/.minecraft-cli/
• Make the tool globally available via minecraft-cli

🚀 Usage

🆕 Create a New Minecraft Profile

minecraft-cli create

Follow the prompts to:

• Choose Minecraft version
• Choose loader (vanilla, fabric, forge)
• Name your profile

🧪 Launch Minecraft

minecraft-cli launch <profile>

🧶 Install Fabric Loader

 minecraft-cli install-loader fabric

Optional args:

--version 1.20.1
--profile mymodpack

🔥 Install Forge Loader

minecraft-cli install-loader forge

Same options as Fabric apply.

🔄 Update Game Versions

minecraft-cli update 

Fetches latest release data from Mojang and Modrinth for possible mod updates.

🧾 List All Profiles

minecraft-cli list 

Returns:

📁 Available Profiles:
- vanilla-1.21.1
- forge-1.20.1-modpack
- fabric-test-env

🗑️ Remove Profile

minecraft-cli delete <profile>

🛠️ Config File

Located at ~/.minecraft-cli/config.json

{
 "java_path": "/usr/bin/java",
 "install_dir": "/home/you/.minecraft-cli/instances/",
 "default_ram": "4G"
}

🧙 Compatibility

• ✔️ Arch
• ✔️ Ubuntu/Debian
• ✔️ Fedora
• ✔️ Alpine (with openjdk17)
• ✔️ Steam Deck
• ✔️ WSL2 (with GUI support)
• ✔️ Even your grandmother’s toaster (maybe)

❓ FAQ

Q: Can I use my Mojang or Microsoft account with it?

A: Yes, minecraft-cli supports both offline and Microsoft authentication (via OAuth, optional).

Q: Is this allowed by Mojang?

A: Technically… no. But it doesn’t bypass authentication or distribute the game itself. It just automates what's already possible manually.

Q: Will it replace Prism, GDLauncher, or MultiMC?

A: No. It’s CLI first. GUI users, this might not be your jam.

🧠 Fun Fact

This tool was originally built by a sysadmin who just wanted to spin up a server to test a Redstone contraption during work hours.

📢 Final Words from The Royal Decree

“Why click 100 buttons when you can run one script?” — MoNoRi-Chan, Server Owner of Project Art3mis

Contributions welcome. Bugs expected. Play responsibly.