FiveM Frameworks: ESX, QBCore, QBOX

Testare uno script gratuito?

Gli script gratuiti vanno bene per controlli rapidi. Per server in produzione, confronta pacchetti server completi o script a pagamento mantenuti, in base al framework e al caso d'uso.

La scelta del framework determinerà l'architettura del server, la compatibilità degli script, le caratteristiche prestazionali e la scalabilità a lungo termine per i prossimi 2-3 anni. Con oltre 12.000 server FiveM lanciati su vari framework, questa guida completa fornisce confronti basati sui dati e strategie di implementazione pratica per aiutarti a prendere la decisione giusta.

Panoramica dell'architettura del framework

I framework FiveM forniscono i sistemi fondamentali che alimentano i server di gioco di ruolo: gestione dei giocatori, economie, inventari, sistemi di lavoro e strumenti amministrativi. A differenza delle semplici raccolte di script, i framework offrono API standardizzate, schemi di database e modelli di sviluppo che garantiscono la compatibilità degli script e basi di codice manutenibili.

Nucleo Framework Components:

• Gestione dei giocatori: Creazione del personaggio, persistenza dei dati, supporto multi-personaggio
• Sistema economico: Banking, cash handling, business management
• Gestione dell'inventario: Sistemi di oggetti, stoccaggio, meccanismi di creazione
• Quadro occupazionale: Sistemi di impiego, progressione delle competenze, buste paga
• Strumenti amministrativi: Moderazione dei giocatori, interfacce di gestione del server
• Sistema di eventi: Protocolli di comunicazione tra risorse

Il framework scelto vincola l'ecosistema di script, la struttura del database e la complessità della migrazione. Gli script scritti per ESX non possono essere eseguiti su QBCore senza modifiche significative, rendendo la selezione iniziale fondamentale.

---

Framework ESX: lo standard consolidato

ESX (EssentialMode Extended) domina l'ecosistema FiveM dal 2017, alimentando circa 60-70% di server di roleplay attivi. Basato su un'architettura modulare basata su MySQL, ESX privilegia la completezza delle funzionalità e la retrocompatibilità.

Punti di forza dell'architettura

• Codice base maturo: oltre 6 anni di sviluppo continuo e correzioni di bug
• Documentazione completa: Ampia documentazione ufficiale e della comunità
• Ecosistema di script: La più grande libreria di script compatibili (oltre 5.000 disponibili)
• Progettazione di database: Schema MySQL ben strutturato con scalabilità comprovata
• Supporto multi-carattere: Supporto nativo per più personaggi per account

Caratteristiche delle prestazioni

Sulla base di test effettuati su server da 200 slot:

• Utilizzo della memoria: 150-200 MB di overhead del framework di base
• Query del database: Media di 2,3 query per azione del giocatore
• Caricamento dello script: Tempo di avvio di 45-60 secondi per il framework completo
• Utilizzo delle risorse: Tempo medio di esecuzione dello script 0,02-0,04 ms

Limitazioni note

• Prestazioni generali: Utilizzo intensivo delle risorse con codice legacy scarsamente ottimizzato
• Frammentazione della versione: Diverse versioni di ESX (1.2, 1.8, 1.9, Legacy) con problemi di compatibilità
• Dipendenza dal database: Richiede l'installazione e la manutenzione di MySQL/MariaDB
• Dipendenze legacy: Alcuni script si basano su librerie e pratiche obsolete

Casi d'uso migliori

ESX funziona meglio per:

• Server che richiedono la massima varietà di script e opzioni di personalizzazione
• Comunità con competenze ESX esistenti e modifiche personalizzate
• Server di gioco di ruolo su larga scala che necessitano di stabilità comprovata (oltre 100 giocatori)
• Progetti con amministratori di database dedicati

Modelli di ESX Server più diffusi: Pacchetto server ispirato a YBN LS (ESX) | Raccolta di script ESX

QBCore: l'alternativa alle prestazioni

QBCore è emerso nel 2020 come alternativa a ESX incentrata sulle prestazioni, risolvendo molti dei limiti architetturali di ESX pur mantenendo funzionalità simili. Sviluppato con le moderne pratiche Lua, QBCore punta sull'efficienza e sull'esperienza degli sviluppatori.

Vantaggi dell'architettura

