Что такое плагин cmdBook в Minecraft
cmdBook — это уникальный плагин для серверов Minecraft, который превращает обычную книгу в мощный инструмент автоматизации. С его помощью можно записывать цепочки команд, чат-сообщения и даже скрипты JavaScript прямо на страницах книги, а затем выполнять их одним кликом. Представьте: вы создаёте книгу для модератора, которая по левому щелчку банит нарушителя, откатывает его постройки и отправляет предупреждение — и всё это без единой ручной команды. Плагин поддерживает десятки переменных, задержки, консольное выполнение и логические конструкции, что делает его незаменимым для администраторов и разработчиков мини-игр.
Основные возможности cmdBook
Плагин даёт гибкость, сравнимую с написанием скриптов, но при этом остаётся интуитивно понятным. Вот что вы получаете:
- Выполнение нескольких команд одной книгой.
- Подстановка переменных: имя игрока, цель, координаты, здоровье и другие.
- Встроенный JavaScript для динамических вычислений.
- Настраиваемые задержки между командами.
- Запрос ввода у игрока перед выполнением.
- Совместимость с другими книжными плагинами.
Кстати, если вы увлекаетесь модификациями и хотите упростить их установку, обратите внимание на лаунчер foxygame.net — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню. Он особенно пригодится, когда нужно быстро переключаться между сборками, не копаясь в файлах вручную.
Как создать cmdBook
Процесс создания книги команд прост и состоит из нескольких шагов. Для начала вам потребуется обычная книга и перо, а также соответствующие права доступа.
Пошаговая инструкция
- Получите права на создание и использование cmdBook (разрешения настраиваются отдельно).
- Возьмите в руку книгу и перо, откройте её для редактирования.
- На первой странице напишите [cmdbook] — это обязательный заголовок, который активирует плагин.
- На следующих строках или страницах вводите команды. Каждая новая строка или страница воспринимается как отдельная команда. Можно также разделять команды символом |.
- Подпишите книгу на наковальне.
- Держа книгу в руке, введите команду /cb create (или /cbook create). Готово!
Теперь при левом клике этой книгой все записанные команды выполнятся последовательно. Вы можете в любой момент отредактировать книгу командой /cb edit, а список команд посмотреть через /cb info.
Команды и права доступа
Плагин добавляет несколько базовых команд, доступных через алиасы /cb или /cbook:
- /cb create — превращает книгу в руке в cmdBook.
- /cb edit — открывает книгу для редактирования (обычные книги при этом блокируются).
- /cb info — показывает список команд внутри книги.
- /cb about — информация о плагине.
- /cb private / public — делает книгу приватной или публичной.
- /cb reload — перезагружает конфигурацию.
- /cb convert — конвертирует устаревшие переменные.
- /cb variables — выводит список доступных переменных прямо в игре.
Права доступа гибко настраиваются: вы можете разрешить создание книг одним игрокам, а использование — другим. Также поддерживаются индивидуальные разрешения на каждую книгу по её имени, если в книге прописан тег @name[имя].
Встроенные переменные и скрипты
Настоящая сила cmdBook раскрывается через переменные. Они заменяются на реальные значения в момент выполнения команды. Вот некоторые из них:
- $player — имя игрока, использующего книгу.
- $targetplayer — имя игрока, на которого направлен взгляд.
- $health, $xp, $lvl, $hunger — характеристики самого игрока.
- $targetxp, $targetlvl, $targethunger — характеристики цели.
- $xpos, $ypos, $zpos — координаты игрока.
- $losx, $losy, $losz — координаты блока, на который смотрит игрок.
- $killer, $targetkiller — имена убийц.
- $input и $input[вопрос] — запрос ввода у игрока перед выполнением.
- $wait[миллисекунды] — пауза между командами.
- $script[код] — выполнение JavaScript. Создайте переменную output в скрипте, и она подставится в команду.
- $calc[выражение] — простые математические вычисления.
- $msg[текст] — отправляет приватное сообщение игроку.
- $broadcast[текст] — транслирует сообщение на весь сервер.
- $chat[текст] — отправляет сообщение в чат от имени игрока.
Для выполнения команд от имени консоли используйте @runconsole в начале книги. А тег @hidemessages скроет служебные сообщения плагина, такие как «Command performed».
Примеры использования
Давайте рассмотрим несколько сценариев, чтобы понять, как cmdBook вписывается в реальную игру.
Простая награда
Содержимое книги:
[cmdbook] /give $player cookie 1 /say Я получил печенье!
Игрок кликает книгой и получает печенье, а в чат выводится сообщение.
Модераторский инструмент
[cmdbook] $targetplayer Вы были замечены за гриферством! /ban $targetplayer Гриферство /lb rollback player $targetplayer time 30 minutes
Здесь книга банит цель, откатывает его действия за полчаса и отправляет личное сообщение.
Динамический ввод
[cmdbook] /ban $targetplayer $input[Причина бана?] /lb rollback player $targetplayer time $input[Сколько дней откатить?] days $wait[2000] /yes $wait[10000] /no
Перед выполнением книга запросит у модератора причину и срок, а затем сделает откат с подтверждением.
JavaScript и вычисления
[cmdbook] /teleport $losx $calc($losy+1) $losz $script[var dNow = new Date(); var output = 'Сегодня ' + dNow.getDate();] /say $output
Телепортирует игрока на блок, на который он смотрит (с коррекцией по высоте), и выводит текущее число месяца.
Обновление и метрики
Плагин использует автоматическую проверку версий через CurseForge. Вы можете отключить эту функцию в конфигурации. Также он собирает анонимную статистику через систему Metrics (можно отключить в файле /plugins/PluginMetrics/config.yml). Разработчик активно дорабатывает функционал: в планах поддержка условных операторов, циклов, интеграция со Skript и CmdHelper, а также встроенный редактор конфигурации.
Заключение
cmdBook — это компактное, но чрезвычайно мощное решение для автоматизации рутинных действий на сервере. Оно не требует знаний программирования на старте, но при этом открывает продвинутые возможности через JavaScript. Благодаря поддержке переменных и задержек вы можете создавать интерактивные книги для игроков, модераторов и администраторов. Плагин совместим с большинством книжных аддонов и регулярно обновляется. Если вы хотите вывести управление сервером на новый уровень, cmdBook определённо заслуживает места в вашей сборке.