Ghid
Cum faci un plugin de quest-uri pentru Minecraft
Actualizat 18 octombrie 2026
Quest-urile le dau jucătorilor un motiv să joace: ucide 20 de zombi, minează 64 de fier, adu-i unui sătean 10 pâini. Un plugin de quest-uri înseamnă trei lucruri: obiective care ascultă evenimentele jocului, progres salvat pentru fiecare jucător și recompense. Dacă definești quest-urile într-un fișier de configurare, poți adăuga altele noi fără să atingi codul.
Schimbă quest-urile și recompensele cu ale tale.
Generează asta cu CodexePas cu pas
1.Alege tipurile de obiective
Începe cu câteva: ucide un tip de mob, sparge sau pune blocuri, colectează obiecte, craftează, ajungi într-un loc, vorbești cu un NPC. Fiecare quest e construit din acestea.
2.Definește quest-urile într-un fișier
Fiecare quest în
quests.yml: un id, un nume, o descriere, obiectivele cu cantitățile lor, recompensele și cerințele (alt quest înainte, o permisiune, un nivel).3.Urmărește progresul fiecărui jucător
Ascultă evenimentele din spatele fiecărui obiectiv și adaugă la progresul jucătorului. Salvează-l în SQLite sau într-un fișier, ca să supraviețuiască deconectărilor și repornirilor.
4.Arată progresul
Un meniu
/questscu quest-urile active și terminate, plus un mesaj, un titlu sau o bară de boss când progresul se schimbă.5.Dă recompense
Obiecte, experiență, bani prin Vault sau comenzi de consolă precum
lp user %player% permission set ...pentru orice altceva.6.Construiește-l și termină un quest în joc
Lasă Codexe să îl compileze, intră pe serverul de testare, acceptă un quest și termină-l. Apoi repornește și verifică dacă progresul și recompensele au fost salvate.
Obiectivele și evenimentele din spatele lor
| Obiectiv | Eveniment | Detaliu de decis |
|---|---|---|
| Ucide mobi | EntityDeathEvent | Numără doar kill-urile jucătorului sau și pe cele ale animalelor lui și ale săgeților |
| Sparge blocuri | BlockBreakEvent | Ignoră blocurile puse de jucător, altfel jucătorii vor pune și vor sparge același bloc |
| Colectează obiecte | Verificarea inventarului sau evenimentul de ridicare | Dacă obiectele sunt luate când quest-ul este predat |
| Craftează obiecte | CraftItemEvent | Craftingul cu shift-click face mai multe deodată |
| Ajungi într-un loc | PlayerMoveEvent | Verifică doar când jucătorul schimbă blocul, nu la fiecare mișcare |
| Vorbește cu un NPC | PlayerInteractEntityEvent | Ce entitate dă quest-ul |
Cei care dau quest-uri
Cel mai simplu mod de a da quest-uri e o comandă sau un meniu. Pentru un personaj din lume, un sătean sau un suport de armură cu un nume custom și un tag PersistentDataContainer funcționează fără alte plugin-uri: pluginul îl recunoaște când un jucător dă click dreapta pe el. Dacă serverul tău folosește deja un plugin de NPC precum Citizens, numește-l în cerere, ca pluginul să se conecteze la el.
Exemplu de descriere
„Un plugin de quest-uri Paper 1.21.4 numit Quests. Tipuri de obiective: ucide mobi, sparge blocuri (nepuse de jucători), colectează obiecte și vorbește cu un sătean marcat ca cel care dă quest-uri. Quest-urile definite în quests.yml cu nume, obiective, quest-ul cerut și recompense (obiecte, experiență, bani Vault, comenzi de consolă). /quests deschide un meniu cu quest-urile disponibile, active și terminate. Progresul afișat în bara de acțiune. Maximum 3 quest-uri active. Quest-urile zilnice se resetează la miezul nopții, după ora serverului. Progresul salvat în SQLite.”
Quest-uri zilnice și repetabile
- Spune când se resetează: la o oră fixă în fiecare zi sau la 24 de ore după ce jucătorul a terminat.
- Spune dacă quest-urile zilnice sunt aleatorii pentru fiecare jucător sau aceleași pentru toată lumea.
- Stochează momentul ultimei finalizări, nu un flag, ca resetările să funcționeze și cât serverul e oprit.
Întrebări
Pot quest-urile să folosească PlaceholderAPI?
Da. Cere placeholder-e precum quest-ul activ și progresul lui, ca scoreboard-urile și listele tab să le poată afișa. Numește PlaceholderAPI în cerere, ca să fie adăugat ca dependență.
Pot scrie quest-uri cu Skript?
Sistemele mici de quest-uri încap într-un Skript cu variabile. Multe tipuri de obiective, meniuri și progres salvat pentru sute de jucători sunt mai ușor de ținut rapide și organizate într-un plugin.
Cum verific dacă quest-urile funcționează?
Joacă-le pe serverul de testare Codexe și adaugă teste cu propriile cuvinte, de exemplu „un jucător normal rulează /quests și vede cum se deschide un meniu”. Testele verifică mesaje, obiecte și meniuri, nu mobi sau blocuri din lume.
Fă-ți pluginul de quest-uri
Acest prompt se deschide gata de trimis:
“Un plugin de quest-uri Paper 1.21.4: tipuri de obiective ucide mobi, sparge blocuri nepuse de jucători, colectează obiecte și vorbește cu un sătean marcat; quest-uri în quests.yml cu obiective, quest-ul cerut și recompense (obiecte, XP, bani Vault, comenzi de consolă); meniu /quests cu quest-urile disponibile, active și terminate; progresul în bara de acțiune; maximum 3 quest-uri active; quest-urile zilnice se resetează la miezul nopții; progresul salvat în SQLite.”
Generează asta cu Codexe