Come cambiare la versione Artifact del proprio server FiveM

Tempo stimato : 5 minuti
Difficoltà : Principiante ⭐
Server compatibili : FiveM

---

📋 Introduzione

Gli Artifacts sono i file di base che fanno funzionare il tuo server FiveM. Ogni versione di artifact porta correzioni di bug, miglioramenti delle prestazioni o nuove funzionalità.

Perché cambiare versione Artifact?

Motivo	Descrizione
🐛 Correggere bug	Una nuova versione può risolvere un problema che stai riscontrando
⬇️ Downgrade	Tornare a una versione stabile se la nuova presenta problemi
🆕 Nuove funzionalità	Accedere alle ultime funzionalità di FiveM
🔧 Compatibilità	Alcune risorse richiedono una versione specifica

---

🔍 Passo 1 : Scegliere la Versione Artifact

Sito ufficiale degli Artifacts

Visita il sito ufficiale degli artifacts FiveM :

👉 https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

💡 Nota : OuiHeberg utilizza server Linux, quindi utilizza sempre gli artifacts build_proot_linux.

---

Comprendere la lista degli Artifacts

Ogni riga rappresenta una versione con :

Elemento	Esempio	Descrizione
Numero di build	7290	Numero di versione (più alto = più recente)
Hash	a1b2c3d4...	Identificativo unico della versione
Data	2024-01-15	Data di pubblicazione

Formato completo : 7290-a1b2c3d4e5f6g7h8i9j0...

---

Quale versione scegliere?

Scelta	Raccomandazione
✅ Raccomandato	Versione stabile recente senza bug noti
⚠️ Latest	Ultima versione (può contenere bug)
🔒 Specifico	Versione richiesta da una risorsa

---

Sito di raccomandazione (FiveM Artifacts DB)

Per conoscere la migliore versione senza bug noti, consulta :

👉 https://artifacts.jgscripts.com/

Questo sito comunitario indica :

• ✅ L'ultima versione stabile raccomandata
• ❌ Le versioni da evitare con i loro bug noti

Esempio : Al momento della scrittura, la versione 23683 è raccomandata.

---

Versioni da evitare (bug noti)

Ecco le versioni problematiche da evitare :

Versione	Problema
21547	Errori e crash lato server
16276	Problemi di caricamento JavaScript
14583-14716	Crash con onEntityBucketChange
13759-13890	Connessioni Mumble (voce) bloccate
12933-13045	Crash al riavvio delle risorse
12255	Problemi server non identificati
12092-12135	Crash client con SetPlayerModel
10268-10309	Crash server e problemi di downgrade

💡 Consulta https://artifacts.jgscripts.com/ per la lista aggiornata.

---

📋 Passo 2 : Copiare l'Identificativo di Versione

Sul sito degli Artifacts

1. Trova la versione desiderata nella lista
2. Clic destro sull'icona di download (📥) accanto alla versione
3. Clicca su "Copia indirizzo link"

---

Estrarre l'identificativo

Il link copiato assomiglia a :

https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/7290-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0/fx.tar.xz

Estrai solo la parte tra master/ e /fx.tar.xz :

7290-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

💡 È questa stringa completa (numero + hash) che devi copiare.

---

Metodo veloce

1. Incolla il link in un editor di testo (Blocco note)
2. Elimina https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/
3. Elimina /fx.tar.xz
4. Conserva solo l'identificativo al centro

Esempio :

• Link : https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/7290-abc123def456.../fx.tar.xz
• Identificativo : 7290-abc123def456...

---

⚙️ Passo 3 : Modificare la Versione in OuiPanel

Accedere alla configurazione

1. Accedi a OuiPanel
2. Seleziona il tuo server FiveM
3. Ferma il tuo server se non lo hai già fatto
4. Nel menu laterale, clicca su Configurazione

---

Modificare la versione FiveM

1. Nella pagina Configurazione, trova il campo "FIVEM VERSION" (o "Versione FiveM")

2. Elimina il contenuto attuale
3. Incolla l'identificativo di versione copiato in precedenza

Esempi di valori validi :

7290-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0

23683-1062db8a7b8e0c03f7c159be4cbfa181f49b2cc1

4. Premi Invio per salvare

---

Valori speciali

Puoi anche utilizzare questi valori speciali :