• Base di codice moderna: Scritto con le migliori pratiche FiveM attuali fin dalle fondamenta
• Ottimizzazione delle prestazioni: Progettato per un sovraccarico minimo delle risorse
• Design modulare: Netta separazione delle preoccupazioni tra i componenti del framework
• Adatto agli sviluppatori: API e standard di codifica coerenti in tutto
• Sviluppo attivo: Aggiornamenti regolari e contributi della comunità

Misure di prestazione

Test su configurazioni server identiche da 200 slot:

• Utilizzo della memoria: 80-120 MB di overhead del framework di base (40% in meno rispetto a ESX)
• Efficienza del database: Media di 1,6 query per azione del giocatore (riduzione di 30%)
• Tempo di avvio: 25-35 secondi per il caricamento completo del framework
• Utilizzo delle risorse: Tempo medio di esecuzione 0,01-0,02 ms (50% più veloce di ESX)

Limitazioni del framework

• Libreria di script più piccola: Meno script disponibili rispetto a ESX (oltre 2.000 contro oltre 5.000)
• Curva di apprendimento: Diverse convenzioni richiedono agli sviluppatori ESX di adattarsi
• Dimensione della comunità: Una comunità più piccola significa meno risorse per la risoluzione dei problemi
• Scadenza: Framework più recente con meno test di stabilità a lungo termine

Applicazioni ottimali

QBCore eccelle in:

• Server critici per le prestazioni con risorse hardware limitate
• Nuovi progetti server senza dipendenze ESX esistenti
• I team di sviluppo danno priorità alla qualità e alla manutenibilità del codice
• Comunità di gioco di ruolo su media scala (50-150 giocatori)

Opzioni del server QBCore: Pacchetto completo QBCore V14 | Libreria di script QBCore

QBOX: Il contendente moderno

QBOX QBOX rappresenta il più recente approccio all'architettura del framework FiveM, lanciato nel 2024 con particolare attenzione a prestazioni, sicurezza ed esperienza degli sviluppatori. Sviluppato da esperti sviluppatori FiveM, QBOX integra le conoscenze acquisite sia da ESX che da QBCore.

Innovazioni architettoniche

• Architettura dei microservizi: Componenti modulari che possono essere abilitati/disabilitati indipendentemente
• Sicurezza avanzata: Integrazione anti-cheat integrata e prevenzione degli exploit
• Supporto TypeScript: Sviluppo TypeScript opzionale per una migliore qualità del codice
• Progettazione moderna del database: Schemi ottimizzati con livelli di memorizzazione nella cache integrati
• Supporto per contenitori: Docker-ready per pipeline di distribuzione moderne

Profilo delle prestazioni

Dati dei primi test (campione di dimensioni limitate):

• Utilizzo della memoria: 60-90 MB di overhead di base (il più basso tra i principali framework)
• Ottimizzazione delle query: 1,2 query medie per azione con memorizzazione nella cache intelligente
• Avvio a freddo: 15-25 secondi di inizializzazione del framework
• Velocità di esecuzione: 0,008-0,015 ms in media (prestazioni più veloci misurate)

Limitazioni attuali

• Adozione limitata: Nuovo framework con una base di utenti ridotta
• Disponibilità dello script: Ecosistema minimo di script di terze parti (stimato <500 script)
• Documentazione: Documentazione e tutorial limitati rispetto ai framework consolidati
• Test di produzione: Dati insufficienti sulla stabilità a lungo termine
• Strumenti di migrazione: Strumenti limitati per la migrazione da altri framework

Casi d'uso target

QBOX è adatto a:

• Progetti all'avanguardia disposti a investire nello sviluppo personalizzato
• Applicazioni critiche per le prestazioni che richiedono la massima efficienza
• Team con forti capacità di sviluppo per la creazione di script personalizzati
• Server di piccole e medie dimensioni (10-100 giocatori) in cui è possibile uno sviluppo personalizzato

Risorse QBOX: Contattare l'assistenza fivemX per una consulenza QBOX e per lo sviluppo di server personalizzati.

QBOX contro QBCORE

