Skip to content

Guía de funciones

Cómo se usa el panel /interactions de Cuxial Interactions: NPC, diálogos, acciones de botón, tiendas, límites y condiciones.

El panel /interactions es donde el staff construye todos los NPC del servidor sin tocar archivos. Lo que guardas se almacena en la base de datos y llega al momento a todos los jugadores conectados.

La lista ​

La primera pantalla muestra todos los NPC creados en el panel, con su estado, su categoría, si tienen tienda o blip, y un aviso cuando alguna de sus acciones apunta a un recurso que no está arrancado.

ControlQué hace
BuscarFiltra por nombre, id o modelo.
FiltrosTodas, activas o apagadas, y por categoría.
NuevaCrea un NPC en tu posición actual. Eliges su id, que no se puede cambiar después.
IrTe teletransporta al NPC.
MarcarPone un punto de ruta en el NPC.
InterruptorActiva o desactiva el NPC para todos. Un NPC desactivado no lo ve nadie.
DuplicarCopia el NPC con un id nuevo. La copia empieza desactivada.
Exportar SQLDa dos líneas SQL que instalan este NPC en otro servidor. Pégalas al final del archivo seed (seed.file) de ese servidor.
BorrarQuita el NPC para todos. Un NPC borrado no vuelve a instalarse desde el seed.

Junto a la lista hay dos vistas más:

  • De script. NPC y tiendas registrados por otros recursos con los exports. Son de solo lectura: se editan en su propio recurso.
  • Importación. Las filas instaladas desde el archivo seed, con su estado. Un NPC cuya conversión perdió algo lo muestra en «Para revisar» hasta que lo marcas como revisado.

Editar un NPC ​

El editor tiene seis pestañas. Nada cambia en el mundo hasta que pulsas Guardar. Si otro miembro del staff guardó el mismo NPC mientras lo editabas, el panel te avisa: recarga para ver su versión, o copia antes tus cambios.

General ​

CampoQué hace
IdLetras, números, _ y -, hasta 64 caracteres. Fijo tras crearlo.
TextoTexto de la opción de target. Vacío muestra «Hablar».
CategoríaEtiqueta libre para agrupar NPC en la lista.
ActivaActiva o desactiva el NPC.
Nota internaSolo se ve en el panel.
Cómo se activaTarget, sprite (aviso con tecla, necesita bl_sprites) o ninguna. Con ninguna el NPC solo se abre desde un script con el export Interact.
Icono del targetClase de Font Awesome de la opción de target. Vacío usa target.icon.
DistanciaMetros desde los que el jugador puede interactuar.
Cámara al hablarEnfoca la cara del NPC durante el diálogo.

NPC ​

SecciónQué se ajusta
PosiciónCoordenadas y rumbo. Aquí toma tu posición. Colocar abre un gizmo para mover y girar el NPC (necesita object_gizmo).
NPCTipo: un modelo, una skin de jugador (el aspecto de un personaje activo al azar, con un modelo de respaldo) o sin NPC (una zona de target en la posición).
En reposoQuieto, un escenario, o una animación con diccionario, clip, velocidad, salida, duración y flag.
ComportamientoInvencible, congelado, ignora lo que pasa alrededor.
RopaComponente, drawable y textura por prenda. Copiar mi ropa la rellena con lo que llevas puesto. No se aplica cuando se pone una skin de jugador.
Blip del mapaSprite, color, escala, nombre y si solo se ve de cerca.
Distancia de apariciónMetros a los que se crea el ped.

Vista previa crea el NPC delante de ti con el borrador actual, para revisar modelo, ropa y reposo antes de guardar.

Las páginas se muestran de una en una; la marcada como inicial se abre primero. Por defecto fija el nombre, el cargo y el icono que usan las páginas que los dejan vacíos. Cada página tiene su id, el nombre y el cargo del NPC, el texto, la velocidad de escritura y hasta admin.limits.buttons botones (9 por defecto).

Cada botón tiene un texto, un icono, sus propias condiciones y una lista de acciones, que se ejecutan en orden:

AcciónQué hace
Ir a páginaMuestra otra página del diálogo.
Cerrar diálogoCierra la ventana.
Abrir tiendaAbre la tienda de este NPC. Necesita la tienda activada en su pestaña.
Frase del NPCReproduce una frase en el NPC (GENERIC_HI, GENERIC_BYE...).
TeletransportarLleva al jugador a unas coordenadas, con fundido a negro opcional.
ComandoEjecuta un comando como el jugador, con sus propios permisos. Se escribe sin /.
Export de clienteLlama a exports[recurso]:nombre(...) en el cliente del jugador.
Evento de clienteLanza un evento de cliente en el cliente del jugador.
Export de servidorLlama a exports[recurso]:nombre(source, ...) en el servidor.
Evento de servidorLanza un evento local de servidor; el handler recibe primero al jugador.
RevivirRevive al jugador pagando: coste, cuenta y si se ignoran los EMS de servicio.

Un botón solo puede tener una acción que cambie o cierre la ventana (ir a página, cerrar o abrir tienda). Los argumentos de exports y eventos se escriben en JSON. Los exports y eventos de cliente pueden añadir además al final el contexto { id, dialogId, buttonId, entity }.

Probar ejecuta una acción de export, evento o comando desde el panel, para comprobarla sin hablar con el NPC.

Datos que se piden al jugador ​

Una acción de comando, export o evento puede pedir al jugador hasta cuatro valores antes de ejecutarse: texto o número, con etiqueta, texto de ejemplo, mínimo, máximo y si es obligatorio. Solo una acción por botón puede pedir datos.

Los valores se comprueban en el servidor (texto recortado a actions.inputLength caracteres sin saltos de línea, números dentro de su rango) y se añaden al final de los argumentos guardados, en orden. En un comando se añaden separados por espacios y no pueden llevar ; ni ". Un dato opcional vacío llega como ''. Si el jugador cancela, no se ejecuta nada.

Tienda ​

Al activar la tienda, el diálogo puede abrirla con la acción «Abrir tienda». Sin páginas en el diálogo, hablar con el NPC abre la tienda directamente.

CampoQué hace
Nombre, cargo, iconoCabecera de la tienda.
Id de tiendaVacío usa el id del NPC.
CuentaCuenta a la que va o de la que sale el dinero. Por defecto usa shop.account. La lista sale de admin.accounts.
DistanciaMetros desde el NPC dentro de los que el servidor acepta una operación. 0 usa shop.maxDistance.
Modo por defectoEl jugador vende (el NPC paga) o El jugador compra (el NPC cobra). Lo usan los objetos en «Por defecto».
ÍtemsObjeto, modo, precio, nombre e imagen. Nombre e imagen vacíos toman los del inventario. El mismo objeto puede estar en los dos modos con precios distintos.
Límites de la tiendaLímites que cuentan todos los objetos de la tienda juntos.

Reiniciar límites borra los registros de esta tienda para todos los jugadores.

Límites ​

Cada objeto y la tienda entera pueden tener hasta admin.limits.limits límites (4 por defecto). Un límite tiene:

CampoValores
CantidadNúmero entero de 1 a 1 000 000.
Ventana15 min, 1 hora, 6 horas, 1 día, 1 semana, o cualquier número de minutos hasta limits.maxWindow.
AlcancePor jugador (cada personaje lleva su propia cuenta) o Global (compartido por todos los jugadores; hace de stock).
MedidaUnidades o Dinero movido.
ModoSolo en límites de la tienda: ambos, al comprar o al vender.

Las ventanas son deslizantes: «30 / 1 día» significa 30 en las últimas 24 horas, no 30 por día natural. La tienda muestra al jugador cuántos le quedan y, al llegar al límite, cuánto falta para que se libere.

Condiciones ​

Los jugadores que no las cumplen no ven el NPC. El servidor las vuelve a comprobar en cada botón, compra, venta y reanimación.

CondiciónCómo funciona
TrabajosVacío significa cualquiera. Basta con uno. Cada trabajo puede exigir un grado mínimo.
ÍtemsEl jugador tiene que llevar todos los objetos de la lista, cada uno con una cantidad mínima.
HorarioHoras desde y hasta, por hora del juego o hora real, y días de la semana. Sin días marcados vale todos los días. La misma hora en desde y hasta significa abierto 24 h.

Los botones tienen las mismas condiciones, en el propio botón.

Avanzado ​

SecciónQué hace
Datos extraObjeto JSON que llega tal cual a los scripts en ctx.extraData.
HistorialQuién creó, editó, activó, duplicó, probó o reinició cada NPC y cuándo. Se guarda admin.auditDays días.
Para revisarLo que la conversión del seed no pudo trasladar. Rehazlo con acciones y pulsa Marcar revisada.
HerramientasDuplicar, exportar SQL y borrar.

Cómo se ejecutan los botones ​

Los botones que solo cambian de página, cierran o reproducen una frase, y no tienen condiciones, se ejecutan al momento en el cliente del jugador. Todos los demás pasan por el servidor, que comprueba que el NPC no ha cambiado desde que se abrió la ventana, la distancia, las condiciones y una espera por jugador (actions.cooldown). Después ejecuta las acciones de servidor con el source del jugador y devuelve los pasos de cliente. El cliente nunca decide qué se ejecuta.

Los exports de servidor se llaman con el candado del jugador puesto. Haz que respondan rápido y que nunca esperen nada del cliente. Un export que devuelve false cuenta como fallo.

Qué ve el jugador en una tienda ​

ElementoQué hace
Pestañas Comprar / VenderAparecen cuando la tienda tiene objetos en los dos modos.
SaldoDinero en la cuenta de la tienda, al comprar.
CantidadAl vender, hasta las unidades que lleva el jugador, y nunca más de shop.maxQuantity por operación.
Quedan / AgotadoLo que queda del límite que más restringe.
VolverRegresa al diálogo, cuando la tienda se abrió desde un botón.

© Cuxial