Cómo instalar un servidor QBCore: receta de txAdmin y pasos manuales

Quieres un servidor QBCore y estás eligiendo entre la receta y una instalación manual. Esta guía cubre ambas, el server.cfg que necesitas, qué verificar en tu primer inicio, y los errores que aparecen en casi todos los primeros servidores de QBCore.

#Opción 1: la receta de txAdmin

La receta es la forma recomendada. En la configuración de txAdmin, elige la plantilla de QBCore de las recetas populares, como se describe en configuración de txAdmin y recetas. Ingresas tu clave de licencia y detalles de la base de datos, txAdmin descarga todo, crea la base de datos y escribe server.cfg. Revisa ese archivo, inicia el servidor, y pasa a las primeras verificaciones a continuación.

#Opción 2: instalación manual

Úsala si ya tienes un servidor y quieres agregar QBCore. Necesitas FXServer, una base de datos MySQL o MariaDB y una clave de licencia.

#1. Obtén los recursos

QBCore no es un único recurso. Necesitas:

• qb-core, el framework en sí.
• Los recursos de qb alrededor de él: inventario, multicarácter, selector de spawn, trabajos, teléfono y así sucesivamente. Normalmente se agrupan en una carpeta como [qb].
• oxmysql para la base de datos y ox_lib, del que muchos recursos actuales dependen.
• Recursos independientes como un recurso de voz (ver pma-voice not working) y cualquier paquete de mapa o vehículos.

Cópialos en tu carpeta resources, por ejemplo resources/[qb] y resources/[standalone].

#2. Crea la base de datos e importa el SQL

CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Importa el archivo SQL que viene con la instalación de QBCore (el repositorio de la receta envía uno con las tablas base) y luego el SQL de cada recurso que tiene su propio archivo. Si un script más tarde dice que falta una tabla, ver SQL table doesn't exist.

#3. Edita server.cfg

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

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure [standalone]

add_ace group.admin command allow
add_ace qbcore.god command allow
add_principal group.admin qbcore.god
add_principal identifier.license:YOUR_LICENSE_HERE qbcore.god

Reemplaza YOUR_LICENSE_HERE con tu propio identificador de licencia de FiveM. Lo encuentras en la lista de jugadores de txAdmin o en la consola del servidor cuando te unes. Las líneas ACE se tratan en permisos ACE.

Consejo: ensure [qb] inicia cada recurso dentro de esa carpeta. Mantén qb-core en sí fuera de ella, como en el ejemplo, o se asegura dos veces. Ver orden de ensure de server.cfg.

#Primeras verificaciones

Inicia el servidor y lee la consola antes de unirte:

1. oxmysql se conecta a la base de datos sin error.
2. qb-core se inicia. Si no lo hace, cada otro recurso de qb falla después de él.
3. Sin errores rojo de los recursos en [qb]. Algunos avisos son normales; los errores repetidos no lo son.
4. Puedes unirte, obtener la selección de personaje, crear un personaje y spawne.
5. Se crea una fila en la tabla players para tu personaje.

Si no puedes unirte o te quedas en la pantalla de carga, lee jugadores atascados en la pantalla de carga.

#Errores comunes del primer inicio

QBCore es nulo. Un script que usa un método antiguo para obtener el objeto núcleo falla con:

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

Usa local QBCore = exports['qb-core']:GetCoreObject() en la parte superior de cada archivo. La explicación completa está en QBCore nil: la corrección GetCoreObject.

qb-core no se inició. Otros recursos entonces reportan:

No such export GetCoreObject in resource qb-core

Mira la parte superior de la consola para el primer error de qb-core en sí, que generalmente es la base de datos. Ver error de conexión oxmysql.

El recurso no se inicia. Dependencia faltante o problemas de nombre de carpeta: no se pudo encontrar la dependencia, no se pudo iniciar el recurso.

No eres administrador. Tu identificador en server.cfg no coincide con el tuyo, o no reiniciaste después de editarlo.

#Próximos pasos

Cuando la base sea estable, las primeras tareas habituales son agregar trabajos e artículos. Ver Agregar trabajo en QBCore y qb-inventory agregar artículos. Si planeas ejecutar el stack más nuevo más adelante, lee primero instalar QBox, porque el stack difiere.

#Lista de verificación