GUÍA

Instalar un script FiveM

Los pasos de abajo son los mismos para todos los scripts que vendemos. Cada ficha de producto repite los suyos, así que lee esto una vez y el resto irá rápido.

Instalar un script FiveM

De dónde salen los archivos

Las compras las entrega Tebex y aterrizan en tu cuenta Keymaster de Cfx.re, en Granted assets. Descarga desde ahí, no desde un enlace que te pase alguien. Un script que te llega fuera de ese canal no tiene ningún entitlement ligado a tu clave de licencia, lo que significa ni actualizaciones ni derecho a reclamar.

Soltar el recurso

Copia la carpeta en tu directorio resources, dejando el nombre exactamente como se entregó. Ese nombre es el que usan las llamadas exports, así que renombrarlo rompe todas las integraciones que tengas tú u otro recurso. Después añade la línea de arranque a la config del servidor.

lua
ensure oxmysql
ensure avenida_barber

Por qué importa el orden

Arranca la capa de base de datos antes que el script, porque el script escribe al iniciar. Si tu framework arranca después de nosotros, el bridge reintenta y lo encuentra igual, pero arrancar oxmysql tarde te da un error SQL en lugar de un reintento.

Ejecutar el SQL

Cada script trae un INSTALL.sql dividido en secciones etiquetadas. La sección [A] es obligatoria y se ejecuta siempre. Las posteriores son condicionales, y la cabecera del archivo dice exactamente cuándo las necesitas, normalmente el almacenamiento de apariencia para servidores que aún no tienen uno.

Comprobar que la instalación ha ido bien

Pon Config.Debug = true, reinicia y lee la consola. Una línea por categoría de bridge nombra el target elegido. La mayoría de scripts también exponen un comando de comprobación que imprime un informe completo dentro del juego, por ejemplo /avenida_barber_check, una vez te has concedido el ace.

lua
add_ace group.admin avenida_barber.admin allow

Qué configurar antes de abrir

Dos cosas merecen decidirse antes de que lleguen los jugadores: el idioma, en Config.Locale, y los precios, que viven en el archivo de config con el nombre del script. Todo lo demás tiene un valor por defecto que funciona en la mayoría de servidores.

Actualizar más adelante

Descarga la nueva versión desde Keymaster y sustituye la carpeta, conservando tus archivos config/ y locales/. Esos dos directorios están fuera del escrow precisamente para que tus cambios sobrevivan a una actualización, y el changelog nombra todo lo que se ha movido.

Preguntas

¿Tengo que reiniciar todo el servidor?

No, basta con reiniciar el recurso para los cambios de config y de idioma. El SQL solo se ejecuta una vez, y un reinicio completo solo sirve si cambias el orden de arranque de los recursos.

El script no arranca, ¿dónde miro primero?

En la consola del servidor al arrancar. Una dependencia que falta, un nombre de carpeta equivocado y un SQL fallido imprimen todos una línea ahí. Pon Config.Debug = true y reinicia para obtener una línea por categoría de bridge, que te dice si la detección encontró lo que esperabas.

¿Puedo renombrar la carpeta del recurso?

No. El nombre de la carpeta es el que usan las llamadas exports, las nuestras y las tuyas, así que renombrarla rompe en silencio todas las integraciones. Si necesitas otro nombre en la config del servidor, usa un enlace simbólico en vez de renombrar.

¿Dónde recupero mis archivos tras una reinstalación?

En tu cuenta Keymaster de Cfx.re, en Granted assets. El entitlement sigue a la cuenta que compró el script, así que un servidor nuevo o una máquina distinta no cambian nada.

Scripts que lo usan

Carrito
Spirit RP
Discord