Guida
Come creare un plugin di quest per Minecraft
Aggiornato il 18 ottobre 2026
Le quest danno ai giocatori un motivo per giocare: uccidi 20 zombie, scava 64 ferro, porta 10 pagnotte a un villico. Un plugin di quest è fatto di tre cose: obiettivi che ascoltano gli eventi di gioco, progressi salvati per ogni giocatore e premi. Definire le quest in un file di configurazione ti permette di aggiungerne di nuove senza toccare il codice.
Sostituisci quest e premi con i tuoi.
Generalo con CodexePasso per passo
1.Scegli i tipi di obiettivo
Inizia con pochi: uccidere un tipo di mob, rompere o piazzare blocchi, raccogliere oggetti, craftare, raggiungere un luogo, parlare con un NPC. Ogni quest si costruisce con questi.
2.Definisci le quest in un file
Ogni quest in
quests.yml: un id, un nome, una descrizione, gli obiettivi con le quantità, i premi e i requisiti (un'altra quest prima, un permesso, un livello).3.Tieni traccia dei progressi per giocatore
Ascolta gli eventi dietro ogni obiettivo e aggiorna i progressi del giocatore. Salvali in SQLite o in un file, così resistono a disconnessioni e riavvii.
4.Mostra i progressi
Un menu
/questscon le quest attive e completate, più un messaggio, un titolo o una boss bar quando i progressi cambiano.5.Dai i premi
Oggetti, esperienza, soldi tramite Vault o comandi da console come
lp user %player% permission set ...per tutto il resto.6.Compila e completa una quest in gioco
Lascia che Codexe la compili, entra nel server di prova, accetta una quest e completala. Poi riavvia e controlla che progressi e premi siano stati salvati.
Gli obiettivi e gli eventi dietro di loro
| Obiettivo | Evento | Dettaglio da decidere |
|---|---|---|
| Uccidere mob | EntityDeathEvent | Contare solo le uccisioni del giocatore, o anche quelle dei suoi animali e delle sue frecce |
| Rompere blocchi | BlockBreakEvent | Ignorare i blocchi piazzati dal giocatore, altrimenti i giocatori piazzano e rompono sempre lo stesso blocco |
| Raccogliere oggetti | Controllo dell'inventario o evento di raccolta | Se gli oggetti vengono tolti alla consegna della quest |
| Craftare oggetti | CraftItemEvent | Con lo shift-clic se ne craftano diversi in un colpo |
| Raggiungere un luogo | PlayerMoveEvent | Controllare solo quando il giocatore cambia blocco, non a ogni movimento |
| Parlare con un NPC | PlayerInteractEntityEvent | Quale entità assegna la quest |
Chi assegna le quest
Il modo più semplice di assegnare quest è un comando o un menu. Per un personaggio nel mondo, un villico o un'armor stand con un nome personalizzato e un tag PersistentDataContainer funziona senza altri plugin: il plugin lo riconosce quando un giocatore ci clicca sopra con il tasto destro. Se il tuo server usa già un plugin di NPC come Citizens, nominalo nella richiesta così il plugin si aggancia a lui.
Esempio di descrizione
"Un plugin di quest per Paper 1.21.4 chiamato Quests. Tipi di obiettivo: uccidere mob, rompere blocchi (non piazzati dai giocatori), raccogliere oggetti e parlare con un villico marcato come assegnatore di quest. Quest definite in quests.yml con nome, obiettivi, quest richiesta e premi (oggetti, esperienza, soldi di Vault, comandi da console). /quests apre un menu con le quest disponibili, attive e completate. Progressi mostrati nella action bar. Fino a 3 quest attive. Le quest giornaliere si azzerano a mezzanotte, ora del server. Progressi salvati in SQLite."
Quest giornaliere e ripetibili
- Scrivi quando si azzerano: a un orario fisso ogni giorno, oppure 24 ore dopo che il giocatore le ha completate.
- Scrivi se le quest giornaliere sono casuali per ogni giocatore o uguali per tutti.
- Salva l'ora dell'ultimo completamento, non un semplice flag, così gli azzeramenti funzionano anche mentre il server è spento.
Domande
Le quest possono usare PlaceholderAPI?
Sì. Chiedi dei placeholder come la quest attiva e i suoi progressi, così scoreboard e tab list possono mostrarli. Nomina PlaceholderAPI nella richiesta così viene aggiunto come dipendenza.
Posso scrivere le quest con Skript?
Un sistema di quest piccolo sta in uno Skript con le variabili. Tanti tipi di obiettivo, menu e progressi salvati per centinaia di giocatori sono più facili da mantenere veloci e ordinati in un plugin.
Come controllo che le quest funzionino?
Giocale sul server di prova di Codexe e aggiungi test con parole tue, per esempio "un giocatore normale esegue /quests e vede aprirsi un menu". I test controllano messaggi, oggetti e menu, non mob o blocchi nel mondo.
Crea il tuo plugin di quest
Questo prompt si apre pronto da inviare:
“Un plugin di quest per Paper 1.21.4: tipi di obiettivo uccidere mob, rompere blocchi non piazzati dai giocatori, raccogliere oggetti e parlare con un villico marcato; quest in quests.yml con obiettivi, quest richiesta e premi (oggetti, XP, soldi di Vault, comandi da console); menu /quests con quest disponibili, attive e completate; progressi nella action bar; massimo 3 quest attive; quest giornaliere azzerate a mezzanotte; progressi salvati in SQLite.”
Generalo con Codexe