Плагин для серверов Майнкрафт, который объединяет NPC, задания, магазины и спутников для ролевого сервера. Игрок разговаривает с NPC, принимает задание в чате, выполняет условия и сдаёт его тому же персонажу.
Возможности
- Создание постоянных NPC с экипировкой, сохранёнными скинами, анимациями и настройкой поворота к игрокам.
- NPC нельзя повредить, а обычная торговля жителей для них отключена.
- Основные цепочки и отдельные побочные задания с требованиями к уже выполненным заданиям.
- У заданий можно задать текст задачи, сдачу нескольких предметов, посещение NPC, опыт и предметные награды.
- Магазины, привязанные к NPC, с графическим меню покупки и продажи.
- Спутники для заданий: они следуют за игроком, могут помогать в бою, но не атакуют игроков. Для задания сопровождения задаются точка и радиус, после достижения которых спутник исчезает.
- Экипировку спутника можно передавать через меню; при завершении или провале задания она возвращается игроку.
Команды
- Создание NPC:
/pnpc npc create <name>. - Сохранение и назначение скина:
/pnpc skin save <skinId> <playerName>,/pnpc skin set <npcId> <skinId>. - Добавление реплики NPC:
/pv chat create <text...> [npcId]. - Создание основного или побочного задания:
/pv hauptquest create <name...> [npcId],/pv nebenquest create <name...> [npcId]. - Редактирование задания в интерактивном меню:
/pv quest edit <questId>. - Активация задания:
/pv quest end <questId>. - Выдача книги заданий:
/pv give questbook. - Привязка магазина к NPC:
/pshop bind <shopKey> <npcId>.
Игрок открывает диалог правой кнопкой мыши по NPC. В чате появляются кнопки принятия и сдачи задания; сдача доступна только после разговора с нужным NPC. Чтобы открыть экипировку своего спутника, нужно нажать Shift и правую кнопку мыши по нему.
Настройка
Данные хранятся в папке plugins/ProgressionNPCWork/. Задания лежат в quests/<id>.yml, реплики NPC — в npcs/<id>.yml, а магазины — в shops/*.yml.
Основные файлы настроек: config.yml, settings.yml, ui.yml, messages.yml, colors.yml, questbook.yml и tool_prices.yml. Для спутника в задании настраиваются параметры companion.enabled, companion.combat и companion.templateNpcId.
Требования
Плагин работает на Paper и требует Java 21, а также обязательный ProgressionAPI. Для скинов NPC и спутников нужны LibsDisguises и ProtocolLib. Покупка и продажа в магазинах требуют ProgressionEconomy.
