Discord
Wiki - Pluginy

CoinsEngine - wiele walut na serwerze

CoinsEngine to plugin od NightExpress pozwalający na tworzenie nieograniczonej liczby niestandardowych walut na serwerze Minecraft. Złoto, diamenty, tokeny, kryształy - każda waluta z własną nazwą, symbolem, formatem i integracją z Vault. Idealne dla serwerów RPG, Skyblock i Prison z wielowalutową ekonomią.

Czas czytania: ~5 min Platforma: Paper / Spigot / Purpur

Co to jest CoinsEngine

CoinsEngine to darmowy plugin walutowy od NightExpress, twórcy popularnych pluginów ExcellentShop, ExcellentCrates i ExcellentEnchants. Główna różnica między CoinsEngine a prostszymi pluginami jak PlayerPoints czy TokenManager to obsługa wielu walut jednocześnie.

Zamiast jednej waluty możesz stworzyć dowolną liczbę: złoto (główna waluta ekonomii), diamenty (waluta premium za głosowanie), kryształy (waluta eventowa), prestiż (waluta sezonowa). Każda waluta ma osobne saldo, komendy, placeholder i może być zarejestrowana w Vault jako niezależny dostawca ekonomii.

CoinsEngine jest dostępny na SpigotMC. Wymaga Java 17+ i Paper/Spigot 1.18+. Opcjonalnie integruje się z Vault i PlaceholderAPI.

Tworzenie walut

Waluty definiujesz w folderze plugins/CoinsEngine/currency/. Każda waluta to osobny plik YAML:

# plugins/CoinsEngine/currency/gold.yml
name: "Złoto"
symbol: "$"
format: "%amount%$"
decimal: false
start-value: 500.0
max-value: 10000000.0
vault-economy: true
command-aliases:
  - gold
  - zloto
  - bal
# plugins/CoinsEngine/currency/diamenty.yml
name: "Diamenty"
symbol: "💎"
format: "%amount% 💎"
decimal: false
start-value: 0
max-value: 100000
vault-economy: false
command-aliases:
  - diamenty
  - gems

Parametr vault-economy: true rejestruje walutę jako dostawcę ekonomii w Vault. Tylko jedna waluta powinna mieć tę opcję włączoną - to będzie główna waluta serwera, z którą integrują się pluginy sklepowe, ChestShop, QuickShop i inne.

Po utworzeniu pliku i przeładowaniu pluginu (/coinsengine reload) waluta jest natychmiast dostępna. Gracze mogą sprawdzać saldo i przesyłać środki.

Komendy i uprawnienia

Komenda Opis Uprawnienie
/[waluta] balance Saldo danej waluty coinsengine.currency.[waluta]
/[waluta] send [gracz] [kwota] Przelew do innego gracza coinsengine.currency.[waluta].send
/[waluta] top Ranking najbogatszych coinsengine.currency.[waluta].top
/coinsengine give [gracz] [waluta] [kwota] Daje walutę graczowi (admin) coinsengine.admin
/coinsengine take [gracz] [waluta] [kwota] Zabiera walutę (admin) coinsengine.admin
/coinsengine set [gracz] [waluta] [kwota] Ustawia dokładną wartość coinsengine.admin
/coinsengine reload Przeładowuje konfigurację coinsengine.admin

Komendy gracza używają aliasów zdefiniowanych w konfiguracji waluty. Jeśli waluta "złoto" ma alias bal, gracz wpisuje /bal żeby sprawdzić saldo - identycznie jak w EssentialsX.

Integracja z Vault

CoinsEngine rejestruje się w Vault jako dostawca ekonomii. Waluta z opcją vault-economy: true staje się widoczna dla wszystkich pluginów obsługujących Vault: ChestShop, QuickShop Hikari, ShopGUI+ i inne.

To oznacza, że możesz zastąpić ekonomię EssentialsX pluginem CoinsEngine bez zmiany konfiguracji sklepów. Wystarczy ustawić vault-economy: true na głównej walucie, a Vault automatycznie przekieruje wszystkie operacje ekonomiczne do CoinsEngine.

Pozostałe waluty (bez Vault) są dostępne przez API CoinsEngine i PlaceholderAPI. Pluginy, które natywnie obsługują CoinsEngine (ExcellentShop, ExcellentCrates) mogą korzystać z dowolnej waluty bez Vault.

Konfiguracja i baza danych

Główna konfiguracja w plugins/CoinsEngine/config.yml:

# Baza danych
database:
  type: SQLITE                 # SQLITE lub MYSQL
  mysql:
    host: localhost
    port: 3306
    database: coinsengine
    user: root
    password: ""

# Ogólne
purge-inactive-days: 60        # usuń dane nieaktywnych graczy
save-interval: 300             # zapis do bazy co 5 minut (sekundy)

PlaceholderAPI placeholdery generują się automatycznie per waluta: %coinsengine_balance_[nazwa_waluty]%. Możesz wyświetlać saldo każdej waluty osobno w scoreboard, TAB i hologramach.

Zastosowania

  • Serwer RPG - złoto (ekonomia), klejnoty doświadczenia (umiejętności), monety lojalności (daily login). Trzy waluty, trzy cele, trzy powody do grania.
  • Serwer Skyblock - pieniądze (handel między wyspami), prestiż (rangi), tokeny (sklep VIP). Waluty nie kolidują ze sobą.
  • Serwer Prison - pieniądze (kopanie), tokeny (ulepszenia), kryształy (cratesy). Każda waluta ma swój obieg i cel.
  • Serwer sezonowy - główna waluta resetowana co sezon + waluta permanentna (tokeny lojalnościowe) przenoszona między sezonami.

CoinsEngine najlepiej współpracuje z innymi pluginami NightExpress: ExcellentShop (sklep z wieloma walutami) i ExcellentCrates (skrzynki kupowane za dowolną walutę).

Powiązane artykuły: Vault, PlayerPoints, TokenManager, katalog pluginów.