ShadowEconomy

In caso di aggiornamento, questo file (come ogni altro file del plugin) viene portato alla nuova versione in automatico: viene ricostruito da quello nuovo e tutto quello che avevi cambiato o aggiunto viene riportato dentro. I vecchi file vengono conservati in backup/<date>/, e se qualcosa richiede la tua attenzione troverai PORTING-<version>.txt in questa cartella, con scritto cosa sistemare.

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

Tutto qui - chiavi, sezioni e commenti - è in inglese, perché lo legge chi gestisce il server, in qualunque parte del mondo si trovi. Le parole che vedono i giocatori stanno in lang/, e di default sono in inglese; è incluso anche l'italiano (messages.default-locale qui sotto).

La banca dà ai soldi un posto dove stare che non sia una chest.

Tre cose: - un CONTO che rende interessi, a un tasso che scende man mano che il saldo

sale. Le fasce sono il punto di tutto: un tasso fisso su qualsiasi cifra è
una macchina per rendere più ricco chi è già ricco, e su un server
te ne accorgi nel giro di una settimana.

- DEPOSITI VINCOLATI, che rendono di più in cambio di non toccare i

soldi fino a una certa data. Romperne uno ha un costo.

- PRESTITI, con un limite calcolato su quello che il giocatore ha davvero,

rate trattenute in automatico, e un'insolvenza che chiude la porta
finché non salda il debito.

Un saldo in banca NON è una nuova tabella: è un normale account con un id derivato da quello del giocatore. Così viene salvato, tracciato in /eco audit e sincronizzato tra i server dallo stesso codice dei portafogli, e resta fuori da /baltop.

IN ITALIANO: lo stesso file con nomi e descrizioni in italiano è in esempi/it_IT/currencies.yml dentro la cartella di questo plugin. Copialo al posto di questo per usarlo: il plugin non lo legge mai da solo.

Le valute del server. Quella indicata in "default" è quella che usa Vault, quella che usa ogni comando senza una valuta esplicita, e quella che intende un prezzo dello shop quando non ne nomina una.

L'id di una valuta lo scrivono i giocatori, quindi tienilo in inglese. Solo "display", "plural" e "symbol" vengono mostrati a loro, e sono quelli da tradurre.

decimals: cifre dopo la virgola. 0 per una valuta in stile "token". max-balance: 0 vuol dire nessun tetto. payable: false toglie la valuta da /pay (normale per quelle premium). baltop: false la toglie dalla classifica.

IN ITALIANO: lo stesso file con nomi e descrizioni in italiano è in esempi/it_IT/district.yml dentro la cartella di questo plugin. Copialo al posto di questo per usarlo: il plugin non lo legge mai da solo.

Il quartiere dei negozi: l'edificio che costruisce il proprietario del server, diviso in negozi che i giocatori affittano.

Come si crea un lotto:

1. /market admin wand
2. click sinistro su un angolo, click destro su quello opposto
3. /market admin create shop-1 shop
4. /market admin panel shop-1  ->  imposta la porta e il punto di visita

Da quel momento il lotto compare in /market e chiunque può affittarlo.

L'exchange: cinque criptovalute e le aziende fondate dai giocatori.

Quattro delle cinque sono quelle di cui tutti hanno sentito parlare, così un giocatore capisce cosa sta guardando senza che nessuno glielo spieghi. La quinta, ShadowCoin, è quella del server ed è l'unica che si può anche produrre: esce dai rig di mining e torna nello shop crypto, dove viene bruciata.

I prezzi si muovono con un moto browniano geometrico - il modo standard in cui si simulano i mercati - più due cose che lo rendono un gioco e non uno

screensaver:
  - la pressione dei giocatori (comprare spinge su, vendere spinge giù)
  - eventi di mercato, annunciati in chat.

volatility è annualizzata: 0.9 è una crypto selvaggia, 0.2 un indice tranquillo. Cambiare tick-interval non cambia il carattere di un asset.

