Come installare ESX Legacy su un server FiveM: ricetta e manuale

Vuoi un server FiveM che esegua ESX Legacy, e vuoi sapere quale modo installarlo. Ce ne sono due: una ricetta txAdmin, che fa tutto, e un'installazione manuale, dove posizionare ogni pezzo. Questa guida copre entrambi, poi cosa controllare al tuo primo accesso e gli errori che hai più probabilità di vedere.

#Opzione 1: la ricetta txAdmin

Questa è la rotta consigliata. Nella configurazione di txAdmin, scegli il modello ESX Legacy dalle ricette popolari. Segui i passaggi in txAdmin setup and recipes: inserisci la tua chiave di licenza e le credenziali del database, quindi rivedi il server.cfg generato e avvia il server.

La ricetta scarica es_extended e le risorse core, oxmysql e ox_lib, crea il database e importa il file SQL ESX. Quando hai finito, hai una base funzionante. Salta a "First login checks".

#Opzione 2: installazione manuale

Fallo quando aggiungi ESX a un server che hai costruito. Hai bisogno di un FXServer in esecuzione, un database MySQL o MariaDB e una chiave di licenza.

#1. Scarica le risorse

Dalle versioni di ESX Legacy, ottieni il core pack (es_extended e le risorse core che usa, come le risorse di identità, menu e notifica). Mettile nella cartella resources, ad esempio in resources/[esx]. Hai anche bisogno:

• oxmysql, il livello di database.
• ox_lib, una dipendenza comune per le risorse ESX moderne.
• Un inventario. Molti server ESX Legacy usano ox_inventory. Seguire la documentazione della versione che scarichi, perché la configurazione predefinita può cambiare tra i rilasci.

#2. Crea il database e importa l'SQL

Crea un database vuoto, ad esempio esx:

CREATE DATABASE esx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Quindi importa il file SQL che viene fornito con es_extended (cerca un file .sql nella sua cartella, di nome legacy.sql al momento della scrittura). Usa HeidiSQL, phpMyAdmin o la riga di comando mysql. Senza di esso, incontrerai errori di tabella non esistente.

#3. Modifica server.cfg

Imposta la stringa di connessione e avvia le risorse in un buon ordine:

set mysql_connection_string "mysql://user:password@localhost/esx?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_inventory
ensure [esx]
ensure [standalone]

L'ordine è spiegato in server.cfg ensure order. Se usi le risorse di identità o multicharacter ESX, assicurati che solo una risorsa di selezione dei caratteri sia in esecuzione.

#Controlli del primo accesso

Avvia il server e leggi la console dall'alto verso il basso prima di unirti. Quindi controlla:

1. oxmysql si connette. C'è una riga sulla connessione del database e nessun errore rosso subito dopo.
2. es_extended si avvia senza errori.
3. Puoi unirti e raggiungere la creazione del personaggio o lo spawn.
4. La tua riga di giocatore esiste. Dopo che ti unisci, dovresti vedere una riga per te nella tabella users.
5. Denaro e lavoro caricano. Apri il tuo inventario o esegui un comando che stampa il tuo account e lavoro.

Per i diritti di admin, imposta il tuo group su admin nella tua riga users, poi ricongiunti. Per txAdmin e comandi ACE, vedi ACE permissions.

#Errori comuni del primo

ESX è nil in uno script. Una risorsa che ancora usa un modo vecchio per ottenere ESX mostra:

attempt to index a nil value (global 'ESX')

Il modo moderno è ESX = exports['es_extended']:getSharedObject(). Vedi ESX is nil: fixing esx:getSharedObject e no such export getSharedObject in es_extended.

Impossibile connettersi al database. La stringa di connessione è sbagliata, il database non è in esecuzione, o l'utente non ha diritti. Vedi oxmysql connection error.

Una risorsa non si avvia. Spesso una dipendenza mancante o un nome di cartella sbagliato. Vedi could not find dependency e couldn't start resource.

Giocatori bloccati su caricamento. Guarda la console per la risorsa che errori durante l'unione. Vedi players stuck on the loading screen.

Consiglio: quando aggiungi uno script, aggiungine uno alla volta e riavvia. Se appare un errore, sai quale script l'ha causato.

#Aggiunta di lavori e articoli

Una volta che la base funziona, i compiti successivi sono lavori e articoli. Add a job on ESX mostra le righe di database di cui hai bisogno. Per gli articoli, il modo dipende dal tuo inventario: vedi ox_inventory add items.

#Elenco di controllo