Lệnh WebSocket

Lệnh là những thực thể JSON gửi qua kết nối WebSocket Mỗi lệnh sinh ra phản hồi qua sự kiện OnWsCommandResponse.

{
  "command": " TênLệnh",  // nhớ không dấu, khoảng cách.
  "requestId": " id-duy-nhat",
  "parameters": []
}

Protocol Commands

Đây là những câu lệnh quản lý phiên WebSocket của chính nó.

`Xác Thực`

Xác thực với mật khẩu đã cài đặt. Nên được gọi trước bất kỳ lệnh nào khác (ngoại lệ: ChangeSessionId)

Các thông số.

Đầu vào	Gõ	Mô tả
0	chuỗi ký tự	Mật khẩu

Ví dụ:

{
  "command": " XacThuc",
  "requestId": " auth-001",
  "parameters": ["mat-khau"]
}

`ChangeSessionId`

Đổi tên phiên làm việc hiện tại. Có thể được gọi mà không qua xác thực. ID mới nên là chuỗi 1-32 ký tự và chưa bị lấy trước.

Các thông số.

Đầu vào	Gõ	Mô tả
0	chuỗi ký tự	ID phiên làm việc mới

Ví dụ:

{
  "command": "ChangeSessionId",
  "requestId": "rename-001",
  "parameters": ["my-bot"]
}

Logging Commands

`LogToConsole`

Log a message to the MCC console.

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	Message

`LogDebugToConsole`

Log a debug message to the MCC console (only visible in debug mode).

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	Message

`LogToConsoleTranslated`

Log a translated message using an MCC translation key.

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	Translation key

`LogDebugToConsoleTranslated`

Log a translated debug message.

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	Translation key

Session Commands

`ReconnectToTheServer`

Reconnect to the Minecraft server.

Các thông số.

Index	Gõ	Mô tả
0	int	Extra reconnect attempts (default 3)
1	int	Delay in seconds (default 0)

`DisconnectAndExit`

Disconnect from the server and shut down MCC. No parameters.

Chat Commands

`SendPrivateMessage`

Send a private message to a player.

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	Player name
1	chuỗi ký tự	Message

Script Commands

`RunScript`

Run an MCC script file.

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	File name

World and Terrain Commands

`GetTerrainEnabled`

Check if terrain handling is enabled. No parameters. Returns { "enabled": true/false }.

`SetTerrainEnabled`

Enable or disable terrain handling.

Các thông số.

Index	Gõ	Mô tả
0	bool	Enabled

`GetWorld`

Check if world data is available. No parameters. Returns { "available": true } if terrain is enabled.

`DigBlock`

Break a block at the given coordinates. Validates the block is within 6 blocks and is not air.

Các thông số.

Index	Gõ	Mô tả
0	double	X coordinate
1	double	Y coordinate
2	double	Z coordinate
3	chuỗi ký tự	Direction (optional, e.g. "Down")

The Direction parameter accepts string names: Down, Up, North, South, West, East.

Entity Commands

`GetEntityHandlingEnabled`

Check if entity handling is enabled. No parameters. Returns { "enabled": true/false }.

`GetEntities`

Get all tracked entities. No parameters. Returns a dictionary of entity ID to entity object.

Entity types are serialized as string names (e.g., "Zombie", "Player").

`InteractEntity`

Interact with an entity.

Các thông số.

Index	Gõ	Mô tả
0	int	Entity ID
1	chuỗi ký tự	Interaction type (`Interact`, `Attack`, `InteractAt`)
2	chuỗi ký tự	Hand (optional, `MainHand` or `OffHand`)

`SendEntityAction`

Send an entity action.

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	Action type (e.g. `StartSneaking`, `StopSneaking`)

`Sneak`

Toggle sneaking.

Các thông số.

Index	Gõ	Mô tả
0	bool	true to sneak, false to stop

Movement Commands

`GetCurrentLocation`

Get the player's current location. No parameters. Returns a location object with x, y, z.

`MoveToLocation`

Move the player to a location using pathfinding.

Các thông số.

Index	Gõ	Mô tả
0	double	X coordinate
1	double	Y coordinate
2	double	Z coordinate
3	bool	Allow unsafe (optional, false)
4	bool	Allow direct teleport (optional)
5	int	Max offset (optional, 0)
6	int	Min offset (optional, 0)

`ClientIsMoving`

Check if the client is currently moving. No parameters. Returns { "moving": true/false }.

`LookAtLocation`

Make the player look at coordinates.

Các thông số.

Index	Gõ	Mô tả
0	double	X
1	double	Y
2	double	Z

