Ghid
Cum faci un plugin de economie pentru Minecraft
Actualizat 18 octombrie 2026
Un plugin de economie păstrează un sold pentru fiecare jucător și îi lasă pe jucători să își plătească unii altora, să câștige bani și să îi cheltuiască în magazine. Partea importantă nu sunt comenzile, ci conectarea la Vault: ea permite plugin-urilor de magazine, joburi și licitații să folosească banii tăi. Ghidul acoperă designul, stocarea și cum îl construiești și îl testezi.
Pornește de la acest exemplu și schimbă regulile cu ale tale.
Generează asta cu CodexePas cu pas
1.Decide ce este pluginul
Fie este economia (stochează soldurile și se înregistrează ca economia Vault), fie folosește o economie existentă prin Vault (un magazin, recompense pe capete, un plugin de joburi). Majoritatea serverelor au nevoie de câte unul din fiecare, nu de două economii.
2.Alege serverul și versiunea
Scrie software-ul serverului și versiunea, de exemplu Paper 1.21.4. Pluginul este construit pentru API-ul și nivelul Java ale acelei versiuni.
3.Enumeră comenzile și regulile
/balance,/pay <player> <amount>,/baltopși comenzi de admin precum/eco give|take|set. Adaugă soldul de pornire, numele monedei, zecimalele și o plată minimă.4.Alege unde se salvează soldurile
SQLite pentru un singur server, MySQL dacă mai multe servere trebuie să împartă aceleași solduri. Banii trebuie să supraviețuiască repornirilor și crash-urilor, așa că nu sunt păstrați niciodată doar în memorie.
5.Lasă-l pe Codexe să îl scrie și să îl compileze
Descrie pluginul și numește explicit Vault, ca să fie adăugat ca dependență. Codexe scrie codul Java,
plugin.ymlșiconfig.yml, îl compilează și repară erorile de build înainte ca proiectul să fie Gata.6.Testează plățile în joc
Apasă Încearcă acum și intră pe serverul de testare. Fă plăți între două conturi, încearcă sume prea mari, negative sau care nu sunt numere, apoi repornește și verifică dacă soldurile sunt încă acolo.
7.Instalează-l
Pune Vault și .jar-ul tău în folderul
plugins/al serverului și repornește. Elimină orice alt plugin de economie sau decide pe care să îl folosească Vault.
Cum se încadrează Vault
Vault este o punte, nu o economie. Un plugin de economie implementează interfața Economy din Vault și o înregistrează în managerul de servicii al serverului; celelalte plugin-uri o cer cu getServer().getServicesManager().getRegistration(Economy.class) și apelează metode precum getBalance, withdrawPlayer și depositPlayer.
Așa că un plugin de magazin nu trebuie să știe niciodată ce economie rulezi. În plugin.yml folosește depend: [Vault] când pluginul nu poate funcționa fără el sau softdepend când Vault este opțional. API-ul Vault este necesar doar la compilare; Vault în sine se instalează pe server.
Decizii de scris în cerere
- Formatul banilor: numele monedei la singular și plural, simbolul, câte zecimale.
- Limite: soldul de pornire, soldul maxim, dacă soldurile pot deveni negative.
- Jucători offline: dacă
/payși/ecofuncționează pe jucători care nu sunt online. - Jurnal: un jurnal al tranzacțiilor în baza de date sau într-un fișier, ca staff-ul să poată verifica disputele.
- Câștigarea banilor: uciderea mobilor, recompense pentru timpul de joc, vânzarea de obiecte sau doar comenzi de admin.
Unde salvezi soldurile
| Stocare | Potrivit pentru | Atenție la |
|---|---|---|
| Fișier YAML | Servere foarte mici, ușor de citit | Lent cu mulți jucători, se corupe ușor la un crash |
| SQLite | Un singur server, fără configurare | Nu poate fi partajat între servere |
| MySQL / MariaDB | Rețele care împart un singur sold | Are nevoie de un server de baze de date și de date de autentificare în config.yml |
Exemplu de descriere
„Un plugin de economie Paper 1.21.4 numit Coins care se înregistrează ca economia Vault. /balance [player], /pay <player> <amount> cu un minim de 1, /baltop cu top 10 și /eco give|take|set pentru jucătorii cu coins.admin. Jucătorii noi pornesc cu 100 de monede. Două zecimale. Fiecare plată înregistrată cu data, expeditorul, destinatarul și suma. Soldurile salvate în SQLite. Numele monedei și toate mesajele în config.yml.”
Codexe folosește implicit SQLite când nu ceri altceva. Dacă ceri MySQL, pluginul este scris cu o setare storage-type, iar serverul de testare îi dă o bază de date MySQL proprie cât timp îl încerci.
Întrebări
Am nevoie de Vault?
Nu pentru o economie de sine stătătoare pe care nu o folosește nimic altceva. Ai nevoie de el imediat ce alte plugin-uri (magazine, joburi, licitații) trebuie să citească sau să modifice soldurile, pentru că acesta este API-ul pe care îl caută.
Îl pot rula alături de EssentialsX?
EssentialsX are propria economie și o înregistrează și ea în Vault. Rulează o singură economie odată sau dezactivează-o pe cea pe care nu o vrei, altfel alte plugin-uri pot folosi alt sold decât cel pe care îl arată comenzile tale.
Pot mai multe servere să împartă aceleași solduri?
Da, cu MySQL sau MariaDB ca stocare și aceeași bază de date în config.yml-ul fiecărui server. Cere asta în cerere, ca pluginul să citească soldurile din baza de date în loc să le țină în cache prea mult timp.
Cum îl testez fără un server real?
Cu Încearcă acum: pornește un server Paper privat pe versiunea ta cu pluginul compilat, iar plugin-urile listate în depend și softdepend, precum Vault, sunt instalate pentru el. Planul gratuit are 3 servere de testare pe zi, de 10 minute fiecare.
Fă economia serverului tău
Acest prompt se deschide gata de trimis:
“Un plugin de economie Paper 1.21.4 numit Coins care se înregistrează ca economia Vault: /balance, /pay cu un minim de 1, /baltop top 10, /eco give|take|set pentru coins.admin, sold de pornire 100, două zecimale, fiecare plată înregistrată, soldurile în SQLite, numele monedei și mesajele în config.yml.”
Generează asta cu Codexe