ShadowQuests

Con un aggiornamento i tuoi file (questo, quests/, lang/, menus/ e gli altri qui sotto) vengono portati alla nuova versione in automatico: ogni valore che hai cambiato o aggiunto resta, le nuove opzioni arrivano con i loro commenti, e quello che hai cancellato resta cancellato. Le vecchie copie sono in backup/<date>/; se qualcosa richiede la tua attenzione troverai PORTING-<version>.txt nella cartella del plugin.

Un valore sbagliato non blocca mai niente: viene sostituito da quello di fabbrica e segnalato in console all'avvio, con il percorso e cosa ci si aspettava.

LINGUA. Tutto quello che configuri è scritto in inglese - chiavi, sezioni, valori, e queste note - perché questo file lo leggono proprietari di server in tutto il mondo. Quello che legge un GIOCATORE è un'altra faccenda e resta traducibile: vedi lang/ qui sotto, che arriva in inglese e in italiano, e messages.default-locale qualche sezione più giù.

Dove stanno le cose:

config.yml        questo file: storage, regole, messaggi, integrazioni
quests/*.yml      le quest, un file per gruppo
rewards.yml       bundle di ricompense riutilizzabili
npcs.yml          quale NPC consegna quale quest
lang/*.yml        i messaggi che leggono i giocatori
menus/*.yml       la disposizione delle finestre
license.yml       la licenza (creata al primo avvio, tenuta a parte
                  apposta: un "mandami il tuo config" non deve mai arrivare
                  con dentro la licenza di qualcuno)

Quale NPC assegna quale quest.

Gli NPC veri e propri vengono da ShadowEssentials: questo file dice solo, per ognuno di loro, cosa ha da offrire. Senza ShadowEssentials il file non fa nulla e non genera errori.

Ci sono due modi per legare una quest a un NPC, e vanno bene entrambi:

1. dentro la quest, con "npc: blacksmith" - il posto giusto per
   chi scrive lo YAML a mano, perché tiene il legame accanto
   al resto della quest;
2. qui - il posto in cui scrive l'editor in gioco, e l'unico modo per
   far offrire a un NPC più di una quest.

Le due fonti si sommano.

L'ORDINE CONTA: l'NPC offre la prima quest dell'elenco che il giocatore può ancora prendere. È così che un personaggio racconta una storia un capitolo alla volta invece di scaricare sei offerte tutte insieme.

Si può fare anche da comando:

/sqa npc bind <npc> <quest>
/sqa npc unbind <npc> <quest>
/sqa npc list

Bundle di ricompense riutilizzabili.

Un bundle si definisce qui una volta sola e si richiama da qualsiasi quest con "bundle: <name>". Cambiarlo qui cambia ogni quest che lo usa, senza toccare un solo file di quest: è la differenza tra ritarare le ricompense di un server in un minuto e riaprire trenta file.

Dentro un bundle scrivi esattamente quello che scriveresti dentro una quest, quindi non c'è una seconda sintassi da imparare.

LA SCALA, E PERCHÉ I NUMERI SONO QUESTI

Sono prezzati sullo shop.yml di ShadowEconomy, dove un diamante si vende a 10 e costa 1000, un lingotto di ferro si vende a 4 e un tronco a 2. Una quest che paga mille volte quello che chiede rompe l'economia il primo giorno, quindi tutta la scala è scritta qui in un unico posto e ogni quest sceglie un gradino invece di inventarsi un numero:

starter-reward      400     il primo capitolo di una catena
small-reward        500     una giornaliera normale
medium-reward     5.000     una settimanale
weekly-reward     7.500     una settimanale difficile, con una chiave di crate
big-reward       25.000     la fine di una catena, o una mensile
monthly-reward   35.000     una mensile che ha richiesto tutto il mese
legend-reward    60.000     l'ultimo capitolo di una catena lunga

Sessantamila sono quattro lingotti di netherite a prezzo di shop. È il tetto apposta: una ricompensa che compra più di quanto un giocatore potrebbe mai minare trasforma lo shop in scenografia.

LE CHIAVI DELLE CRATE sono quelle con cui arriva ShadowCrazyChest - basic, vote, daily, magic, epic. Su un server senza un plugin di crate la chiave non viene consegnata e la console lo dice una volta: ogni bundle che ne contiene una contiene anche soldi, quindi nessuno resta a mani vuote.

Nomi, chiavi e valori sono in inglese, e lo è anche quello che vede un giocatore - "display": cambialo, è tuo. Una versione italiana di questo file è in esempi/it_IT/rewards.yml. Non viene caricata: copiala al posto di questo per usarla.

Formato MiniMessage. I placeholder si scrivono <come_questo>.

TRE PLACEHOLDER SONO SEMPRE DISPONIBILI, OVUNQUE:

<prefix>      il prefisso qui sotto
<label>       l'etichetta con cui il comando del giocatore è stato DAVVERO
              registrato su questo server
<adminlabel>  la stessa cosa per il comando dello staff

I comandi non si scrivono mai a mano in un messaggio. Un alias corto come /sq può già appartenere a un altro plugin, e chi lo chiede per secondo non lo ottiene: un aiuto in chat che nomina un comando che qui non risponde manda la gente a scrivere qualcosa che non funziona, e sembra colpa del plugin. Con <label> non può succedere.

Con un aggiornamento questo file viene portato automaticamente alla nuova versione: le righe che hai riscritto restano come le hai scritte, le nuove chiavi vengono aggiunte, e la copia vecchia viene tenuta in backup/<date>/. Se qualcosa richiede la tua attenzione troverai PORTING-<version>.txt nella cartella del plugin.

Le catene: storie fatte di quest, una dopo l'altra.

Per ogni catena vedi fin dove è arrivata e quale capitolo viene dopo - non quelli successivi, perché una storia raccontata tutta insieme dentro un menu non è una storia.

Chiavi e slot sono in inglese. LE PAROLE: un titolo o un nome scritto "lang:<key>" viene dai file di lingua in lang/, così ogni giocatore lo legge nella sua lingua. Scrivi invece un testo - per esempio name: "<yellow>Back to the quests" - e quel testo viene mostrato così com'è, a tutti: quello che scrivi qui vince sul file di lingua.

Tutte le schermate dell'editor in gioco, in un unico file.

Un blocco per schermata:

editor          la lista delle quest
quest-edit      la scrivania di una quest
objectives      gli obiettivi di una quest
types           la scelta del tipo di obiettivo
objective-edit  un obiettivo nel dettaglio
rewards         le ricompense di una quest
reward-types    la scelta del tipo di ricompensa
reward-edit     una ricompensa nel dettaglio

LE ETICHETTE non sono qui: stanno nei file di lingua, sotto editor.field, editor.obj e editor.rew. Questo file dice solo dove vanno i pulsanti e di cosa sono fatti, così se ne può spostare uno senza toccare una sola traduzione.

Anche i titoli e i pochi nomi qui sotto puntano ai file di lingua: "lang:<key>" viene letto nella lingua di chi apre l'editor. Scrivi invece un testo e quel testo viene mostrato così com'è, a tutti: quello che scrivi qui vince sul file di lingua.

Una quest, vista da vicino.

Slot 4        l'intestazione: nome, descrizione, barra, requisiti
Riga 1        gli obiettivi, uno per slot
Riga 2        le ricompense
Riga 3        il pulsante che ha senso in quel momento

Il pulsante centrale cambia da solo: accetta quando la quest non è ancora stata presa, riscuoti quando è finita, abbandona mentre è in corso. Per questo tutti e tre condividono lo stesso slot.

Chiavi e slot sono in inglese. LE PAROLE: un titolo o un nome scritto "lang:<key>" viene dai file di lingua in lang/, così ogni giocatore lo legge nella sua lingua. Scrivi invece un testo - per esempio name: "<green><bold>Take it" - e quel testo viene mostrato così com'è, a tutti: quello che scrivi qui vince sul file di lingua.

La schermata principale delle quest.

Riga 0        una scheda per gruppo
Centro        le quest del gruppo selezionato
Ultima riga   riscuoti tutto, catene, pagine, chiudi

Ogni slot, materiale e testo si può cambiare qui senza ricompilare niente. Una chiave eliminata non rompe il menu: torna semplicemente al valore che ha il codice.

Gli slot si contano da 0, in alto a sinistra. Le espressioni accettano liste e intervalli: "10-16,19-25".

All'aggiornamento questo file viene portato alla nuova versione in automatico: quello che hai cambiato resta, il resto prende il nuovo layout, e la vecchia copia viene conservata in backup/<date>/.

Chiavi e slot sono in inglese. LE PAROLE: un titolo o un nome scritto "lang:<key>" viene dai file di lingua in lang/, così ogni giocatore lo legge nella sua lingua. Scrivi invece un testo - per esempio name: "<red>Leave" - e quel testo viene mostrato così com'è, a tutti: quello che scrivi qui vince sul file di lingua.