The OpenVoxel Launcher directly in your terminal! A command-line interface for managing Minecraft accounts, downloading maps, and launching Minecraft with OpenVoxel Studios content.

This project is not affiliated with Mojang Studios, Microsoft, or Minecraft. Minecraft is a trademark of Mojang Studios. All rights to the game and its assets belong to their respective owners.

• 🔐 Secure Authentication: Uses system keychain to store Minecraft access tokens
• 🗺️ Map Management: Download, import, and organize Minecraft maps
• 🔍 Version Detection: Automatically detects recommended Minecraft versions from map data
• 👥 Multiple Accounts: Switch between different Minecraft accounts easily
• 🌐 Cross-Platform: Works on macOS, Windows, and Linux

brew tap OpenVoxelStudios/cli
brew install ovl

cargo install --git https://github.com/OpenVoxelStudios/CLI.git

# This will download and run the OpenVoxel map "Bendy and the Ink Machine"
ovl play batim

# This will open minecraft on 1.21.5
ovl run 1.21.5

Authenticate with your Minecraft account and save credentials securely in your system keychain.

Sign out of the currently selected account and remove stored credentials.

Alias: account

List all configured Minecraft accounts and switch between them.

Alias: who-am-i

Display information about the currently selected account (name, UUID, online/offline status).

Search for and launch an OpenVoxel map by name.

ovl play BATIM
ovl play lethal budget

Alias: list

Browse all available OpenVoxel maps in an interactive menu and select one to play.

Alias: import

Import and launch a map from various sources:

• Local folder: ovl open /path/to/map/folder
• ZIP file: ovl open /path/to/map.zip
• HTTPS URL: ovl open https://example.com/map.zip
• Existing save: ovl open "My World"

It will auto-detect the Minecraft version and ask for confirmation before launch.

Launch a specific Minecraft version directly, optionally connecting to a server.

ovl run 1.21.5
ovl run 1.20.1 mc.hypixel.net

This code is available under the MIT License

Uses the Open Launcher code available under the MIT License

For issues and feature requests, visit: https://github.com/OpenVoxelStudios/CLI/issues

Or join our Discord: https://discord.gg/cRFHWgnWjE