MCCTeam/Minecraft-Console-Client

README

Minecraft Console Client (MCC)

Documentation | Download | Installation | Configuration | Usage

Important

📢 Major News

After 13 years of active development, we are rewriting MCC from the ground up to make development faster and enable powerful new features. The rewrite is currently being led by @milutinke. Along the refactoring, the client is being polished, the UX and UI are being improved, new features are being added and existing ones improved. ✨

Update (10.10.2026) The early access build (No. 12) for the 2.0 client is available for download: here

Please leave feedback on Discord.

After the release of the Minecraft Console Client 2.0, the old client will remain available to use but will no longer be updated. The new client is expected for public testing in the coming weeks. 🚀

Follow progress in #🚀refactor-updates on our Discord server!

About ℹ️

Minecraft Console Client (MCC) is a lightweight cross-platform open-source Minecraft TUI client for Java edition that allows you to connect to any Minecraft Java server, send commands and receive text messages in a fast and easy way without having to open the main Minecraft game.

Download

Get the latest release from the Releases section.

Quick Install ⚡

Open a terminal in the folder where you want MCC and run:

Linux / macOS:

curl -fsSL https://mccteam.github.io/install.sh | sh

Windows (PowerShell):

iwr -useb https://mccteam.github.io/install.ps1 | iex

The script detects your architecture and downloads the right binary. For more options (including wget and manual downloads), see the installation guide.

How to use 📚

Getting Help 🙋

Check out the Website, README and existing Discussions: Maybe your question is answered there. If not, please open a New Discussion and ask your question. If you find a bug, please report it in the Issues section.

Discord

We now have a Discord server, click here to join.

Helping Us ❤️

We are a small community so we need help to implement upgrades for new Minecraft versions, fixing bugs and expanding the project. We are always looking for motivated people to contribute. If you feel like it could be you, please have a look at the issues section :)

How to contribute 📝

If you'd like to contribute to Minecraft Console Client, great, just fork the repository and submit a pull request on the Master branch. To contribute to the website / online documentation see also the Website repository.

Translating Minecraft Console Client 🌍

To improve translations for MCC, please visit: Crowdin - Minecraft Console Client.

Building from the source 🏗️

This section has been moved to our new Documentation website.

Community projects 🧩

Tools built by the community around MCC. They are not maintained by the MCC Team, report issues in their own trackers.

MCC GUI V2 > Windows 11 desktop app that runs many accounts at once: one MCC process per connection, a tab with a live colored log for each account, and chat or commands sent to one account or to all of them. It does not bundle or modify MCC, it starts the MinecraftClient.exe you point it at, and it works with MCC 1.x. Free and open source (MIT).

License ⚖️

Unless specifically stated, the code is from the MCC Team or Contributors, and available under CDDL-1.0. Else, the license and original author are mentioned in source file headers. The main terms of the CDDL-1.0 license are basically the following:

You may use the licensed code in whole or in part in any program you desire, regardless of the license of the program as a whole (or rather, as excluding the code you are borrowing). The program itself may be open or closed source, free or commercial.
However, in all cases, any modifications, improvements, or additions to the CDDL code (any code that is referenced in direct modifications to the CDDL code is considered an addition to the CDDL code, and so is bound by this requirement; e.g. a modification of a math function to use a fast lookup table makes that table itself an addition to the CDDL code, regardless of whether it's in a source code file of its own) must be made publicly and freely available in source, under the CDDL license itself.
In any program (source or binary) that uses CDDL code, recognition must be given to the source (either project or author) of the CDDL code. As well, modifications to the CDDL code (which must be distributed as source) may not remove notices indicating the ancestry of the code.

More info at http://qstuff.blogspot.fr/2007/04/why-cddl.html Full license at http://opensource.org/licenses/CDDL-1.0

Uses technologies from