mirror of
https://github.com/MCCTeam/Minecraft-Console-Client
synced 2026-08-15 13:04:36 +00:00
236 lines
9.5 KiB
Markdown
236 lines
9.5 KiB
Markdown
---
|
|
title: About & Features
|
|
---
|
|
|
|
# Introduction
|
|
|
|
- [Introduction](#introduction)
|
|
- [About](#about)
|
|
- [Features](#features)
|
|
- [Why Minecraft Console Client?](#why-minecraft-console-client)
|
|
- [Quick Intro](#quick-intro)
|
|
- [The list of the tutorials:](#the-list-of-the-tutorials)
|
|
- [Getting Help](#getting-help)
|
|
- [Before getting help](#before-getting-help)
|
|
- [Bugs, Ideas, Feature Requests](#bugs-ideas-feature-requests)
|
|
- [Before submitting](#before-submitting)
|
|
- [AI-Assisted Development](#ai-assisted-development)
|
|
- [Notes on some features](#notes-on-some-features)
|
|
- [Inventory, Terrain and Entity Handling](#inventory-terrain-and-entity-handling)
|
|
- [Path-Finding and Physics](#path-finding-and-physics)
|
|
- [Credits](#credits)
|
|
- [Disclaimer](#disclaimer)
|
|
- [License](#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](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/), now it's maintained by him and many other contributors from the community.
|
|
|
|
## Features
|
|
|
|
- Chat
|
|
|
|
- Send and receive chat messages
|
|
- [Log chat history](chat-bots.md#chat-log)
|
|
- [Get alerted on certain keywords](chat-bots.md#alerts)
|
|
- [Auto Respond](chat-bots.md#auto-respond)
|
|
|
|
- Microsoft account authentication with 2FA support (OAuth 2.0 device code flow)
|
|
|
|
- [Anti AFK](chat-bots.md#anti-afk)
|
|
|
|
- [Auto Relog](chat-bots.md#auto-relog)
|
|
|
|
- [Script Scheduler](chat-bots.md#script-scheduler)
|
|
|
|
- [Remote Control](chat-bots.md#remote-control)
|
|
|
|
- [Auto Respond](chat-bots.md#auto-respond)
|
|
|
|
- [Auto Attack](chat-bots.md#auto-attack)
|
|
|
|
- [Auto Fishing](chat-bots.md#auto-fishing)
|
|
|
|
- [Auto Eat](chat-bots.md#auto-eat)
|
|
|
|
- [Auto Craft](chat-bots.md#auto-craft)
|
|
|
|
- [Mailer Bot](chat-bots.md#mailer)
|
|
|
|
- [Auto Drop](chat-bots.md#auto-drop)
|
|
|
|
- [Replay Mod](chat-bots.md#replay-mod)
|
|
|
|
- [API for creating Bots in C#](creating-bots.md#creating-chat-bots)
|
|
|
|
- [Docker Support](installation.md#using-docker)
|
|
|
|
- [Inventory Handling](usage.md#inventory)
|
|
|
|
- [Book Support](usage.md#book)
|
|
|
|
- [Terrain Traversing](usage.md#move)
|
|
|
|
- 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](https://www.youtube.com/watch?v=BkCqOCa2uQw)
|
|
- [Installation on Windows + Auto AFK and More by Dexter113](https://www.youtube.com/watch?v=FxJ0KFIHDrY)
|
|
|
|
Using Commands, Scripts and other features:
|
|
|
|
- [Minecraft Console Client | Tutorial | Commands, Scripts, AppVars, Matches, Tasks and C# Scripts by Daenges](https://youtu.be/JbDpwwETEnU)
|
|
- [Console Client Tutorial - Scripting by Zixxter](https://www.youtube.com/watch?v=XE7rYBFJxn0)
|
|
|
|
## Getting Help
|
|
|
|
MCC has an active community, and the GitHub Discussions section is the best place to ask for help.
|
|
|
|
Click [here](https://github.com/MCCTeam/Minecraft-Console-Client/discussions) 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](https://github.com/MCCTeam/Minecraft-Console-Client/issues) section of our [GitHub repository](https://github.com/MCCTeam/Minecraft-Console-Client).
|
|
|
|
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](ai-assisted-development.md).
|
|
|
|
## 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](https://github.com/ORelio) in 2012 on the [Minecraft Forum](http://www.minecraftforum.net/topic/1314800-/)._
|
|
|
|
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](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BIdea%5D+is%3Aopen).
|
|
|
|
**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](https://github.com/MCCTeam/Minecraft-Console-Client/issues?q=is%3Aissue+%5BBUG%5D+is%3Aopen+).
|
|
|
|
**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](https://github.com/MCCTeam/Minecraft-Console-Client/graphs/contributors)!_
|
|
|
|
**Libraries:**
|
|
|
|
Minecraft Console Client also borrows code from the following libraries:
|
|
|
|
| Name | Purpose | Author | License |
|
|
| ----------- | ---------------- | ---------------- | ------- |
|
|
| Biko | Proxy handling | Benton Stark | MIT |
|
|
| Heijden.Dns | DNS SRV Lookup | Geoffrey Huntley | MIT |
|
|
| DotNetZip | Zlib compression | Dino Chiesa | MS-PL |
|
|
|
|
## 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](https://github.com/MCCTeam/Minecraft-Console-Client)
|
|
|
|
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](http://qstuff.blogspot.fr/2007/04/why-cddl.html)
|
|
|
|
Full license at [http://opensource.org/licenses/CDDL-1.0](http://opensource.org/licenses/CDDL-1.0)
|