Přeskočit na obsah

Instalace a aktualizace pluginu

Oficiální plugin BlazeVip 2 běží na Paper i Spigot (1.20+, Java 17+). Vyzvedává zaplacené nákupy, spouští příkazy pro aktivaci i odebrání VIP, pamatuje si provedená doručení (aby se nic nespustilo dvakrát), posílá heartbeat do panelu a drží lokální cache VIP statusů.

Stažení

Aktuální verzi stáhneš zde: BlazeVip.jar. Plugin nepotřebuje žádné další závislosti — SQLite ovladač je součástí Paper/Spigot.

Instalace

1. Token

V panelu majitele otevři server → Integrace → Plugin a API tokeny → vytvoř token. Token se zobrazí jen jednou.

2. Nahraj jar a spusť server

Zkopíruj BlazeVip.jar do plugins/ a spusť server. Plugin vytvoří plugins/BlazeVip/config.yml.

3. Konfigurace

plugins/BlazeVip/config.yml
api:
  url: "https://vip.blazehost.cz"   # musí být https://
  token: "blz_TVUJ_TOKEN_ZE_PANELU"

sync:
  interval-seconds: 30      # jak často vyzvedávat doručení
  batch-size: 25
  vip-cache-seconds: 300
  heartbeat-seconds: 60     # server může interval upravit

store:
  retention-days: 30        # jak dlouho si pamatovat provedená doručení

delivery:
  stagger-ticks: 1          # mezera mezi příkazy (async permission pluginy)
  ack-on-command-error: false
  # Ochrana konzole (plugin 2.2): op, deop, stop, restart, reload, whitelist,
  # sudo … a LuckPerms "permission set *" doručení NIKDY nespustí.
  allowed-commands: []      # doporučeno: jen povolené příkazy, např. ["lp", "give"]
  denied-commands: []       # další zakázané příkazy
  # Každý spuštěný příkaz se zapisuje do plugins/BlazeVip/commands.log

messages:
  vip-delivered: "&aVIP balíček &c{package} &abyl aktivován pro &c{player}&a!"
  vip-revoked: ""           # prázdné = bez oznámení
  test-delivered: "&aTestovací doručení proběhlo úspěšně."

debug: false
Token nikdy nesdílej. Kdokoli ho má, může číst nákupy tvých hráčů a označovat je za doručené. Při podezření na únik ho v panelu okamžitě zneplatni a vytvoř nový.

4. Ověření

Po /blazevip reload (nebo restartu) se v panelu u serveru do minuty objeví Plugin online s verzí. Pak v sekci Spuštění obchodu pošli testovací doručení — projde celou cestou (vyzvednutí → provedení → potvrzení) bez platby.

Příkazy

in-game
/vip                     # tvůj VIP status
/vip check <hráč>        # status jiného hráče (blazevip.check.others)
/blazevip status         # verze, heartbeat, stav lokálního úložiště, poslední doručení
/blazevip sync           # okamžitě spustí synchronizaci
/blazevip reload         # znovu načte config a restartuje zastavené smyčky

Aktualizace pluginu

Stáhni nový jar, nahraď starý v plugins/ a restartuj server. Soubor plugins/BlazeVip/deliveries.db nemaž — obsahuje seznam provedených doručení, díky kterému se nic nespustí dvakrát. Panel u serveru ukazuje, když je plugin zastaralý; pokud klesne pod minimální podporovanou verzi, API doručování odmítne (HTTP 426) a plugin to jasně zapíše do konzole — heartbeat ale běží dál.

Plugin 1.x funguje dál pro aktivaci VIP, ale neumí odebrání VIP (vypršení, refundace) ani testovací doručení. Tato doručení čekají, dokud nenainstaluješ verzi 2.

Jak psát příkazy

Ke každému balíčku patří příkazy pro aktivaci a pro odebrání VIP (spustí se při vypršení nebo refundaci). Používej {player} nebo {uuid}, bez úvodního lomítka.

příklad (LuckPerms)
aktivace:  lp user {player} parent add vip
odebrání:  lp user {player} parent remove vip

Příkazy musí být idempotentní — dvojí spuštění nesmí nic pokazit. Plugin 2 dvojímu spuštění brání, ale při tvrdém pádu serveru v nevhodnou milisekundu se to výjimečně stát může. Neznámý příkaz (např. chybí LuckPerms) plugin nahlásí jako chybu; po 5 neúspěšných pokusech se hráči platba automaticky vrátí.

Řešení problémů

„API token byl odmítnut“ / „INSUFFICIENT_SCOPE“

Token je špatný, zneplatněný, server byl smazán, nebo token nemá oprávnění k doručování (token „jen pro čtení“). Vytvoř nový token, vlož ho a dej /blazevip reload.

„Lokální úložiště doručení není dostupné“

Soubor deliveries.db je poškozený nebo nečitelný. Plugin v takovém stavu záměrně nedoručuje (jinak by mohl příkazy spustit dvakrát). Zazálohuj a smaž soubor a dej /blazevip reload.

Nákupy nechodí

Zkontroluj /blazevip status a panel serveru (online/offline, verze). Objednávka musí být ve stavu Zaplaceno. Je-li server v panelu Pozastaven, nové nákupy nejsou možné, ale už zaplacená doručení se dokončí.