> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/primeros-pasos/requirements.md). # Requisitos Qué necesita tu servidor antes de instalar un script de Cuxial, qué añade cada script y en qué orden arrancarlo. Los scripts de Cuxial comparten una base: OneSync, tres recursos compartidos y un framework compatible. Se prepara una vez. Algunos scripts añaden requisitos propios, que están en [Requisitos por script](#requisitos-por-script). ## Servidor | Requisito | Notas | | ----------------------------- | ---------------------------------------------------------------------------------------------------- | | FXServer para GTA V | Los scripts declaran `fx_version 'cerulean'` y `game 'gta5'`. Usa un artefacto recomendado reciente. | | OneSync | Obligatorio. La mayoría de los scripts lo declaran como dependencia y no arrancan sin él. | | Base de datos MySQL o MariaDB | Se usa a través de `oxmysql`. | Activa OneSync desde txAdmin o en la configuración del servidor: ```cfg set onesync on ``` ## Recursos compartidos | Recurso | Para qué | | --------------- | --------------------------------------------------------------------------------------------------------------------------------- | | `ox_lib` | Callbacks, traducciones y utilidades comunes. | | `oxmysql` | Acceso a la base de datos. | | `cuxial_bridge` | Conecta los scripts con tu framework, inventario y target. Consulta [Cuxial Bridge](/scripts/es/primeros-pasos/cuxial-bridge.md). | Todos los scripts necesitan los tres, con dos excepciones: Cuxial Pause Menu no usa `oxmysql`, y Cuxial Gang App no declara `cuxial_bridge` (depende directamente de `qbx_core` y de Cuxial Gang). ## Framework, inventario y target Cuxial Bridge detecta lo que usa tu servidor. Estas son las opciones compatibles: | Capa | Compatibles | | ---------- | ---------------------------------------------------------- | | Framework | QBox (`qbx_core`), QBCore (`qb-core`), ESX (`es_extended`) | | Inventario | `ox_inventory`, `qb-inventory` | | Target | `sleepless_interact`, `ox_target`, `qb-target` | El framework es siempre obligatorio. El inventario y el target solo importan en los scripts que los usan; algunos necesitan uno en concreto, como muestran las tablas de abajo. {% hint style="warning" %} Algunos scripts requieren un framework concreto. Cuxial Multichar requiere QBox o QBCore. Consulta la tabla de abajo antes de comprar o instalar. {% endhint %} ## Compatibilidad por framework Frameworks con los que funciona cada script. | Script | QBox | QBCore | ESX | Notas | | ------------------------------------------------------------------------ | ---- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Cuxial Multichar](/scripts/es/nucleo/cuxial-multichar.md) | Sí | Sí | No | Requiere QBox o QBCore. | | [Cuxial Appearance](/scripts/es/nucleo/cuxial-appearance.md) | Sí | Sí | Parcial | En ESX el creador empieza en el modelo masculino. | | [Cuxial Banking](/scripts/es/nucleo/cuxial-banking.md) | Sí | Sí | Parcial | En ESX el historial recoge los movimientos hechos desde Cuxial Banking. | | [Cuxial Garages](/scripts/es/nucleo/cuxial-garages.md) | Sí | Sí | Sí | En ESX añade columnas a `owned_vehicles` en el primer arranque. | | [Cuxial License](/scripts/es/nucleo/cuxial-license.md) | Sí | Sí | Parcial | La fecha de nacimiento, la nacionalidad y el género del personaje se leen en QBox y QBCore. | | [Cuxial Interactions](/scripts/es/nucleo/cuxial-interactions.md) | Sí | Sí | Parcial | `usePlayerSkin` requiere QBox o QBCore. | | [Cuxial Safezones](/scripts/es/nucleo/cuxial-safezones.md) | Sí | Sí | Sí | | | [Cuxial Admin](/scripts/es/nucleo/cuxial-admin.md) | Sí | No | No | Requiere `qbx_core`. | | [Cuxial Servicios Comunitarios](/scripts/es/nucleo/cuxial-cmservices.md) | Sí | Sí | No | Requiere QBox o QBCore. | | [Cuxial Chat](/scripts/es/interfaz/cuxial-chat.md) | Sí | Sí | Sí | | | [Cuxial Emotes](/scripts/es/interfaz/cuxial-emotes.md) | Sí | Sí | Sí | | | [Cuxial Pause Menu](/scripts/es/interfaz/cuxial-pausemenu.md) | Sí | Sí | Parcial | En ESX los contadores de servicio van por nombre de trabajo. La etiqueta de banda se muestra en QBox y QBCore. | | [Cuxial Anuncios](/scripts/es/interfaz/cuxial-anuncios.md) | Sí | Sí | Sí | | | [Cuxial Police](/scripts/es/policia-y-medico/cuxial-police.md) | Sí | Parcial | Parcial | Cambiar un rango desde la página de personal requiere multitrabajo. En ESX el servicio requiere una versión cuyos trabajos guarden el estado de servicio. | | [Cuxial Medical](/scripts/es/policia-y-medico/cuxial-medical.md) | Sí | Sí | Parcial | En ESX necesita metadatos de jugador (`getMeta` / `setMeta`) y estado de servicio en el trabajo. | | [Cuxial Diseases](/scripts/es/policia-y-medico/cuxial-diseases.md) | Sí | Sí | Parcial | En ESX pon `onboarding.enabled = false`. | | [Cuxial Gang](/scripts/es/bandas/cuxial-gang.md) | Sí | Sí | No | Requiere QBox o QBCore. | | [Cuxial Gang App](/scripts/es/bandas/cuxial-gang-app.md) | Sí | No | No | Requiere `qbx_core`. | | [Cuxial Fuel](/scripts/es/vehiculos/cuxial-fuel.md) | Sí | Sí | Sí | En ESX los descuentos por trabajo necesitan una versión que informe del estado de servicio. | | [Cuxial Gas Stations](/scripts/es/vehiculos/cuxial-gasstations.md) | Sí | Sí | Sí | | | [Cuxial Chipeo](/scripts/es/vehiculos/cuxial-chipeo.md) | — | — | — | Usa el framework a través de Cuxial Bridge. | | [Cuxial Diving](/scripts/es/trabajos/cuxial-diving.md) | Sí | Sí | Sí | | | [Cuxial Electrician](/scripts/es/trabajos/cuxial-electrician.md) | Sí | Sí | Sí | | | [Cuxial Gardener](/scripts/es/trabajos/cuxial-gardener.md) | Sí | Sí | Sí | | | [Cuxial Gym](/scripts/es/ocio/cuxial-gym.md) | — | — | — | Usa el framework a través de Cuxial Bridge. | | [Cuxial Dance Class](/scripts/es/ocio/cuxial-danceclass.md) | Sí | Sí | Sí | | | [Cuxial Domino](/scripts/es/ocio/cuxial-domino.md) | Sí | Sí | Sí | | | [Cuxial PvP](/scripts/es/ocio/cuxial-pvp.md) | Sí | Sí | Sí | En ESX requiere `ox_inventory`. | **Sí**: compatible. **Parcial**: funciona, con lo indicado en la columna Notas. **No**: requiere otro framework. **—**: usa el framework que detecte Cuxial Bridge. El detalle de cada «Parcial» está en las páginas de Introducción e Instalación del script. ## Requisitos por script A algunos scripts les basta la base común. Otros declaran dependencias extra y no arrancan sin ellas. Las integraciones opcionales se detectan si están en marcha: si falta una, esa parte se queda apagada y el resto funciona igual. | Script | Requisitos extra | Integraciones opcionales | | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Cuxial Multichar](/scripts/es/nucleo/cuxial-multichar.md) | Ninguno | `cuxial_appearance` o `illenium-appearance`, `cuxial_emotes`, `cuxial_license`, `cuxial_garages`, `av_weather`, `qbx_properties` | | [Cuxial Appearance](/scripts/es/nucleo/cuxial-appearance.md) | Ninguno | Inventario y target (prendas como ítems, bolsa de outfits), `cuxial_appearance_photos`, `screencapture` o `screenshot-basic`, `cuxial_emotes`, `rcore_tattoos` | | [Cuxial Banking](/scripts/es/nucleo/cuxial-banking.md) | Un inventario y un target compatibles con el bridge | `cuxial_interactions` | | [Cuxial Garages](/scripts/es/nucleo/cuxial-garages.md) | Ninguno | `ox_inventory` (recomendado; necesario mientras el sistema de llaves esté activo), `ox_target`, `cuxial_gang`, `cuxial_police`, `cuxial_license`, `cuxial_fuel`, `lb-phone`, `jg-dealerships`, `rahe-speakers` | | [Cuxial License](/scripts/es/nucleo/cuxial-license.md) | `screencapture`. `ox_inventory` para los ítems de las tarjetas y un target para el NPC de la oficina | Cuenta de Fivemanage (fotos), `cuxial_police`, `av_weather` | | [Cuxial Interactions](/scripts/es/nucleo/cuxial-interactions.md) | `ox_inventory`. Un target: `sleepless_interact`, `ox_target` o `qb-target` | `cuxial_appearance`, `cuxial_medical`, `bl_sprites` | | [Cuxial Safezones](/scripts/es/nucleo/cuxial-safezones.md) | Ninguno | `ox_inventory` | | [Cuxial Admin](/scripts/es/nucleo/cuxial-admin.md) | `qbx_core` | `cuxial_medical`, `cuxial_appearance`, `cuxial_garages`, `cuxial_multichar`, `cuxial_cmservices`, `cuxial_emotes`, `av_weather` o `prim_climatime`, txAdmin | | [Cuxial Servicios Comunitarios](/scripts/es/nucleo/cuxial-cmservices.md) | `bl_sprites` | `cuxial_chat` | | [Cuxial Chat](/scripts/es/interfaz/cuxial-chat.md) | Ninguno | `cuxial_gang` | | [Cuxial Emotes](/scripts/es/interfaz/cuxial-emotes.md) | Ninguno | `cuxial_emotes_dlc`, `cuxial_diseases`, `ox_inventory` | | [Cuxial Pause Menu](/scripts/es/interfaz/cuxial-pausemenu.md) | Ninguno | Ninguna | | [Cuxial Anuncios](/scripts/es/interfaz/cuxial-anuncios.md) | Ninguno | Ninguna | | [Cuxial Police](/scripts/es/policia-y-medico/cuxial-police.md) | `pma-voice` | `ox_inventory` (recomendado), `screencapture`, `cuxial_medical`, `cuxial_diseases`, `cuxial_gang`, `cuxial_banking`, `cuxial_license`, `cuxial_garages`, `cuxial_interactions`, `lb-phone`, `rcore_prison` | | [Cuxial Medical](/scripts/es/policia-y-medico/cuxial-medical.md) | Un inventario y un target compatibles con el bridge | `cuxial_interactions`, `cuxial_police` | | [Cuxial Diseases](/scripts/es/policia-y-medico/cuxial-diseases.md) | `ox_inventory` o `qb-inventory` | `cuxial_police`, `cuxial_medical`, `cuxial_emotes`, `lb-phone` | | [Cuxial Gang](/scripts/es/bandas/cuxial-gang.md) | `ox_inventory` para los almacenes | `cuxial_police`, `cuxial_garages`, `cuxial_medical`, `cuxial_appearance`, `nextgenfivem_crafting`, `lb-phone` | | [Cuxial Gang App](/scripts/es/bandas/cuxial-gang-app.md) | `qbx_core`, `lb-phone`, `cuxial_gang` | `ox_inventory` | | [Cuxial Fuel](/scripts/es/vehiculos/cuxial-fuel.md) | `sleepless_interact`, `ox_inventory`, `cuxial_gas_assets` | `cuxial_gasstations` | | [Cuxial Gas Stations](/scripts/es/vehiculos/cuxial-gasstations.md) | `sleepless_interact`, `cuxial_gas_assets` | `cuxial_fuel`, `cuxial_garages`, un teléfono compatible con el bridge | | [Cuxial Chipeo](/scripts/es/vehiculos/cuxial-chipeo.md) | `ox_inventory` para los ítems y un target para los altavoces portátiles | Ninguna | | [Cuxial Diving](/scripts/es/trabajos/cuxial-diving.md) | `sleepless_interact`, `cuxial_jobs`, `cuxial_diving_assets` | `cuxial_garages` | | [Cuxial Electrician](/scripts/es/trabajos/cuxial-electrician.md) | `sleepless_interact`, `cuxial_jobs` | `cuxial_garages` | | [Cuxial Gardener](/scripts/es/trabajos/cuxial-gardener.md) | `sleepless_interact`, `cuxial_jobs`, `cuxial_gardener_assets` | `cuxial_garages`, `ox_inventory` o `qb-inventory` (recompensas en ítems) | | [Cuxial Gym](/scripts/es/ocio/cuxial-gym.md) | `sleepless_interact`, `cuxial_gym_assets` | `ox_inventory` (recomendado; taquillas y almacenes lo necesitan), `cuxial_appearance` | | [Cuxial Dance Class](/scripts/es/ocio/cuxial-danceclass.md) | `cuxial_emotes` | `cuxial_gym` | | [Cuxial Domino](/scripts/es/ocio/cuxial-domino.md) | `sleepless_interact` | Ninguna | | [Cuxial PvP](/scripts/es/ocio/cuxial-pvp.md) | `ox_inventory` o `qb-inventory` | `av_weather` o `cd_easytime` | {% hint style="info" %} `cuxial_jobs` y los paquetes de assets (`cuxial_gas_assets`, `cuxial_gym_assets`, `cuxial_diving_assets`, `cuxial_gardener_assets`) se entregan con el script que los usa. Consulta [Cuxial Jobs](/scripts/es/primeros-pasos/cuxial-jobs.md). {% endhint %} Para qué sirve cada recurso, y qué pasa sin él, está en la tabla de requisitos de la página de Introducción de cada script. ## Orden de arranque Primero las dependencias, después tu framework, después Cuxial Bridge, después librerías y assets, y por último los scripts. {% tabs %} {% tab title="QBox" %} {% code title="server.cfg" %} ```cfg ensure oxmysql ensure ox_lib ensure qbx_core ensure ox_inventory ensure ox_target ensure cuxial_bridge # librerías y assets de tus scripts (cuxial_jobs, cuxial_*_assets) # aquí tus scripts de Cuxial ``` {% endcode %} {% endtab %} {% tab title="QBCore" %} {% code title="server.cfg" %} ```cfg ensure oxmysql ensure ox_lib ensure qb-core ensure qb-inventory ensure qb-target ensure cuxial_bridge # librerías y assets de tus scripts (cuxial_jobs, cuxial_*_assets) # aquí tus scripts de Cuxial ``` {% endcode %} {% endtab %} {% tab title="ESX" %} {% code title="server.cfg" %} ```cfg ensure oxmysql ensure ox_lib ensure es_extended ensure ox_inventory ensure ox_target ensure cuxial_bridge # librerías y assets de tus scripts (cuxial_jobs, cuxial_*_assets) # aquí tus scripts de Cuxial ``` {% endcode %} En ESX arranca solo los scripts marcados con «Sí» o «Parcial» en [Compatibilidad por framework](#compatibilidad-por-framework). {% endtab %} {% endtabs %} Las líneas de inventario y target son ejemplos. Deja las que tu servidor ya usa y pon solo los scripts que tengas. Las líneas `ensure` exactas de cada script están en su página de Instalación. {% hint style="warning" %} Las librerías y los assets (`cuxial_jobs`, `cuxial_*_assets`) deben arrancar **antes** que el script que los usa. Lo mismo vale para cualquier otro requisito extra (`sleepless_interact`, `pma-voice`, `screencapture`, `lb-phone`) y para un script de Cuxial del que dependa otro: Cuxial Emotes antes que Cuxial Dance Class, Cuxial Gang antes que Cuxial Gang App. {% endhint %} {% hint style="warning" %} Tu framework, inventario y target deben arrancar **antes** que los scripts de Cuxial. La detección ocurre cuando carga cada script; lo que arranque después no se ve, y el script recurre a QBox, `ox_inventory` y `ox_target`. {% endhint %} {% hint style="info" %} Si arrancas los recursos por carpeta (`ensure [cuxial]`), el orden dentro de la carpeta no está garantizado. Arranca tu framework, inventario, target y `cuxial_bridge` con sus propias líneas `ensure` por encima. {% endhint %} ## Siguiente Configura [Cuxial Bridge](/scripts/es/primeros-pasos/cuxial-bridge.md) y después abre la página de instalación de tu script. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.cuxial.com/scripts/es/primeros-pasos/requirements.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.