Guida
Come creare un plugin economia per Minecraft
Aggiornato il 18 ottobre 2026
Un plugin economia tiene un saldo per ogni giocatore e permette di pagarsi a vicenda, guadagnare soldi e spenderli nei negozi. La parte importante non sono i comandi ma l'aggancio a Vault: è quello che permette a plugin di negozi, lavori e aste di usare i tuoi soldi. Questa guida spiega la struttura, il salvataggio dei dati e come compilarlo e provarlo.
Parti da questo esempio e cambia le regole con le tue.
Generalo con CodexePasso per passo
1.Decidi che cosa è il plugin
O è l'economia (salva i saldi e si registra come economia di Vault), oppure usa un'economia esistente tramite Vault (un negozio, le taglie, un plugin dei lavori). Alla maggior parte dei server serve uno di ciascuno, non due economie.
2.Scegli il server e la versione
Scrivi il software del server e la versione, per esempio Paper 1.21.4. Il plugin viene compilato per l'API e la versione di Java di quella release.
3.Elenca comandi e regole
/balance,/pay <player> <amount>,/baltope comandi admin come/eco give|take|set. Aggiungi il saldo iniziale, il nome della valuta, i decimali e un pagamento minimo.4.Scegli dove salvare i saldi
SQLite per un solo server, MySQL se più server devono condividere gli stessi saldi. I soldi devono sopravvivere a riavvii e crash, quindi non stanno mai solo in memoria.
5.Lascia che Codexe lo scriva e lo compili
Descrivi il plugin e nomina esplicitamente Vault, così viene aggiunto come dipendenza. Codexe scrive il codice Java,
plugin.ymleconfig.yml, lo compila e corregge gli errori di build prima di dichiarare pronto il progetto.6.Prova i pagamenti in gioco
Premi Provalo subito ed entra nel server di prova. Fai pagamenti tra due account, prova importi troppo alti, negativi o che non sono numeri, poi riavvia e controlla che i saldi ci siano ancora.
7.Installalo
Metti Vault e il tuo .jar nella cartella
plugins/del server e riavvia. Togli ogni altro plugin economia, oppure decidi quale deve usare Vault.
Che ruolo ha Vault
Vault è un ponte, non un'economia. Un plugin economia implementa l'interfaccia Economy di Vault e la registra nel services manager del server; gli altri plugin la chiedono con getServer().getServicesManager().getRegistration(Economy.class) e chiamano metodi come getBalance, withdrawPlayer e depositPlayer.
Così un plugin di negozi non ha mai bisogno di sapere quale economia usi. In plugin.yml usa depend: [Vault] quando il plugin non può funzionare senza, oppure softdepend quando Vault è facoltativo. L'API di Vault serve solo per compilare; Vault vero e proprio si installa sul server.
Decisioni da scrivere nella richiesta
- Formato dei soldi: nome della valuta al singolare e al plurale, simbolo, quanti decimali.
- Limiti: saldo iniziale, saldo massimo, se i saldi possono andare in negativo.
- Giocatori offline: se
/paye/ecofunzionano anche sui giocatori non connessi. - Registro: un log delle transazioni nel database o in un file, così lo staff può verificare le contestazioni.
- Come si guadagna: uccidendo mob, premi per il tempo di gioco, vendendo oggetti, oppure solo con comandi admin.
Dove salvare i saldi
| Salvataggio | Adatto a | Attenzione a |
|---|---|---|
| File YAML | Server molto piccoli, facile da leggere | Lento con tanti giocatori, si corrompe facilmente in un crash |
| SQLite | Un solo server, nessuna configurazione | Non si può condividere tra più server |
| MySQL / MariaDB | Network che condividono un unico saldo | Serve un server di database e le credenziali in config.yml |
Esempio di descrizione
"Un plugin economia per Paper 1.21.4 chiamato Coins che si registra come economia di Vault. /balance [player], /pay <player> <amount> con un minimo di 1, /baltop con i primi 10 e /eco give|take|set per i giocatori con coins.admin. I nuovi giocatori partono con 100 monete. Due decimali. Ogni pagamento registrato con data, mittente, destinatario e importo. Saldi salvati in SQLite. Nomi della valuta e tutti i messaggi in config.yml."
Codexe usa SQLite di default se non chiedi altro. Se chiedi MySQL, il plugin viene scritto con un'impostazione storage-type e, mentre lo provi, il server di prova gli dà un database MySQL tutto suo.
Domande
Mi serve Vault?
Non per un'economia a sé che nient'altro usa. Ti serve appena altri plugin (negozi, lavori, aste) devono leggere o modificare i saldi, perché è l'API che cercano.
Posso usarlo insieme a EssentialsX?
EssentialsX ha una sua economia e la registra anche lei in Vault. Usa un'economia alla volta, o disattiva quella che non vuoi, altrimenti altri plugin potrebbero usare un saldo diverso da quello che mostrano i tuoi comandi.
Più server possono condividere gli stessi saldi?
Sì, con MySQL o MariaDB come salvataggio e lo stesso database nel config.yml di ogni server. Chiedilo nella richiesta, così il plugin legge i saldi dal database invece di tenerli in cache troppo a lungo.
Come lo provo senza un server vero?
Con Provalo subito: parte un server Paper privato della tua versione con il plugin compilato, e i plugin elencati in depend e softdepend, come Vault, vengono installati apposta. Il piano gratuito ha 3 server di prova al giorno, da 10 minuti ciascuno.
Crea l'economia del tuo server
Questo prompt si apre pronto da inviare:
“Un plugin economia per Paper 1.21.4 chiamato Coins che si registra come economia di Vault: /balance, /pay con un minimo di 1, /baltop con i primi 10, /eco give|take|set per coins.admin, saldo iniziale 100, due decimali, ogni pagamento registrato, saldi in SQLite, nomi della valuta e messaggi in config.yml.”
Generalo con Codexe