Útmutató
Hogyan készíts Minecraft gazdasági plugint
Frissítve: 2026. október 18.
Egy gazdasági plugin minden játékosnak egyenleget vezet, és lehetővé teszi, hogy fizessenek egymásnak, pénzt keressenek és boltokban költsenek. Nem a parancsok a fontosak, hanem a Vault-bekötés: ezen keresztül használhatják a pénzedet a bolt-, munka- és aukciós pluginok. Ez az útmutató a tervezést, a tárolást, valamint a buildelést és a tesztelést mutatja be.
Indulj ki ebből a példából, és írd át a szabályokat a sajátjaidra.
Generáld ezt a Codexe-szelLépésről lépésre
1.Döntsd el, mi legyen a plugin
Vagy ő maga a gazdaság (tárolja az egyenlegeket, és Vault-gazdaságként regisztrálja magát), vagy egy meglévő gazdaságot használ a Vaulton keresztül (bolt, fejvadászat, munkaplugin). A legtöbb szervernek mindkettőből egy kell, nem két gazdaság.
2.Válaszd ki a szervert és a verziót
Írd meg a szerverszoftvert és a verziót, például Paper 1.21.4. A plugin az adott verzió API-jára és Java-szintjére készül.
3.Sorold fel a parancsokat és a szabályokat
/balance,/pay <player> <amount>,/baltop, valamint adminparancsok, például/eco give|take|set. Add meg a kezdő egyenleget, a pénznem nevét, a tizedesjegyeket és a minimális fizetést.4.Válaszd ki, hová mentse az egyenlegeket
SQLite egy szerverhez, MySQL, ha több szervernek ugyanazokat az egyenlegeket kell használnia. A pénznek túl kell élnie az újraindításokat és az összeomlásokat, ezért soha nem tárolódik csak a memóriában.
5.Hagyd, hogy a Codexe megírja és lebuildelje
Írd le a plugint, és nevezd meg kifejezetten a Vaultot, hogy függőségként bekerüljön. A Codexe megírja a Java-kódot, a
plugin.ymlés aconfig.ymlfájlt, lefordítja, és kijavítja a buildhibákat, mielőtt a projekt Kész lenne.6.Teszteld a fizetéseket játékban
Nyomd meg a Próbáld ki most gombot, és csatlakozz a tesztszerverre. Fizess két fiók között, próbálj túl nagy, negatív vagy nem számként megadott összegeket, majd indítsd újra, és ellenőrizd, hogy az egyenlegek megmaradtak-e.
7.Telepítsd
Tedd a Vaultot és a .jar fájlodat a szerver
plugins/mappájába, és indítsd újra. Távolíts el minden más gazdasági plugint, vagy döntsd el, melyiket használja a Vault.
Hogyan illeszkedik a Vault
A Vault híd, nem gazdaság. A gazdasági plugin megvalósítja a Vault Economy interfészét, és regisztrálja a szerver szolgáltatáskezelőjénél; a többi plugin a getServer().getServicesManager().getRegistration(Economy.class) hívással kéri le, és olyan metódusokat hív, mint a getBalance, a withdrawPlayer és a depositPlayer.
Így egy boltpluginnak soha nem kell tudnia, melyik gazdaságot futtatod. A plugin.yml fájlban használd a depend: [Vault] sort, ha a plugin nem működik nélküle, vagy a softdepend sort, ha a Vault opcionális. A Vault API csak a fordításhoz kell; magát a Vaultot a szerverre telepíted.
Döntések, amelyeket írj bele a kérésbe
- Pénzformátum: a pénznem neve egyes és többes számban, szimbólum, hány tizedesjegy.
- Korlátok: kezdő egyenleg, maximális egyenleg, mehet-e az egyenleg mínuszba.
- Offline játékosok: működik-e a
/payés az/ecoolyan játékosokon, akik nincsenek online. - Naplózás: tranzakciónapló az adatbázisban vagy egy fájlban, hogy a staff ellenőrizni tudja a vitás eseteket.
- Pénzszerzés: mobok megölése, játékidő-jutalmak, tárgyak eladása vagy csak adminparancsok.
Hová mentsd az egyenlegeket
| Tárolás | Mire jó | Mire figyelj |
|---|---|---|
| YAML-fájl | Nagyon kis szerverek, könnyen olvasható | Sok játékossal lassú, összeomláskor könnyen megsérül |
| SQLite | Egy szerver, nincs beállítás | Nem osztható meg szerverek között |
| MySQL / MariaDB | Közös egyenleget használó hálózatok | Adatbázisszerver és bejelentkezési adatok kellenek a config.yml-ben |
Példa leírás
„Egy Paper 1.21.4 gazdasági plugin Coins néven, amely Vault-gazdaságként regisztrálja magát. /balance [player], /pay <player> <amount> legalább 1-es összeggel, /baltop a top 10-zel, és /eco give|take|set a coins.admin joggal rendelkező játékosoknak. Az új játékosok 100 coinnal kezdenek. Két tizedesjegy. Minden fizetés naplózva dátummal, küldővel, fogadóval és összeggel. Az egyenlegek SQLite-ban mentve. A pénznemnevek és minden üzenet a config.yml-ben.”
A Codexe alapértelmezés szerint SQLite-ot használ, ha nem kérsz mást. Ha MySQL-t kérsz, a plugin egy storage-type beállítással készül, és a tesztszerver saját MySQL-adatbázist ad neki, amíg kipróbálod.
Kérdések
Kell nekem a Vault?
Önálló gazdasághoz, amelyet semmi más nem használ, nem. Akkor kell, amikor más pluginoknak (boltok, munkák, aukciók) olvasniuk vagy módosítaniuk kell az egyenlegeket, mert ezt az API-t keresik.
Futtathatom az EssentialsX mellett?
Az EssentialsX-nek saját gazdasága van, és azt is regisztrálja a Vaultnál. Egyszerre egy gazdaságot futtass, vagy kapcsold ki azt, amelyiket nem akarod, különben más pluginok más egyenleget használhatnak, mint amit a parancsaid mutatnak.
Használhat több szerver közös egyenlegeket?
Igen, MySQL vagy MariaDB tárolással, és ugyanazzal az adatbázissal minden szerver config.yml fájljában. Kérd a kérésben, hogy a plugin az adatbázisból olvassa az egyenlegeket, ahelyett, hogy túl sokáig gyorsítótárazná őket.
Hogyan tesztelhetem valódi szerver nélkül?
A Próbáld ki most funkcióval: elindul egy privát Paper-szerver a verziódon a lefordított pluginnal, és a depend és softdepend alatt felsorolt pluginok, például a Vault, is települnek hozzá. A Free csomagban naponta 3 tesztszerver jár, egyenként 10 percre.
Készítsd el a szervered gazdaságát
Ez a prompt küldésre készen nyílik meg:
“Egy Paper 1.21.4 gazdasági plugin Coins néven, amely Vault-gazdaságként regisztrál: /balance, /pay legalább 1-es összeggel, /baltop top 10, /eco give|take|set a coins.admin joghoz, kezdő egyenleg 100, két tizedesjegy, minden fizetés naplózva, egyenlegek SQLite-ban, pénznemnevek és üzenetek a config.yml-ben.”
Generáld ezt a Codexe-szel