Benchmark delle prestazioni {#performance-benchmarks}

Test reali condotti su server dedicati con specifiche identiche (Intel i7-9700K, 32 GB di RAM, SSD NVMe) con 100 giocatori in esecuzione contemporaneamente:

Metrico	ESX 1.9	QBCore	QBOX
Utilizzo della memoria (MB)	180	95	75
Utilizzo della CPU (%)	15-25	10-18	8-15
Query di database/min	2,400	1,680	1,200
Tempo medio di risposta (ms)	45	32	28
Tempo di caricamento dello script (s)	52	31	22
Giocatori/Stabilità del core	200+	150+	100+*

*Test di stabilità del QBOX in corso; dati di produzione limitati disponibili.

Metodologia di test delle prestazioni

Test condotti utilizzando:

• Configurazioni server standardizzate
• Simulazione del comportamento identico del giocatore
• periodi di stress test di 72 ore
• Monitoraggio tramite il sistema integrato FiveM resmon e strumenti APM esterni
• Prestazioni del database misurate con i log delle query lente di MySQL

Nota: Le prestazioni variano significativamente in base alla selezione dello script, alla configurazione del server e all'ambiente di hosting. Questi benchmark rappresentano solo il sovraccarico del framework.

Matrice di confronto delle caratteristiche

Categoria di funzionalità	ESX	QBCore	QBOX
Sistemi di base
Supporto multi-carattere	✅ Nativo	✅ Nativo	✅ Nativo
Sistema di inventario	✅ Avanzato	✅ Interfaccia utente moderna	✅ Ottimizzato
Sistema bancario	✅ Completo	✅ Ricco di funzionalità	✅ Semplificato
Quadro occupazionale	✅ Esteso	✅ Flessibile	✅ Modular
Sistema di proprietà	✅ Funzionalità complete	✅ Semplificato	⚠️ Base
Sistema del veicolo	✅ Complesso	✅ Efficiente	✅ Leggero
Sviluppo
Documentazione API	✅ Esteso	✅ Buono	⚠️ Limitato
Compatibilità degli script	✅ Oltre 5.000 script	✅ Oltre 2.000 script	⚠️ Oltre 500 script
Strumenti di migrazione	❌ Nessuno	⚠️ Base	❌ Nessuno
Supporto TypeScript	❌ No	❌ No	✅ Sì
Prestazione
Efficienza delle risorse	⚠️ Pesante	✅ Ottimizzato	✅ Eccellente
Prestazioni del database	⚠️ Intensivo	✅ Migliorato	✅ Ottimizzato
Utilizzo della memoria	❌ Alto	✅ Moderato	✅ Basso
Comunità
Sviluppo attivo	✅ Stabile	✅ Attivo	✅ Rapid
Dimensione della comunità	✅ Grande	✅ In crescita	⚠️ Piccolo
Forum di supporto	✅ Esteso	✅ Attivo	⚠️ Limitato

Strategie di migrazione

La migrazione del framework richiede un'attenta pianificazione ed esecuzione. Sulla base di oltre 200 migrazioni riuscite, ecco alcune strategie comprovate:

Migrazione da ESX a QBCore

Valutazione pre-migrazione (2-4 settimane):

1. Inventario degli script: Cataloga tutti gli script personalizzati e i loro equivalenti QBCore
2. Analisi del database: Mappa lo schema del database ESX sulla struttura QBCore
3. Audit del codice personalizzato: Identificare le modifiche personalizzate che richiedono una conversione manuale
4. Ambiente di test: Imposta il server QBCore parallelo per i test

Processo di migrazione:

-- Conversione dei dati del giocatore da ESX a QBCore -- Esegui questo script per convertire la struttura dei dati del giocatore funzione ConvertPlayerData() local esxPlayers = MySQL.query.await('SELECT * FROM users') for i = 1, #esxPlayers do local player = esxPlayers[i] -- Converti il formato money ESX in QBCore local money = { cash = player.money or 0, bank = player.bank or 0, crypto = 0 } -- Converti i dati del lavoro local job = { name = player.job or 'unemployed', grade = player.job_grade or 0, payment = GetJobPayment(player.job, player.job_grade) } -- Inserisci nella tabella dei giocatori QBCore MySQL.insert.await('INSERT INTO players (citizenid, cid, money, job) VALUES (?, ?, ?, ?)', { GenerateCitizenId(), player.id, json.encode(denaro), json.encode(lavoro) }) fine fine

Verifica post-migrazione:

• Controlli di integrità dei dati del giocatore
• Test di funzionalità dello script
• Benchmark di confronto delle prestazioni
• Periodo di raccolta del feedback della community

Migrazione da QBCore a QBOX

Gli strumenti di migrazione QBOX sono attualmente in fase di sviluppo. È richiesta la conversione manuale per:

• Aggiornamenti dello schema del database dei giocatori
• Modifiche personalizzate allo script
• Conversioni dei file di configurazione

Stato attuale della migrazione: Processo manuale che richiede 40-80 ore per i server tipici. Strumenti automatizzati previsti per il secondo trimestre del 2025.

Migrazione diretta da ESX a QBOX

La migrazione diretta da ESX a QBOX non è consigliata a causa di differenze architettoniche. Percorso consigliato:

1. ESX → QBCore (utilizzando strumenti consolidati)
2. QBCore → QBOX (quando gli strumenti saranno disponibili)

Investimento di tempo: 3-6 mesi per la migrazione completa, inclusi test e sostituzione dello script.

Roadmap di implementazione

Nuova implementazione del server: ESX

Tempi: 3-4 settimane

Settimana 1: Preparazione della base

# 1. Installazione del server mkdir fivem-server cd fivem-server wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/server.zip unzip server.zip # 2. Installazione di ESX git clone https://github.com/esx-framework/esx-legacy cp -r esx-legacy/resources/* resources/ # 3. Configurazione del database mysql -u root -p CREATE DATABASE fivemserver; USE fivemserver; SOURCE resources/[esx]/esx_core/esx.sql;

Settimana 2-3: Configurazione del core

• Configurare server.cfg con risorse ESX
• Impostare script di lavoro e sistemi economici
• Installare sistemi di inventario e bancari
• Configurare gli strumenti e le autorizzazioni di amministrazione

Settimana 4: Test e ottimizzazione

• Test di carico con giocatori simulati
• Ottimizzazione delle prestazioni e debug degli script
• Periodo di test della comunità

Nuova implementazione del server: QBCore

Tempi: 2-3 settimane

Settimana 1: Installazione del Framework

# Script di installazione QBCore #!/bin/bash git clone https://github.com/qbcore-framework/qb-core cd qb-core # Installa le dipendenze npm installa # Se si utilizzano componenti Node.js mysql -u root -p fivemserver < qb-core/shared/items.sql

Settimana 2: Integrazione del sistema

• Configurare le impostazioni del framework in condiviso/config.lua
• Impostare sistemi di lavoro specifici per QBCore
• Installa script di inventario ed economia compatibili
• Configurare le interfacce amministrative

Settimana 3: Ottimizzazione e lancio

• Ottimizzazione delle prestazioni tramite le funzionalità di ottimizzazione integrate di QBCore
• Test di compatibilità degli script
• Lancio soft della comunità

Nuova implementazione del server: QBOX

Tempistiche: 4-6 settimane (include tempo di sviluppo personalizzato)

Prerequisiti: Team di sviluppo esperto con familiarità con framework moderni

Settimane 1-2: Impostazione del framework e apprendimento

• Installazione e configurazione iniziale di QBOX
• Formazione di gruppo sull'architettura e le API di QBOX
• Configurazione dell'ambiente di sviluppo con supporto TypeScript

Settimane 3-4: Sviluppo personalizzato

• Sviluppa funzionalità mancanti non disponibili nell'ecosistema QBOX
• Crea script personalizzati per requisiti server unici
• Test di integrazione di componenti personalizzati

Settimane 5-6: Test e preparazione al lancio

• Test approfonditi dovuti a precedenti di produzione limitati
• Ottimizzazione delle prestazioni e configurazione del monitoraggio
• Introduzione graduale alla comunità con raccolta di feedback

Analisi dei costi

Analisi del costo totale di proprietà (TCO) – Periodo di 12 mesi

Costi del framework ESX:

• Tempo di sviluppo: 120-160 ore di configurazione iniziale
• Requisiti di hosting: Maggiore utilizzo delle risorse (+30% costi di hosting)
• Licenza di script: $200-800 per pacchetti di script di qualità
• Manutenzione: 20-30 ore al mese per aggiornamenti e risoluzione dei problemi
• Rischio di migrazione: Basso (ecosistema consolidato)

TCO ESX stimato: $2.400-4.200 all'anno

Costi del framework QBCore:

• Tempo di sviluppo: 80-120 ore di configurazione iniziale (più veloce grazie a una migliore documentazione)
• Requisiti di hosting: Utilizzo standard delle risorse
• Licenza di script: $300-600 (sono disponibili meno script premium)
• Manutenzione: 15-20 ore al mese (una migliore ottimizzazione riduce i problemi)
• Rischio di migrazione: Media (comunità in crescita ma più piccola)

TCO QBCore stimato: $2.000-3.200 all'anno

Costi del framework QBOX:

• Tempo di sviluppo: 160-240 ore (è richiesto uno sviluppo personalizzato)
• Requisiti di hosting: Minore utilizzo delle risorse (-20% costi di hosting)
• Sviluppo della sceneggiatura: $1.500-3.000 costi di sviluppo personalizzato
• Manutenzione: 10-15 ore mensili (architettura moderna)
• Rischio di migrazione: Alto (nuovo framework con supporto limitato)

Costo totale di proprietà (TCO) QBOX stimato: $3.500-5.800 all'anno (anno 1), $1.800-2.800 (anni successivi)

Considerazioni sul ROI

• ESX: Tempi di commercializzazione più rapidi, massima fidelizzazione dei giocatori grazie a sistemi familiari
• QBCore: Approccio equilibrato con buone prestazioni e costi di sviluppo ragionevoli
• QBOX: Investimento a lungo termine con potenziale per prestazioni superiori e costi operativi inferiori

Albero decisionale per la selezione del framework

Fattori decisionali primari

1. Budget e risorse

• Team di sviluppo + budget elevato: QBOX per prestazioni all'avanguardia
• Budget medio + alcuni sviluppi: QBCore per un approccio bilanciato
• Budget limitato + sviluppo minimo: ESX per la massima disponibilità degli script

2. Requisiti temporali

• Lancio in 1-2 mesi: ESX (distribuzione più rapida)
• Lancio tra 2-4 mesi: QBCore (linea temporale bilanciata)
• Lancio tra 4-6+ mesi: QBOX (tempo di sviluppo personalizzato)

3. Priorità delle prestazioni

• Massima prestazione critica: QBOX > QBCore > ESX
• Prestazioni/caratteristiche bilanciate: QBCore
• Priorità di ricchezza delle funzionalità: ESX

4. Competenza del team

• Sviluppatori FiveM esperti: Qualsiasi framework praticabile
• Sviluppatori generali: QBCore (miglior equilibrio della documentazione)
• Risorse tecniche limitate: ESX (la più grande comunità di supporto)

Diagramma di flusso per la selezione del framework

Inizio: Nuova pianificazione del server FiveM ├─ Hai più di 6 mesi di tempo per lo sviluppo? │ ├─ Sì → Hai sviluppatori esperti? │ │ ├─ Sì → Considera QBOX per le massime prestazioni │ │ └─ No → Scegli QBCore per l'equilibrio │ └─ No → Hai bisogno della massima varietà di script? │ ├─ Sì → Scegli ESX │ └─ No → Scegli QBCore

Matrice decisionale sulla migrazione

Migrare DA ESX se:

• Il server riscontra costantemente problemi di prestazioni (utilizzo delle risorse >80%)
• Il team di sviluppo desidera pratiche di codifica moderne
• Il budget consente un progetto di migrazione di 3-6 mesi
• La crescita del numero di giocatori richiede una migliore ottimizzazione

Rimani con ESX se:

• Le prestazioni attuali soddisfano i requisiti
• Investimenti ingenti in script ESX personalizzati
• Il team non ha la larghezza di banda necessaria per il progetto di migrazione
• La comunità è soddisfatta delle funzionalità attuali

Prendi in considerazione la migrazione di QBOX se:

• Le prestazioni sono un requisito aziendale fondamentale
• Il team ha forti capacità di sviluppo
• Il budget consente investimenti di sviluppo personalizzati
• Il server rappresenta un investimento aziendale a lungo termine (oltre 3 anni)

Conclusione

Scegli ESX per la massima compatibilità degli script e una distribuzione più rapida, QBCore per prestazioni bilanciate e pratiche di sviluppo moderne o QBOX per prestazioni all'avanguardia con un investimento significativo nello sviluppo personalizzato.

---

Risorse correlate:

• Pacchetti server FiveM completi – Server preconfigurati per tutti i framework
• Raccolta di script ESX – Risorse ESX compatibili
• Libreria di script QBCore – Risorse specifiche di QBCore
• Guida all'ottimizzazione delle prestazioni FiveM – Strategie di ottimizzazione del server

Documentazione esterna:

• Documentazione del framework ESX – Risorse ufficiali ESX
• Documentazione QBCore – Guide allo sviluppo QBCore
• Documenti ufficiali FiveM – Documentazione della piattaforma
• Forum della comunità Cfx.re – Supporto e risorse della comunità

---