Плагин NPC NPCPro - A Premium NPCs for your Network/Servers [1.21.x - 26.3] [1.10]

Особенности плагина NPCPro:​

NPC на пакетах — без Bukkit-сущностей, тиков ИИ и засорения таблицы счёта (scoreboard).

• NPC в виде игроков со скинами Mojang и пакетные мобы: VILLAGER, ZOMBIE, SHEEP, RAINBOW_SHEEP, CUSTOM_MOB.
• Индивидуальные для каждого игрока скины, экипировка, позы (стоя, присев, лёжа, плавание, сидя) и транспорт.
• Отслеживание взгляда игрока, анимации бездействия и движения рук мобов при ходьбе.

MiniMessage повсюду

• Градиенты, RGB HEX-цвета, события наведения и клика, а также PlaceholderAPI во всех именах, строках голограмм и сообщениях.

Действия при нажатии — левый и правый клик, полностью настраиваемые для каждого NPC через npcs.yml или прямо в игре:

• command / console — выполнение любой команды (открытие сторонних магазинов, меню, варпов и т. д.).
• open-menu — встроенные меню на основе сундуков (файлы menus/*.yml) с действиями для предметов.
• connect/server — отправка игрока на другой сервер через Velocity.
• quest — интеграция с плагинами Quests, BetonQuest и NotQuests.
• message, title, actionbar, sound, give-item, teleport, warp — отправка сообщений, заголовков, текста в actionbar, воспроизведение звуков, выдача предметов, телепортация и перемещение на варп.
• chain — последовательное выполнение действий, random — случайный выбор с настраиваемыми весами.
• Перезарядки для NPC, действий и отдельных игроков, а также условия по правам, мирам и плейсхолдерам PlaceholderAPI.

Патрули с полноценным поиском пути — полностью асинхронные:

• Режимы маршрутов: LOOP, PINGPONG, ONCE, с паузами на каждой точке и настраиваемой скоростью.
• NPC обходят стены, поднимаются по лестницам, не срезают углы и могут спускаться максимум на 3 блока.
• Плавные повороты и перемещение через пакетную телепортацию с частотой 20 раз в секунду.

Встроенные голограммы — на основе DecentHolograms:

• Многострочные голограммы с поддержкой MiniMessage и PlaceholderAPI, индивидуальными смещениями и интервалами между строками.
• Полноценный редактор прямо в игре: добавление, изменение, вставка, перестановка и удаление строк, настройка смещения и интервалов, просмотр списка.
• Голограммы сохраняются при выгрузке чанков и переключении серверов.

Интеграция с Velocity — через встроенный канал BungeeCord, без дополнительных плагинов на прокси:

• Подканалы Connect, PlayerCount, GetServers с кэшированием количества игроков на серверах (%npc_server_count_<server>%).
• Синхронизация между лобби через MySQL — изменения в реальном времени распространяются на все серверы через встроенный подканал Forward ALL. Дополнительный плагин на прокси не требуется.

Масштабируемость и производительность

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

Права плагина NPCPro:​

• npc.command.use — доступ к команде /npc.
• npc.admin — все права плагина, включая перечисленные ниже.
• npc.command.create / remove / move / skin / hologram / tp / reload / list / edit / server / animation / migrate — права на создание, удаление, перемещение, настройку скинов и голограмм, телепортацию, перезагрузку, просмотр списка, редактирование, настройку серверов, анимаций и миграцию NPC.
• npc.command.edit — доступ к инструменту редактирования, настройке поз, экипировки, транспорта, патрулей и привязке действий.

Конфигурация плагина NPCPro:​

• config.yml — настройки по умолчанию, дальность видимости, кэширование, способ хранения данных (YAML/MySQL), канал Velocity и интеграции.
• messages.yml — все отображаемые игрокам сообщения с поддержкой MiniMessage. Автоматически обновляется при обновлении плагина.
• npcs.yml — настройки NPC, их действия и голограммы. Поддерживает автоматическое сохранение и восстановление конфигурации.
• menus/*.yml — меню на основе сундуков (GUI), которые можно привязать к NPC.
• dialogs/*.yml — диалоговые меню (GUI), которые можно привязать к NPC.

Плэйсхолдеры плагина NPCPro:​

Для PlaceholderAPI регистрируется собственное расширение с префиксом npc_ (требуется установленный PlaceholderAPI):

• %npc_count% — количество зарегистрированных на сервере NPC.
• %npc_server_count_<server>% — закэшированное количество игроков онлайн на сервере Velocity (например, %npc_server_count_survival%).
• %npc_proxy_detected% — true/false, обнаружена ли прокси-сеть (Velocity).

Все имена NPC, строки голограмм и сообщения обрабатываются через PlaceholderAPI. Это позволяет использовать плейсхолдеры других плагинов, например %vault_eco_balance% и %luckperms_primary_group_name%.

Установка плагина NPCPro:​

1. Скачайте плагин.
2. Выключите сервер
3. Переместите файл .jar в папку /plugins/ вашего сервера.
4. Установите плагины PacketEvents и DecentHolograms — они обязательны для работы NPCPro.
5. Запустите сервер.
6. Готово.