Ръководство

Как да направиш Minecraft плъгин за куестове

Обновено на 18 октомври 2026 г.

Куестовете дават на играчите причина да играят: убий 20 зомбита, изкопай 64 желязо, донеси на селянин 10 хляба. Плъгинът за куестове е три неща: цели, които слушат събитията в играта, напредък, запазен за всеки играч, и награди. Когато описваш куестовете в конфигурационен файл, можеш да добавяш нови, без да пипаш кода.

Смени куестовете и наградите със своите.

Генерирай това с Codexe

Стъпка по стъпка

  1. 1.Избери видовете цели

    Започни с няколко: убий даден тип моб, чупи или поставяй блокове, събери предмети, изработи, стигни до място, говори с NPC. Всеки куест се гради от тях.

  2. 2.Опиши куестовете във файл

    Всеки куест в quests.yml: id, име, описание, целите му с бройки, награди и изисквания (първо друг куест, permission, ниво).

  3. 3.Следи напредъка на всеки играч

    Слушай събитията зад всяка цел и добавяй към напредъка на играча. Запазвай го в SQLite или във файл, за да оцелява след излизане и рестарти.

  4. 4.Покажи напредъка

    Меню /quests с активните и завършените куестове, плюс съобщение, заглавие или boss bar, когато напредъкът се промени.

  5. 5.Давай награди

    Предмети, опит, пари през Vault или конзолни команди като lp user %player% permission set ... за всичко останало.

  6. 6.Компилирай и завърши куест в играта

    Остави Codexe да го компилира, влез в тестовия сървър, приеми куест и го завърши. После рестартирай и провери дали напредъкът и наградите са запазени.

Целите и събитията зад тях

ЦелСъбитиеДетайл за решаване
Убий мобовеEntityDeathEventБроят се само убийствата от играча или и тези от неговите любимци и стрели
Чупи блоковеBlockBreakEventПренебрегвай блоковете, поставени от играча, иначе играчите ще поставят и чупят един и същ блок
Събери предметиПроверка на инвентара или събитие за вдиганеДали предметите се взимат, когато куестът се предаде
Изработи предметиCraftItemEventИзработването с shift-клик прави няколко наведнъж
Стигни до мястоPlayerMoveEventПроверявай само когато играчът смени блока, не при всяко движение
Говори с NPCPlayerInteractEntityEventКое същество дава куеста

Даващи куестове

Най-простият даващ куестове е команда или меню. За персонаж в света селянин или armor stand със собствено име и таг в PersistentDataContainer работи без други плъгини: плъгинът го разпознава, когато играч кликне върху него с десен бутон. Ако сървърът ти вече използва NPC плъгин като Citizens, посочи го в заявката, за да се свърже плъгинът с него.

Примерно описание

„Плъгин за куестове за Paper 1.21.4, наречен Quests. Видове цели: убий мобове, чупи блокове (не поставени от играчи), събери предмети и говори със селянин, маркиран като даващ куестове. Куестовете са описани в quests.yml с име, цели, изискван куест и награди (предмети, опит, пари от Vault, конзолни команди). /quests отваря меню с наличните, активните и завършените куестове. Напредъкът се показва в action bar. До 3 активни куеста. Дневните куестове се нулират в полунощ по времето на сървъра. Напредъкът се пази в SQLite.“

Дневни и повторяеми куестове

  • Кажи кога се нулират: в определен час всеки ден или 24 часа след като играчът е завършил.
  • Кажи дали дневните куестове са случайни за всеки играч или еднакви за всички.
  • Пази времето на последното завършване, а не флаг, за да работят нулиранията и докато сървърът е спрян.

Въпроси

Могат ли куестовете да използват PlaceholderAPI?

Да. Поискай placeholders като активния куест и напредъка му, за да могат scoreboard-ите и tab списъците да ги показват. Посочи PlaceholderAPI в заявката, за да се добави като зависимост.

Мога ли да напиша куестове със Skript?

Малки системи за куестове се побират в Skript с променливи. Много видове цели, менюта и запазен напредък за стотици играчи е по-лесно да се поддържат бързи и подредени в плъгин.

Как да проверя дали куестовете работят?

Изиграй ги на тестовия сървър на Codexe и добави тестове със свои думи, например „обикновен играч изпълнява /quests и вижда, че се отваря меню“. Тестовете проверяват съобщения, предмети и менюта, а не мобове или блокове в света.

Направи своя плъгин за куестове

Този промпт се отваря готов за изпращане:

“Плъгин за куестове за Paper 1.21.4: видове цели убий мобове, чупи блокове, които не са поставени от играчи, събери предмети и говори с маркиран селянин; куестове в quests.yml с цели, изискван куест и награди (предмети, XP, пари от Vault, конзолни команди); меню /quests с наличните, активните и завършените куестове; напредък в action bar; макс. 3 активни куеста; дневните куестове се нулират в полунощ; напредъкът се пази в SQLite.”

Генерирай това с Codexe
Как да направиш Minecraft плъгин за куестове | Codexe