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 |
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.
Páginas
InstalaciónDependencias, convars y orden de arranque.ConfiguraciónCada opción de
shared/config.lua y cómo funcionan los conjuntos de NPC de data/.Comandos y permisosTeclas del diálogo y quién puede hablar con cada NPC.Exports y eventosRegistra tus propios NPC, diálogos y tiendas desde otro recurso.Problemas frecuentesLos fallos más habituales y cómo resolverlos.