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
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: false4. 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
/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čkyAktualizace 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.
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.
aktivace: lp user {player} parent add vip
odebrání: lp user {player} parent remove vipPří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čí.