Citizens

Створюйте NPC (неігрових персонажів), схожих на гравців, з діалогами, маршрутами руху та інтеграцією з квестами. Основа RPG-серверів.

RPG та NPC SpigotPaperPurpur

Про Citizens

Citizens є плагіном для створення NPC (неігрових персонажів) на сервері Minecraft і керування ними. NPC виглядають як справжні гравці (з будь-яким скіном), але керує ними сервер. Вони можуть стояти на місці, ходити заданими маршрутами, вести діалоги, торгувати з гравцями й брати участь у квестах. На Citizens тримаються RPG- та MMO-сервери. NPC можуть мати різні ролі: крамар (продає й купує предмети), охоронець (атакує ворожих мобів), провідник (веде гравців маршрутом) або квестодавець (видає квести).

Плагін модульний. Сам по собі Citizens дає змогу створювати NPC і задавати їм маршрути руху. Denizen (окремий плагін) додає розширені скрипти, діалоги й механіки квестів. Також Citizens інтегрується з плагінами Sentinel (NPC-охоронці й бійці) і BetonQuest (система квестів).

Citizens належить до ключових RPG-плагінів, які варто розглянути, якщо ви адмініструєте сервер Minecraft. Він підтримує Minecraft 1.8.8 - 1.21.x і працює на Spigot, Paper і Purpur.

Можливості Citizens

Ось основні можливості, які Citizens додає на ваш сервер. Кожну з них можна налаштувати у файлі конфігурації плагіна.

NPC з будь-яким скіном
Маршрути руху (waypoints)
Інтеграція з Denizen (діалоги)
Різні типи NPC (крамар, охоронець)
Sentinel (бойові NPC)
Понад 20 типів сутностей

Команди Citizens

Ось 6 найважливіших команд Citizens. Повний список ви знайдете в офіційній документації. Пам'ятайте, що будь-яку команду можна заблокувати або дозволити через систему прав (наприклад, LuckPerms).

Команда	Опис	Право
`/npc create [ім'я]`	Створює нового NPC	`citizens.npc.create`
`/npc skin [гравець]`	Встановлює для NPC скін з акаунта гравця	`citizens.npc.skin`
`/npc select`	Вибирає NPC (клацніть по ньому правою кнопкою миші)	`citizens.npc.select`
`/npc remove`	Видаляє вибраного NPC	`citizens.npc.remove`
`/npc tphere`	Телепортує NPC до вас	`citizens.npc.tphere`
`/npc lookclose`	Змушує NPC дивитися на найближчого гравця	`citizens.npc.lookclose`

Порада: щоб побачити, які аргументи приймає команда, скористайтеся автодоповненням у серверній консолі (клавіша Tab). На сервері з LuckPerms видавайте права групам, а не окремим гравцям.

Права

Система прав дає змогу визначити, хто може користуватися кожною функцією Citizens. Права видають через плагін рангів, наприклад LuckPerms (/lp group [група] permission set [вузол] true). Стовпець «OP за замовчуванням» показує, чи отримують оператори це право автоматично, без жодних налаштувань.

Вузол права	Опис	OP за замовчуванням
`citizens.npc.create`	Створення NPC	Так
`citizens.npc.edit`	Редагування NPC	Так
`citizens.npc.remove`	Видалення NPC	Так

Конфігурація Citizens

Під час першого запуску Citizens створює файл конфігурації в теці plugins/Citizens/. Нижче наведено найважливіші параметри з коментарями. Повний список налаштувань є в офіційній документації.

# config.yml плагіна Citizens
npc:
  default:
    look-close:
      enabled: false       # За замовчуванням NPC не дивляться на гравців
      range: 5             # Дальність погляду
    pathfinding:
      enabled: true
      attack-range: 1.75   # Дальність атаки охоронців
  max-npcs-per-player: 10  # Ліміт NPC на одного гравця

Змінивши конфігурацію, збережіть файл і виконайте команду перезавантаження (наприклад, /reload або власну команду перезавантаження плагіна). Якщо після перезавантаження плагін не підхопив змін, перезапустіть сервер: зупиніть його командою /stop і запустіть знову.

YAML не прощає помилок. Один неправильний пробіл чи символ табуляції може зламати весь файл. Користуйтеся редактором із підсвічуванням синтаксису (VS Code, Notepad++) і перевіряйте файл на yamllint.com, перш ніж завантажити його на сервер.

Як встановити Citizens

Завантажте Citizens з офіційного сайту. Переконайтеся, що завантажена версія сумісна з вашою версією Minecraft (1.8.8 - 1.21.x).
Скопіюйте завантажений файл .jar у теку plugins/ серверної директорії.
Зупиніть сервер командою /stop і запустіть його знову. Для першого встановлення не використовуйте /reload.
Перегляньте серверну консоль. Якщо Citizens завантажився правильно, ви побачите повідомлення з версією плагіна. Якщо з'явилася помилка, перевірте, чи встановлено всі залежності.
Налаштуйте плагін, відредагувавши plugins/Citizens/config.yml (або відповідний файл). Після змін виконайте команду перезавантаження.

Сумісність із серверами: Citizens працює на Spigot, Paper і Purpur. Як серверне ядро радимо Paper: у нього краща продуктивність і більше API, ніж у Spigot.

Альтернативи Citizens

Citizens не єдиний плагін у своїй категорії. Нижче наведено альтернативи, які варто розглянути, якщо ви шукаєте щось інше або Citizens не відповідає вашим потребам.

FancyNPCs

Легша альтернатива з мінімалістичним підходом до створення NPC.

ZNPCsPlus

Сучасний плагін для NPC на основі пакетів, який працює без ProtocolLib.

Часті запитання про Citizens

Як встановити Citizens?

Завантажте Citizens з офіційного CI-сервера. Покладіть файл .jar у теку plugins/ і перезапустіть сервер. Створюйте NPC командою /npc create [ім'я]. Для діалогів і квестів встановіть Denizen або BetonQuest. Докладну інструкцію разом із залежностями й конфігурацією ви знайдете вище, у розділі про встановлення.

На яких серверних ядрах працює Citizens?

Citizens працює на таких ядрах: Spigot, Paper, Purpur. Радимо вибрати ядро Paper: для більшості серверів воно дає найкращий баланс між продуктивністю та сумісністю з плагінами. Більше про серверні ядра читайте в нашому порівнянні.

Чи безкоштовний Citizens?

Citizens можна завантажити з офіційного сайту. Умови ліцензії перевірте на сторінці завантаження.

Citizens не працює. Що робити?

Перегляньте файл logs/latest.log у серверній директорії. Найчастіші причини помилок: (1) відсутня залежність, (2) несумісна версія Minecraft (перевірте, чи версія на вашому сервері входить у діапазон 1.8.8 - 1.21.x), (3) помилка в config.yml (перевірте форматування YAML), (4) конфлікт з іншим плагіном, який робить те саме.

Чи можна використовувати Citizens на сервері Bedrock?

Ні. Citizens є плагіном для Java Edition і працює на серверах Spigot/Paper/Purpur. Bedrock Edition використовує іншу систему (пакети поведінки). Якщо ви хочете, щоб гравці Java та Bedrock грали на одному сервері, зверніть увагу на Geyser.