El problema de la compatibilidad de frameworks
La mayoría de scripts de FiveM vienen con un framework cableado en su código. Si corres QBCore, usas scripts QBCore. Los usuarios de ESX se quedan con scripts ESX. Los usuarios de standalone suelen apañarse a mano. Los scripts de Agency se crearon con la filosofía opuesta: el framework es un adaptador, no una suposición.
El patrón de adaptador
Cada script de Agency expone un pequeño conjunto de funciones de consulta: getPlayerData, getInventory, addMoney, removeItem, getJob. Publicamos adaptadores que las mapean a las implementaciones de QBCore y ESX de fabrica. Para standalone, implementas tú mismo las cuatro o cinco funciones — normalmente el trabajo de una mañana — y cada script de Agency queda compatible.
Qué significa esto en la práctica
Cuando cambias tu servidor de QBCore a ESX (cosa que pasa cada cierto tiempo a medida que los frameworks evolucionan), los scripts de Agency no necesitan reinstalarse ni reconfigurarse. Cambias el adaptador y todo lo demás sigue funcionando. Eso es increíblemente raro en el ecosistema FiveM y es la razón principal por la que los dueños de servidores estandarizan su stack en nuestras herramientas a largo plazo.
Qué significa cada etiqueta de framework en nuestras fichas de producto
Cuando una ficha lista "QBCore, ESX", quiere decir que enviamos adaptadores listos para ambos. Cuando dice "Standalone", queremos decir que el script es agnóstico al framework — no necesita adaptador y corre en cualquier servidor. En la práctica, casi todos los scripts de Agency se pueden usar en configuraciones standalone con un pequeño shim de compatibilidad.
Cuándo preguntar antes de comprar
Si tu setup es raro — framework a medida, QBCore muy modificado o algo muy personal —, abre un ticket en nuestro Discord antes de comprar. Te diremos honestamente qué va a funcionar, qué necesita una adaptación ligera y qué no merece la pena. Sin presión comercial; preferimos que compres un script que te encaje a tres que no.
Instalación y Configuración
No se necesita configuración especial de compatibilidad de framework. Cada recurso Agency detecta automáticamente tu framework en el arranque verificando qué recursos están presentes. La detección ocurre una vez en el inicio, sin costo de rendimiento durante la ejecución.
Opciones de Configuración
- Anulación de framework — fuerza un framework específico si la detección automática falla
- Configuración del modo standalone — define fuentes de datos personalizadas cuando no se usa ningún framework estándar
- Ajustes de compatibilidad de versiones — para frameworks con versiones antiguas que tienen APIs diferentes
Compatibilidad con Frameworks
Los recursos Agency soportan ESX (1.2, 1.6, 1.9, y versiones más recientes), QBCore (todas las versiones principales), y modo standalone para servidores construidos sobre bases de datos y eventos personalizados. Algunos recursos también tienen compatibilidad declarada con ox_core y nd_core para aquellos que usan esos frameworks alternativos.
Migrar Entre Frameworks con Agency Scripts
Uno de los momentos más estresantes para un desarrollador de FiveM es decidir migrar de ESX a QBCore o viceversa. Esta migración normalmente implica reescribir docenas de recursos. Con Agency Scripts, el dolor se reduce considerablemente: solo cambias la configuración del framework, y la lógica de la aplicación permanece idéntica.
Modo Standalone: Más Flexible de lo que Parece
El modo standalone de Agency Scripts no es solo para servidores sin framework. Algunos operadores de servidores lo eligen deliberadamente porque les da más control. Construyen su propia capa de datos minimalista y usan los recursos Agency como bloques de construcción.
Preguntas Frecuentes
- ¿Funcionan los recursos Agency con frameworks altamente modificados? Generalmente sí, siempre que los nombres de eventos principales y las funciones de exportación no hayan cambiado. Las modificaciones personalizadas extensas pueden necesitar ajustes menores.
- ¿Pueden los recursos Agency mezclarse de diferentes versiones de framework? No recomendado — todos los recursos Agency deben detectar el mismo framework para que los datos sean consistentes.
- ¿Qué pasa durante la migración cuando se usan tanto ESX como QBCore? Es un período de transición difícil. El mejor enfoque es migrar todos los recursos Agency simultáneamente durante una ventana de mantenimiento del servidor.
Acerca de Agency Scripts
Agency Scripts es una colección de recursos premium de FiveM diseñados para servidores de roleplay que se toman en serio la inmersión. Cada recurso está construido con los mismos principios: compatibilidad multi-framework, rendimiento optimizado y configuración flexible para adaptarse a cualquier concepto de servidor.
Todos los recursos de Agency están disponibles a través del sistema de licencias de cfx.re Keymaster. Una vez comprado, puedes desplegar el recurso en cualquier servidor que poseas, con soporte activo disponible a través del Discord de Agency Scripts.
Soporte y Comunidad
La comunidad de Agency Scripts incluye miles de servidores de FiveM que utilizan estos recursos. El Discord oficial es donde los desarrolladores comparten sus configuraciones, hacen preguntas y sugieren nuevas características. Las actualizaciones son regulares e incluyen tanto correcciones de errores como nuevas características basadas en los comentarios de la comunidad.
Para preguntas de instalación, problemas de compatibilidad o solicitudes de características, Discord es el mejor canal. La documentación se mantiene actualizada y cubre todas las configuraciones con ejemplos prácticos. También hay una wiki comunitaria activa con guías contribuidas por los propios operadores de servidores.
Por Qué los Servidores Eligen Agency Scripts
La razón principal por la que los servidores de FiveM eligen Agency Scripts es la consistencia. Cuando todas tus herramientas vienen del mismo proveedor, tienen el mismo estilo de configuración, el mismo soporte y el mismo estándar de calidad. No hay sorpresas al actualizar un recurso porque saben qué esperar. Para los administradores de servidores que quieren pasar más tiempo en el roleplay y menos en solucionar problemas de scripts, esa consistencia tiene un valor real.
Requisitos del Sistema
Para usar los recursos de Agency Scripts, tu servidor FiveM necesita cumplir con los siguientes requisitos mínimos:
- Versión de servidor FiveM — artifact 4752 o superior recomendado
- Framework — ESX 1.2+, QBCore (cualquier versión principal), o configuración standalone
- Base de datos — MariaDB o MySQL 5.7+ con oxmysql como capa de base de datos
- ox_lib — recomendado para elementos UI mejorados, no siempre obligatorio
Los recursos de Agency Scripts están probados en los artifacts de servidor más recientes y se actualizan regularmente para mantenerse al día con los cambios de FiveM. Si usas un artifact particularmente antiguo y encuentras problemas, actualizar el servidor suele ser el primer paso de diagnóstico.
Licencias y Keymaster
Como todos los recursos premium de FiveM, los recursos de Agency Scripts se licencian a través del sistema Keymaster de cfx.re. Compras el recurso en el Tebex de Agency Scripts, luego aparece en tu cuenta de Keymaster donde puedes vincularlo a los identificadores de tu servidor. Las licencias son per-servidor pero no tienen fecha de caducidad una vez compradas.