ZNPCs: плагин для создания NPC в Minecraft
Зависимости: Тип сервера: Paper или Spigot 1.8.8–1.21.4 Версия Minecraft: 1.8.8–1.21.4 Зависимые плагины: PlaceholderAPI (необязательно…
Зависимости: Тип сервера: Paper или Spigot 1.8.8–1.21.4 Версия Minecraft: 1.8.8–1.21.4 Зависимые плагины: PlaceholderAPI (необязательно, для переменных в голограммах) Скачать: SpigotMC / GitHub Если вам нужны простые NP
Зависимости:
Тип сервера: Paper или Spigot 1.8.8–1.21.4
Версия Minecraft: 1.8.8–1.21.4
Зависимые плагины: PlaceholderAPI (необязательно, для переменных в голограммах)
Скачать: SpigotMC / GitHub
Если вам нужны простые NPC для лобби или декораций, Citizens может оказаться слишком тяжёлым. ZNPCs решает ту же задачу проще: это один файл .jar без кучи зависимостей, который позволяет ставить персонажей со своим скином, текстом и реакцией на клик.
Основные возможности
У всех NPC есть уникальный числовой ID. Можно создать обычного игрока со скином по нику или URL либо поставить моба вроде ZOMBIE или SKELETON.
Когда игрок кликает по NPC, плагин выполняет заданные действия. Это может быть сообщение, команда от имени игрока или консоли, либо даже отправка игрока на другой сервер через BungeeCord. Если действий несколько, они выполнятся по очереди. Вы также можете настроить кулдаун (задержку) для каждого действия.
Текст над головой (Lines)
Над NPC можно добавить текст с помощью команды lines. Плагин поддерживает цветовые коды, а если установлен PlaceholderAPI, то ещё и переменные, такие как %player_name% или %server_online%. Вы также можете изменить высоту текста командой height.
Маршруты (Paths)
NPC необязательно должен стоять на месте. Чтобы научить его ходить, нужно включить режим записи (/znpcs path create <название>) и пройти нужный маршрут самому. После завершения надо прописать /znpcs path exit. Далее этот маршрут назначается конкретному NPC (/znpcs path set <id> <название>), и тот начинает бесконечно по нему курсировать.
Важный нюанс: движение очень простое. ZNPCs не использует ванильный поиск пути (Pathfinder), поэтому персонажи не будут обходить препятствия и не будут реагировать на других игроков.
Снаряжение и внешний вид
Персонажей можно одеть в броню и дать им предметы в руки. Достаточно взять нужную вещь и прописать /znpcs equip <id> <слот> (доступные слоты: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Также есть возможность настроить поведение NPC через команду toggle: заставить его смотреть на ближайших игроков (look), отзеркаливать скин игрока, который смотрит на него (mirror), либо добавить подсветку (glow) выбранного цвета.
Команды
Эти команды требуют прав администратора (znpcs.admin).
Команда | Описание | Право |
| Создаёт NPC на ваших координатах | znpcs.admin |
| Удаляет NPC | znpcs.admin |
| Выводит список NPC и их ID | znpcs.admin |
| Телепортирует NPC к вам | znpcs.admin |
| Телепортирует вас к NPC | znpcs.admin |
| Меняет тип существующего NPC | znpcs.admin |
| Меняет скин персонажа | znpcs.admin |
| Даёт предмет из вашей руки NPC | znpcs.admin |
| Меняет текст над NPC | znpcs.admin |
| Меняет высоту текста (по умолчанию 1) | znpcs.admin |
| Добавляет действие при клике | znpcs.admin |
| Показывает список действий NPC (с их ID) | znpcs.admin |
| Удаляет действие по его ID | znpcs.admin |
| Устанавливает задержку на выполнение действия | znpcs.admin |
| Записывает новый маршрут | znpcs.admin |
| Выходит из режима записи маршрута | znpcs.admin |
| Назначает маршрут NPC | znpcs.admin |
| Включает/выключает опции (look, holo, mirror) | znpcs.admin |
| Добавляет эффект свечения выбранного цвета | znpcs.admin |
Типы действий для action add:
CMD (выполняет команду от имени игрока)
CONSOLE (выполняет команду от консоли)
CHAT (игрок пишет сообщение в чат)
MESSAGE (отправляет сообщение игроку)
SERVER (перебрасывает на другой сервер через BungeeCord)
Права доступа
Тут всё максимально просто. Почти для всего нужна лишь одна нода:
Нода | Что даёт |
znpcs.admin | Полный доступ ко всем командам |
Конфигурация
config.json
Параметр | Значение | Описание |
| 500 | Максимальное количество точек (шагов), которые можно записать для одного маршрута NPC. Если маршрут слишком длинный, запись автоматически остановится при достижении этого лимита. |
| "DEFAULT" | Алгоритм генерации внутренних имён для NPC. Стандартное значение обеспечивает корректную привязку ID. |
| TRUE | Автоматически выравнивает NPC точно по центру блока при его создании. Предотвращает смещение модели к краю блока. |
| "-" | Символ, который плагин использует для замены пробелов в тексте команд или при генерации идентификаторов. |
| 600 | Интервал автоматического сохранения созданных персонажей в файл npcs.json (600 секунд = 10 минут). Защищает от потери данных при внезапном падении сервера. |
| TRUE | Активация режима отладки. Плагин начнёт выводить подробную техническую информацию и логи ошибок в консоль сервера. Рекомендуется отключать (false) на стабильных серверах для чистоты консоли. |
| 0.3 | Расстояние между строками голограммы (текста) над головой NPC. Меньшее значение делает текст более плотным. |
| 32 | Радиус (в блоках), в пределах которого сервер начинает отправлять игроку пакеты для отрисовки модели NPC. Снижение значения экономит ресурсы сервера и клиента. |
| FALSE | Поддержка динамической смены цветов (переливание RGB) для текста голограмм. Включение может создавать дополнительную нагрузку на клиент. |
npcs.json
Все созданные NPC записываются в файл npcs.json. Плагин генерирует его автоматически, поэтому руками его лучше не редактировать. Единственное оправдание лезть в этот файл — когда вам нужно перенести настроенных NPC на другой сервер.
conversations.json
Все диалоги хранятся здесь.
paths
Папка, в которой хранятся все записанные маршруты.
data.json
Здесь хранится вся подробная информация о созданных NPC.
Интеграции
Если на сервере установлен PlaceholderAPI, ZNPCs подхватит его автоматически без специальных расширений. Это пригодится, например, если вы хотите вывести над NPC динамический счётчик онлайна.
Совместимость
Оригинальный ZNPCs нормально работает только до версии 1.21.1. Для более новых серверов (1.21.1 и выше) нужно ставить форк ZNPC Plus.
Также плагин не запустится на Folia из-за особенностей её работы с сущностями.
Когда стоит использовать ZNPCs
Если вам нужно поставить на спавне NPC, который просто будет открывать меню, выдавать стартовый набор или перебрасывать игроков на другие серверы мини-игр, ZNPCs — отличный выбор. Он делает ровно то, что обещает, и не нагружает сервер ненужным функционалом.
Но если вы планируете делать разветвлённые диалоги или сложные квесты, вам нужна экосистема Citizens + Denizen. ZNPCs для этого не предназначен.
Установка
Базовая установка занимает около 5 минут. Общий процесс одинаков, отличается только лоадер и совместимый билд.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.











