> 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/nucleo/cuxial-interactions/installation.md).

# Instalación

Instala Cuxial Interactions paso a paso: dependencias, conjuntos de ejemplo, convars y orden de arranque.

Cuxial Interactions no necesita importar SQL ni añade objetos al inventario. No crea tablas.

{% stepper %}
{% step %}

## Comprueba las dependencias

Estos recursos deben estar instalados y funcionando antes:

* `ox_lib`
* `oxmysql`
* `ox_inventory`
* `cuxial_bridge`, con uno de los frameworks soportados: QBox, QBCore o ESX
* Un recurso de target: `sleepless_interact`, `ox_target` o `qb-target`
* OneSync activado en el servidor

Recursos opcionales:

* `cuxial_appearance` viste a los NPC que usan `usePlayerSkin`.
* `cuxial_medical` es el recurso al que llama el servicio del médico NPC de pago para reanimar al jugador.
* `bl_sprites` activa el modo de aviso de tecla (`interaction = 'sprite'`).

{% hint style="warning" %}
`usePlayerSkin` requiere QBox o QBCore. En ESX esos NPC aparecen con su `model`, o con `npc.fallbackModel`.
{% endhint %}
{% endstep %}

{% step %}

## Copia el recurso

Coloca la carpeta `cuxial_interactions` dentro de tu directorio `resources`. No cambies el nombre de la carpeta: otros recursos llaman a sus exports con ese nombre.
{% endstep %}

{% step %}

## Revisa los conjuntos de ejemplo

El paquete incluye tres conjuntos de ejemplo: `Greeter`, un guía con un diálogo de varias páginas en Legion Square; `Buyer`, un NPC que compra objetos en Vinewood; y `Doctor`, el médico NPC de pago de Sandy Shores, que viene desactivado. Cambia sus coordenadas, textos y objetos, o desactívalos y escribe los tuyos.

Abre `shared/config.lua` y deja activados solo los conjuntos que quieras:

{% code title="shared/config.lua" %}

```lua
sets = {
    Greeter = true,   -- se carga data/Greeter.lua
    Buyer = true,     -- se carga data/Buyer.lua
    Doctor = false,   -- data/Doctor.lua se ignora
},
```

{% endcode %}

{% hint style="info" %}
Un botón que llama a un recurso que no tienes no rompe nada: deja un aviso en la consola del cliente y el diálogo sigue funcionando. Desactiva el conjunto, o edita el botón, para mantener la consola limpia.
{% endhint %}

Los objetos que compra una tienda deben existir en `ox_inventory`. Los textos de los NPC de ejemplo están escritos en los archivos de datos, no en `locales/`.
{% endstep %}

{% step %}

## Define las convars

Las dos son opcionales.

{% code title="server.cfg" %}

```cfg
# Idioma de la interfaz y de las notificaciones (incluye en y es)
setr ox:locale "es"

# Trazas de depuración en la consola
setr cuxial_interactions_debug "0"
```

{% endcode %}

{% hint style="info" %}
Usa `setr`, no `set`: la convar de depuración se lee tanto en el cliente como en el servidor.
{% endhint %}
{% endstep %}

{% step %}

## Arranca el recurso

Arráncalo después de sus dependencias, de tu framework y de tu recurso de target. Los recursos que registran sus propios NPC van después.

{% code title="server.cfg" %}

```cfg
ensure ox_lib
ensure oxmysql
# tu framework aquí (qbx_core, qb-core o es_extended)
ensure ox_inventory
ensure cuxial_bridge
# tu recurso de target (sleepless_interact, ox_target o qb-target)
ensure ox_target
# opcionales
ensure cuxial_appearance
ensure cuxial_medical
ensure cuxial_interactions
# los recursos que registran NPC con los exports van aquí
```

{% endcode %}
{% endstep %}

{% step %}

## Comprueba que funciona

1. Entra al servidor y ve a las coordenadas de un NPC de un conjunto que hayas dejado activado.
2. A menos de 60 metros aparece el NPC. Apúntale con tu target: sale la opción de hablar.
3. Selecciónala. La cámara se mueve hacia el NPC y se abre el diálogo.
4. Pulsa <kbd>1</kbd> para elegir el primer botón, o <kbd>Esc</kbd> para cerrar.
5. Si el NPC tiene tienda, ábrela y vende un objeto. El objeto sale de tu inventario y llega el dinero.
   {% endstep %}
   {% endstepper %}

Siguiente paso: ajusta el comportamiento y escribe tus propios NPC en [Configuración](/scripts/es/nucleo/cuxial-interactions/configuration.md).


---

# 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/nucleo/cuxial-interactions/installation.md?ask=<question>&goal=<user_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.