### Develop Documentation Locally

Source: https://github.com/mccteam/minecraft-console-client/blob/master/AGENTS.md

Install dependencies and start a local development server for the documentation site.

```bash
cd docs && npm install && npm run docs:dev
```

--------------------------------

### Verify Environment Setup

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Run these commands to check if essential tools like Git, .NET, Java, Python, and tmux are installed and accessible. Then, verify that the MCC helper functions are loaded correctly.

```bash
git --version
dotnet --version
java -version
python3 --version
tmux -V
```

```bash
type mc-start
type mcc-build
type mcc-debug
```

--------------------------------

### Example: Show Player Inventory

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

A direct example of how to display the player's own inventory.

```bash
/inventory player
```

--------------------------------

### Install .NET SDK 10

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Commands to install the required .NET 10 SDK.

```bash
sudo apt-get update && sudo apt-get install -y dotnet-sdk-10.0
```

```bash
wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update && sudo apt-get install -y dotnet-sdk-10.0
```

```bash
wget https://packages.microsoft.com/config/debian/13/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
sudo apt-get update && sudo apt-get install -y dotnet-sdk-10.0
```

```bash
sudo pacman -S dotnet-sdk
```

```bash
brew install --cask dotnet-sdk
```

```bash
dotnet --version
```

--------------------------------

### Install .NET SDK on Ubuntu

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Installs the .NET 10 SDK on Ubuntu using the apt package manager.

```bash
sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0
```

--------------------------------

### Install Ubuntu using proot-distro

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Install the latest Ubuntu LTS release using proot-distro in Termux.

```bash
pd install ubuntu:26.04
```

--------------------------------

### Full Script Scheduler Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

A comprehensive example demonstrating multiple tasks with different triggers and actions. Ensure proper indentation for readability.

```toml
[ChatBot.ScriptScheduler]
Enabled = true

    [[ChatBot.ScriptScheduler.TaskList]]
    Task_Name = "Task Name 1"
    Trigger_On_First_Login = false
    Trigger_On_Login = false
    Trigger_On_Times = { Enable = true, Times = [ 14:00:00, ] }
    Trigger_On_Interval = { Enable = true, MinTime = 3.6, MaxTime = 4.8 }
    Action = "send /hello"

    [[ChatBot.ScriptScheduler.TaskList]]
    Task_Name = "Task Name 2"
    Trigger_On_First_Login = false
    Trigger_On_Login = true
    Trigger_On_Times = { Enable = false, Times = [ ] }
    Trigger_On_Interval = { Enable = false, MinTime = 1.0, MaxTime = 10.0 }
    Action = "send /login pass"
```

--------------------------------

### Full Metadata Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/creating-bots.md

A complete example of the script metadata section including custom namespaces and DLLs.

```csharp
//MCCScript 1.0

//using System.Collections.Immutable
//dll MyDll.dll

MCC.LoadBot(new ExampleChatBot());

//MCCScript Extensions
```

--------------------------------

### Install Git

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Commands to install Git on various operating systems.

```bash
sudo apt update
sudo apt install git
```

```bash
sudo pacman -S git
```

```bash
brew install git
```

```bash
git --version
```

--------------------------------

### Verify .NET SDK Installation

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Checks the installed .NET SDK version and information. This command confirms that the SDK was installed correctly.

```bash
dotnet --info
```

```bash
dotnet
```

--------------------------------

### Install Java 21

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Commands to install Java 21 for the local server harness.

```bash
sudo apt update
sudo apt install openjdk-21-jdk
```

```bash
sudo pacman -S jdk21-openjdk
```

```bash
brew install openjdk@21
sudo ln -sfn "$(brew --prefix openjdk@21)/libexec/openjdk.jdk" /Library/Java/JavaVirtualMachines/openjdk-21.jdk
```

```bash
java -version
```

--------------------------------

### Install Nano Text Editor

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Installs the Nano text editor on your VPS, which is useful for editing configuration files directly on the server.

```bash
sudo apt install nano -y
```

--------------------------------

### Verify .NET SDK Installation

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Check the installed .NET SDK version and environment details. This is useful for troubleshooting build issues.

```bash
dotnet --info
```

--------------------------------

