Integraciones

Cómo funcionan las integraciones#

La carrera en sí no sabe nada de tu framework, inventario o teléfono. Todo lo específico del servidor pasa por pequeños archivos de código abierto en custom/, así que se puede leer y cambiar sin tocar el resto.

Las integraciones opcionales se comprueban cuando se usan, así que qs-inventory y qs-smartphone funcionan sea cual sea el orden en que se inicien. Solo el framework tiene que iniciarse antes de Advanced Racing.

Frameworks#

El bridge se elige según el recurso de framework que esté iniciado: es_extended carga custom/esx/, qb-core y qbx_core cargan custom/qb/. Los perfiles de carreras pertenecen al personaje (el identifier de ESX o el citizen id de QBCore), así que cada personaje tiene su propia puntuación, circuitos y resultados.

Cada bridge responde a las mismas preguntas:

Cuentas de dinero#

Notificaciones#

Cada mensaje que se muestra sobre el juego (te uniste, reembolso, eliminado, un piloto terminó) pasa por una función, Notification en custom/client.lua. Usa ox_lib de serie:

-- custom/client.lua
function Notification(msg, type) -- type is 'info', 'error' or 'success'
    lib.notify({
        title = msg,
        type = type
    })
end

Sustituye el cuerpo para usar tu propio sistema. Por ejemplo, okokNotify:

function Notification(msg, type)
    exports['okokNotify']:Alert('Racing', msg, 5000, type)
end

Los mensajes del servidor llegan a la misma función, así que este único cambio los cubre todos. Las ventanas emergentes dentro de la tablet son de la propia tablet y no se ven afectadas.

Quasar Smartphone#

Con qs-smartphone en ejecución, la app Racing del teléfono lee directamente de Advanced Racing: el mismo perfil, carreras y resultados que la tablet. No hay nada que configurar.

La app busca el recurso por su nombre, qs-advancedracing. Si se cambia el nombre de la carpeta, la app indica que racing no está iniciado.

Misiones de Quasar Inventory#

Con qs-inventory en ejecución, cada jugador recibe dos misiones de carreras cuando carga su personaje:

Los títulos, descripciones, recompensas y niveles están en custom/missions.lua.

Añadir un framework#

Un framework que no está en la lista necesita una carpeta y una línea:

1. Copia el bridge más parecido

   Duplica custom/qb/ o custom/esx/ como custom/myframework/, con su client.lua y server.lua.

2. Completa las funciones

   Reescribe cada función de server.lua (la tabla de Frameworks) con las llamadas de tu framework. Mantén getIdentifier devolviendo 'automated' para el server id 0, y mantén la línea return framework al final.

3. Regístralo

   En shared/config.lua, asocia el recurso de tu framework al nombre de la carpeta:

   local frameworks = {
       ['es_extended'] = 'esx',
       ['qb-core']     = 'qb',
       ['qbx_core']    = 'qb',
       ['my_core']     = 'myframework', -- your resource → custom/myframework/
   }

Ejecuta solo un framework: si hay dos de la lista iniciados, se puede elegir cualquiera.

Idiomas#

Se incluyen 28 traducciones en locales/, y el mismo archivo controla la tablet, el texto de la línea de salida, las tarjetas del mapa y las notificaciones:

ar · bg · ca · cs · da · de · el · en · es · fa · fr · hi · hu · it · ja · ko · nl · no · pl · pt · ro · ru · sl · sv · th · tr · zh-CN · zh-TW

Config.Locale = 'es' -- the file name without .json

Para añadir un idioma, copia locales/en.json con un nombre nuevo como locales/eu.json, traduce los valores (nunca las claves) y pon Config.Locale en 'eu'. Cualquier clave que falte en tu archivo se toma del inglés, y la consola la indica para que puedas añadirla.