Vodič
Kako napraviti Minecraft economy plugin
Ažurirano 18. listopada 2026.
Economy plugin vodi stanje računa za svakog igrača i omogućuje im da plaćaju jedni drugima, zarađuju novac i troše ga u trgovinama. Najvažnije nisu naredbe nego veza s Vaultom: upravo ona omogućuje pluginovima za trgovine, poslove i aukcije da koriste tvoj novac. Ovaj vodič pokriva dizajn, spremanje podataka te kako ga napraviti i testirati.
Kreni od ovog primjera i promijeni pravila u svoja.
Generiraj ovo uz CodexeKorak po korak
1.Odluči što plugin jest
Ili on jest ekonomija (sprema stanja i registrira se kao Vault ekonomija) ili koristi postojeću ekonomiju preko Vaulta (trgovina, ucjene, plugin za poslove). Većini poslužitelja treba po jedan od svakog, a ne dvije ekonomije.
2.Odaberi poslužitelj i verziju
Napiši softver poslužitelja i verziju, na primjer Paper 1.21.4. Plugin se izrađuje za API i Java razinu te verzije.
3.Popiši naredbe i pravila
/balance,/pay <player> <amount>,/baltopi admin naredbe kao što je/eco give|take|set. Dodaj početno stanje, naziv valute, decimale i najmanji iznos plaćanja.4.Odaberi gdje se spremaju stanja
SQLite za jedan poslužitelj, MySQL ako više poslužitelja mora dijeliti ista stanja. Novac mora preživjeti ponovna pokretanja i rušenja, pa se nikad ne drži samo u memoriji.
5.Pusti Codexe da ga napiše i builda
Opiši plugin i izričito navedi Vault kako bi se dodao kao ovisnost. Codexe piše Java kod,
plugin.ymliconfig.yml, kompajlira ga i ispravlja greške pri buildu prije nego što je projekt Spremno.6.Testiraj plaćanja u igri
Pritisni Isprobaj odmah i uđi na testni poslužitelj. Plati između dva računa, isprobaj prevelike, negativne iznose ili one koji nisu brojevi, zatim ponovno pokreni poslužitelj i provjeri jesu li stanja još tu.
7.Instaliraj ga
Stavi Vault i svoj .jar u mapu
plugins/na poslužitelju i ponovno ga pokreni. Ukloni sve druge economy pluginove ili odluči koji od njih Vault treba koristiti.
Kako se Vault uklapa
Vault je most, a ne ekonomija. Economy plugin implementira Vaultovo sučelje Economy i registrira ga u services manageru poslužitelja; drugi pluginovi traže ga s getServer().getServicesManager().getRegistration(Economy.class) i pozivaju metode kao što su getBalance, withdrawPlayer i depositPlayer.
Zato plugin za trgovinu nikad ne mora znati koju ekonomiju koristiš. U plugin.yml koristi depend: [Vault] kad plugin ne može raditi bez njega ili softdepend kad je Vault neobavezan. Vault API treba samo za kompajliranje; sam Vault instalira se na poslužitelj.
Odluke koje treba napisati u zahtjevu
- Format novca: naziv valute u jednini i množini, simbol, koliko decimala.
- Ograničenja: početno stanje, najveće stanje, smiju li stanja ići u minus.
- Igrači offline: rade li
/payi/econa igračima koji nisu online. - Bilježenje: zapisnik transakcija u bazi podataka ili datoteci, kako bi staff mogao provjeriti sporove.
- Zarada: ubijanje mobova, nagrade za vrijeme igranja, prodaja predmeta ili samo admin naredbe.
Gdje spremati stanja
| Spremanje | Dobro za | Pazi na |
|---|---|---|
| YAML datoteka | Vrlo male poslužitelje, lako se čita | Sporo s mnogo igrača, lako se ošteti pri rušenju |
| SQLite | Jedan poslužitelj, bez postavljanja | Ne može se dijeliti između poslužitelja |
| MySQL / MariaDB | Mreže koje dijele jedno stanje | Treba poslužitelj baze podataka i podatke za prijavu u config.yml |
Primjer opisa
„Paper 1.21.4 economy plugin pod nazivom Coins koji se registrira kao Vault ekonomija. /balance [player], /pay <player> <amount> s minimumom od 1, /baltop s top 10 i /eco give|take|set za igrače s coins.admin. Novi igrači počinju sa 100 novčića. Dvije decimale. Svako plaćanje bilježi se s datumom, pošiljateljem, primateljem i iznosom. Stanja se spremaju u SQLite. Nazivi valute i sve poruke u config.yml.”
Codexe po zadanom koristi SQLite kad ne tražiš nešto drugo. Ako tražiš MySQL, plugin se piše s postavkom storage-type, a testni poslužitelj dobiva vlastitu MySQL bazu podataka dok ga isprobavaš.
Pitanja
Treba li mi Vault?
Ne za samostalnu ekonomiju koju ništa drugo ne koristi. Treba ti čim drugi pluginovi (trgovine, poslovi, aukcije) moraju čitati ili mijenjati stanja, jer to je API koji traže.
Mogu li ga pokretati uz EssentialsX?
EssentialsX ima vlastitu ekonomiju i također je registrira u Vaultu. Pokreći jednu ekonomiju istodobno ili isključi onu koju ne želiš, inače drugi pluginovi mogu koristiti drugačije stanje od onoga koje prikazuju tvoje naredbe.
Mogu li više poslužitelja dijeliti ista stanja?
Da, uz MySQL ili MariaDB kao spremište i istu bazu podataka u config.yml svakog poslužitelja. Zatraži to u zahtjevu kako bi plugin čitao stanja iz baze umjesto da ih predugo drži u cacheu.
Kako ga testirati bez pravog poslužitelja?
Uz Isprobaj odmah: pokreće se privatni Paper poslužitelj tvoje verzije s kompajliranim pluginom, a pluginovi navedeni u depend i softdepend, kao što je Vault, instaliraju se za njega. Besplatni plan ima 3 testna poslužitelja dnevno, svaki po 10 minuta.
Napravi ekonomiju za svoj poslužitelj
Ovaj prompt otvara se spreman za slanje:
“Paper 1.21.4 economy plugin pod nazivom Coins koji se registrira kao Vault ekonomija: /balance, /pay s minimumom od 1, /baltop top 10, /eco give|take|set za coins.admin, početno stanje 100, dvije decimale, svako plaćanje se bilježi, stanja u SQLiteu, nazivi valute i poruke u config.yml.”
Generiraj ovo uz Codexe