### Switch to New User

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Log in as the newly created user to perform subsequent setup steps. You will be prompted for the user's password.

```bash
su mcc
```

--------------------------------

### Server Dialog Confirmation Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Example structure of a 'Confirmation' type dialog from the server, showing two possible actions.

```text
Type: Confirmation

Reset your progress?

Actions:
  [1] Yes (close)
  [2] No (close)
```

--------------------------------

### Full Auto-Fishing Movement Configuration Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

An example demonstrating how to configure multiple movement points for the auto-fishing bot, including position and facing angles.

```toml
[[ChatBot.AutoFishing.Movements]]
facing = { yaw = 12.34, pitch = -23.45 }

[[ChatBot.AutoFishing.Movements]]
XYZ = { x = 123.45, y = 64.0, z = -654.32 }
facing = { yaw = -25.14, pitch = 36.25 }
```

--------------------------------

### Install screen utility

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Installs the 'screen' utility on Debian-based systems using apt. The '-y' flag automatically confirms the installation.

```bash
sudo apt install screen -y
```

--------------------------------

### Install tmux

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Commands to install tmux for managing server sessions.

```bash
sudo apt update
sudo apt install tmux
```

```bash
sudo pacman -S tmux
```

```bash
brew install tmux
```

```bash
tmux -V
```

--------------------------------

### Install .NET SDK and Dependencies in Ubuntu

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Update Ubuntu package lists and install the .NET SDK (version 10.0) along with wget, curl, and nano.

```bash
apt update && apt upgrade -y && apt install -y dotnet-sdk-10.0 wget curl nano
```

--------------------------------

### Download Files using wget

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Example of using the wget command to download files from a given URL.

```bash
wget your_link_here
```

--------------------------------

### Login to Ubuntu in Termux

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Start an Ubuntu session within Termux after installation. This command must be run each time Termux is opened after being closed.

```bash
pd login ubuntu
```

--------------------------------

### Server Dialog Notice Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Example structure of a 'Notice' type dialog from the server, including title, body, and actions.

```text
Type: Notice

Welcome to the server!

Body: Read the rules before playing.

Actions:
  [1] OK (close)
```

--------------------------------

### TOML Configuration File Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/configuration.md

Illustrates the structure and syntax of a TOML configuration file, including sections, key-value pairs, comments, arrays, and nested tables.

```toml
[SectionNameHere]
Setting_Name = "this is some name"
Setting_Something = 15

[OtherSection]
# This is a comment explaining what this setting/option does
Other_Setting = true  # This also is a comment

[ThirdSection]
Section_Enabled = true
colors = [ "red", "yellow", "green" ]

[ThirdSection.Subsection]
Coordinate = { x = 145, y = 64, z = 2045 }

```

--------------------------------

### Example: Show Inventory by ID

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Demonstrates previewing items in an inventory using its numerical ID.

```bash
/inventory 3
```

--------------------------------

### Install MCC on Linux/macOS with wget

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

An alternative to curl for installing MCC on Linux or macOS. This command achieves the same result by downloading and executing the installation script.

```bash
wget -qO- https://mccteam.github.io/install.sh | sh
```

--------------------------------

### Install Python 3

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Commands to install Python 3 for RCON and version-adaptation tools.

```bash
sudo apt update
sudo apt install python3
```

```bash
sudo pacman -S python
```

```bash
brew install python@3.14
```

```bash
python3 --version
```

--------------------------------

### Example: Give Item in Creative Mode

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

An example of giving 64 diamond blocks to a player's inventory slot 36 in creative mode.

```bash
/inventory creativegive 36 diamondblock 64
```

--------------------------------

### Install .NET 10 SDK on Ubuntu

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Installs the .NET 10 SDK using Ubuntu's package manager. This command assumes you are using Ubuntu 24.04 LTS or a compatible version.

```bash
sudo apt-get update -y && sudo apt-get install -y dotnet-sdk-10.0
```

--------------------------------

### Example: Click Item in Player Inventory

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Shows how to click an item in a specific slot of the player's inventory.

```bash
/inventory player click 36
```

--------------------------------

### Install proot-distro in Termux

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Install the proot-distro utility in Termux, which is used for managing Linux distributions.

```bash
pkg install proot-distro -y
```

--------------------------------

