Плагин для серверов Майнкрафт, который добавляет управляемых NPC — персонажей с внешностью игрока. Их можно настраивать прямо в игре, назначать действия на клики, самостоятельное поведение и маршруты перемещения.
Возможности
- Редактор NPC в игровом меню: имя, скин, экипировка, поза, свечение, видимость, отображение в списке игроков, масштаб и другие параметры.
- Скины можно брать у игрока, по UUID, из локального файла
.png, по URL, из.ymlили через PlaceholderAPI. - Отдельные цепочки действий для левого, правого и обоих кликов: выполнение команд, отправка на сервер BungeeCord, ожидание, анимации, движение по пути, условия, циклы, переменные и изменение параметров NPC.
- NPC умеют идти к точке, проходить сохранённый маршрут, следовать за сущностью, атаковать цель, осматриваться, ждать и бесцельно ходить в заданном радиусе.
- Маршрут создаётся из точек или записывается во время ходьбы; его можно визуализировать, проверить временным NPC и использовать повторно.
- Поддерживаются локальные переменные игрока, переменные конкретного NPC и общие переменные сервера. Их значения можно использовать в условиях и математических выражениях.
- PlaceholderAPI работает как необязательная зависимость: плейсхолдеры доступны в сообщениях и подходящих настройках плагина.
Команды
/npc create [options]— создать NPC./npc edit [npc]— включить режим редактирования или открыть редактор выбранного NPC. В режиме редактирования нажмите ПКМ по персонажу./npc list— открыть список NPC./npc copy <npc>— скопировать NPC./npc delete <npc> [force]— удалить NPC./npc tp <npc> [location] [rotation]и/npc tphere <npc>— переместить NPC./npc reload [npc]— перезагрузить NPC./npc cancel <npc>или/npc cancel all— остановить цепочку действий./npc tag <npc> add|remove|list <tag>— управлять тегами NPC./npc animation <animation> [targets]— запустить анимацию./npc path point add— добавить точку маршрута;/npc path create <name>— сохранить маршрут;/npc path visualize <name>— показать его;/npc path test <name> [speed]— проверить./npc path record startи/npc path record stop— записать маршрут во время ходьбы./npc movement record start|stop— записать движение,/npc movement play <name> [target] [speed]— воспроизвести запись./npc wait <player> <name> [values...]— продолжить действие типа ожидания, настроенное на внешний вызов./npc variable list|get|set|delete— управлять общими переменными.
Права
Для открытия редактора NPC требуется право npc.admin. Также NPC должен быть отмечен как редактируемый.
Настройка
Основной файл: plugins/NpcPlugin/config.yml. В нём настраиваются частота обновления взгляда на игрока и плейсхолдеров, проверка команд, отладка, время ввода, дальность показа идущих NPC, загрузка чанков на маршруте и поиск пути.
Пути хранятся в plugins/NpcPlugin/paths.yml, а общие переменные — в global-variables.yml. Языковые файлы находятся в plugins/NpcPlugin/lang/<language>/*.json; исходный язык — en_US.
Требования
Плагин работает на серверах Spigot, Paper и Purpur. Для действия отправки игрока на другой сервер нужен настроенный BungeeCord, а названия серверов должны совпадать с настройками прокси. Для использования событий плагина в Skript требуется Skript-Reflect.
