player
Manage in-game players with actions like retrieving info/location, sending messages, managing inventory, setting gamemodes, adjusting abilities, and handling tags. Supports chained operations for efficient player control on Minecraft Bedrock MCP Server.
Instructions
PLAYER management: info/location/communication/inventory/abilities/gamemode. Actions: get_info/location (player details), send_message (chat to player), give_item (add to inventory), set_gamemode (survival/creative/adventure/spectator), add_levels (XP), get/set_ability (mayfly/mute/worldbuilder), get/check_tag, get_ping, list_all_players. Supports sequences for chained player operations.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ability | No | Player ability to modify | |
| ability_value | No | Enable or disable the ability | |
| action | Yes | Player operation to perform: get_info (returns player details), get_location (returns exact coordinates x,y,z including NEGATIVE values like x:-45.7, z:-123.2, plus rotation data), send_message (chat to player), give_item (add to inventory), set_gamemode (survival/creative/adventure/spectator), add_levels (XP), get/set_ability (mayfly/mute/worldbuilder), get/check_tag, get_ping, list_all_players. Use get_location before building to know exact position. | |
| amount | No | Item amount (1-64) | |
| can_destroy | No | Blocks this item can destroy (optional) | |
| can_place_on | No | Blocks this item can be placed on (optional) | |
| gamemode | No | Game mode to set | |
| item_id | No | Item ID to give (e.g., minecraft:diamond, minecraft:iron_sword) | |
| keep_on_death | No | Keep item on death (optional) | |
| levels | No | Experience levels to add | |
| message | No | Message to send to player | |
| player_name | No | Target player name (optional, defaults to local player) | |
| steps | No | Array of player sequence steps. Each step needs "type" (action) and params. Optional: "wait_time" (seconds), "on_error" (continue/stop/retry). Example: [{type:"send_message",message:"Hello!"},{type:"set_gamemode",gamemode:"creative",wait_time:1}] | |
| tag | No | Tag to check for |
Input Schema (JSON Schema)
{
"properties": {
"ability": {
"description": "Player ability to modify",
"enum": [
"mayfly",
"mute",
"worldbuilder"
],
"type": "string"
},
"ability_value": {
"description": "Enable or disable the ability",
"type": "boolean"
},
"action": {
"description": "Player operation to perform: get_info (returns player details), get_location (returns exact coordinates x,y,z including NEGATIVE values like x:-45.7, z:-123.2, plus rotation data), send_message (chat to player), give_item (add to inventory), set_gamemode (survival/creative/adventure/spectator), add_levels (XP), get/set_ability (mayfly/mute/worldbuilder), get/check_tag, get_ping, list_all_players. Use get_location before building to know exact position.",
"enum": [
"get_info",
"get_location",
"send_message",
"give_item",
"set_gamemode",
"add_levels",
"get_abilities",
"set_ability",
"get_tags",
"check_tag",
"get_ping",
"list_all_players",
"sequence"
],
"type": "string"
},
"amount": {
"default": 1,
"description": "Item amount (1-64)",
"maximum": 64,
"minimum": 1,
"type": "number"
},
"can_destroy": {
"description": "Blocks this item can destroy (optional)",
"type": "array"
},
"can_place_on": {
"description": "Blocks this item can be placed on (optional)",
"type": "array"
},
"gamemode": {
"description": "Game mode to set",
"enum": [
"survival",
"creative",
"adventure",
"spectator"
],
"type": "string"
},
"item_id": {
"description": "Item ID to give (e.g., minecraft:diamond, minecraft:iron_sword)",
"type": "string"
},
"keep_on_death": {
"default": false,
"description": "Keep item on death (optional)",
"type": "boolean"
},
"levels": {
"description": "Experience levels to add",
"minimum": 1,
"type": "number"
},
"message": {
"description": "Message to send to player",
"type": "string"
},
"player_name": {
"description": "Target player name (optional, defaults to local player)",
"type": "string"
},
"steps": {
"description": "Array of player sequence steps. Each step needs \"type\" (action) and params. Optional: \"wait_time\" (seconds), \"on_error\" (continue/stop/retry). Example: [{type:\"send_message\",message:\"Hello!\"},{type:\"set_gamemode\",gamemode:\"creative\",wait_time:1}]",
"items": {
"description": "Individual sequence step",
"properties": {
"on_error": {
"description": "Error handling: continue (ignore), stop (halt), retry (try again)",
"enum": [
"continue",
"stop",
"retry"
],
"type": "string"
},
"type": {
"description": "Player action: get_info, get_location, send_message, give_item, set_gamemode, add_levels, get_abilities, set_ability, get_tags, check_tag, get_ping",
"type": "string"
},
"wait_time": {
"description": "Seconds to wait after this step (0-60)",
"maximum": 60,
"minimum": 0,
"type": "number"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
},
"tag": {
"description": "Tag to check for",
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
}