Jak zrobić plugin ekonomii do Minecrafta

Krok po kroku

1. 1.Zdecyduj, czym jest plugin

   Albo jest ekonomią (przechowuje salda i rejestruje się jako ekonomia w Vault), albo korzysta z istniejącej ekonomii przez Vault (sklep, nagrody za głowy, plugin prac). Większość serwerów potrzebuje po jednym z każdego, a nie dwóch ekonomii.

2. 2.Wybierz serwer i wersję

   Wpisz silnik serwera i wersję, na przykład Paper 1.21.4. Plugin jest budowany pod API i poziom Javy tej wersji.

3. 3.Wypisz komendy i zasady

   /balance, /pay <player> <amount>, /baltop oraz komendy admina, takie jak /eco give|take|set. Dodaj saldo początkowe, nazwę waluty, miejsca po przecinku i minimalną kwotę przelewu.

4. 4.Wybierz, gdzie zapisywać salda

   SQLite dla jednego serwera, MySQL, jeśli kilka serwerów musi współdzielić te same salda. Pieniądze muszą przetrwać restarty i awarie, więc nigdy nie są trzymane tylko w pamięci.

5. 5.Pozwól Codexe go napisać i zbudować

   Opisz plugin i wymień Vault z nazwy, żeby został dodany jako zależność. Codexe pisze kod Java, plugin.yml i config.yml, kompiluje go i naprawia błędy builda, zanim projekt będzie gotowy.

6. 6.Przetestuj przelewy w grze

   Naciśnij Wypróbuj teraz i wejdź na serwer testowy. Zrób przelew między dwoma kontami, spróbuj kwot za dużych, ujemnych i takich, które nie są liczbą, potem zrestartuj serwer i sprawdź, czy salda nadal są na miejscu.

7. 7.Zainstaluj go

   Wrzuć Vault i swój plik .jar do folderu plugins/ serwera i zrestartuj go. Usuń inne pluginy ekonomii albo zdecyduj, którego ma używać Vault.

Jak działa Vault

Vault to most, a nie ekonomia. Plugin ekonomii implementuje interfejs Economy z Vault i rejestruje go w menedżerze usług serwera; inne pluginy pobierają go przez getServer().getServicesManager().getRegistration(Economy.class) i wywołują metody takie jak getBalance, withdrawPlayer i depositPlayer.

Dzięki temu plugin sklepu nigdy nie musi wiedzieć, jakiej ekonomii używasz. W plugin.yml użyj depend: [Vault], gdy plugin nie działa bez niego, albo softdepend, gdy Vault jest opcjonalny. API Vault jest potrzebne tylko do kompilacji; sam Vault instaluje się na serwerze.

Decyzje do wpisania w prośbie

• Format pieniędzy: nazwa waluty w liczbie pojedynczej i mnogiej, symbol, liczba miejsc po przecinku.
• Limity: saldo początkowe, saldo maksymalne, czy salda mogą spaść poniżej zera.
• Gracze offline: czy /pay i /eco działają na graczy, którzy nie są online.
• Logowanie: dziennik transakcji w bazie danych lub w pliku, żeby administracja mogła sprawdzać spory.
• Zarabianie: zabijanie mobów, nagrody za czas gry, sprzedaż przedmiotów albo tylko komendy admina.

Gdzie zapisywać salda

Przykładowy opis

„Plugin ekonomii na Paper 1.21.4 o nazwie Coins, który rejestruje się jako ekonomia w Vault. /balance [player], /pay <player> <amount> z minimum 1, /baltop z top 10 oraz /eco give|take|set dla graczy z coins.admin. Nowi gracze zaczynają ze 100 monetami. Dwa miejsca po przecinku. Każdy przelew zapisywany z datą, nadawcą, odbiorcą i kwotą. Salda zapisywane w SQLite. Nazwy waluty i wszystkie wiadomości w config.yml.”

Codexe domyślnie używa SQLite, jeśli nie poprosisz o coś innego. Jeśli poprosisz o MySQL, plugin dostaje ustawienie storage-type, a serwer testowy daje mu na czas testów własną bazę MySQL.

Pytania