Script RedM: installare risorse sul tuo server

Uno script RedM gira sul server come risorsa, cioè una cartella dentro resources. Questa guida ti mostra come scegliere uno script affidabile, verificare che sia fatto per RedM, caricarlo con OuiPanel, dichiararlo nel server.cfg e avviarlo. Script e mod lato server di RedM si installano tutti così.

Il tuo server, preso con il nostro hosting server RedM, deve già avviarsi con la sua chiave Cfx.re. Se non è così, segui prima la guida Creare un server RedM: chiave Cfx.re, server.cfg e txAdmin.

---

Scegliere uno script RedM affidabile

Gli autori pubblicano i loro script sul forum di Cfx.re, nella categoria RedM Releases, e sulla loro pagina GitHub. Il titolo di un argomento di solito dice due cose.

• Il framework richiesto, tra parentesi quadre, come [VORP], [RSG], [REDEMRP], oppure [Standalone] per uno script che funziona da solo.

• Il prezzo, con [FREE] per uno script gratuito e [PAID] per uno a pagamento.

Uno script pensato per un framework funziona solo con quello. Uno script VORP non gira così com'è su RSG. Per installare il framework, segui la guida Framework RedM: installare VORP Core o RSG Core sul server.

Installa solo script pubblicati dal loro autore. Una copia di uno script a pagamento trovata altrove viola la sua licenza e può contenere codice che non controlli.

Gli script a pagamento protetti

Molti script a pagamento usano il sistema di escrow di Cfx.re. Dopo l'acquisto ricevi un link di download e lo script resta legato al tuo account Cfx.re. Si avvia solo su un server la cui chiave di licenza appartiene a quello stesso account. Altrimenti la console mostra «You lack the required entitlement».

---

Verificare che uno script sia fatto per RedM

Ogni risorsa contiene un file fxmanifest.lua che la descrive. Su RedM, FXServer è severo con questo file. Aprilo e cerca queste tre righe.

fx_version 'cerulean'
game 'rdr3'
rdr3_warning 'I acknowledge that this is a prerelease build of RedM, and I am aware my resources *will* become incompatible once RedM ships.'

• fx_version è obbligatoria.

• game deve contenere rdr3. Una risorsa pensata per entrambi i giochi scrive games { 'rdr3', 'gta5' }. Una risorsa solo gta5 viene rifiutata.

• rdr3_warning deve riportare questa frase esatta, senza cambiare un solo carattere.

• Il vecchio file __resource.lua non è accettato su RedM.

Se manca una di queste regole, FXServer non avvia la risorsa e lo scrive nella console.

---

Caricare lo script sul server

Gli script arrivano di solito in un archivio .zip. Caricalo così com'è, OuiPanel lo decomprime.

1. In OuiPanel, clicca su Gestione file, poi apri la cartella resources.

2. Trascina l'archivio sulla pagina. Compare il livello «Trascina i tuoi file qui», rilascia il file.

3. Clicca su ⋯ in fondo alla riga dell'archivio, poi su Decomprimi e conferma. L'archivio resta al suo posto.

4. Apri la cartella ottenuta. Il file fxmanifest.lua deve trovarsi direttamente al suo interno, non in una sottocartella.

5. Se serve, rinomina la cartella con Rinomina. Togli per esempio il suffisso -main che aggiunge GitHub. Il nome della cartella diventa il nome della risorsa.

6. Elimina l'archivio con ⋯ › Elimina.

Il pulsante Importa URL scarica un archivio direttamente sul server. Incolla lì il link di una versione pubblicata su GitHub.

Il trascinamento accetta 100 MB per file. Oltre, usa l'SFTP con la guida Come connettersi in SFTP con FileZilla.

Raccogli i tuoi script in una cartella tra parentesi quadre, per esempio [scripts]. FXServer la legge come una categoria, e una sola riga ensure [scripts] avvia tutto il suo contenuto.

Se txAdmin ha installato il tuo server

Una ricetta txAdmin, come quella di VORP o di RSG, crea una propria cartella del server in txData, per esempio txData/vorp_123abc.base. Lì si trovano le sue risorse e il suo server.cfg. Metti lo script nella cartella resources di quella cartella, non in quella principale.

---

Dichiarare lo script nel server.cfg

Uno script parte solo se una riga ensure lo nomina. FXServer legge queste righe in ordine, quindi ogni dipendenza deve venire prima dello script che la usa.

1. Nella Console, ferma il server con Ferma.

2. Apri server.cfg nella Gestione file.

3. Aggiungi la riga dello script dopo quelle del database e del framework.

4. Clicca su Salva, poi avvia il server.

# Database
ensure oxmysql

# Framework
ensure vorp_core

# I tuoi script
ensure mio_script

Il file README di uno script elenca le sue dipendenze. Su un server installato da txAdmin, puoi anche modificare server.cfg dall'editor di configurazione di txAdmin.

All'avvio, la console mostra «Started resource mio_script» quando lo script è caricato.

---

Avviare lo script senza riavviare

Con txAdmin puoi provare uno script senza fermare il server. Digita questi comandi nella console in tempo reale di txAdmin, la Live Console. La Console di OuiPanel non trasmette questi comandi al gioco quando txAdmin gestisce il server. Senza txAdmin, aggiungi la riga ensure nel server.cfg e riavvia il server.

1. Digita refresh. FXServer rilegge la cartella resources e trova il nuovo script.

2. Digita ensure mio_script.

3. Leggi la console. Un avvio riuscito termina con la riga «Started resource mio_script».

Aggiungi comunque la riga ensure al server.cfg. Senza, lo script non riparte al prossimo avvio.

Comando	Effetto
refresh	Rilegge la cartella resources
ensure nome	Avvia la risorsa, o la riavvia se è già attiva
start nome	Avvia la risorsa
stop nome	Ferma la risorsa
restart nome	Riavvia la risorsa

---

Configurare lo script

Molti script si regolano in un file config.lua, nella cartella principale della risorsa o in una cartella config o shared. Contiene la lingua, i prezzi, le posizioni o i permessi.

1. Apri il file nella Gestione file, modificalo, poi clicca su Salva.

2. Con txAdmin, digita restart mio_script nella Live Console. Senza txAdmin, riavvia il server.

Alcuni script forniscono un file .sql che crea le loro tabelle. Importalo nel tuo database con PhpMyAdmin. La guida Creare un database MySQL per il tuo server di gioco su OuiPanel spiega come aprirlo.

---

Se lo script non si avvia

La console di OuiPanel indica il motivo. Ecco i messaggi più comuni di FXServer.

Messaggio	Soluzione
Couldn't find resource mio_script.	Il nome della cartella è diverso dalla riga ensure, oppure lo script è in una sottocartella di troppo
Could not find dependency oxmysql for resource mio_script.	Installa la dipendenza e metti la sua riga ensure prima di quella dello script
Resource mio_script does not support the current game (rdr3).	Lo script è fatto per FiveM. Cerca una versione per RedM
Resource mio_script does not contain the RedM pre-release warning in fxmanifest.lua.	Manca la riga rdr3_warning o è diversa dalla frase esatta
Resource mio_script is not using CitizenFXv2 manifest.	Lo script usa il vecchio __resource.lua. Chiedi al suo autore una versione aggiornata
You lack the required entitlement	Lo script a pagamento è stato comprato con un account Cfx.re diverso da quello della chiave del server

Un errore può arrivare anche dal lato del gioco. In RedM, la console F8 mostra gli errori degli script caricati sul PC del giocatore.

---

Hai bisogno di aiuto?

Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.

Apri un ticketDiscord