Player Info Commands

`GetUsername`

Get the player's username. No parameters. Returns { "username": "..." }.

`GetUserUUID`

Get the player's UUID. No parameters. Returns { "uuid": "..." }.

`GetGamemode`

Get the current gamemode. No parameters. Returns { "gamemode": 0 }.

`GetYaw`

Get the player's yaw rotation. No parameters. Returns { "yaw": 0.0 }.

`GetPitch`

Get the player's pitch rotation. No parameters. Returns { "pitch": 0.0 }.

`GetOnlinePlayers`

Get a list of online player names. No parameters. Returns a string array.

`GetOnlinePlayersWithUUID`

Get online players with their UUIDs. No parameters. Returns a dictionary of UUID to player name.

`GetPlayersLatency`

Get latency information for online players. No parameters.

Server Info Commands

`GetServerHost`

Get the server hostname. No parameters. Returns { "host": "..." }.

`GetServerPort`

Get the server port. No parameters. Returns { "port": 25565 }.

`GetServerTPS`

Get the server TPS (ticks per second). No parameters. Returns { "tps": 20.0 }.

`GetTimestamp`

Get the current timestamp. No parameters. Returns { "timestamp": "..." }.

`GetProtocolVersion`

Get the Minecraft protocol version. No parameters. Returns { "protocolVersion": 769 }.

`GetMaxChatMessageLength`

Get the maximum chat message length. No parameters. Returns { "length": 256 }.

Inventory Commands

`GetInventoryEnabled`

Check if inventory handling is enabled. No parameters. Returns { "enabled": true/false }.

`GetPlayerInventory`

Get the player's inventory. No parameters. Returns the full inventory container with items.

Item types are serialized as string names (e.g., "DiamondSword", "Stone").

`GetInventories`

Get all open inventories. No parameters.

`WindowAction`

Perform a window/inventory action.

Các thông số.

Index	Gõ	Mô tả
0	int	Inventory ID
1	int	Slot ID
2	chuỗi ký tự	Action type (e.g. `LeftClick`, `RightClick`, `DropItemStack`)

`ChangeSlot`

Change the active hotbar slot.

Các thông số.

Index	Gõ	Mô tả
0	short	Slot number (0-8)

`GetCurrentSlot`

Get the currently selected hotbar slot. No parameters. Returns { "slot": 0 }.

`SetSlot`

Set the active slot (legacy command).

Các thông số.

Index	Gõ	Mô tả
0	int	Slot number

`ClearInventories`

Clear tracked inventory state. No parameters.

`CloseInventory`

Close an inventory window.

Các thông số.

Index	Gõ	Mô tả
0	int	Inventory ID

Creative Mode Commands

`CreativeGive`

Give an item in creative mode.

Các thông số.

Index	Gõ	Mô tả
0	int	Slot ID
1	chuỗi ký tự	Item type (e.g. `"DiamondSword"` or `798`)
2	int	Count

`CreativeDelete`

Delete an item from a slot in creative mode.

Các thông số.

Index	Gõ	Mô tả
0	int	Slot ID

Block Interaction Commands

`SendPlaceBlock`

Place a block.

Các thông số.

Index	Gõ	Mô tả
0	double	X coordinate
1	double	Y coordinate
2	double	Z coordinate
3	chuỗi ký tự	Direction (e.g. `"Up"`)
4	chuỗi ký tự	Hand (optional, `"MainHand"` or `"OffHand"`)

`SendAnimation`

Play arm swing animation.

Các thông số.

Index	Gõ	Mô tả
0	chuỗi ký tự	Hand (optional, default `"MainHand"`)

`UseItemInHand`

Use the item currently held. No parameters.

`UpdateSign`

Update text on a sign.

Các thông số.

Index	Gõ	Mô tả
0	double	X coordinate
1	double	Y coordinate
2	double	Z coordinate
3	chuỗi ký tự	Line 1
4	chuỗi ký tự	Line 2
5	chuỗi ký tự	Line 3
6	chuỗi ký tự	Line 4

`UpdateCommandBlock`

Update a command block.

Các thông số.

Index	Gõ	Mô tả
0	double	X coordinate
1	double	Y coordinate
2	double	Z coordinate
3	chuỗi ký tự	Command
4	chuỗi ký tự	Mode (e.g. `"Sequence"`, `"Auto"`, `"Redstone"`)
5	chuỗi ký tự	Flags

Trading Commands

`SelectTrade`

Select a villager trade.

Các thông số.

Index	Gõ	Mô tả
0	int	Trade index