### Dialog Command Examples

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Demonstrates practical usage of dialog commands for common interactions like showing dialogs, clicking buttons by index or label, setting input fields, and closing dialogs.

```bash
/dialog show
/dialog click 1
/dialog click-label Teleport
/dialog set name MyPlayer
/dialog dismiss
```

--------------------------------

### Install .NET 10 SDK on Windows

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

This command uses the Windows Package Manager (winget) to install the .NET 10 SDK. Ensure winget is available on your system.

```powershell
winget install Microsoft.DotNet.SDK.10
```

--------------------------------

### Start Docker Compose Interactively

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Start the Minecraft Console Client container using docker-compose. This command is used when MinecraftClient.ini is configured.

```bash
docker-compose up
```

--------------------------------

### Start Shared Server and MCC Session (Worktree A)

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

In the first worktree, start the Minecraft server for a specific version and then launch MCC in debug mode with file input enabled. This sets up the harness for AI interaction.

```bash
cd ~/Minecraft/Minecraft-Console-Client
source tools/mcc-env.sh
mc-start 1.21.11
mcc-debug -v 1.21.11 --file-input
```

--------------------------------

### Install WSL2 on Windows

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Commands to enable and configure WSL2 for development on Windows.

```powershell
wsl --install
```

```powershell
wsl --install -d Ubuntu
```

```powershell
wsl --install --web-download -d Ubuntu
```

--------------------------------

### Example: Delete Item in Creative Mode

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Example of deleting an item from slot 36 in a player's inventory while in creative mode.

```bash
/inventory creativedelete 36
```

--------------------------------

### Example: Search for Slime Blocks

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Searches for 10 Slime Blocks across all available inventories.

```bash
/inventory s SlimeBlock 10
```

--------------------------------

### Load Settings from a File

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Use a custom INI file to load client settings. This is useful for managing multiple configurations or complex setups.

```bash
MinecraftClient.exe <settings-file.ini> [--other settings]
```

--------------------------------

### Example: Show Console Chat

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Turns chat messages back on in the console.

```bash
/console-chat on
```

--------------------------------

### Install MCC on Windows with PowerShell

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Run this command in PowerShell to install MCC on Windows. The script downloads the appropriate executable for your system architecture.

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

--------------------------------

### BasicIO console output example

Source: https://github.com/mccteam/minecraft-console-client/wiki/Command-arguments

Visual representation of how BasicIO mode handles interleaved console output and user input.

```text
<testbot> foo
>i am inputt

(some other player msg)

<testbot> foo
>i am inputt<player2> bar
ing
```

--------------------------------

### Start Local Server and Resolve MCC Identity

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Source environment variables, define a session name, resolve the username, and start the Minecraft server. Ensure you have the necessary tools and environment set up.

```bash
source tools/mcc-env.sh
SESSION="smoke-a"
USERNAME="$(_mcc_resolve_username "$SESSION")"
mc-start 1.20.6
```

--------------------------------

### Proxy Server Configuration Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/configuration.md

Specifies the IP address and port of the proxy server. Ensure the proxy server allows HTTPS for login and non-443 ports for gameplay.

```configuration
Server = { Host = "<ip>", Port = <port> }
```

--------------------------------

### Example: Drop All Items from Slot

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Demonstrates dropping all items contained within a specific player inventory slot.

```bash
/inventory player drop 37 all
```

--------------------------------

### Install Minecraft Console Client via Terminal

Source: https://github.com/mccteam/minecraft-console-client/blob/master/README.md

Use these commands to automatically detect your system architecture and download the appropriate binary for your platform.

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

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

--------------------------------

### Navigate to MCC Directory

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Navigate into the directory where Minecraft Console Client was installed.

```bash
cd MinecraftConsoleClient
```

--------------------------------

### Start MCC Session (Worktree B)

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

In a second worktree, source the MCC environment and launch MCC in debug mode. This allows multiple worktrees to join the same shared server without conflicts, using distinct sessions.

```bash
cd ~/Minecraft/Minecraft-Console-Client-foo
source tools/mcc-env.sh
mcc-debug -v 1.21.11 --file-input
```

--------------------------------

### Example: Right-Click Item in Specific Inventory

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Demonstrates performing a right-click action on an item in a specific slot of an inventory identified by its ID.