Valore	Descrizione
latest	Ultima versione disponibile (automatica)
recommended	Versione raccomandata da Cfx.re

⚠️ Attenzione : latest può installare una versione con bug. Preferisci una versione specifica testata.

---

🔄 Passo 4 : Reinstallare il Server

Affinché la modifica abbia effetto, devi reinstallare i file artifacts.

Accedere alle impostazioni

1. Nel menu laterale, clicca su Impostazioni

---

Reinstallare il server

1. Trova il pulsante "Reinstalla il server"

2. Clicca su di esso
3. Conferma la reinstallazione

⚠️ Importante : Solo la cartella alpine (file di base di FiveM) sarà eliminata e sostituita. Le tue risorse, configurazioni e database NON saranno influenzati.

---

Attendere la reinstallazione

La reinstallazione richiede generalmente 1-2 minuti :

[OuiPanel] Downloading artifact...
[OuiPanel] Extracting files...
[OuiPanel] Reinstallazione completata!

---

✅ Passo 5 : Verificare la Nuova Versione

Avviare il server

1. Torna su Console
2. Clicca su Avvia

---

Verificare nella console

All'avvio, la versione artifact appare nei log :

[    14070] citizen:server:main: Starting FiveM server version XXXXX

---

Verificare in gioco

1. Collegati al tuo server FiveM
2. Apri la console (tasto F8)
3. La versione appare in alto

---

🔧 Risoluzione dei problemi

Il server non si avvia dopo il cambiamento

❌ Causa	✅ Soluzione
Identificativo copiato male	Controlla il formato (numero-hash completo)
Versione incompatibile	Prova un'altra versione (più recente o più vecchia)
Reinstallazione non effettuata	Clicca su "Reinstalla il server"

---

Errori all'avvio

❌ Errore	✅ Soluzione
Could not find resource	Le tue risorse potrebbero essere incompatibili con questa versione
Failed to load	Downgrade a una versione più vecchia
Crash all'avvio	Utilizza una versione senza bug noti

---

Risorse incompatibili

Alcune risorse richiedono una versione minima di artifact.

Soluzione :

1. Controlla la documentazione della risorsa
2. Aggiorna alla versione richiesta
3. Oppure aggiorna la risorsa stessa

---

Tornare alla versione precedente

Se la nuova versione presenta problemi :

1. Annota l'identificativo della tua vecchia versione (se lo hai)
2. Oppure scegli una versione stabile su https://artifacts.jgscripts.com/
3. Ripeti i passi 2-5 con la vecchia versione

---

💡 Buone Pratiche

Prima di cambiare versione

• ✅ Fai un backup dei tuoi file importanti (server.cfg, risorse personalizzate)
• ✅ Annota la tua versione attuale nel caso
• ✅ Controlla che la nuova versione non abbia bug noti
• ✅ Testa su un server di test se possibile

Scelta della versione

• ✅ Prediligi le versioni raccomandate e stabili
• ✅ Evita le versioni troppo recenti (< 1 settimana)
• ✅ Controlla regolarmente i changelog di FiveM
• ✅ Usa https://artifacts.jgscripts.com/ per le raccomandazioni

Manutenzione

• ✅ Aggiorna regolarmente (almeno 1 volta al mese)
• ✅ Segui gli annunci di Cfx.re per aggiornamenti importanti
• ✅ Testa le nuove versioni fuori dagli orari di punta

---

📚 Risorse Utili

Risorsa	URL
Artifacts Linux	https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/
Artifacts Windows	https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/
Versioni raccomandate	https://artifacts.jgscripts.com/
Forum Cfx.re	https://forum.cfx.re/
Changelog	https://github.com/citizenfx/fivem/commits/master

---

📝 Riepilogo

1. Scegliere la versione su runtime.fivem.net/artifacts/fivem/build_proot_linux/master/
   (o consultare artifacts.jgscripts.com per la raccomandata)

2. Clic destro → Copia indirizzo link

3. Estrarre l'identificativo : XXXXX-hash...
   (tra "master/" e "/fx.tar.xz")

4. OuiPanel → Configurazione → Campo "FIVEM VERSION"
   → Incolla l'identificativo → Invio

5. OuiPanel → Impostazioni → Reinstalla il server

6. Avviare il server e verificare