helpy4/Minecraft-Console-Client

Fork 0

mirror of https://github.com/MCCTeam/Minecraft-Console-Client synced 2025-10-14 21:22:49 +00:00

BruceChen 5624e77125 Fix format

2022-11-04 14:25:59 +08:00

21 KiB

Raw Blame History

Usage

How to run the program:

Running on Windows
Running on Linux, macOS
Running using Docker

Using the command line parameters:

Examples
Command line parameters
Internal commands

Windows

Simply run MinecraftClient.exe

::: tip

On Windows it's best using Windows Terminal for the best experience and looks. Some features like emojis in the /chunk command do not work in CMD or Powershell 5

:::

Linux, macOS

To run the client you need to type the following command in your terminal emulator:

./MinecraftClient

If you want to keep it running in the background you can use screen (Linux only)

Example:

# Start the screen
screen -S mcc

# Run it
./MinecraftClient

# Detach from the screen by pressing CTRL + A + D

# Re-attach if you want to have accces again
screen -r mcc

Learn more on how to use the screen command: YouTube

Docker

See Run using Docker

Command-line usage

Minecraft Console Client has a plethora of useful command line parameters, here you can learn about them.

For people not familiar with the command line

For people who are not familiar with the usage of programs in the command line (terminal emulators), here we will explain what every single thing means, if you're already experienced you can skip this.

In command line (terminal emulators) you can run programs by specifying their name and hitting enter, usually programs have additional way of being configured, started or provided some additional data in a different manner, this is achieved by using command line parameters.

Command line parameters are written after the name of the program, they're separated by spaces and they can have a few different formats, examples:

someparameter
-some-parameter
--some-other-parameter
--some-setting="some value"
-a=5

Parameters with a single dash (-) are usually used for a single letter (short-hand) parameters, while the ones with a double dash (--) are being used for parameters with a longer/full name.

When you are reading examples, you will often see something like this: <something here>, this means that this is a place holder and it should be changed with some value, excluding the < and the >.

For example <username> you need to change to an username of your liking, example: notch (< and > should not be included).

[ and ] mean that a parameter is an optional one.

They also can hold some values, example from the MCC:

MinecraftClient.exe --debugmessages=false

When a parameter has a textual value that includes one more spaces, you will need to wrap it the value in double quotes ("), example: --some-parameter="some text here with spaces in it"

Here is an example for using a --help command line parameter for MCC that will print out a page on how to use MCC from the command line:

MinecraftClient.exe --help

Quick usage of MCC with examples

::: tip

On Linux and macOS, you need to type: ./MinecraftClient instead of MinecraftClient.exe

:::

MinecraftClient.exe --help
MinecraftClient.exe <username> <password> <server>
MinecraftClient.exe <username> <password> <server> "/mycommand"
MinecraftClient.exe --setting=value [--other settings]
MinecraftClient.exe --section.setting=value [--other settings]
MinecraftClient.exe <settings-file.ini> [--other settings]

Examples:

# Logging in as a user: notch, with a password: password123 onto a server with the ip: mc.someserver.com:25565
MinecraftClient.exe notch password123 mc.someserver.com:25565

# Overriding a setting from MinecraftClient.ini using a command line parameter
MinecraftClient.exe --debugmessages=false

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

Rules of using the command line parameters

You can mix and match arguments by following theses rules:

First positional argument may be either the login or a settings file
Other positional arguments are read in order: login, password, server, command
Arguments starting with -- can be in any order and position

Examples and further explanations:

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

This will automatically connect you to the chosen server.
You may omit password and/or server to specify e.g. only the login
To specify a server but ask password interactively, use "" as password.
To specify offline mode with no password, use - as password.

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

This will automatically send /mycommand to the server and close.
To send several commands and/or stay connected, use the 1ScriptScheduler1 bot instead.

MinecraftClient.exe <myconfig.ini>

This will load the specified configuration file
If the file contains login / password / server ip, it will automatically connect.

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

Specify settings on the command-line, see possible value in the configuration file
Use --section.setting=value for settings outside the [Main] section
Example: --antiafk.enabled=true for enabling the AntiAFK bot

MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]

