Sync every 2 weeks. A mirror of original repository.
Find a file
BruceChen 399c8cdc79 fix: remove spurious jump on vines in WalkTemplate and add pitch tracking
- WalkTemplate: remove OnClimbable jump/sprint logic that caused the
  player to jump when walking past vine blocks during flat traversal
- TemplateHelper: add CalculatePitch() for computing the look angle
  toward a 3D target relative to eye height
- All templates (Walk, Ascend, Descend, Climb, SprintJump): set
  physics.Pitch each tick so the player visually looks toward the
  current path target direction
- McClient: sync playerPitch and set _yaw/_pitch after pathfinding
  ticks so rotation is included in position update packets sent to
  the server

Made-with: Cursor
2026-04-12 18:43:32 +00:00
.claude Centralized skills to .skills folder. 2026-03-21 14:44:47 +01:00
.codex Add MCC wrappers and guards for build and publish 2026-04-12 18:37:03 +00:00
.cursor Centralized skills to .skills folder. 2026-03-21 14:44:47 +01:00
.github fix: update build command in GitHub Actions workflow 2026-04-06 20:36:12 +08:00
.idea [SKIP_BUILD] Fix document build failure 2022-11-28 14:10:55 +08:00
.skills Add MCC wrappers and guards for build and publish 2026-04-12 18:37:03 +00:00
config fix: correct PathNode.Pack bit overlap causing hash collisions 2026-04-12 18:43:32 +00:00
ConsoleInteractive@ff6d2129e9 chore: update subproject commit reference for ConsoleInteractive 2026-04-08 02:50:39 +08:00
DebugTools chore: remove remaining CursorBot references 2026-04-12 23:43:54 +08:00
Docker [skip ci] Update docker image to use updated releases 2024-08-14 18:22:05 +08:00
docs Add MCC wrappers and guards for build and publish 2026-04-12 18:37:03 +00:00
MinecraftClient fix: remove spurious jump on vines in WalkTemplate and add pitch tracking 2026-04-12 18:43:32 +00:00
MinecraftClientGUI Added changes from 2927 2026-03-22 12:45:52 +01:00
tools Add MCC wrappers and guards for build and publish 2026-04-12 18:37:03 +00:00
.cursorindexingignore feat: add cursor indexing ignore rules for SpecStory files 2026-03-22 15:30:42 +08:00
.gitattributes [skip ci] Set repository line endings to LF 2023-09-15 14:43:24 +08:00
.gitignore fix: correct PathNode.Pack bit overlap causing hash collisions 2026-04-12 18:43:32 +00:00
.gitmodules [SKIP_BUILD] Fix document build failure 2022-11-28 14:10:55 +08:00
1.21.4 fix: correct PathNode.Pack bit overlap causing hash collisions 2026-04-12 18:43:32 +00:00
1.21.11 fix: correct PathNode.Pack bit overlap causing hash collisions 2026-04-12 18:43:32 +00:00
AGENTS.md Add MCC wrappers and guards for build and publish 2026-04-12 18:37:03 +00:00
CLAUDE.md Added AGENTS.md/CLAUDE.md and a C# 12 best practices skill for MCC. 2026-03-21 19:12:13 +01:00
crowdin.yml chore: add websocket guide translations to Crowdin configuration 2026-04-08 22:29:42 +08:00
Directory.Build.props Add worktree-isolated tmpfs build outputs 2026-04-12 20:07:15 +08:00
LICENSE.md Add LICENSE.md 2023-04-10 18:47:52 +02:00
MinecraftClient.sln Implemented a first version of an MCP server as a Chat Bot 2026-03-28 02:08:47 +01:00
MinecraftClientGUI.sln Added Minecraft Client GUI v1.0 to the repository 2013-08-21 14:31:57 +02:00
README.md fix: update Crowdin project URL in documentation and settings 2026-04-06 19:57:45 +08:00

Logo

Minecraft Console Client (MCC)

Documentation | Download | Installation | Configuration | Usage

GitHub Actions build status 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.

Alt

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.

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