Платно Ultimate Quests 1.0.0

UltimateQuests - плагин квестов, где квест и есть событие. Большинство квестовых плагинов следят за инвентарём и щёлкают счётчик. Здесь шаг выбирает точку на карте, отмечает её игроку и строит на ней что-то: патрульный вертолёт над сброшенным грузом, шестерых стрелков, окопавшихся за кромкой леса, акулу над ящиком на дне. Зачистить, забрать содержимое и донести до того, кто послал.

Зона принадлежит тому, кто взял квест, и ставится в тот момент, когда он его берёт, поэтому двое на одном и том же квесте не топчутся в одном поле, а следующий игрок уйдёт в другое место. Из 45 квестов в комплекте 17 разворачивают такую зону, ещё два ставят на точку разделки, которую надо удерживать в открытую, и один выдаёт добычу, которую любой убивший заберёт с трупа. Остальное - добыча, крафт и охота, которые их питают.

Все 45 идут вместе с плагином на английском и русском и выложены в дерево, которое раскрывается по мере прохождения. Как они попадут к игроку - решать вам: квестодатели стоят у памятников, к ним нужно подойти и поговорить, либо меню раздаёт ту же работу, и на карте нет ни одного NPC. Оба трека садятся в ServerPanel отдельной категорией, если он у вас стоит. Всё остальное тоже ваше: цели, диалоги, награды, зоны и то, где стоят NPC.


Возможности UltimateQuests

• Любой шаг может развернуть собственное событие: плагин ставит зону, отмечает её на карте, спавнит всё, что в ней живёт, и убирает целиком, когда шаг закончен.
• Что бывает в зоне: волны NPC по вашим пресетам, звери, патрульный вертолёт, ящики с вашим содержимым и лут, запертый до зачистки территории или до конца таймера выживания.
• Зоны ставятся сами, каждому игроку и каждый раз заново. Выберите Sea, Land, Beach, Monument или базу самого игрока, и плагин подберёт подходящее место рядом с квестодателем. Режим PlayerBase превращает шаг в оборону: чужие выходят из леса к стенам самого игрока.
• Два способа поставить между игроками других игроков: добыча-переносчик, которая едет в инвентаре, пока её не заберут с трупа, и точки разделки, которые надо удерживать пару минут в открытую.
• 45 квестов у трёх квестодателей — торговца, фермера и охотника — на английском и русском, выложенных в дерево с требованиями и сложностью, где каждый узел читается как доступный, активный, выполненный, закрытый или VIP.
• 21 тип цели: добыча, охота, рыбалка, крафт, переработка, карты-пропуска, взлом ящиков, доставка груза и другие.
• Два трека, переключаются одним полем конфига. В режиме Npc квестодатели стоят у памятников, на карточке написано, в какой квадрат идти, а работа предлагается в ветвящемся разговоре и сдаётся лично. В режиме Menu никто не спавнится, и всё происходит в панели, включая дерево квестов.
• Любой из треков садится в ServerPanel отдельной категорией или живёт сам по себе на полноэкранной раскладке плагина. Всего четыре шкурки: полный экран и ServerPanel V1, V2 и V4, выбираются автоматически по вашему шаблону.
• HUD-трекер текущего шага, маркеры на карте и указатели в мире на зоны, ящики и точки разделки.
• Награды предметами или консольными командами, с шансом выпадения, скрытыми наградами, чертежами, обвесами на оружие и генами растений.
• Засчёт шагов больше чем от 30 ивент-плагинов: победа в Convoy, Caravan, ArmoredTrain или на Raidable Base закрывает шаг квеста.
• Логирование выполненных квестов в консоль, файл, чат и Discord-вебхук.

Команды

• /quest (или /quests) – открыть список квестов
• /questlist – открыть уже взятые квесты
• /questhud – включить или выключить HUD-трекер
• /uq – команды администратора. /uq help выводит полный список: create, quest create, start, move, rotate, save, cancel, teleport, spawn, kill, list, reloadnpcs, complete

Права доступа

• ultimatequests.admin – команды администратора и режим правки NPC

Отдельному квесту можно назначить своё право. Впишите любое имя в профиль: плагин зарегистрирует его при загрузке и покажет квест как VIP-узел всем, у кого этого права нет.

Квесты в комплекте

