Discord
Wiki - Pluginy

TokenManager - system tokenów na serwerze

TokenManager to plugin dodający alternatywną walutę tokenową na serwerze Minecraft. Gracze zdobywają tokeny za głosowanie, wykonywanie zadań, zabijanie i inne aktywności, a następnie wydają je w dedykowanym sklepie tokenowym. Idealne uzupełnienie standardowej ekonomii pieniężnej.

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

Co to jest TokenManager

TokenManager to darmowy plugin wprowadzający system tokenów jako drugą walutę na serwerze. W przeciwieństwie do standardowej ekonomii (pieniądze z Vault), tokeny są walutą premium - trudniejszą do zdobycia, przeznaczoną na ekskluzywne nagrody.

Typowy scenariusz: gracz zarabia pieniądze kopając i handlując (ekonomia Vault), a tokeny zdobywa głosując na serwer, wygrywając eventy lub wypełniając wyzwania. Pieniądze wydaje w zwykłym sklepie (ShopGUI+), a tokeny w specjalnym sklepie tokenowym na unikalne nagrody.

TokenManager jest dostępny na SpigotMC. Działa samodzielnie - nie wymaga Vault (ma własny silnik walutowy). Obsługuje MySQL, SQLite i flat-file. Wersje 1.8 do 1.21.x.

Zdobywanie tokenów

TokenManager oferuje wiele sposobów na zdobywanie tokenów przez graczy:

  • Głosowanie - integracja z Votifier/NuVotifier. Gracz głosuje na serwer i automatycznie otrzymuje tokeny.
  • Zabijanie mobów - konfigurowalny drop tokenów per typ moba (np. 5 tokenów za Ender Dragona, 1 za zombie).
  • Zabijanie graczy - tokeny za zabójstwa w PvP (na serwerach PvP/Factions).
  • Kopanie bloków - tokeny za wydobywanie rud (popularne na serwerach Prison).
  • Komendy admina - /token give [gracz] [ilość] do ręcznego przyznawania.
  • Skrypty - przez PlaceholderAPI i integracje z innymi pluginami.

Każdy źródło tokenów jest konfigurowane oddzielnie. Możesz włączyć tylko głosowanie, tylko zabijanie, albo wszystko naraz. Kwoty tokenów za każdą akcję ustala admin w konfiguracji.

Sklep tokenowy

TokenManager posiada wbudowany sklep GUI, w którym gracze wydają tokeny. Sklep otwierasz komendą /tokenmanager shop lub /tm shop. Admin definiuje produkty w pliku shops.yml:

shop:
  vip-rank:
    name: "&6Ranga VIP (30 dni)"
    material: GOLD_INGOT
    price: 500
    slot: 10
    commands:
      - "lp user %player% parent addtemp vip 30d"
  fly-1h:
    name: "&bLatanie przez 1 godzinę"
    material: FEATHER
    price: 50
    slot: 11
    commands:
      - "lp user %player% permission settemp essentials.fly true 1h"
  diamond-kit:
    name: "&bZestaw diamentowy"
    material: DIAMOND_CHESTPLATE
    price: 200
    slot: 12
    commands:
      - "give %player% diamond_sword 1"
      - "give %player% diamond_chestplate 1"
      - "give %player% diamond_leggings 1"
      - "give %player% diamond_boots 1"

Produkty mogą wykonywać dowolne komendy konsolowe - od nadawania rang przez LuckPerms, przez dawanie przedmiotów, po otwieranie skrzynek (CrazyCrates). To czyni sklep tokenowy niezwykle elastycznym.

Komendy i uprawnienia

Komenda Opis Uprawnienie
/tokens Sprawdza saldo tokenów tokenmanager.use
/tokens [gracz] Sprawdza saldo innego gracza tokenmanager.check
/tm shop Otwiera sklep tokenowy tokenmanager.shop
/tm send [gracz] [ilość] Przesyła tokeny innemu graczowi tokenmanager.send
/tm top Ranking graczy z największą liczbą tokenów tokenmanager.top
/tm give [gracz] [ilość] Daje tokeny graczowi (admin) tokenmanager.admin
/tm take [gracz] [ilość] Zabiera tokeny graczowi (admin) tokenmanager.admin

Konfiguracja

Główne ustawienia w plugins/TokenManager/config.yml:

# Baza danych
storage-type: SQLITE           # SQLITE, MYSQL, FLAT_FILE

# Głosowanie (wymaga Votifier)
vote-reward: 10                # tokenów za każdy głos

# Zabijanie mobów
mob-killing:
  enabled: true
  rewards:
    ZOMBIE: 1
    SKELETON: 1
    CREEPER: 2
    ENDER_DRAGON: 50
    WITHER: 30

# PvP
pvp-killing:
  enabled: false
  reward: 5

# Transfer między graczami
allow-transfer: true
transfer-tax: 0                # procent podatku od transferu

TokenManager obsługuje PlaceholderAPI - placeholder %tokenmanager_tokens% wyświetla saldo gracza. Możesz go użyć w scoreboard, hologramach (DecentHolograms) i tabliście (TAB).

Zastosowania na serwerze

  • Nagrody za głosowanie - najczęstsze zastosowanie. Gracz głosuje na serwer, dostaje tokeny, wydaje je w sklepie na rangi VIP, kity i bonusy.
  • Waluta eventowa - podczas wydarzeń (PvP turniej, konkurs budowania) nagradzaj zwycięzców tokenami zamiast pieniędzy.
  • Waluta sezonowa - resetuj tokeny co sezon, zachowując ekonomię pieniężną. Gracze startują od zera w nowym sezonie tokenowym.
  • System osiągnięć - w połączeniu z pluginem zadań (np. AuraSkills) nagradzaj osiągnięcia tokenami.
  • Serwery Prison - tokeny za kopanie bloków, wydawane na ulepszenia kopalni i narzędzi.

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