Carpet Bot Manager

Carpet Bot Manager

Carpet Bot Manager добавляет управление ботами, принадлежащими игрокам, поверх команды /player из Fabric Carpet. Мод создан для серверов, которые хотят, чтобы боты Carpet ощущались как контролируемая функция для игроков, а не как неограниченный админский инструмент.

Игроки получают собственных пронумерованных ботов, могут спавнить и управлять только своими ботами, а также покупать дополнительных ботов за предмет, настроенный на сервере. Операторы могут настроить шаблон имени, стартовое количество ботов, цену и лимит на игрока.

Возможности

• Боты Carpet, принадлежащие игрокам, с постоянным владением для каждого мира
• Безопасная обёртка команды /cbot вокруг действий /player из Carpet
• Один стартовый бот по умолчанию для каждого игрока
• Опциональная система покупки дополнительных ботов
• Настраиваемая цена бота, количество бесплатных стартовых ботов, лимит ботов и шаблон имени бота
• Статус онлайн/оффлайн ботов в /cbot list
• Телепортация бота к владельцу или к координатам
• Передача распространённых действий Carpet, таких как use once, attack continuous, move forward, stop, kill, jump, sneak и других
• Опциональный клиентский GUI, если мод установлен и на клиенте, и на сервере
• Серверная валидация, чтобы игроки могли управлять только своими ботами

Требования

• Minecraft 1.21.11 или новее
• Fabric Loader
• Fabric API
• Fabric Carpet

Fabric Carpet необходим для спавна ботов и передачи действий ботов. Если Carpet отсутствует, /cbot всё равно загружается, но действия на основе Carpet сообщат, что Carpet не установлен.

Установка

Для использования только через команды установите мод на сервер.

Для графического интерфейса установите тот же jar мода и на сервер, и на каждый клиент, который хочет использовать GUI. Игроки без клиентского мода всё ещё могут пользоваться командным интерфейсом.

Команды игрока

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

Примеры:

/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

Клиентский GUI

Запустите /cbot gui или назначьте клавишу Open Carpet Bot Manager в меню управления Minecraft.

GUI позволяет игрокам:

• Видеть своих ботов и статус онлайн
• Обновлять состояние ботов
• Покупать ещё одного бота, когда это разрешено политикой сервера
• Спавнить ботов
• Телепортировать ботов
• Отправлять предустановленные действия Carpet
• Отправлять своё действие Carpet

Админская настройка остаётся доступной только через команды.

Админская настройка

Команды настройки требуют уровень прав 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

Значения по умолчанию:

• Шаблон имени бота: cbot_{player}_{id}
• Бесплатные стартовые боты: 1
• Цена покупки: 1 minecraft:netherite_block
• Лимит ботов: нет

Поддерживаемые плейсхолдеры имени бота:

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

Сгенерированные имена ботов очищаются и детерминированно сокращаются, чтобы уложиться в лимит имени игрока в Minecraft — 16 символов.

Модель безопасности

/cbot отправляет нижележащие команды ботов с серверными правами, но только после проверки владения игроком и ботом. Игроки указывают ID бота, а не сырое имя бота, и сервер определяет этот ID из сохранённого списка владения игрока.

Мод отправляет только ограниченные команды для определённого принадлежащего бота:

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

Это позволяет серверам открывать полезное управление ботами Carpet, не давая игрокам произвольное выполнение команд.

Примечания

Изменение шаблона имени бота сразу переименовывает сохранённые личности ботов. Уже заспавненных ботов со старыми именами, возможно, придётся убить или перезапустить вручную.