ESX, QBCore, nebo Qbox: jaký framework pro FiveM roleplay server?

Kdo zakládá FiveM roleplay server, dříve či později narazí na otázku, na jakém frameworku ho postavit. Nejčastěji padají tři jména: ESX, QBCore a Qbox. Všechny tři jsou open source, všechny řeší podobné věci a na všech běží funkční servery. Liší se ale ekosystémem skriptů, způsobem vývoje a tím, s čím jsou kompatibilní. Tento článek vám nedá jednoho vítěze — dá vám kritéria, podle kterých si vyberete sami.

Co framework dělá

Samotný FiveM server nemá postavy, peníze, práce ani inventář. To všechno přidává framework: sadu resources, které definují hráčská data a jejich ukládání do databáze, ekonomiku, joby, oprávnění a funkce, přes které s tím mluví ostatní skripty. Framework je tedy základ, na kterém stojí všechno ostatní — telefon, garáže, obchody, policejní a záchranářské systémy.

Z toho plyne nejdůležitější praktický důsledek: skripty se píší pro konkrétní framework. Skript pro ESX volá funkce ESX a čeká tabulky v databázi ve tvaru, jaký používá ESX. Na QBCore bez úprav nepoběží a naopak. Přechod na jiný framework v pozdější fázi proto obvykle znamená přepsat nebo vyměnit velkou část skriptů a převést data hráčů.

ESX

ESX je nejstarší z trojice a dlouho byl synonymem pro FiveM roleplay. Dnešní udržovaná verze se jmenuje ESX Legacy a vyvíjí ji ESX tým v organizaci esx-framework na GitHubu; dokumentace je na docs.esx-framework.org. S databází pracuje přes oxmysql.

Výhodou dlouhé historie je obrovské množství existujících skriptů, návodů a vývojářů, kteří ESX znají. Nevýhodou je, že část starších skriptů vznikla pro dřívější verze ESX a na ESX Legacy může potřebovat úpravy. U každého staršího resource se proto vyplatí ověřit, pro jakou verzi byl napsaný a jestli se ještě udržuje.

QBCore

QBCore je mladší framework postavený jako sada modulárních resources s předponou qb- (například qb-core, qb-inventory, joby a další systémy). Vyvíjí se v organizaci qbcore-framework na GitHubu a dokumentace je na docs.qbcore.org. I QBCore používá pro databázi oxmysql.

Oproti ESX nabízí QBCore v základní instalaci víc hotových roleplay systémů, takže se s ním dá rychleji dostat k hratelnému serveru. Kolem QBCore vznikl velký ekosystém volných i placených skriptů a řada placených skriptů dnes podporuje ESX i QBCore zároveň. Protože je v základu víc resources, bývá výchozí instalace náročnější na paměť.

Qbox

Qbox vznikl jako fork QBCore. Jádro (qbx_core) staví na knihovnách z ekosystému ox — ox_lib, ox_inventory a oxmysql — a snaží se přitom zůstat kompatibilní se skripty pro QBCore díky vrstvě pro zpětnou kompatibilitu. Projekt žije v organizaci Qbox-project na GitHubu, dokumentace je na docs.qbox.re.

Qbox je zajímavý pro ty, kdo chtějí přístup k ekosystému QBCore, ale preferují ox knihovny a jejich způsob práce. Kompatibilita ale neznamená stoprocentní shodu: skripty, které sahají hluboko do vnitřností QBCore nebo počítají s qb-inventory, mohou vyžadovat úpravy. Seznam toho, co je a není podporované, uvádí dokumentace Qboxu.

Srovnání v tabulce

Jak se rozhodnout

Místo otázky „který je nejlepší“ si položte tyto:

• Jaké skripty už máte nebo chcete koupit? Pokud máte zaplacené skripty pro konkrétní framework, je to silný argument. Ověřte, které frameworky autoři podporují.
• Co zná váš vývojář nebo tým? Framework, ve kterém se tým orientuje, ušetří víc času než teoretické výhody jiného.
• Chcete rychle hratelný základ, nebo stavět od menšího jádra? QBCore a Qbox dávají v základu víc hotových systémů, ESX Legacy je střídmější.
• Láká vás ekosystém ox? Pokud chcete stavět na ox_lib a ox_inventory, nabízí se Qbox; tyto knihovny se ale běžně používají i s ESX.
• Jak aktivní je vývoj? Podívejte se na nedávné commity a vydání v repozitářích a na aktuálnost dokumentace.

Placené skripty a escrow

Mnoho placených skriptů se distribuuje přes systém Asset Escrow od Cfx.re. Takový skript je navázaný na účet Cfx.re, který ho koupil, a funguje na serveru s licenčním klíčem z tohoto účtu. Při stěhování serveru nebo změně frameworku proto počítejte s tím, že klíč i nákupy zůstávají u vašeho účtu, ne u hostingu — a že escrow skript pro jeden framework nemusíte mít možnost sami upravit pro jiný.

Co to znamená pro hosting

Všechny tři frameworky potřebují MySQL nebo MariaDB databázi, licenční klíč Cfx.re a rozumně aktuální server artifacts. Pro víc než 32 hráčů je potřeba OneSync. Základ serveru lze nasadit přes recept v txAdminu; postup pro konkrétní framework popisuje jeho dokumentace. U nás najdete MySQL a txAdmin přímo u služby — viz návod Databáze a txAdmin — a verzi artifacts si změníte podle návodu Změna verze artifacts.

Paměť určuje hlavně množství a kvalita resources. Doporučovač na stránce FiveM tarifů bere jako výchozí bod zhruba 4 GB pro ESX a 5 GB pro QBCore a přidává rezervu podle počtu hráčů a náročnosti skriptů; předpokládá jednu instanci serveru a databázi na stejném stroji. Qbox v doporučovači samostatně nemáme — jako výchozí bod poslouží QBCore. Pokud chcete změnit framework na stávajícím serveru, začněte čistou instalací podle návodu Reinstalace FiveM serveru a databázi si předem vyexportujte.

Shrnutí

ESX Legacy má nejdelší historii a velké množství skriptů, u starších je ale potřeba hlídat kompatibilitu. QBCore dává v základu víc hotových roleplay systémů a má široký ekosystém. Qbox staví na knihovnách ox a udržuje kompatibilitu s většinou QBCore skriptů. Rozhodujte podle skriptů, které chcete používat, podle zkušeností týmu a podle aktivity vývoje — a počítejte s tím, že pozdější přechod je drahý. Pokud si nejste jistí velikostí tarifu, napište nám přes kontakt seznam resources a poradíme.