Se preferisci, le quattro monete reali possono invece seguire il loro prezzo reale su Binance: vedi finance.real-prices qui sotto. Spento di default.

Due cose in un solo file, perché sono i due modi in cui i giocatori si vendono roba a vicenda:

- la casa d'aste (/ah), per vendere a chiunque senza essere presente;
- i chest shop, per vendere dalla propria base.

IN ITALIANO: lo stesso file con nomi e descrizioni in italiano è in esempi/it_IT/mining.yml nella cartella di questo plugin. Copialo al posto di questo per usarlo: il plugin non lo legge mai da solo.

Rig di mining: un blocco che si apre come un case, con dentro una scheda madre, un processore, un alimentatore, il raffreddamento e le schede video.

Un rig produce crypto, consuma corrente pagata in valuta vera, si scalda e si usura. Non sono soldi gratis: l'elettricità si paga ogni ora, la difficoltà sale con il numero di rig attivi sul server, e quello che esce è crypto, che va venduta sull'exchange prima di diventare soldi.

Per dare un componente a qualcuno:   /rig give <id> [amount] [player]
Per la lista dei componenti:         /rig parts

IN ITALIANO: lo stesso file con nomi e descrizioni in italiano è in esempi/it_IT/shop.yml, nella cartella di questo plugin. Copialo al posto di questo per usarlo: il plugin non lo legge mai da solo.

Lo shop del server, pronto all'uso.

Non è un esempio da riempire: quattordici categorie, con i prezzi calibrati l'uno sull'altro, pensate per uno SkyBlock. I giocatori guadagnano vendendo ciò che producono le loro isole - cobblestone, canna da zucchero, meloni, ferro, drop dei mob - e spendono in blocchi decorativi, equipaggiamento e cose che non si possono farmare.

LA SCALA È BASSA, ED È VOLUTO

Un'economia si rompe quando lo shop paga cifre alte per cose prodotte a stack: il primo giocatore con una farm automatica fa dieci milioni in una settimana, e da lì in poi i soldi non valgono più niente per nessuno. Qui il grano vale 3.50 e un diamante 10: guadagni piano, e quello che guadagni conta.

I punti fissi da cui discende tutto il resto:

cobblestone       0.50     il generatore non si esaurisce mai
tronco            2.00     un albero è tempo speso
grano             3.50     una pianta, un grano
patata / carota   1.50     la stessa pianta ne dà due o tre
lingotto di ferro 4.00
diamante         10.00     la più cara delle cose comuni

La regola del grano contro la patata vale per tutto il catalogo: non si dà il prezzo all'item, ma al RACCOLTO. La canna da zucchero cresce e si taglia da sola, quindi 0.50. Una fetta di melone è un nono di melone, quindi 0.25.

IL PREZZO DI ACQUISTO

Non un solo moltiplicatore. Più una cosa è rara, più comprarla deve convenire meno che andarsela a prendere:

x3      vendita sotto 1      cobble, terra, sabbia, foglie, semi
x2.5    fino a 4             tronchi, raccolti, lana
x6      da 4 in su           lingotti, vetro, macchine, attrezzi
x15     di valore            ossidiana, perle, bacchette di blaze
x100    rari                 diamante, smeraldo, netherite

Un tronco si vende a 2 e costa 5. Un diamante si vende a 10 e costa 1000: lo shop te lo compra volentieri, ma non è il posto dove equipaggiarti. È questa la differenza tra uno shop al servizio di un'economia e uno che la sostituisce.

LA REGOLA CHE NON SI TOCCA

Niente di craftabile vale più dei pezzi di cui è fatto. Un pistone vale le sue tre assi, quattro cobble, un lingotto e una redstone, e non una moneta di più. Senza quella regola un autocrafter che gira in loop stampa soldi e nessuno se ne accorge.

L'eccezione voluta è la fusione: la cobblestone che diventa pietra vale il doppio, il minerale grezzo fuso in lingotto guadagna. È progressione, non una falla - è ciò che spinge un'isola a costruire fornaci.

