¿Qué es kq_link? El bridge detrás de los scripts de KuzQuality

Si has instalado un script de KuzQuality, quizá hayas visto que kq_link aparece como dependencia obligatoria. En este post te explicamos qué es, por qué existe y por qué el patrón que hay detrás es tan común en la comunidad de scripting de FiveM.

El problema: los servidores de FiveM no están estandarizados

Los servidores de FiveM funcionan con frameworks distintos. Unos usan ESX, otros QBCore y otros QBox, vRP, TMC o algo totalmente personalizado. Además, cada servidor puede usar su propio sistema de inventario, su propio sistema de targeting y su propio sistema de notificaciones.

Un script que se comunica directamente con ESX no funcionará en QBCore sin cambios en el código. Un script que llama a ox_target dejará de funcionar en un servidor que usa qb-target. Y un script que usa un sistema de notificaciones se verá mal en un servidor que usa otro.

Esto es un problema para cualquier desarrollador que quiera que su trabajo funcione en más de una configuración de servidor. La solución ingenua es escribir una versión distinta para cada framework, algo que lleva mucho tiempo y es difícil de mantener. La mejor solución es un bridge.

¿Qué es un bridge de scripts?

Un bridge (puente) es un recurso que se sitúa entre un script y las dependencias del servidor. En lugar de llamar directamente a ESX o QBCore, el script llama al bridge. El bridge detecta qué framework y qué dependencias están en uso y traduce la llamada en consecuencia.

No es un concepto exclusivo de KuzQuality. La mayoría de los desarrolladores serios de scripts para FiveM usan algún tipo de bridge. Puede que hayas visto recursos parecidos, como ox_lib, jim_bridge, pp-bridge o tw_bridge, como dependencias de otros scripts. El principio es el mismo en todos: escribes el script una vez y el bridge se encarga de las diferencias entre frameworks.

¿Qué es kq_link?

kq_link es el bridge de código abierto de KuzQuality. Conecta los scripts de KuzQuality con el framework, el sistema de inventario, el sistema de targeting y el sistema de notificaciones que use el servidor.

En la práctica, esto es lo que gestiona:

• Detección del framework: identifica automáticamente si el servidor usa ESX, QBCore, QBox, vRP, TMC o ningún framework
• Integración con el inventario: envía las comprobaciones, entregas y retiradas de objetos al sistema de inventario correcto
• Sistema de notificaciones: envía las notificaciones a través del recurso de notificaciones que use el servidor
• Sistema de targeting: funciona con ox_target, qb-target o, como alternativa, con un texto 3D integrado
• Funciones auxiliares: utilidades compartidas de las que dependen los scripts de KuzQuality, para no tener que reimplementarlas en cada recurso

Como kq_link se encarga de todo esto, ningún script de KuzQuality necesita saber qué framework usa el servidor. El script simplemente llama a kq_link, y kq_link hace el resto.

¿Por qué es un recurso aparte?

kq_link se instala una sola vez y lo comparten todos los scripts de KuzQuality. Todos los scripts del servidor que usan kq_link aprovechan el mismo bridge, en lugar de que cada uno incluya su propia copia del mismo código.

Esto también significa que los cambios de compatibilidad con los frameworks solo hay que hacerlos en un sitio. Cuando una nueva versión de un framework cambia algo, se actualiza kq_link y todos los scripts de KuzQuality se benefician automáticamente.

Cómo instalar kq_link

kq_link es gratis y de código abierto. Está disponible en GitHub: github.com/Kuzkay/kq_link.

La instalación es sencilla:

1. Descarga o clona kq_link en la carpeta resources/ del servidor. La carpeta debe llamarse exactamente kq_link. Si le cambias el nombre, dejarán de funcionar todos los scripts de KuzQuality que dependen de él.
2. Abre server.cfg y añade ensure kq_link después del framework y de cualquier dependencia, como los sistemas de targeting o de notificaciones
3. Abre kq_link/config.lua y configura el framework y las dependencias

kq_link incluye detección automática del framework, pero aun así se recomienda configurar el framework manualmente en la config para evitar cualquier ambigüedad.

Tienes todos los detalles de la instalación en docs.kuzquality.com.

Resumen

Los bridges de scripts son un patrón estándar en el desarrollo para FiveM. Resuelven el problema de la fragmentación de frameworks actuando como una capa de traducción entre un script y las dependencias del servidor.

kq_link es la versión de KuzQuality. Es gratis, de código abierto y obligatorio para todos los scripts de KuzQuality. Instálalo una vez, configúralo según tu servidor y todos los scripts de KuzQuality funcionarán, sin importar qué framework uses.