Jak vytvořit ekonomický plugin pro Minecraft

Krok za krokem

1. 1.Rozhodni, čím plugin bude

   Buď ekonomikou je (ukládá zůstatky a registruje se jako ekonomika pro Vault), nebo existující ekonomiku přes Vault používá (obchod, odměny za hlavy, plugin na práce). Většina serverů potřebuje od každého jeden, ne dvě ekonomiky.

2. 2.Vyber server a verzi

   Napiš serverový software a verzi, například Paper 1.21.4. Plugin se sestaví pro API a úroveň Javy této verze.

3. 3.Sepiš příkazy a pravidla

   /balance, /pay <player> <amount>, /baltop a příkazy pro adminy jako /eco give|take|set. Přidej počáteční zůstatek, název měny, počet desetinných míst a minimální platbu.

4. 4.Vyber, kam se zůstatky ukládají

   SQLite pro jeden server, MySQL, pokud má víc serverů sdílet stejné zůstatky. Peníze musí přežít restarty i pády, takže se nikdy nedrží jen v paměti.

5. 5.Nech Codexe napsat a sestavit ho

   Popiš plugin a výslovně zmiň Vault, aby se přidal jako závislost. Codexe napíše kód v Javě, plugin.yml a config.yml, zkompiluje ho a opraví chyby sestavení, než projekt označí jako Ready.

6. 6.Otestuj platby ve hře

   Stiskni Vyzkoušet hned a připoj se na testovací server. Pošli platbu mezi dvěma účty, zkus příliš velké, záporné nebo nečíselné částky, pak restartuj a zkontroluj, že zůstatky zůstaly.

7. 7.Nainstaluj ho

   Dej Vault a svůj .jar do složky plugins/ na serveru a restartuj. Odstraň jakýkoli jiný ekonomický plugin, nebo rozhodni, který má Vault používat.

Jakou roli hraje Vault

Vault je most, ne ekonomika. Ekonomický plugin implementuje rozhraní Economy z Vaultu a zaregistruje ho ve správci služeb serveru; ostatní pluginy si o něj řeknou přes getServer().getServicesManager().getRegistration(Economy.class) a volají metody jako getBalance, withdrawPlayer a depositPlayer.

Plugin pro obchod tak nikdy nemusí vědět, jakou ekonomiku používáš. V plugin.yml použij depend: [Vault], když plugin bez Vaultu nefunguje, nebo softdepend, když je Vault volitelný. API Vaultu je potřeba jen ke kompilaci; samotný Vault se instaluje na server.

Co rozhodnout v zadání

• Formát peněz: název měny v jednotném a množném čísle, symbol, počet desetinných míst.
• Limity: počáteční zůstatek, maximální zůstatek, jestli může jít zůstatek do mínusu.
• Offline hráči: jestli /pay a /eco fungují i na hráče, kteří nejsou online.
• Záznamy: log transakcí v databázi nebo v souboru, aby tým mohl řešit spory.
• Vydělávání peněz: zabíjení mobů, odměny za odehraný čas, prodej předmětů, nebo jen příkazy pro adminy.

Kam ukládat zůstatky

Příklad popisu

„Ekonomický plugin pro Paper 1.21.4 jménem Coins, který se registruje jako ekonomika pro Vault. /balance [player], /pay <player> <amount> s minimem 1, /baltop s top 10 a /eco give|take|set pro hráče s coins.admin. Noví hráči začínají se 100 mincemi. Dvě desetinná místa. Každá platba se zaznamená s datem, odesílatelem, příjemcem a částkou. Zůstatky uložené v SQLite. Názvy měny a všechny zprávy v config.yml.“

Codexe ve výchozím stavu používá SQLite, pokud nepožádáš o něco jiného. Když požádáš o MySQL, plugin se napíše s nastavením storage-type a testovací server mu po dobu zkoušení přidělí vlastní databázi MySQL.

Otázky