FiveM resource (FXServer)
Resource blazevip dělá na FiveM serveru totéž co Java plugin na Minecraftu: vyzvedává zaplacená doručení (aktivace, odebrání, test), spouští příkazy v serverové konzoli, pamatuje si provedená doručení (aby se nic nespustilo dvakrát), posílá heartbeat do panelu a drží lokální cache VIP pro /vip.
Identifikace hráče
FiveM nemá veřejný převod jména na ID, takže hráč při nákupu zadá svůj identifikátor: license:… (doporučeno), steam:…, discord:… nebo fivem:…. V příkazech je dostupný jako {player}. Hru serveru zvolíš při jeho vytvoření a později ji nejde změnit.
Instalace
1. Token
V panelu majitele otevři server → Integrace → Plugin a API tokeny → vytvoř token (zobrazí se jen jednou).
2. Nahraj resource
Stáhni blazevip-fivem.zip a rozbal ho do resources/[blazehost]/ — vznikne složka resources/[blazehost]/blazevip. Nejrychlejší je průvodce na stránce serveru v panelu: připraví ti i řádky do server.cfg s vloženým tokenem.
3. server.cfg
# Token jen přes "set" — NIKDY "setr" (ten se posílá všem klientům)
set blazevip_token "blz_TVUJ_TOKEN_ZE_PANELU"
ensure blazevip
# Kdo smí kontrolovat cizí VIP a používat admin příkazy
add_ace group.admin blazevip.check.others allow
add_ace group.admin command.blazevip allowPříkazy balíčků
Typicky přidání do ACE skupiny — idempotentní, takže případné opakování nevadí:
add_principal identifier.{player} group.vip
remove_principal identifier.{player} group.vip{player} je identifikátor hráče (license:…), ne číslo hráče na serveru. Příkazy frameworků jako ESX giveitem / giveaccountmoney, QBCore givemoney nebo ox_inventory additem čekají server ID online hráče — s {player} nefungují. Resource 2.4+ hlásí panelu seznam příkazů serveru, takže editor produktu upozorní na příkaz, který server mezi registrovanými nehlásí. FXServer ale nehlásí všechno (např. say nebo příkazy frameworků) — vestavěné a běžné příkazy ESX / QBCore / ox (giveitem, giveaccountmoney, setgroup…) proto bere jako známé a ostatní při doručení jen zapíše jako varování do konzole a spustí je. Vlastní příkazy doplníš do Config.Delivery.KnownCommands; přísný režim, který neznámý příkaz nespustí a nahlásí „Command not handled“, zapneš přes Config.Delivery.FailOnUnknownCommand = true.Konzolová ochrana: quit, exec, rcon_password, set/sets/setr/seta, sv_licensekey, start/stop/ensure/restart/refresh, endpoint_add_*, remove_ace, add_ace … command, add_ace builtin.everyone … a add_principal … group.admin|god|superadmin|owner doručení nikdy nespustí; stejně tak příkaz obsahující ; nebo nový řádek. Panel takové příkazy odmítne už při uložení balíčku a resource je odmítne znovu před spuštěním. V config.lua můžeš navíc nastavit allowlist (AllowedCommands) a další zakázané příkazy.
config.lua
Config.Sync.IntervalSeconds = 30 -- vyzvedávání doručení
Config.Sync.HeartbeatSeconds = 60
Config.Delivery.StaggerMs = 250 -- mezera mezi příkazy
Config.Delivery.RerunAfterCrash = false
Config.Delivery.AllowedCommands = { 'add_principal', 'remove_principal', 'say' }Pád serveru uprostřed doručení
Resource si před prvním příkazem uloží značku IN_PROGRESS a po posledním DONE (KVP úložiště resource). Doručení přerušené pádem se samo znovu nespustí — resource ho nahlásí k ruční kontrole. Po kontrole hráče použij v konzoli blazevip resolve <deliveryId> done (už proběhlo) nebo rerun (spustit znovu).
Admin příkazy
blazevip status
blazevip sync
blazevip resolve <deliveryId> done|rerun
vip check <serverId hráče>