```bash
/inventory 2 click 4 right
```

--------------------------------

### Crafting Table Recipe Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

Define a recipe for crafting Stone Bricks using a crafting table. The 'CraftingTable' setting must be configured. Use 'Null' for empty slots.

```toml
# Stone Bricks using a crafting table
[[ChatBot.AutoCraft.Recipes]]
Name = "Recipe-Name-2"
Type = "table"
Result = "StoneBricks"
Slots = [ "Stone", "Stone", "Null", "Stone", "Stone", "Null", "Null", "Null", "Null" ]
```

--------------------------------

### Example: Drop Single Item

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Shows how to drop exactly one item from a player's inventory slot.

```bash
/inventory player drop 36 1
```

--------------------------------

### Player Crafting Recipe Example

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

Define a recipe for crafting Stone Bricks using only the player's inventory. Ensure the 'Stone' material is available in the inventory.

```toml
# Stone Bricks using the player inventory
[[ChatBot.AutoCraft.Recipes]]
Name = "Recipe-Name-1"
Type = "player"
Result = "StoneBricks"
Slots = [ "Stone", "Stone", "Stone", "Stone" ]
```

--------------------------------

### Get Entity Type Mappings Command

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/websocket/README.md

Example response for the `GetEntityTypeMappings` command, showing a mapping of entity names to their numeric IDs.

```json
{ "Player": 128, "Zombie": 119, ... }
```

--------------------------------

### Get Item Type Mappings Command

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/websocket/README.md

Example response for the `GetItemTypeMappings` command, showing a mapping of item names to their numeric IDs.

```json
{ "DiamondSword": 798, "Stone": 1, ... }
```

--------------------------------

### Build Documentation for Deployment

Source: https://github.com/mccteam/minecraft-console-client/blob/master/AGENTS.md

Generate a static build of the documentation site.

```bash
npm run docs:build
```

--------------------------------

### Start and Debug MCC Locally

Source: https://github.com/mccteam/minecraft-console-client/blob/master/tools/README.md

Source the environment script and use mcc-start and mcc-debug for local debugging. mcc-cmd is used to send commands to a running MCC session.

```bash
source tools/mcc-env.sh
mc-start 1.21.11
mcc-debug -v 1.21.11 --file-input
mcc-cmd "debug state"
```

--------------------------------

### Run Docker Compose

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Start the Minecraft Console Client container using docker-compose. This command runs the container in interactive mode, suitable for direct interaction.

```bash
docker-compose run MCC
```

--------------------------------

### Example: Close Specific Inventory

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Example of closing an inventory using its numerical ID.

```bash
/inventory 2 close
```

--------------------------------

### Apply Settings via Command Line

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Configure the client by specifying settings directly on the command line. This can include general settings or section-specific configurations.

```bash
MinecraftClient.exe --setting=value [--other settings]
MinecraftClient.exe --section.setting=value [--other settings]
```

--------------------------------

### Show Help Commands

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Displays help information for available commands. Note that for server-specific help, use "/send /help".

```bash
help
```

--------------------------------

### Create New User Account

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Execute this command to create a new user account on your VPS. The `-m` flag ensures the user's home directory is created.

```bash
sudo useradd mcc -m
```

--------------------------------

### Basic Command Structure

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Illustrates the general structure for running the Minecraft Console Client with various parameter types, including settings and files.

```bash
MinecraftClient.exe --setting=value [--other settings]
MinecraftClient.exe --section.setting=value [--other settings]
MinecraftClient.exe <settings-file.ini> [--other settings]
```

--------------------------------

### Update System Packages

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Updates the package list and upgrades installed packages on the system. This is a standard first step before installing new software.

```bash
sudo apt update -y && sudo apt upgrade -y
```

--------------------------------

### Create Directory and Download MCC

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Create a directory for Minecraft Console Client and download the latest ARM binary using a script.

```bash
mkdir MinecraftConsoleClient
cd MinecraftConsoleClient
wget -qO- https://mccteam.github.io/install.sh | sh
```

--------------------------------

### Initialize Git Submodules

Source: https://github.com/mccteam/minecraft-console-client/blob/master/AGENTS.md

Ensure all necessary submodules are downloaded and initialized before building the project.

