01 - Introduzione e Setup

2 min read

Integrazione ESX + OX — Introduzione

QUESTION

Cosa sono ESX e OX?

ESX è il framework più diffuso per FiveM (gestisce giocatori, denaro, lavori, veicoli). ox_inventory, ox_target e ox_lib sono strumenti moderni che si integrano con ESX per offrire inventario, interazioni e UI.

Obiettivi del Modulo

Alla fine di questo modulo saprai:

  • Configurare una risorsa ESX + OX
  • Registrare item custom in ox_inventory
  • Integrare armi, veicoli e vestiti con ESX
  • Usare ox_target per interazioni nel mondo
  • Usare ox_lib per notifiche, menu e progress bar
  • Creare una risorsa completa funzionante

Lo Stack

┌──────────────────────────────────────────┐
│            ESX Framework                  │
│  (Giocatori, denaro, lavori, veicoli)     │
├──────────────────────────────────────────┤
│  ox_lib           ox_inventory           │
│  (UI, notifiche,   (inventario, armi,    │
│   menu, progress,   oggetti, crafting)   │
│   locale)                                │
├──────────────────────────────────────────┤
│  ox_target                                │
│  (Interazioni: apri portiere, raccogli,  │
│   parla con NPC, entra in zona)          │
├──────────────────────────────────────────┤
│       LE TUE RISORSE CUSTOM              │
│  (Mappe, armi, veicoli, vestiti, suoni)  │
└──────────────────────────────────────────┘

Struttura Base di una Risorsa ESX

-- fxmanifest.lua
fx_version 'cerulean'
game 'gta5'
 
shared_scripts {
    '@es_extended/imports.lua',
    'config.lua'
}
 
client_scripts { 'client.lua' }
server_scripts { 'server.lua' }
-- client.lua
local ESX = exports['es_extended']:getSharedObject()
 
-- Notifica con ox_lib
lib.notify({
    title = 'Mia Risorsa',
    description = 'Ciao!',
    type = 'info'
})

Installazione OX

# ox_lib (dipendenza obbligatoria)
cd resources/[system]
git clone https://github.com/overextended/ox_lib
 
# ox_inventory
git clone https://github.com/overextended/ox_inventory
 
# ox_target (OPZIONALE ma consigliato per le interazioni)
git clone https://github.com/overextended/ox_target

Ordine in server.cfg: ensure ox_lib → ensure es_extended → ensure ox_target → ensure ox_inventory

WARNING

ox_target NON è incluso in ox_inventory. È una risorsa separata e va installata da sola. L’ordine corretto prevede ox_target prima di ox_inventory (che lo usa per stashes/shops se inventory:target true).

Prossimo passo: 02 - Registrare Items in ox_inventory