Carpet Bot Manager

Carpet Bot Manager

Carpet Bot Manager adds player-owned bot management on top of Fabric Carpet's /player command. It is built for servers that want Carpet bots to feel like a controlled player feature instead of an unrestricted admin tool.

Players get their own numbered bots, can spawn and control only the bots they own, and can buy additional bots using a server-configured item cost. Operators can tune the naming pattern, starter bot count, price, and per-player cap.

Features

• Player-owned Carpet bots with persistent per-world ownership
• Safe /cbot command wrapper around Carpet's /player actions
• One starter bot by default for each player
• Optional buy system for additional bots
• Configurable bot price, free starter count, bot cap, and bot name pattern
• Bot online/offline status in /cbot list
• Teleport bot to owner or to coordinates
• Forward common Carpet actions such as use once, attack continuous, move forward, stop, kill, jump, sneak, and more
• Optional client GUI when the mod is installed on both client and server
• Server-authoritative validation so players can only control their own bots

Requirements

• Minecraft 1.21.11 or newer
• Fabric Loader
• Fabric API
• Fabric Carpet

Fabric Carpet is required for spawning bots and forwarding bot actions. If Carpet is missing, /cbot still loads, but Carpet-backed actions will report that Carpet is not installed.

Installation

For command-only use, install the mod on the server.

For the graphical interface, install the same mod jar on both the server and each client that wants to use the GUI. Players without the client mod can still use the command interface.

Player Commands

/cbot list
/cbot buy
/cbot gui
/cbot <id> spawn
/cbot <id> tp
/cbot <id> tp <x> <y> <z>
/cbot <id> <carpet action...>

Examples:

/cbot list
/cbot 1 spawn
/cbot 1 use once
/cbot 1 attack continuous
/cbot 1 move forward
/cbot 1 stop
/cbot 1 tp
/cbot 1 tp 100 64 -20
/cbot buy

Client GUI

Run /cbot gui or bind the Open Carpet Bot Manager key in Minecraft's controls menu.

The GUI lets players:

• See owned bots and online status
• Refresh bot state
• Buy another bot when allowed by server policy
• Spawn bots
• Teleport bots
• Send preset Carpet actions
• Send a custom Carpet action

Admin configuration remains command-only.

Admin Configuration

Configuration commands require permission level 4.

/cbot config show
/cbot config botname "<pattern>"
/cbot config starting-free <count>
/cbot config price <item> <count>
/cbot config cap <count>
/cbot config cap none
/cbot config reset

Defaults:

• Bot name pattern: cbot_{player}_{id}
• Free starter bots: 1
• Buy price: 1 minecraft:netherite_block
• Bot cap: none

Supported bot name placeholders:

• {player}
• {id}
• {uuid}

Generated bot names are sanitized and shortened deterministically to fit Minecraft's 16-character player name limit.

Security Model

/cbot dispatches the underlying bot commands with server authority, but only after validating the player and bot ownership. Players provide a bot ID, not a raw bot name, and the server resolves that ID from the player's saved ownership list.

The mod only dispatches restricted commands for the resolved owned bot:

• `player ...`
• `tp ...`

This allows servers to expose useful Carpet bot controls without giving players arbitrary command execution.

Notes

Changing the bot name pattern renames saved bot identities immediately. Already-spawned bots using old names may need to be killed or restarted manually.