> 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.md).

# Cuxial Interactions

NPC con diálogo y tienda de venta para FiveM, con una API para que otros recursos registren los suyos.

Cuxial Interactions coloca en el mundo NPC que hablan con el jugador en una ventana de diálogo y que pueden comprarle objetos. Tus otros recursos registran sus propios NPC, diálogos y tiendas mediante exports, así todas las conversaciones del servidor se ven y se comportan igual.

## Qué hace

* **NPC definidos en archivos de datos.** Cada archivo de `data/` es un conjunto de NPC que activas o desactivas desde el config.
* **Diálogos con páginas y botones.** Un botón puede cerrar, saltar a otra página, abrir la tienda, ejecutar una función o lanzar un evento.
* **Tiendas de venta.** El NPC compra objetos al jugador. Precio, distancia y cantidad se comprueban en el servidor.
* **Condiciones por NPC y por botón**: trabajo, grado mínimo, objetos que lleva o una función propia.
* **Cámara sobre el NPC** mientras dura la conversación, con el jugador oculto.
* **NPC con el aspecto de jugadores reales.** Un punto puede tomar la apariencia de un personaje activo al azar.
* **Blips en el mapa** por NPC.
* **API para otros recursos**: registrar un punto con su propio ped, colgar un diálogo de un ped que ya existe, o abrir un diálogo o una tienda directamente.
* **Limpieza automática.** Al parar un recurso se quitan sus NPC, sus diálogos y sus tiendas.

## Requisitos

| Recurso                                         | Obligatorio  | Para qué se usa                                                                                                          |
| ----------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------ |
| OneSync                                         | Sí           | Comprobaciones de distancia en el servidor                                                                               |
| `ox_lib`                                        | Sí           | Callbacks, notificaciones, idiomas, puntos de aparición                                                                  |
| `oxmysql`                                       | Sí           | Leer apariencias de jugadores para los NPC con `usePlayerSkin`                                                           |
| `ox_inventory`                                  | Sí           | Cantidades, nombres e imágenes de los objetos de la tienda                                                               |
| `cuxial_bridge`                                 | Sí           | Conecta con tu framework (QBox, QBCore o ESX) y con tu recurso de target                                                 |
| `sleepless_interact`, `ox_target` o `qb-target` | Uno de ellos | La opción a la que apunta el jugador para hablar con el NPC                                                              |
| `cuxial_appearance`                             | No           | Viste a los NPC que usan `usePlayerSkin`. Sin él conservan el modelo base                                                |
| `cuxial_medical`                                | No           | Reanima al jugador en el servicio del médico NPC de pago. Sin él, el servicio responde que no está disponible y no cobra |
| `bl_sprites`                                    | No           | Activa `interaction = 'sprite'` (un aviso de tecla sobre el NPC). Sin él, el punto usa el target                         |

{% hint style="warning" %}
`usePlayerSkin` requiere QBox o QBCore: lee las tablas `appearance` y `players`. En ESX, pon un `model` a esos NPC; un punto sin él aparece con `npc.fallbackModel`.
{% endhint %}

## Páginas

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Instalación</strong></td><td>Dependencias, convars y orden de arranque.</td><td><a href="/scripts/es/nucleo/cuxial-interactions/installation.md">Instalación</a></td></tr><tr><td><strong>Configuración</strong></td><td>Cada opción de <code>shared/config.lua</code> y cómo funcionan los conjuntos de NPC de <code>data/</code>.</td><td><a href="/scripts/es/nucleo/cuxial-interactions/configuration.md">Configuración</a></td></tr><tr><td><strong>Comandos y permisos</strong></td><td>Teclas del diálogo y quién puede hablar con cada NPC.</td><td><a href="/scripts/es/nucleo/cuxial-interactions/commands.md">Comandos y permisos</a></td></tr><tr><td><strong>Exports y eventos</strong></td><td>Registra tus propios NPC, diálogos y tiendas desde otro recurso.</td><td><a href="/scripts/es/nucleo/cuxial-interactions/developers.md">Exports y eventos</a></td></tr><tr><td><strong>Problemas frecuentes</strong></td><td>Los fallos más habituales y cómo resolverlos.</td><td><a href="/scripts/es/nucleo/cuxial-interactions/troubleshooting.md">Problemas frecuentes</a></td></tr></tbody></table>


---

# 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.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.