• Хэл Бранниган, Торговец – 15 квестов. Достать затонувший груз, перехватить чужой товар, набить склад и вооружить тех, кто его стережёт.
• Рой Хэтчер, Фермер – 15 квестов. Теплицы, вода, куры и яйца, и налётчики, которых хороший урожай приводит к воротам.
• Уэйд Кестрел, Охотник – 15 квестов. Выслеживать и разделывать зверя, брать трофеи и выгонять чужую артель из дельты.

Пять из них, чтобы было видно, как здесь устроен квест:

• На дне – Хэл отмечает место погружения в трёхстах метрах от себя: настоящее дно, не меньше восьми метров глубины. На дно ложится запечатанный ящик, над ним ходит акула. Вскрыть его там, внизу, и донести контейнер Хэлу в руки.
• Под прицелом – сброс груза на открытом месте. Пока контейнер не вскрыт, не происходит ничего: вскрытие взводит зону, запускает отсчёт на шестьдесят секунд и приводит патрульный вертолёт. Лут заперт всю эту минуту, так что сначала её надо пережить.
• Дом нашли – сперва две турели на доме. Потом зона ставится на вашу собственную постройку, и через пятнадцать секунд из леса двумя волнами выходят шестеро: трое с винтовками, трое с дробовиками. Спавнятся не ближе двадцати пяти метров — увидеть их вы успеете.
• Артель – чужаки окопались на пятачке в двадцать восемь метров там, где обрывается лес. Шесть стрелков в двух волнах, и появляются они вокруг вас, а не в центре зоны. Элитный ящик заперт, пока не ляжет последний, а ящики за пределами зоны не считаются.
• Разделать дочиста – три медведя у кромки леса, двадцать жира с туш, а потом разделочная колода Роя: круг в восемь метров, который надо удерживать две-три минуты в открытую. То, что с него сходит, едет домой в инвентаре, и любой убивший заберёт это себе.

