Introduction

• Introduction
  • About
  • Features
  • Why Minecraft Console Client?
  • Quick Intro
    • The list of the tutorials:
  • Getting Help
    • Before getting help
  • Bugs, Ideas, Feature Requests
    • Before submitting
  • AI-Assisted Development
  • Notes on some features
    • Inventory, Terrain and Entity Handling
    • Path-Finding and Physics
  • Credits
  • Disclaimer
  • License

About

Minecraft Console Client (MCC) is a lightweight, cross-platform, open-source Minecraft TUI client for Java Edition. It lets you connect to Minecraft Java servers, send commands, and receive text messages without launching the main game.

It also includes built-in automation for administration and utility work, plus an extensible C# API for creating bots and runtime scripts.

It was originally made by ORelio in 2012 on the Minecraft Forum, now it's maintained by him and many other contributors from the community.

Features

• Chat

  • Send and receive chat messages
  • Log chat history
  • Get alerted on certain keywords
  • Auto Respond

• Microsoft account authentication with 2FA support (OAuth 2.0 device code flow)

• Anti AFK

• Auto Relog

• Script Scheduler

• Remote Control

• Auto Respond

• Auto Attack

• Auto Fishing

• Auto Eat

• Auto Craft

• Mailer Bot

• Auto Drop

• Replay Mod

• API for creating Bots in C#

• Docker Support

• Inventory Handling

• Terrain Traversing

• Entity Handling

Note: Some of these features are disabled by default. You need to enable them in the configuration file, and some also require additional setup.

Why Minecraft Console Client?

• Easy to use
• Helpful community
• Open-Source
• Fast performance
• Easy Scripting/Automation
• Cross-Platform
• Docker Support
• 10 years of continuous development
• Active contributors
• Widely used

Quick Intro

If you do not want to read through the documentation right away, the community has made a few short introduction videos for Minecraft Console Client.

The list of the tutorials:

Installation:

• Installation on Windows by Daenges
• Installation on Windows + Auto AFK and More by Dexter113

Using Commands, Scripts and other features:

• Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges
• Console Client Tutorial - Scripting by Zixxter

Getting Help

MCC has an active community, and the GitHub Discussions section is the best place to ask for help.

Click here to access it.

Before getting help

• Please use the search option here or in the discussion section and read the documentation so we avoid duplicate questions. Thank you!
• Please be kind and patient, respect others as they're the ones using their time to help you

Bugs, Ideas, Feature Requests

Bug reports, ideas, and feature requests all go through the Issues section of our GitHub repository.

Before opening a new issue, search both the documentation and the Issues section to avoid duplicates.

If you do not find anything similar, click New issue and choose the appropriate template.

If you are reporting a bug, be as specific as possible. Explain how to reproduce it, attach screenshots and logs, and make sure debug logging is enabled before collecting them.

Before submitting

• Please use the search option here or in the Issues section and read the documentation so we avoid duplicate questions/ideas/reports. Thank you!
• Please be kind, patient and respect others. Thank you!

AI-Assisted Development

If you want the repeatable agent workflow used by maintainers, start with AI-Assisted Development.

Notes on some features

Inventory, Terrain and Entity Handling

MCC currently supports Minecraft versions 1.4.6 through 26.1.

Feature support still depends on protocol version:

• Inventory handling is supported on 1.8+.
• Terrain handling is supported on 1.7.2+.
• Entity handling is supported on 1.8+.

These features may lag behind brand-new Minecraft releases when Mojang changes the protocol or registries in a major way.

If there was a major game update, and the MCC hasn't been updated to support these features, if you're a programmer, feel free to contribute to the project.

Path-Finding and Physics

MCC now uses A* path-finding together with a physics-based movement system for movement and collision handling.

What is supported and works:

• Terrain navigation with A* path-finding and physics-driven movement
• Collision-aware movement using real block shapes
• Automatic jumping when the path requires moving up
• Step-up movement for slabs and similar low obstacles
• Sneaking and sprinting
• Movement physics in water and lava
• Climbing up and down ladders and all types of vines
• Gravity, friction, and block speed modifiers such as ice, soul sand, soul soil, and honey blocks

Current limitations:

• Path-finding is still block-based, so very complex terrain can still fail
• Automatic route planning still avoids underwater routes by default, so this is not a full swimming path-finder yet
• Knockback and other external velocity effects are not simulated yet

Credits

Project initiated by ORelio in 2012 on the Minecraft Forum.

Many features would not have been possible without the help of our talented community:

Maintainers

ORelio, ReinforceZwei, milutinke, BruceChenQAQ, bradbyte

Ideas

ambysdotnet, Awpocalypse, azoundria, bearbear12345, bSun0000, Cat7373, dagonzaros, Dids, Elvang, fuckofftwice, GeorgH93, initsuj, JamieSinn, joshbean39, LehmusFIN, maski, medxo, mobdon, MousePak, TNT-UP, TorchRJ, yayes2, Yoann166, ZizzyDizzyMC and many more.

Bug Hunters

1092CQ, ambysdotnet, bearbear12345, c0dei, Cat7373, Chtholly, Darkaegis, dbear20, DigitalSniperz, doranchak, drXor, FantomHD, gerik43, ibspa, iTzMrpitBull, JamieSinn, k3ldon, KenXeiko, link3321, lyze237, mattman00000, Nicconyancat, Pokechu22, ridgewell, Ryan6578, Solethia, TNT-UP, TorchRJ, TRTrident, WeedIsGood, xp9kus, Yoann166 and many more.

Contributors

Allyoutoo, Aragas, Bancey, bearbear12345, corbanmailloux, Daenges, dbear20, dogwatch, initsuj, JamieSinn, justcool393, lokulin, maxpowa, medxo, milutinke, Pokechu22, ReinforceZwei, repository, TheMeq, TheSnoozer, vkorn, v1RuX, yunusemregul, ZizzyDizzyMC, BruceChenQAQ, bradbyte ... And all the GitHub contributors!

Libraries:

Minecraft Console Client also borrows code from the following libraries:

Disclaimer

Even if everything should work, we are not responsible for any damage this app could cause to your computer or your server.

This app does not steal your password. If you don't trust it, don't use it or check & compile from the source code.

Also, remember that when you connect to a server with this program, you will appear where you left the last time.

This means that you can die if you log in in an unsafe place on a survival server!

Use the script scheduler bot to send a teleport command after logging in.

We remind you that you may get banned by your server for using this program. Use accordingly with server rules.

License

Minecraft Console Client is a totally free of charge, open source project.

The source code is available at the GitHub repository

Unless specifically stated, source code is from the MCC Team or Contributors, and available under CDDL-1.0.

More info about CDDL-1.0: http://qstuff.blogspot.fr/2007/04/why-cddl.html

Full license at http://opensource.org/licenses/CDDL-1.0