Instalace pluginu

Oficiální plugin BlazeVip běží na Paper i Spigot (1.20+, Java 17+). Postará se o vyzvedávání nákupů, spouštění příkazů, potvrzování a lokální cache VIP statusů.

Požadavky

Paper nebo Spigot 1.20+, Java 17 nebo novější, a odchozí HTTPS spojení na vip.blazehost.cz. Plugin nepotřebuje databázi ani žádné další závislosti.

Instalace

1. Nahraj jar

Zkopíruj BlazeVip.jar do složky plugins/ svého serveru.

2. První spuštění

Spusť (nebo restartuj) server. Plugin vytvoří výchozí plugins/BlazeVip/config.yml a v konzoli upozorní, že chybí token.

3. Konfigurace

Otevři config a vyplň URL a token vygenerovaný v panelu:

plugins/BlazeVip/config.yml

api:
  # Musí být https:// (výjimka: http://localhost pro vývoj)
  url: "https://vip.blazehost.cz"
  token: "blz_TVUJ_TOKEN_ZE_PANELU"

sync:
  interval-seconds: 30      # jak často fetchovat nové nákupy
  batch-size: 25            # max nákupů na jeden dotaz
  vip-cache-seconds: 300    # obnova lokální cache VIP

delivery:
  stagger-ticks: 1          # mezera mezi příkazy (řeší async permission pluginy)
  ack-on-command-error: false

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řenášej config jen bezpečně a nikdy ho necommituj do gitu.

4. Reload

Restartuj server, nebo použij /blazevip reload. V konzoli by se mělo objevit:

console

[BlazeVip] BlazeVip aktivní. Synchronizace každých 30s.
[BlazeVip] VIP cache obnovena: 12 hráčů.

Příkazy

in-game

/vip                     # tvůj VIP status
/vip check <hráč>        # status jiného hráče (blazevip.check.others)
/blazevip status         # stav pluginu, velikost cache, interval
/blazevip sync           # okamžitě spustí synchronizaci
/blazevip reload         # znovu načte config.yml

Řešení problémů

„API token byl odmítnut“

Token je špatný, byl zneplatněn, nebo je server vypnutý. Plugin synchronizaci zastaví, aby zbytečně nezatěžoval API. Vygeneruj nový token, vlož ho a dej /blazevip reload.

Nákupy nechodí

Zkontroluj /blazevip status a zapni debug: true. Ověř, že server má odchozí HTTPS a že objednávka je ve stavu Zaplaceno (ne Čeká) — Čeká znamená, že nákup neproběhl kvůli nedostatku kreditu.

Příkaz se spustil dvakrát

To je očekávané chování při výpadku sítě — doručení je „alespoň jednou“. Napiš příkazy idempotentně (viz varování výše). Není to chyba pluginu.