Как да направиш Minecraft плъгин за икономика

Стъпка по стъпка

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 е мост, а не икономика. Плъгинът за икономика имплементира интерфейса Economy на Vault и го регистрира в services manager на сървъра; другите плъгини го искат с getServer().getServicesManager().getRegistration(Economy.class) и извикват методи като getBalance, withdrawPlayer и depositPlayer.

Така плъгинът за магазин никога не трябва да знае каква икономика ползваш. В plugin.yml използвай depend: [Vault], когато плъгинът не може да работи без него, или softdepend, когато Vault е по избор. Vault API трябва само за компилирането; самият Vault се инсталира на сървъра.

Решения, които да напишеш в заявката

• Формат на парите: име на валутата в единствено и множествено число, символ, колко десетични знака.
• Ограничения: начален баланс, максимален баланс, дали балансите могат да стават отрицателни.
• Офлайн играчи: дали /pay и /eco работят за играчи, които не са онлайн.
• Записи: дневник на транзакциите в базата данни или във файл, за да може екипът да проверява спорове.
• Печелене на пари: убиване на мобове, награди за време в игра, продажба на предмети или само админ команди.

Къде да се пазят балансите

Примерно описание

„Плъгин за икономика за 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 база данни, докато го пробваш.

Въпроси