Scripts de RedM: instalar recursos en tu servidor

Los scripts de RedM funcionan en el servidor como recursos, carpetas guardadas en resources. Esta guía te muestra cómo elegir un script fiable, comprobar que está hecho para RedM, subirlo con OuiPanel, declararlo en server.cfg y arrancarlo. Los scripts y mods de servidor de RedM se instalan todos así.

Tu servidor, contratado en nuestro hosting RedM, ya debe arrancar con su clave de Cfx.re. Si no es así, sigue antes la guía Crear un servidor RedM: clave Cfx.re, server.cfg y txAdmin.

---

Elegir un script de RedM fiable

Los autores publican sus scripts en el foro de Cfx.re, en la categoría RedM Releases, y en su página de GitHub. El título de un tema suele darte dos datos.

• El framework que necesita, entre corchetes, como [VORP], [RSG], [REDEMRP], o [Standalone] para un script que funciona solo.

• El precio, con [FREE] para un script gratuito y [PAID] para uno de pago.

Un script pensado para un framework solo funciona con él. Un script de VORP no funciona tal cual en RSG. Para instalar el framework, sigue la guía VORP Core o RSG Core: instalar un framework de rol en tu servidor RedM.

Instala solo scripts publicados por su autor. Una copia de un script de pago encontrada en otro sitio viola su licencia y puede contener código que no controlas.

Los scripts de pago protegidos

Muchos scripts de pago usan el sistema de escrow de Cfx.re. Tras la compra recibes un enlace de descarga y el script queda vinculado a tu cuenta de Cfx.re. Solo arranca en un servidor cuya clave de licencia pertenece a esa misma cuenta. Si no, la consola muestra «You lack the required entitlement».

---

Comprobar que un script está hecho para RedM

Cada recurso contiene un archivo fxmanifest.lua que lo describe. En RedM, FXServer es estricto con este archivo. Ábrelo y busca estas tres líneas.

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 es obligatoria.

• game debe incluir rdr3. Un recurso pensado para los dos juegos escribe games { 'rdr3', 'gta5' }. Un recurso solo gta5 se rechaza.

• rdr3_warning debe llevar esta frase exacta, sin cambiar ni un carácter.

• El antiguo archivo __resource.lua no se acepta en RedM.

Si falta una de estas reglas, FXServer no arranca el recurso y lo indica en la consola.

---

Subir el script al servidor

Los scripts suelen venir en un archivo .zip. Súbelo tal cual, OuiPanel lo descomprime.

1. En OuiPanel, haz clic en Gestor de archivos y abre la carpeta resources.

2. Arrastra el archivo a la página. Aparece la capa «Arrastra tus archivos aquí», suelta el archivo.

3. Haz clic en ⋯ al final de la fila del archivo y luego en Descomprimir. Confirma con Confirmar. El archivo comprimido se conserva.

4. Abre la carpeta resultante. El archivo fxmanifest.lua debe estar directamente dentro, no en una subcarpeta.

5. Si hace falta, cambia el nombre de la carpeta con Renombrar. Quita por ejemplo el sufijo -main que añade GitHub. El nombre de la carpeta pasa a ser el nombre del recurso.

6. Elimina el archivo comprimido con ⋯ › Eliminar.

El botón Importar URL también descarga un archivo directamente al servidor. Pega ahí el enlace de una versión publicada en GitHub.

Arrastrar y soltar admite 100 MB por archivo. Para archivos más grandes, usa el SFTP con la guía FileZilla y SFTP: cómo conectarte a tu servidor de juego.

Guarda tus scripts en una carpeta entre corchetes, por ejemplo [scripts]. FXServer la lee como una categoría, y una sola línea ensure [scripts] arranca todo su contenido.

Si txAdmin instaló tu servidor

Una receta de txAdmin, como la de VORP o la de RSG, crea su propia carpeta de servidor en txData, por ejemplo txData/vorp_123abc.base. Ahí están sus recursos y su server.cfg. Pon el script en la carpeta resources de esa carpeta, no en la de la raíz.

---

Declarar el script en server.cfg

Un script solo arranca si una línea ensure lo nombra. FXServer lee estas líneas en orden, así que cada dependencia debe ir antes del script que la usa.

1. En la Consola, detén el servidor con Detener.

2. Abre server.cfg en el Gestor de archivos.

3. Añade la línea del script después de las de la base de datos y del framework.

4. Haz clic en Guardar y arranca el servidor.

# Base de datos
ensure oxmysql

# Framework
ensure vorp_core

# Tus scripts
ensure mi_script

El archivo README de un script lista sus dependencias. En un servidor instalado por txAdmin, también puedes editar server.cfg desde el editor de configuración de txAdmin.

Al arrancar, la consola muestra «Started resource mi_script» cuando el script se ha cargado.

---

Arrancar el script sin reiniciar

Con txAdmin, puedes probar un script sin parar el servidor. Escribe estos comandos en la consola en directo de txAdmin, la Live Console. La Consola de OuiPanel no transmite estos comandos al juego cuando txAdmin gestiona el servidor. Sin txAdmin, añade la línea ensure en server.cfg y reinicia el servidor.

1. Escribe refresh. FXServer vuelve a leer la carpeta resources y encuentra el nuevo script.

2. Escribe ensure mi_script.

3. Lee la consola. Un arranque correcto termina con la línea «Started resource mi_script».

Añade igualmente la línea ensure a server.cfg. Sin ella, el script no vuelve a arrancar en el siguiente inicio.

Comando	Efecto
refresh	Vuelve a leer la carpeta resources
ensure nombre	Arranca el recurso, o lo reinicia si ya funciona
start nombre	Arranca el recurso
stop nombre	Detiene el recurso
restart nombre	Reinicia el recurso

---

Configurar el script

Muchos scripts se ajustan en un archivo config.lua, en la raíz del recurso o en una carpeta config o shared. Ahí están el idioma, los precios, las posiciones o los permisos.

1. Abre el archivo en el Gestor de archivos, edítalo y haz clic en Guardar.

2. Con txAdmin, escribe restart mi_script en la Live Console. Sin txAdmin, reinicia el servidor.

Algunos scripts traen un archivo .sql que crea sus tablas. Impórtalo en tu base de datos con PhpMyAdmin. La guía Crear una base de datos MySQL para tu servidor de juego en OuiPanel explica cómo abrirlo.

---

Si el script no arranca

La consola de OuiPanel da el motivo. Estos son los mensajes más habituales de FXServer.

Mensaje	Solución
Couldn't find resource mi_script.	El nombre de la carpeta no coincide con la línea ensure, o el script está una subcarpeta más abajo
Could not find dependency oxmysql for resource mi_script.	Instala la dependencia y pon su línea ensure antes de la del script
Resource mi_script does not support the current game (rdr3).	El script está hecho para FiveM. Busca una versión para RedM
Resource mi_script does not contain the RedM pre-release warning in fxmanifest.lua.	Falta la línea rdr3_warning o no coincide con la frase exacta
Resource mi_script is not using CitizenFXv2 manifest.	El script usa el antiguo __resource.lua. Pide a su autor una versión actualizada
You lack the required entitlement	El script de pago se compró con otra cuenta de Cfx.re distinta de la que tiene la clave del servidor

Un error también puede venir del lado del juego. En RedM, la consola F8 muestra los errores de los scripts cargados en el PC del jugador.

---

¿Necesitas ayuda?

Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.

Abrir un ticketDiscord