Ú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-szel

Lépésről lépésre

  1. 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. 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. 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. 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. 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 a config.yml fájlt, lefordítja, és kijavítja a buildhibákat, mielőtt a projekt Kész lenne.

  6. 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. 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 /eco olyan 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ásMire jóMire figyelj
YAML-fájlNagyon kis szerverek, könnyen olvashatóSok játékossal lassú, összeomláskor könnyen megsérül
SQLiteEgy szerver, nincs beállításNem osztható meg szerverek között
MySQL / MariaDBKözös egyenleget használó hálózatokAdatbá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
Hogyan készíts Minecraft gazdasági plugint (Vault, Paper) | Codexe