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 Якщо вам потрібні прості NPC
Залежності:
Тип сервера: 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, або поставити моба на кшталт зомбі чи скелета.
Коли гравець клікає по 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.