```bash
git submodule update --init --recursive
```

--------------------------------

### Specify Settings via Command Line

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Configure client settings directly on the command line. Use `--section.setting=value` for settings outside the default `[Main]` section, such as enabling bots.

```bash
MinecraftClient.exe --setting=value [--other settings]
```

```bash
MinecraftClient.exe --antiafk.enabled=true
```

--------------------------------

### Start a new screen session

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Starts a new named screen session. Replace 'mcc' with your desired session name. This is useful for running MCC in the background.

```bash
screen -S mcc
```

--------------------------------

### Connect to VPS via SSH

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Use this command to establish an SSH connection to your VPS. Replace `<username>` and `<ip>` with your specific credentials.

```bash
ssh <username>@<ip>
```

--------------------------------

### Enum Serialization Example (String Names)

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/websocket/README.md

Shows how enum values like entity types are serialized as string names in JSON. This example demonstrates a Zombie entity.

```json
{
  "type": "Zombie",
  "location": {
    "x": 10,
    "y": 64,
    "z": -20
  }
}
```

--------------------------------

### Load Configuration from File

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Load client settings and connection details from a specified configuration file. If the file contains login and server IP, the client will automatically connect. Microsoft account authentication uses device code flow.

```bash
MinecraftClient.exe <myconfig.ini>
```

--------------------------------

### Start Docker Compose in Background

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Start the Minecraft Console Client container using docker-compose in detached mode for background running. Note that interactive functionality is not available with this command.

```bash
docker-compose up -d # for daemonized background running
```

--------------------------------

### Start Farming Melon with Debug and Teleport

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

Starts the Farmer bot for melon farming, enabling debug output and direct teleportation. Requires Terrain And Movements and Inventory Handling to be enabled.

```minecraft-commands
/farmer start melon debug:true teleport:true
```

--------------------------------

### Install MCC on Linux/macOS with curl

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Use this command to quickly install MCC on Linux or macOS. It auto-detects your OS and CPU architecture, fetches the latest release, and saves the binary to your current directory.

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

--------------------------------

### Build the Minecraft Console Client Locally

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Builds the client for local development after sourcing the environment script.

```bash
source tools/mcc-env.sh
mcc-build
```

--------------------------------

### Connect to Server with Login, Password, and Server

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Connect to a server using login, password, and server address. Password and server can be omitted. For Microsoft accounts, the password is not required and an empty string should be used as a placeholder if a server is specified. Use '-' for offline mode password.

```bash
MinecraftClient.exe <login> <password> <server>
```

--------------------------------

### Example: Hide Console Chat

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Hides chat messages in the console until explicitly turned back on.

```bash
/console-chat off
```

--------------------------------

### Display Help for Minecraft Client

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Use the --help parameter to view all available command-line options and their descriptions for the Minecraft Console Client.

```bash
MinecraftClient.exe --help
```

--------------------------------

### Get Server TPS

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Retrieves the server's Ticks Per Second (TPS) value.

```bash
/tps
```

--------------------------------

### Clone Repository with Submodules

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/ai-assisted-development.md

Use this command to clone the repository and initialize all its submodules in a single step.

```bash
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
```

--------------------------------

### Build Docker Image

Source: https://github.com/mccteam/minecraft-console-client/blob/master/AGENTS.md

Build the Docker image for the Minecraft Console Client.

```bash
cd Docker && docker build -t minecraft-console-client:latest .
```

--------------------------------

### AI-Assisted Bot Authoring Prompts

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/creating-bots.md

Example prompts for using the mcc-chatbot-authoring skill to generate or fix bot code.

```text
Create a standalone MCC /script bot that watches public chat for the word "auction" and logs matching messages to the console. Use the mcc-chatbot-authoring skill.
```

```text
Fix this existing MCC script bot so it stops sending chat from Initialize() and moves the startup command to AfterGameJoined(). Use the mcc-chatbot-authoring skill.
```

```text
Make a built-in MCC chat bot named AutoTorch and wire it fully into the repo config and bot registration. Use the mcc-chatbot-authoring skill.
```

```text
Create a standalone MCC /script bot that follows private messages, uses GetVerbatim(text), and replies only to bot owners. Use the mcc-chatbot-authoring skill.
```

--------------------------------