Se cambi un prezzo, guarda in cosa viene craftato quell'item. Alzare un prezzo di vendita da solo è il modo classico di aprire una stampante di soldi nel tuo stesso shop.

COSA PUOI CAMBIARE SENZA PENSARCI

display / description / icon    come appare una categoria
slot                            dove sta sullo schermo
limit-buy-per-day               quanti al giorno, per giocatore
permission                      per nasconderla a chi non ce l'ha

Ogni voce ha:

id                  identificatore unico (usato dal database e dall'API)
material            il materiale, oppure "item" con un item serializzato
buy                 quanto costa al giocatore. 0 = non si può comprare
sell                quanto paga al giocatore. 0 = non si può vendere
dynamic             true = il prezzo si muove con la domanda (attivo di default)
limit-buy-per-day   0 = nessun limite
limit-sell-per-day  0 = nessun limite
permission          se c'è, serve quel permesso per vederla
lore                righe in più nella descrizione

I nomi visualizzati e le descrizioni sono gli unici testi pensati per i giocatori, quindi sono la parte da tradurre. Tutto il resto - chiavi, id e questi commenti - è in inglese, perché lo legge chi gestisce il server, in qualunque parte del mondo.

Per aggiungere o correggere una voce senza toccare questo file: /shop edit

IN ITALIANO: lo stesso file con nomi e descrizioni in italiano è in esempi/it_IT/tokens.yml dentro la cartella di questo plugin. Copialo al posto di questo per usarlo: il plugin non lo legge mai da solo.

Un token è denaro con un corpo: ha un saldo come qualsiasi valuta, e può uscire dal conto come item - tenuto in mano, regalato, messo in una cassa, venduto in uno shop, e riportato allo sportello per tornare un saldo.

DUE FORME, e una riga sceglie tra le due:

currency: coins   -> è una BANCONOTA di una valuta che esiste
                     già. Incassarla restituisce coins.
currency: none    -> è una VALUTA A SÉ. Il plugin la registra
                     come tale, così /balance, /pay, /baltop, lo shop
                     e la casa d'aste la capiscono senza
                     altre configurazioni.

DUE MODI DI ESSERE UN ITEM, ed è questa la scelta che conta:

serialized: false -> AL PORTATORE. Si stacka, è comodo, ed è

copiabile esattamente come è copiabile
un diamante. Va bene per gli spiccioli.

serialized: true -> REGISTRATO. Ogni item porta un numero che

esiste una sola volta nel database e si incassa una volta.
Copiare l'item copia il numero, e il
secondo che arriva viene rifiutato. Usalo per
qualsiasi cosa che valga qualcosa.

Il modello 3D si imposta con item-model - un nome, non un numero, così due plugin non possono contendersi "shadow:banknote". Serve un resource pack che definisca quel modello; senza, l'item è semplicemente il materiale che hai scelto, e funziona lo stesso.

L'id di un token viene digitato dai giocatori e usato da altri plugin, quindi tienilo in inglese. "display", il nome dell'item e la sua lore sono le parti da tradurre.

COSA C'È DI SERIE

Un solo token, ed è voluto. Un server che parte con quattro token ha quattro cose di cui nessuno ha ancora deciso cosa fare, e compaiono tutte in /balance. Quello qui sotto è il token degli eventi: una valuta a sé, guadagnata agli eventi, spesa in /tokenshop.

Per aggiungerne un altro, copia il suo blocco e cambia le due righe che contano - "currency" e "serialized" - come descritto sopra. Una banconota di coins è currency: coins con serialized: false; un assegno è currency: coins con value: 0 e serialized: true.

Scambi tra due giocatori: item, soldi ed esperienza, in un'unica finestra che stanno guardando tutti e due.

COME UNO SCAMBIO RESTA ONESTO

Ogni truffa negli scambi è lo stesso trucco. Il ladro aspetta che l'altro giocatore legga l'offerta, e cambia qualcosa nell'attimo tra la lettura e l'accettazione. Qui tre regole fanno sì che quell'attimo non esista, e nessuna si può disattivare:

1. qualsiasi modifica a uno dei due lati annulla ENTRAMBE le accettazioni,
   non solo quella di chi ha fatto la modifica;
2. una volta che entrambi hanno accettato, l'offerta si CONGELA, e parte un
   conto alla rovescia durante il quale nessuno può modificare niente;
3. solo allora compaiono i pulsanti di conferma, e ognuno mostra l'intero
   accordo - cosa esce, cosa entra - nel proprio tooltip.

In più, il lato destro dello schermo descrive ogni item in arrivo per quello che è davvero: un blocco rinominato dice il suo vero nome, una shulker box dice se è vuota, un attrezzo usurato dice quanto è usurato. È lì che si nasconde il resto delle truffe.

COSA VIENE REGISTRATO

Ogni scambio completato finisce nel database, a parole, e si rilegge con "/trade log <player>". Quando due giocatori raccontano due storie diverse, quella riga è la risposta.

Gli item offerti hanno già lasciato l'inventario del proprietario, quindi vengono registrati anche loro, e tutto ciò che un crash lascia indietro viene restituito al login successivo. Niente viene mai buttato a terra.

I colori si scrivono con i codici &: &a &c &7, &l per il grassetto, &#FF8800 per un colore esatto. Funzionano anche i tag stile <gray> se li preferisci: il plugin capisce entrambi, ovunque.

I placeholder si scrivono <come-questo> e NON sono colori: <amount>, <player>, <prefix>. Lasciali come sono. Questo file è l'ultimo ripiego: una chiave che manca ovunque viene cercata qui, quindi tienilo completo.

Un messaggio è sempre una riga sola. Suono, canale e cooldown si scrivono come chiavi vicine, con lo stesso nome più un suffisso:

paid: "&aDone."
paid-sound: entity.experience_orb.pickup
paid-channel: ACTION_BAR     # CHAT | ACTION_BAR | TITLE | SUBTITLE | NONE
paid-cooldown: "2s"          # per player anti spam
paid-volume: 0.7
paid-pitch: 0.8

Così la chiave del messaggio resta il messaggio: un traduttore tocca solo quella, e chi cerca una chiave la trova dove è scritta.

Le liste sono descrizioni su più righe (la lore di un item della GUI).

Il distretto commerciale, /market.

Livelli e lotti stanno in district.yml: qui si decidono solo la dimensione e la cornice delle schermate.

L'exchange, /crypto e /stocks.

Gli asset stanno in finance.yml, ognuno con la sua icona: dimensione e cornice si decidono qui.

La casa d'aste, /ah.

Titoli e descrizioni stanno in lang/, perché seguono la lingua del giocatore. Dimensione e cornice si decidono qui.

I rig, /rig.

I componenti e le loro icone stanno in mining.yml: dimensione e cornice della lista si decidono qui.

La schermata iniziale dello shop, /shop.

Le categorie e la loro posizione stanno in shop.yml, ognuna con il suo "slot": qui si decidono solo la cornice e i pulsanti di servizio.

I testi sono vuoti apposta: vuoto significa il file di lingua, nella lingua di ogni giocatore (shop.main-title, shop.sell-all.title e .lore, shop.editor.button e .button-lore). Un testo scritto qui viene mostrato così com'è a ogni giocatore, qualunque sia la sua lingua.

Il portafoglio, /wallet.

Dimensione, filler e posizione dei pulsanti si decidono qui. Il testo delle voci tradotte sta in lang/, perché cambia con la lingua del giocatore; quello che è scritto qui è uguale per tutti. Ecco perché il titolo e i nomi dei pulsanti qui sotto sono vuoti: vuoto vuol dire il file di lingua (wallet.title, wallet.buttons.*).

Slot: 0 è in alto a sinistra, poi da sinistra a destra, riga per riga. Con 5 righe gli slot vanno da 0 a 44.