Квесты лежат в «data/UltimateQuests/Profiles/*.json», по файлу на каждого NPC. Правьте их, добавляйте свои или снесите всё и начните заново.

Витрина

Видео

Редактор в игре

NPC расставляются в игре, а не в конфиге. Встаньте туда, где хотите его видеть, и введите «/uq create <имя>», затем «/uq start <id>», чтобы войти в режим правки и подвинуть его через «/uq move» и «/uq rotate». Команда «/uq save» запишет место как смещение от ближайшего памятника, поэтому NPC встанет в тот же угол этого памятника на любой карте после вайпа.


Веб-редактор конфига

Настройки UltimateQuests удобно править в нашем веб-редакторе конфигов. Он даёт понятный интерфейс вместо ручной правки файлов на сервере.

Редактор открывает все три типа файлов UltimateQuests: основной конфиг, профиль NPC с его квестами и файл статистики. Квесты, шаги, награды, деревья диалогов, ивент-зоны, точки спавна NPC, фильтры дерева, HUD, маркеры, ограничения, звуки, логирование и переводы — у каждого своя форма, так что цепочку квестов можно собрать, ни разу не открыв JSON.


P.S. Зайдите в наш Discord https://discord.gg/mevent и запросите группу «UltimateQuests», чтобы получить доступ к веб-редактору конфигов.

Тестовый сервер

Присоединяйтесь к нашему тестовому серверу и опробуйте все возможности самостоятельно!
Скопируйте IP-адрес ниже, чтобы начать играть!

Код:
connect 194.147.90.239:28015

FAQ

В: Обязательно ли использовать NPC?
О: Нет. Поле «Quest Mode» в конфиге принимает «Npc» или «Menu», по умолчанию стоит «Menu». В режиме «Npc» квестодатели спавнятся у своих памятников, на каждой карточке в списке написан квадрат, где их искать, а взять работу, сдать её, забрать награду или отказаться можно только лично. Если попробовать из меню, плагин ответит: «Это делается только лично. Иди к заказчику.» В режиме «Menu» не спавнится ни одного NPC, те же 45 квестов берутся и сдаются прямо в панели, а у каждого квестодателя на карточке появляется кнопка дерева квестов.

В: Меняется ли от этого встраивание в ServerPanel?
О: Нет, оба трека рисуются категорией ServerPanel, и плагин сам читает ваш шаблон и подбирает подходящую раскладку. Отличается только содержимое карточек: в режиме «Npc» это место, куда идти, в режиме «Menu» — полоса прогресса и дерево. Без ServerPanel любой из треков открывается на собственной полноэкранной раскладке плагина по команде в чате.

В: Что будет, если десять игроков возьмут один и тот же зонный квест разом?
О: Каждый получит свою зону, поставленную отдельно, со своими NPC и своим лутом. Зона убирается, когда шаг завершён, когда игрок отказался от квеста, когда он вышел с сервера и когда плагин выгружается, так что на карте после неё ничего не остаётся.

В: NPC стоят, а квестов у них нет. Что не так?
О: На сервер не попала папка «data» из архива. Плагин не создаёт контент квестов сам, поэтому скопируйте папку целиком, чтобы профили легли в «oxide/data/UltimateQuests/Profiles/*.json» (или «carbon/data/»). Имя файла профиля должно в точности совпадать с именем NPC в конфиге, так что если переименовали NPC, переименуйте и его файл.

В: Какие ещё плагины нужны?
О: ImageLibrary для аватаров и иконок квестов. NpcSpawn, если нужны враждебные волны внутри ивент-зон: без него зона всё равно срабатывает, отсчитывает таймер и запирает лут, просто NPC в ней не будет. MonumentFinder для зон и NPC, которые ставятся по памятнику.

В: Как добавить UltimateQuests в меню ServerPanel?
О: В ServerPanel создайте категорию с Type: Plugin, Plugin Name: UltimateQuests, Plugin Hook: API_OpenPlugin. Раскладка подберётся по вашему шаблону ServerPanel сама (t1 и t1_1 дают V1, t2 даёт V2, t4 даёт V4), всё остальное откатывается на полноэкранную. Пока эта категория существует, команды в чате открывают именно её, а не отдельный интерфейс.

В: У игроков появляется сообщение «The plugin does not work correctly, contact the administrator!». Как исправить?
О: Эта ошибка появляется, когда плагин ImageLibrary работает неправильно. Что сделать:

• Установите плагин ImageLibrary, если его ещё нет.
• Убедитесь, что ImageLibrary загружен и работает (проверьте командой o.plugins).
• Перезапустите сервер после установки ImageLibrary.
• Проверьте консоль сервера на ошибки ImageLibrary и устраните их.

В: Я вижу чёрные картинки с логотипом Rust или ошибку 429 при загрузке изображений. Что делать?
О: Это происходит из-за проблем со скачиванием картинок из интернета. Плагин UltimateQuests передаёт картинки в ImageLibrary, но сам за скачивание не отвечает. Ошибка 429 обычно приходит из-за лимитов на стороне хостинга картинок вроде Imgur. Переведите плагин на локальные картинки:

1. Подготовьте картинки:
   • Создайте папку «TheMevent» в «oxide/data» (или «carbon/data» для Carbon)
   • Скачайте PluginsStorage (кнопка «CODE» → «Download ZIP»)
   • Распакуйте архив и скопируйте всё содержимое в папку «TheMevent»
2. Включите «Enable Offline Image Mode» в конфиге
3. Перезагрузите плагин:
   • Введите o.reload UltimateQuests (Oxide) или c.reload UltimateQuests (Carbon)

Примечание: Свои картинки кладите в папку «TheMevent» и указывайте их с префиксом «TheMevent/». Например: «TheMevent/Icon1.png», «TheMevent/MyCustomIcon.jpg».

В: Где менять названия или добавить свой язык?
О: Правьте lang-файлы, например «oxide/lang/ru/UltimateQuests.json» или «carbon/lang/ru/UltimateQuests.json». Английский файл сопоставляет каждому ключу его же текст, поэтому заодно служит шаблоном для перевода: скопируйте его в «lang/<код>/UltimateQuests.json» и переводите только значения. Ключи не трогайте, именно по ним плагин находит перевод. Русский идёт в комплекте, игроки с любым другим языком клиента видят английский текст.

В: Что можно положить в награду-команду?
О: Любую консольную команду, где «%steamid%» подставляется под игрока. Так же выдаётся и ранг за пройденную цепочку, например «o.grant user %steamid% yourplugin.vip».

API

Хуки, которые плагин вызывает для других плагинов: