NPC Plugin

NPC Plugin - это мощный инструмент для администраторов серверов Minecraft, который даёт возможность создавать живых, интерактивных персонажей прямо в игре. Забудьте про сложные конфиги и командные блоки - здесь всё настраивается через понятный GUI-редактор.

Зачем это нужно

Любой сервер с RPG-механиками, квестами, мини-играми или торговыми зонами нуждается в NPC. Обычно для этого используют костыльные решения: арморстенды, невидимые мобы или плагины с минимальным функционалом. NPC Plugin решает эту проблему радикально: вы получаете полноценных персонажей, которые выглядят как игроки, могут ходить по заданным маршрутам, реагировать на клики и даже атаковать мобов.

Плагин работает на Paper (версии 1.21-26.2) и Spigot (1.20.6-26.2). Важный момент: билд для Paper сейчас помечен как -SNAPSHOT из-за альфа-стадии версии 26.3, так что могут быть баги. Если обновляетесь с версии старше 2.1.0, сначала поставьте промежуточную версию из диапазона 2.1.0-2.4.2, иначе данные слетят.

Основные возможности

Редактор NPC прямо в игре

Создать персонажа можно командой /npc create, а затем /npc edit включает режим редактирования. Кликаете правой кнопкой по NPC - открывается GUI, где можно:

• Поменять имя и скин (через ник игрока, UUID, локальный .png, URL или файл .yml)
• Настроить экипировку (броня, предметы в руках)
• Включить свечение с выбором цвета
• Скрыть из таб-листа или убрать имя над головой
• Задать позу (стоя, сидя, лёжа)
• Настроить масштаб (Scale)
• Включить поворот головы к игрокам в заданном радиусе
• Телепортировать NPC к себе или себя к NPC

Если нужен скин конкретного игрока - есть опция "Use Player Skin", которая применяет скин индивидуально для каждого зашедшего на сервер.

Система действий по клику

Самая мощная фича плагина - это Click Actions. Вы создаёте цепочки действий для левого, правого или обоих кликов сразу. Например, NPC-торговец может открыть GUI магазина, а NPC-квестодатель - выдать задание и телепортнуть игрока.

Доступные типы действий:

• Command - выполняет команду от имени игрока или консоли. Поддерживает плейсхолдеры {player}, {player_name} и переменные.
• Server - отправляет игрока на другой сервер BungeeCord (полезно для лобби).
• Wait - пауза в цепочке. Можно настроить задержку по времени (от 0.05 до 600 секунд) или ждать триггера через команду /npc wait <player> <name>.
• Path - NPC идёт по сохранённому маршруту. Можно задать скорость (0.01-1.0) и включить опцию "Change real location", чтобы NPC действительно переместился, а не просто сыграл анимацию.
• Animation - проигрывает анимацию (взмах рукой, поклон и т.д.).
• SetVariable - устанавливает числовую переменную. Бывают локальные (для игрока), instance (для конкретного NPC) и глобальные (сохраняются в global-variables.yml).
• Condition - запускает подцепочку действий, если выражение истинно.
• Loop - повторяет подцепочку в цикле (while или for).
• Npc - применяет настройки NPC как действие. Можно менять внешний вид персонажа только для кликнувшего игрока или для всех.
• Stop - останавливает цепочку.

Действия можно переставлять, удалять средней кнопкой мыши и добавлять через Shift+ЛКМ. Есть опция Run on show - цепочка запустится не при клике, а когда NPC появится перед игроком.

Система путей (Path System)

Хотите, чтобы NPC патрулировал территорию или ходил между точками? Создайте маршрут двумя способами:

1. Через точки

• Добавляете точки командой /npc path point add в нужных местах
• Визуализируете их через /npc path visualize points
• Создаёте путь: /npc path create <название>

2. Запись движения

• /npc path record start - начинаете запись
• Идёте по маршруту
• /npc path record stop - останавливаете
• /npc path create <название> - сохраняете

Пути хранятся в plugins/NpcPlugin/paths.yml и могут использоваться любым NPC. Можно протестировать маршрут командой /npc path test <название> [скорость] - появится временный NPC, который пройдёт путь.

AI-цели (Goals)

NPC Plugin поддерживает автономное поведение через систему целей:

• Walk to Location - идёт к указанной точке через pathfinding
• Walk Path - ходит по сохранённому маршруту
• Follow Entity - следует за существом по UUID
• Attack Entity - атакует подходящих мобов в радиусе
• Look Around - случайно оглядывается (эффект живого персонажа)
• Wait - стоит на месте заданное время
• Wander - бродит в пределах радиуса

Для цели Attack Entity можно задать условия через выражения. Например, атаковать только зомби ближе 5 блоков:

$distance < 5 && [if entity @s[type=zombie]]

Доступные переменные: $distance, $entity.x/y/z, $entity.health, $npc.x/y/z.

Парсер выражений

Плагин использует математический парсер для переменных и условий. Поддерживаются:

• Операторы: +, -, *, /, ^, &&, ||, !, ==, !=, <, >, <=, >=
• Функции: sin(), cos(), sqrt(), abs(), round(), floor() и другие
• Константы: PI, E
• Переменные: $varName (автоопределение), $global.varName, $instance.varName, $local.varName
• Специальные переменные: $self.rightClick, $self.sneaking, $self.op, $loop.index

Можно выполнять команды внутри выражений:

2 + (/count players)

Это открывает возможности для сложной логики: проверки баланса игрока, подсчёта онлайна, условных наград.

Команды и управление

Базовые команды:

• /npc create [опции] - создать NPC с параметрами вроде --name "Торговец"
• /npc edit - включить режим редактирования
• /npc list - открыть список всех NPC
• /npc tp <npc> - телепортироваться к NPC
• /npc delete <npc> - удалить NPC
• /npc reload - перезагрузить конфиг

Переменные:

• /npc variable list - список глобальных переменных
• /npc variable set <название> <выражение> - установить значение
• /npc variable delete <название> - удалить переменную

Пути:

• /npc path point add - добавить точку маршрута
• /npc path create <название> - создать путь
• /npc path visualize <название> - показать маршрут

Селекторы (как в командных блоках):

Плагин поддерживает Minecraft-селекторы для массовых операций:

• @a - все NPC
• @n / @p - ближайший NPC
• @r - случайный NPC
• Фильтры: tag=<значение>, distance=<мин>..<макс>, limit=<число>

Пример:

/npc execute as @a[tag=guard,distance=..10] do animation WAVE

Все охранники в радиусе 10 блоков взмахнут рукой.

Интеграция с другими плагинами

PlaceholderAPI - мягкая зависимость, можно использовать плейсхолдеры в сообщениях и настройках.

BungeeCord - действие Server отправляет игроков между серверами сети.

Skript - через плагин Skript-Reflect можно ловить события:

• NpcInteractEvent - клик по NPC
• NpcShowEvent - NPC появился перед игроком
• NpcStartWalkingEvent - NPC начал движение

Пример скрипта:

import:
  de.eisi05.npc.api.events.NpcInteractEvent

on NpcInteractEvent:
    set {_player} to event.getPlayer()
    send "Привет!" to {_player}

Настройки (config.yml)

• look-at-update-interval - как часто NPC поворачивает голову к игрокам (в тиках)
• walking-viewer-distance - на каком расстоянии игроки видят идущих NPC
• placeholder-timer - частота обновления плейсхолдеров
• pathfinding-factory - алгоритм поиска пути. ASTAR (быстрый) или BOUNDING_BOX <шаг> (точный, учитывает коллизии нестандартных блоков вроде полок)
• load-chunks-on-path - подгружать ли чанки по маршруту NPC
• auto-update - автоматически применять изменения к NPC без перезагрузки

Типичные проблемы

"This plugin does not support Paper servers!"

Вы поставили Spigot-версию плагина на Paper. Скачайте Paper-билд отдельно.

Server-действие не работает

Убедитесь, что BungeeCord настроен и название сервера совпадает с конфигом прокси.

Не открывается редактор

Проверьте:

• Есть ли права npc.admin
• Включён ли режим редактирования (/npc edit)
• Не заблокирован ли NPC для редактирования

NPC не идёт по пути

Включите check-path: true в конфиге - плагин проверит, есть ли твёрдые блоки под точками маршрута. Если путь проходит через воздух, NPC застрянет.

Установка на сервер через BungeeHost

Если хотите запустить сервер с NPC Plugin для игры с друзьями, удобнее всего использовать хостинг серверов Майнкрафт BungeeHost. Там плагин устанавливается в один клик через панель управления - не нужно вручную загружать файлы и настраивать FTP. Просто выбираете Paper или Spigot, добавляете плагин из каталога, и сервер готов. Подходит для RP-серверов, квестовых карт и любых проектов, где нужны интерактивные персонажи.

Для кого этот плагин

• Администраторы RP-серверов - создавайте торговцев, квестодателей, охранников с минимальными усилиями.
• Разработчики мини-игр - NPC могут выдавать задания, телепортировать игроков между аренами, вести счёт через переменные.
• Билдеры и креаторы карт - оживите постройки персонажами с уникальными маршрутами и поведением.

Плагин NPC Plugin превращает статичный мир Minecraft в динамичное пространство с живыми персонажами, которые реагируют на игроков, ходят по своим делам и выполняют сценарии. Скачать плагин NPC можно прямо на этой странице - поддерживаются все актуальные версии Paper и Spigot.