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.
| Control | Qué hace |
|---|---|
| Buscar | Filtra por nombre, id o modelo. |
| Filtros | Todas, activas o apagadas, y por categoría. |
| Nueva | Crea un NPC en tu posición actual. Eliges su id, que no se puede cambiar después. |
| Ir | Te teletransporta al NPC. |
| Marcar | Pone un punto de ruta en el NPC. |
| Interruptor | Activa o desactiva el NPC para todos. Un NPC desactivado no lo ve nadie. |
| Duplicar | Copia el NPC con un id nuevo. La copia empieza desactivada. |
| Exportar SQL | Da dos líneas SQL que instalan este NPC en otro servidor. Pégalas al final del archivo seed (seed.file) de ese servidor. |
| Borrar | Quita 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
| Campo | Qué hace |
|---|---|
| Id | Letras, números, _ y -, hasta 64 caracteres. Fijo tras crearlo. |
| Texto | Texto de la opción de target. Vacío muestra «Hablar». |
| Categoría | Etiqueta libre para agrupar NPC en la lista. |
| Activa | Activa o desactiva el NPC. |
| Nota interna | Solo se ve en el panel. |
| Cómo se activa | Target, 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 target | Clase de Font Awesome de la opción de target. Vacío usa target.icon. |
| Distancia | Metros desde los que el jugador puede interactuar. |
| Cámara al hablar | Enfoca la cara del NPC durante el diálogo. |
NPC
| Sección | Qué se ajusta |
|---|---|
| Posición | Coordenadas y rumbo. Aquí toma tu posición. Colocar abre un gizmo para mover y girar el NPC (necesita object_gizmo). |
| NPC | Tipo: 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 reposo | Quieto, un escenario, o una animación con diccionario, clip, velocidad, salida, duración y flag. |
| Comportamiento | Invencible, congelado, ignora lo que pasa alrededor. |
| Ropa | Componente, 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 mapa | Sprite, color, escala, nombre y si solo se ve de cerca. |
| Distancia de aparición | Metros 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.
Diálogo
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ón | Qué hace |
|---|---|
| Ir a página | Muestra otra página del diálogo. |
| Cerrar diálogo | Cierra la ventana. |
| Abrir tienda | Abre la tienda de este NPC. Necesita la tienda activada en su pestaña. |
| Frase del NPC | Reproduce una frase en el NPC (GENERIC_HI, GENERIC_BYE...). |
| Teletransportar | Lleva al jugador a unas coordenadas, con fundido a negro opcional. |
| Comando | Ejecuta un comando como el jugador, con sus propios permisos. Se escribe sin /. |
| Export de cliente | Llama a exports[recurso]:nombre(...) en el cliente del jugador. |
| Evento de cliente | Lanza un evento de cliente en el cliente del jugador. |
| Export de servidor | Llama a exports[recurso]:nombre(source, ...) en el servidor. |
| Evento de servidor | Lanza un evento local de servidor; el handler recibe primero al jugador. |
| Revivir | Revive 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.
| Campo | Qué hace |
|---|---|
| Nombre, cargo, icono | Cabecera de la tienda. |
| Id de tienda | Vacío usa el id del NPC. |
| Cuenta | Cuenta a la que va o de la que sale el dinero. Por defecto usa shop.account. La lista sale de admin.accounts. |
| Distancia | Metros desde el NPC dentro de los que el servidor acepta una operación. 0 usa shop.maxDistance. |
| Modo por defecto | El jugador vende (el NPC paga) o El jugador compra (el NPC cobra). Lo usan los objetos en «Por defecto». |
| Ítems | Objeto, 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 tienda | Lí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:
| Campo | Valores |
|---|---|
| Cantidad | Número entero de 1 a 1 000 000. |
| Ventana | 15 min, 1 hora, 6 horas, 1 día, 1 semana, o cualquier número de minutos hasta limits.maxWindow. |
| Alcance | Por jugador (cada personaje lleva su propia cuenta) o Global (compartido por todos los jugadores; hace de stock). |
| Medida | Unidades o Dinero movido. |
| Modo | Solo 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ón | Cómo funciona |
|---|---|
| Trabajos | Vacío significa cualquiera. Basta con uno. Cada trabajo puede exigir un grado mínimo. |
| Ítems | El jugador tiene que llevar todos los objetos de la lista, cada uno con una cantidad mínima. |
| Horario | Horas 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ón | Qué hace |
|---|---|
| Datos extra | Objeto JSON que llega tal cual a los scripts en ctx.extraData. |
| Historial | Quién creó, editó, activó, duplicó, probó o reinició cada NPC y cuándo. Se guarda admin.auditDays días. |
| Para revisar | Lo que la conversión del seed no pudo trasladar. Rehazlo con acciones y pulsa Marcar revisada. |
| Herramientas | Duplicar, 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
| Elemento | Qué hace |
|---|---|
| Pestañas Comprar / Vender | Aparecen cuando la tienda tiene objetos en los dos modos. |
| Saldo | Dinero en la cuenta de la tienda, al comprar. |
| Cantidad | Al vender, hasta las unidades que lleva el jugador, y nunca más de shop.maxQuantity por operación. |
| Quedan / Agotado | Lo que queda del límite que más restringe. |
| Volver | Regresa al diálogo, cuando la tienda se abrió desde un botón. |