### Build for Local Development

Source: https://github.com/mccteam/minecraft-console-client/blob/master/AGENTS.md

Build the project for local development using the provided environment script and build command.

```bash
source tools/mcc-env.sh && mcc-build
```

--------------------------------

### Update and Upgrade Termux Packages

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Update and upgrade the package lists and installed packages in Termux. Ensure you press 'Y' if prompted.

```bash
pkg update -y
pkg upgrade -y
```

--------------------------------

### Clone Minecraft Console Client Repository

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Use this command to clone the main repository and its submodules. Ensure you have Git installed.

```bash
git clone https://github.com/MCCTeam/Minecraft-Console-Client.git --recursive
```

--------------------------------

### Use Custom Settings File and Override Language

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Load client configurations from a specified INI file and simultaneously override the language setting via a command-line parameter.

```bash
# Providing a custom settings file and overriding the language to Chinese
MinecraftClient.exe CustomSettingsFile.ini --language=zh
```

--------------------------------

### SendEntityAction WebSocket Command

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/websocket/Commands.md

Sends a specific action to an entity, such as starting or stopping sneaking. The action type is provided as a string parameter.

```json
{
  "command": "SendEntityAction",
  "requestId": "entity-action-001",
  "parameters": ["StartSneaking"]
}
```

--------------------------------

### Build Minecraft Client Locally

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/installation.md

Compile the MinecraftClient.sln solution in Release configuration using the .NET CLI. This performs a standard local build.

```bash
dotnet build MinecraftClient.sln -c Release
```

--------------------------------

### Configure MCC Server in OpenCode JSON (Basic)

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

Configure the MCC server for OpenCode. This basic setup enables the remote connection.

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcc": {
      "type": "remote",
      "url": "http://127.0.0.1:33333/mcp",
      "enabled": true
    }
  }
}
```

--------------------------------

### Run and Debug from Source

Source: https://github.com/mccteam/minecraft-console-client/blob/master/AGENTS.md

Execute and debug the client directly from the source code, specifying the Minecraft version and enabling file input.

```bash
source tools/mcc-env.sh && mcc-debug -v 1.21.11 --file-input
```

--------------------------------

### Connect and Execute Command

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Connect to a server, execute a specified command, and then close the client. For multiple commands or to stay connected, use ScriptScheduler.

```bash
MinecraftClient.exe <login> <password> <server> "/mycommand"
```

--------------------------------

### Export MCP Auth Token

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

Export the authentication token as an environment variable before starting MCC. This is recommended for securing the MCP server endpoint.

```bash
export MCC_MCP_AUTH_TOKEN="replace-me"
```

--------------------------------

### Interact with Entities

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Attack an entity, use an entity, or get a list of nearby entities. Requires Inventory Handling and Entity Handling to be enabled.

```bash
/entity <id|entitytype> <attack|use>
```

```bash
/entity
```

```bash
/entity Zombie attack
```

--------------------------------

### Use Block

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/usage.md

Places a block from hand onto a specific coordinate or opens an inventory GUI for certain blocks. Requires Inventory Handling and Terrain and Movements to be enabled.

```bash
/useblock
```

--------------------------------

### Start Farming Wheat

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/chat-bots.md

Initiates the Farmer bot to farm wheat within a specified radius. Ensure Terrain And Movements and Inventory Handling are enabled.

```minecraft-commands
/farmer start wheat radius:40
```

--------------------------------

### OnBlockBreakAnimation Payload

Source: https://github.com/mccteam/minecraft-console-client/blob/master/docs/guide/websocket/Events.md

Triggered when a block break animation starts or updates. Includes the entity performing the break, the block's location, and the break stage.

```json
{
  "entity": { ... },
  "location": { "x": 10, "y": 64, "z": -20 },
  "stage": 5
}
```

--------------------------------

### Execute Minecraft Console Client with arguments

Source: https://github.com/mccteam/minecraft-console-client/wiki/Command-arguments

Run the executable with specific flags to enable debug modes or basic I/O for external process integration.

```bash
$ MinecraftClient.exe
    --keyboard-debug    Enter keyboard debug mode
    BasicIO             Enable basic console input output mode.
    BasicIO-NoColor     Enable basic console input output mode and disable console color output
```