Водич

Како направити Minecraft плагин за економију

Ажурирано 18. октобар 2026.

Плагин за економију води стање за сваког играча и омогућава играчима да шаљу новац једни другима, зарађују га и троше у продавницама. Најважнији део нису команде, већ веза са Vault-ом: управо она омогућава плагинима за продавнице, послове и аукције да користе твој новац. Овај водич покрива дизајн, чување података и то како да га направиш и тестираш.

Крени од овог примера и промени правила по својој мери.

Генериши ово уз Codexe

Корак по корак

  1. 1.Одлучи шта плагин јесте

    Или он јесте економија (чува стања и региструје се као Vault економија), или користи постојећу економију преко Vault-а (продавница, уцене, плагин за послове). Већини сервера треба по један од сваког, а не две економије.

  2. 2.Изабери сервер и верзију

    Напиши софтвер сервера и верзију, на пример Paper 1.21.4. Плагин се прави за API и Java ниво те верзије.

  3. 3.Наведи команде и правила

    /balance, /pay <player> <amount>, /baltop и админ команде као што је /eco give|take|set. Додај почетно стање, назив валуте, број децимала и минималну уплату.

  4. 4.Изабери где се чувају стања

    SQLite за један сервер, MySQL ако више сервера мора да дели иста стања. Новац мора да преживи рестартовања и падове, па се никада не чува само у меморији.

  5. 5.Пусти Codexe да га напише и билдује

    Опиши плагин и изричито наведи Vault да би био додат као зависност. Codexe пише Java код, plugin.yml и config.yml, компајлира га и исправља грешке у билду пре него што пројекат буде Спремно.

  6. 6.Тестирај уплате у игри

    Притисни „Испробај одмах“ и уђи на тест сервер. Пошаљи новац између два налога, пробај износе који су превелики, негативни или нису бројеви, па рестартуј и провери да ли су стања и даље ту.

  7. 7.Инсталирај га

    Стави Vault и свој .jar у фолдер plugins/ на серверу и рестартуј. Уклони сваки други плагин за економију или одлучи који ће Vault користити.

Где се Vault уклапа

Vault је мост, а не економија. Плагин за економију имплементира Vault-ов Economy интерфејс и региструје га у менаџеру сервиса сервера; други плагини га траже преко getServer().getServicesManager().getRegistration(Economy.class) и позивају методе као што су getBalance, withdrawPlayer и depositPlayer.

Зато плагин за продавницу никада не мора да зна коју економију користиш. У plugin.yml користи depend: [Vault] када плагин не може да ради без њега, или softdepend када је Vault опционалан. Vault API треба само за компајлирање; сам Vault се инсталира на серверу.

Одлуке које треба написати у захтеву

  • Формат новца: назив валуте у једнини и множини, симбол, број децимала.
  • Ограничења: почетно стање, максимално стање, да ли стање може да оде у минус.
  • Играчи ван мреже: да ли /pay и /eco раде на играче који нису онлајн.
  • Евиденција: дневник трансакција у бази података или фајлу, да би особље могло да провери спорове.
  • Зарада: убијање мобова, награде за време у игри, продаја предмета или само админ команде.

Где чувати стања

СкладиштеДобро заПази на
YAML фајлВеома мале сервере, лако се читаСпоро са много играча, лако се оштети при паду
SQLiteЈедан сервер, без подешавањаНе може да се дели између сервера
MySQL / MariaDBМреже које деле једно стањеТреба сервер базе података и подаци за пријаву у config.yml

Пример описа

„Paper 1.21.4 плагин за економију под називом Coins који се региструје као Vault економија. /balance [player], /pay <player> <amount> са минимумом од 1, /baltop са првих 10 и /eco give|take|set за играче са coins.admin. Нови играчи почињу са 100 новчића. Две децимале. Свака уплата се бележи са датумом, пошиљаоцем, примаоцем и износом. Стања се чувају у SQLite-у. Називи валуте и све поруке у config.yml.“

Codexe подразумевано користи SQLite кад не тражиш нешто друго. Ако тражиш MySQL, плагин се пише са подешавањем storage-type, а тест сервер му додељује сопствену MySQL базу док га испробаваш.

Питања

Да ли ми треба Vault?

Не за самосталну економију коју ништа друго не користи. Треба ти чим други плагини (продавнице, послови, аукције) морају да читају или мењају стања, јер управо тај API траже.

Могу ли да га покрећем поред EssentialsX-а?

EssentialsX има сопствену економију и такође је региструје у Vault-у. Покрећи једну по једну економију или искључи ону коју не желиш, иначе други плагини могу да користе другачије стање од оног које приказују твоје команде.

Могу ли више сервера да деле иста стања?

Да, са MySQL-ом или MariaDB-ом као складиштем и истом базом у config.yml сваког сервера. Затражи то у захтеву да би плагин читао стања из базе уместо да их предуго држи у кешу.

Како да га тестирам без правог сервера?

Преко „Испробај одмах“: покреће се приватни Paper сервер твоје верзије са компајлираним плагином, а плагини наведени у depend и softdepend, као што је Vault, инсталирају се уз њега. Бесплатни план има 3 тест сервера дневно, по 10 минута.

Направи економију за свој сервер

Овај промпт се отвара спреман за слање:

“Paper 1.21.4 плагин за економију под називом Coins који се региструје као Vault економија: /balance, /pay са минимумом од 1, /baltop првих 10, /eco give|take|set за coins.admin, почетно стање 100, две децимале, свака уплата се бележи, стања у SQLite-у, називи валуте и поруке у config.yml.”

Генериши ово уз Codexe
Како направити Minecraft плагин за економију (Vault, Paper) | Codexe