FiveM Frameworks: ESX, QBCore, QBOX

Testing a free script?

Free scripts are fine for quick checks. For production servers, compare full server packs or maintained paid scripts by framework and use case.

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à

---