🌸 Origami

✨ Lightweight Minecraft CLI Launcher — beautiful, fast, and scriptable.

Origami is a terminal-first Minecraft launcher that supports authentication, installation, and launching of Minecraft versions — with built-in support for Microsoft accounts, mod loaders, profile management, and more. Designed for power users, modders, and anyone who loves minimalism and productivity.

📥 Install Node.js

Before installing Origami, you need Node.js and npm (Node's package manager) installed.

🪟 Windows

1. Download the LTS version of Node.js from the official website.

2. Run the installer and follow the setup instructions.

3. Open Command Prompt and verify installation:

   node -v
   npm -v

🍎 macOS

You can use Homebrew:

brew install node

Or download the LTS installer from nodejs.org.

Verify installation:

node -v
npm -v

🐧 Linux (Ubuntu/Debian)

sudo apt update
sudo apt install nodejs npm

Alternatively, for newer versions:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

Then check versions:

node -v
npm -v

📦 Alternative: Using NVM (Node Version Manager)

NVM allows you to easily switch between Node.js versions:

macOS/Linux:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.nvm/nvm.sh
nvm install --lts

Windows:

Use nvm-windows:

1. Download the latest nvm-setup.exe from the releases page.

2. Install and open Command Prompt:

   nvm install lts
   nvm use lts
   node -v
   npm -v

✅ Make sure you're using Node.js v18 or higher for best compatibility.

🚀 Installation

🔒 Stable (Recommended)

Install the latest stable version from NPM:

npm install -g @origami-minecraft/stable

Once installed, you can use the origami command anywhere in your terminal.

🧪 Development Builds

🚧 Development builds are experimental. These builds may include experimental features and are considered unstable.

You can install them directly from NPM:

Install the latest dev build:

npm install -g @origami-minecraft/devbuilds

🗒️ Changelog

See what's new in stable builds in the Changelog.

⚠️ Dev builds are expermental — use them at your own risk!

⚠️ Check out the latest dev build updates on the GitHub Actions page.

🎮 Features

• 🎨 Beautiful terminal UI with gradient animations and ASCII art
• 🔐 Microsoft & Mojang Authenticator support
• 📂 Profile management (choose/create/remove)
• ⬇️ Install and manage Minecraft versions (vanilla & modded)
• 🛠 Customizable settings and CLI-first configuration
• 💨 Launch Minecraft directly from the terminal

📦 Usage

After installation, just run:

origami menu

🖼️ Preview

Navigate using your keyboard to log in, manage accounts, install versions, or launch the game.

📘 CLI Documentation

See the full CLI documentation here: 📖 CLI.md

📝 License

This project is licensed under the GPL-3.0-only license.

🧪 Development

git clone https://github.com/merasugd/origami-launcher.git
cd origami-launcher
npm install

# testing
npm run compile
npm run origami

💖 Credits

• Inquirer for interactive menus
• Figlet for ASCII banners
• Gradient-string for rainbow text
• MCLC for the back bone of the launcher
• Temurin for JDK base
• Minecraft is copyright Mojang

🌐 Links

• 📁 GitHub: github.com/merasugd/origami-launcher
• 📦 NPM Stable: npmjs.com/package/@origami-minecraft/stable

🙏 Support

Found a bug or want to suggest a feature? Open an issue or submit a PR!

🤝 Contributing

We welcome contributions of all kinds — from bug fixes and documentation to new features.

• 📖 See our CONTRIBUTING.md guide to get started.
• 📜 Please review our Code of Conduct before participating in discussions or contributing.

Enjoy the terminal. Happy crafting :D 🧵