Load the specified configuration file and override some settings from the file

Internal Commands

These commands can be performed from the chat prompt, scripts or remote control.

From chat prompt, commands must by default be prepended with a slash, eg. /quit.

In scripts and remote control, no slash is needed to perform the command, eg. quit.

::: tip

Some commands may not be documented yet or are defined in description of Chat Bots, use /help to list them all, or you can contribute to this page.

:::

`animation`

Description:

Swing your main or off hand.
Usage:
```
/animation <mainhand|offhand>
```

`bed`

Description:

Allows you to make the bot sleep easily, all about sleeping in one command.
Usage:

Basic usage: bed leave|sleep <x> <y> <z>|sleep <radius>
Examples:

Leave a bed:
```
/bed leave
```
Sleep in a bed on 124 84 76:
```
/bed sleep 124 84 76
```
Sleep in a bed using relative coordinates:
```
/bed sleep ~ ~ ~-2
```
Automatically find a bed in radius of 50 blocks and sleep in it:
```
/bed sleep 50
```

`bots`

Description:

Allows you to list and unload a specific bot or all bots. Useful when debugging and developing scripts.
Usage:
```
/bots <list|unload <bot name|all>>
```
Examples:

Unload a bot called CustomScript
```
/bots unload CustomScript
```
Unload all bots
```
/bots unload all
```

`changeslot`

Description:

Change your selected slot in the hotbar.

::: tip

You need to have Inventory Handling enabled in order for this to work.

:::
Usage:
```
/changeslot <1-9>
```

`chunk`

Description:

Displays the chunk loading status in a nice way.

::: warning

To use this feature you need to enable the Terrain and Movements

:::

::: tip

You need a terminal with emoji support, like Powershell 7, Windows Terminal or Alacritty, if you do not want emoji support and want to use cmd or powershell 5, disable emojis with: enableemoji

:::

Usage:

/chunk status [chunkX chunkZ|locationX locationY locationZ]

How it looks:

`dig`

Description:

Dig a block on a specific coordinate.
Usage:
```
/dig <x> <y> <z>
```
Example:
```
/dig 127 63 12
```
Using relative coordinates:
```
/dig ~ ~-1 ~2
```

`dropitem`

Description:

Drop all items of a specific type from your inventory.

::: tip

You need to have Inventory Handling enabled in order for this to work.

:::
Usage:
```
/dropitem <itemtype>
```
::: tip

All item types can be found here.

:::
Example:
```
/dropitem diamond
```

`entity`

Description:

Attack an entity, use an entity or get a list of entities around you.

::: tip

You need to have Inventory Handling and Entity Handling enabled in order for this to work.

:::
Usage:

Basic usage:
```
/entity <id|entitytype> <attack|use>
```
Get a list of entities around you:
```
/entity
```
::: tip

All entity types can be found here.

:::
Examples:

Attack a Zombie:
```
/entity Zombie attack
```

`execif`

Description:

Allows you to execute a command if a specific condition is met.

The condition is a C# expression and the local variables you set using set, setrnd or the configuration file can be used. The condition is always returned as a boolean, so only comparison can be done, if needed cast the expression result to bool.

Also the instance of MCC is available with MCC..

::: tip

All local variables are treated as strings in the app, when comparing their values, you can use <variable> == "<value>", or better use .Equals method

:::
Usage:

Basic usage: /execif <condition (C# expression)> ---> <command>

Examples:

Setting a variable and using it:

/set test=Something
/execif test == "Something" ---> send Success!

/set test2=1
/execif test2 == "1" ---> send Success 2!

Basic C# expression:

/execif 1 + 2 + 3 == 6 ---> send Success!

Using MCC class:

/execif MCC.GetHealth() == 20.0 ---> send Success!

Using in combination with execmulti:

/execif 1 == 1 ---> execmulti send 1 -> send 2 -> send 3

`execmulti`

Description:

Allows you to execute multiple commands in succession on a single line, useful for debugging or when using execif

Commands are separated by ->
Usage:

Basic usage: execmulti <command 1> -> <command 2> -> <command 3> -> ...

Examples:

/execmulti send 1 -> send 2 -> send 3 -> sneak

`quit`

Alias: exit
Description:

Disconnect from the server and close the application

`reco`

Description:

Disconnect and reconnect to the server
Usage:
```
/reco [account]
```
::: tip

[account] is an account alias defined in accounts file, for more info check out accountlist

:::

`reload`

Description:

Reloads settings from MinecraftClient.ini and Chat Bots.

::: tip

Some settings won't be reloaded since they are used before the client initialization. Also, settings provided by the command line paramteres will be overriden. This also does not reload the ReplayBot due to technical limitations.

:::
Usage:
```
/reload
```

`connect`

Description:

Go to the given server and resume the script
Usage:
```
/connect <server> [account]
```
::: tip

<server> is either a server IP or a server alias defined in servers file, for more info check out serverlist

:::

::: tip

[account] is an account alias defined in accounts file, for more info check out accountlist

:::

`script`

Description:

Run a script containing a list of commands
Usage:
```
/script <script name>
```

`send`

Description:

Send a message or a command to the server
Usage:
```
/send <text>
```

`respawn`

Description:

Use this to respawn if you are dead (like clicking "respawn" in-game)
Usage:
```
/respawn
```

`log`

Description:

Display some text in the console (useful for scripts)
Usage:
```
/log <text>
```
Example:
```
/log this is some text
```

`list`

Description:

List players logged in to the server (uses tab list info sent by server)
Usage:
```
/list
```

`set`

Description:

Set a value which can be used as %variable% in further commands
Usage:
```
/set <variable>=<value>
```
Examples:
```
/set abc=123
```

`setrnd`

Description:

Set a %variable% randomly to one of the provided values

Usage:

/setrnd <variable> string1 "\"string2\" string3"

Examples:
```
/setrnd <variable> -7to10
```
(Set a %variable% to a number from -7 to 9)

`sneak`

Description:

Toggle sneaking.
Usage:
```
/Sneak
```

`tps`

Description:

Get the server TPS (Ticks Per Second).
Usage:
```
/tps
```

`useitem`

Description:

Use item in the hand, this can be used to do a right click on items which open menus on servers.

::: tip

You need to have Inventory Handling enabled in order for this to work.

:::

::: warning

The Inventory Handling is currently not supported in 1.4.6 - 1.9

:::
Usage:
```
/useitem
```

`useblock`

Description:

Place a block from a hand on a specific coordinate or open an inventory:
- chest/trap chest
- furnace
- brewing stand
- dispenser/dropper
- hopper
- shulker
- loom
::: tip

You need to have Inventory Handling and Terrain and Movements enabled in order for this to work.

:::

::: tip

Not all inventories have a GUI representation in an ASCII art format.

:::

::: warning

The Inventory Handling is currently not supported in 1.4.6 - 1.9.

:::
Usage:
```
/useblock <x> <y> <z>
```
Example:
```
/useblock 43 72 7
```

`follow`

Description:

Make the bot follow a player.

::: tip

This command is avaliable only with Follow Player Chat Bot enabled.

:::

::: tip

You need to have Inventory Handling enabled in order for this to work.

:::

::: tip

You need to have Enity Handling enabled in order for this to work.

:::
Usage:
```
/follow <player name|stop>
```
Example:
```
/follow milutinke
```

`wait`

Description:

Wait X ticks (10 ticks = ~1 second. Only for scripts)
Usage:
```
/wait <time>
```
Examples:
```
/wait 20
```

`move`

Description:

Used for moving when terrain and movements feature is enabled.

::: tip

You need to have Terrain and Movements enabled in order for this to work.

:::

::: warning

The Terrain and Movements is currently not supported in 1.4.6 - 1.6.

:::

Usage:

/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f": force unsafe movements like falling or touching fire

Examples:

Enable gravity
```
/move gravity on
```
Move to coordinates:
```
/move 125 72 34
```
Move to a center of a block:
```
/move center
```

`look`

Description:

Used for looking at direction when terrain and movements is enabled

Usage:

/look <x y z|yaw pitch|up|down|east|west|north|south>

Examples:
```
/look up
```
```
/look east
```

`inventory`

Description:

Used for inventory manipulation.

::: tip

You need to have Inventory Handling enabled in order for this to work.

:::

::: warning

The Inventory Handling is currently not supported in 1.4.6 - 1.9.

:::

MCC defines inventories as containers internally, so player's inventory, chests, droppers, dispensers, hoppers, chest minecarts, barrels, furnaces, etc... are all considered a container, and each one of them has it's ID, the words container and inventory can be used interchangeably.

Inventory has slots and each one of them has an id.

::: tip

This command DOES NOT physically open a container (eg. chest), for that you need to use useblock command first.

:::

An example of player inventory with annotated IDs in ASCII art and a list of items:
Usage:

Basic usage:
```
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]
```
::: tip

player and container can be simplified with p and c accordingly

:::

Actions:
- click
- shiftclick
- drop
Show/Preview items in an inventory:
```
/inventory <player|id>
```
Click/Shift-Click on an item in an inventory:
```
/inventory <player|container|<id>> <click|shiftclick> <slot id> [left|right|middle]
```
::: tip

The default click is left click

:::

Close an inventory:
```
/inventory <player|container|<id>> close
```
Drop item(s) from an inventory:
```
/inventory <player|id> drop <slot id> <number of items|all>
```
::: tip

To drop all items from a slot, you can use: all

:::

Give an item to the player inventory from a creative menu when in the creative mode:
```
/inventory creativegive <slot id> <item type> <amount>
```
::: tip

To find item types, check out this list

:::

Delete an item from a player's inventory when in the creative mode:
```
/inventory creativedelete <slot id>
```
Show all available inventories:
```
/inventory inventories
```
Search for an item of specified type in available inventories:
```
/inventory search <item type>
```
Examples:

Show player's inventory:
```
/inventory player
```
Show/Preview items in an inventory using an id:
```
/inventory 3
```
Click on an item in player's inventory in slot number/id 36:
```
/inventory player click 36
```
Right-Click on an item in slot number/id 4 in an inventory with an id 2:
```
/inventory 2 click 4 right
```
Close an inventory with an id 2:
```
/inventory 2 close
```
Drop a single item from a player's inventory in slot number/id 36:
```
/inventory player drop 36 1
```
Drop all items from a player's inventory in slot number/id 37:
```
/inventory player drop 37 all
```
Give an item to the player inventory from a creative menu when in the creative mode:
```
/inventory creativegive 36 diamondblock 64
```
::: tip

To find item types, check out this list

:::

Delete an item from a player's inventory in slot number/id 36 when in the creative mode:
```
/inventory creativedelete 36
```
Search for 10 Slime Blocks in available inventories:
```
/inventory s SlimeBlock 10
```

`debug`

Description:

Toggle debug messages, useful for chatbot developers.

`help`

Description:

Show commands help.

::: tip

Use "/send /help" for server help

:::

21 KiB Raw Blame History

Usage

Windows

Linux, macOS

Docker

Command-line usage

For people not familiar with the command line

Quick usage of MCC with examples

Rules of using the command line parameters

Internal Commands

animation

bed

bots

changeslot

chunk

dig

dropitem

entity

execif

execmulti

quit

reco

reload

connect

script

send

respawn

log

list

set

setrnd

sneak

tps

useitem

useblock

follow

wait

move

look

inventory

debug

help

21 KiB

Raw Blame History

`animation`

`bed`

`bots`

`changeslot`

`chunk`

`dig`

`dropitem`

`entity`

`execif`

`execmulti`

`quit`

`reco`

`reload`

`connect`

`script`

`send`

`respawn`

`log`

`list`

`set`

`setrnd`

`sneak`

`tps`

`useitem`

`useblock`

`follow`

`wait`

`move`

`look`

`inventory`

`debug`

`help`