El máster IA

Qué hace y qué no

El máster sí	El máster no
Narra lo que pasa y da voz a los NPC	Tira dados (lo hace el servidor)
Elige qué prueba pide cada acción	Mueve a nadie, cura o hiere sin tool
Propone acciones sugeridas	Actúa por un jugador
Recuerda lo que los NPC han hablado	Resuelve más de una acción por mensaje
Siembra ganchos y rumores	Revela secretos sin motivo en el juego
	Mata o resucita a un personaje
	Adelanta el tiempo

La persona del narrador está en El narrador. En las pruebas se fijó un tono de mago sabio, breve, que observa más que interpela, con párrafos de dos o tres líneas pensados para leer en el móvil.

Una llamada por acción

flowchart TD
  J["Jugador escribe una acción"] --> D{"¿Es determinista?<br/>ir, coger, soltar, esperar"}
  D -- sí --> P["Motor la resuelve<br/>y la narra por plantilla<br/>(coste cero)"]
  D -- no --> C["Motor arma el contexto:<br/>solo lo que el PJ percibe"]
  C --> M["Máster (Claude)"]
  M --> T["Tools de lectura y escritura"]
  T --> V["Motor valida, calcula<br/>y aplica cada cambio"]
  V --> M
  M --> L["Cierre obligatorio<br/>con log_event"]
  L --> K{"Comprobación del cierre"}
  K -- falla --> M
  K -- bien --> E["Evento en el log"]
  E --> R["Entrega por percepción<br/>a quien lo ve u oye"]
  R --> N["Narración en el chat"]

1. Si la acción es trivial (ir, salir, coger, soltar, esperar, clic en el tablero), la resuelve el motor. Coste cero.
2. Si no, el motor arma el contexto de escena.
3. El máster lee lo que le falte con tools, cambia el mundo con tools y cierra con log_event.
4. El motor registra el evento, lo entrega a quien lo percibe y dispara ganchos y memorias.
5. Si hace falta tirada, aparece el dado. Al tirar, el servidor resuelve y el máster narra la consecuencia en una segunda llamada.

El contexto: poco y justo

El máster no ve el mundo entero. Ve:

• lo que el personaje percibe, con la banda de cada cosa (ver Percepción);
• de cada NPC presente, solo lo que contaría al personaje con la confianza que le tiene; si calla algo más, que lo calla y a quién se lo contaría, sin el texto;
• las pistas ancladas a este lugar o a estos NPC que el personaje ya puede conseguir (si grant_clue da una que no, el motor la rechaza con el motivo para narrarlo);
• los encargos en una línea;
• los últimos seis eventos;
• un aviso si no hay testigos.

Lo demás lo pide bajo demanda: notas de campaña (get_campaign_notes) o una regla del SRD (lookup_rule). La parte fija (instrucciones, chuleta de reglas y tools) va cacheada: ronda los 12.000 tokens y se paga al 10 %.

Las tools

A 16 de octubre eran 29. Se agrupan así:

Grupo	Ejemplos
Leer	notas de campaña, consultar reglas
Dados	pruebas de habilidad, ataques
Espacio	moverse, descubrir un punto oculto
Objetos	transferir, comprar, vender, recolectar
Personajes	daño, curación, estabilizar, descansar, gastar recursos
Progreso	conceder pista, completar encargo
Mundo	sembrar o cancelar un gancho, sembrar un rumor, apuntar un hecho del personaje
Tratos	deudas y prendas como estado (set_debt, settle_debt, pawn_item)
Cierre	log_event, obligatorio en cada turno

Si una tool falla, el motor devuelve el error y el máster lo vuelve a narrar. Al llegar al tope de tools sin cerrar, una última llamada solo con log_event le obliga a contar lo que pasó.

Intención antes de efecto y el dado

• Si una acción con consecuencias no tiene objetivo, dirección o propósito, el máster pregunta antes. No se gasta nada.
• Cuando hay riesgo, el máster pide tirada y aparece el botón Tirar.
• El servidor tira, enseña el desglose y el máster narra la consecuencia.
• Las tiradas ocultas del máster no llevan botón.

Acciones sugeridas

• El máster propone 2 a 4 botones cuando la situación lo pide.
• Salen del personaje: su clase, sus rasgos, lo que lleva en la mano. Un pícaro codicioso verá «registrar el cadáver» antes que «rezar por él».
• Son reacciones a lo que acaba de pasar, no planes a futuro (ajustado tras las pruebas).
• No adelantan lo que el jugador no sabe. Un botón que nombra a alguien de quien no ha oído hablar y que no tiene sitio fijo (un perro perdido) se quita, aunque el máster lo sepa por el contexto. Si se lo acaban de nombrar («Ceniza no vuelve»), el nombre va tal cual: cambiarlo por lo que es («el perro») contaría lo que no sabe. A quien tiene sitio fijo y no conoce, por su oficio: «Preguntar a la tabernera» (desde el 2026-11-05).
• Siempre se puede escribir otra cosa. Pulsar un botón es lo mismo que escribir su texto.

NPC con memoria

• Cada NPC tiene descripción, motivación y secreto.
• El máster conoce los secretos, pero no los desvela ni los insinúa: hace falta confianza, presión o una tirada alta.
• Al cerrar una conversación, el máster apunta en el NPC una frase con importancia de 1 a 3.

Importancia	Se olvida a los…
1	3 días de juego
2	30 días de juego
3	Nunca

• Tope: 8 recuerdos por personaje y 40 por NPC.
• Un NPC habla con uno cada vez; los demás esperan turno o se unen a la conversación.
• Si solo hablan, se ven las conversaciones (desde el 04-11, src/engine/narrator.ts). En cada turno de charla el motor decide cuánto habla el narrador: en silencio si es charla sin más (solo las burbujas de los personajes), una acotación de 15 palabras como mucho si algo pequeño cambia (un regalo, un insulto, una compra, una misión que se da, una despedida) y narración normal cuando pasa algo más que hablar (el jugador hace algo, una tirada, un combate, un alto que llega, la charla empieza). El gesto de quien habla («baja la voz», «vuelve a gritar») va en cursiva dentro de su propia burbuja, encima de lo que dice. El servidor lo hace cumplir sin pedir otra llamada: recorta la narración y quita las frases que el narrador ya ha dicho en los últimos turnos («Ilse sigue sin decir nada», «la plaza espera»). Si hablan dos NPC, cada uno va en su burbuja, también cuando se hablan entre ellos.

NPC que conversan

Como en Baldur's Gate 3, una charla con un NPC tiene que sonar a persona, no a cartel.

• Flujo de charla en cinco capas (desde el 06-11, src/engine/talk.ts; antes, una situación por prioridad desde el 27-10). Antes de llamar a la IA, el motor se hace cinco preguntas, siempre en el mismo orden, y con las respuestas monta un guion de cinco huecos en el orden en que habla una persona:

  1. Lo urgente (hueco A): una alarma del sitio (fuego, derrumbe), que le ataquen, que sepa que el PJ ha matado, que le hayan robado y lo haya notado, un regalo o una deuda vencida. El peligro corta el turno: solo reacciona a eso.
  2. Qué sabe del PJ (hueco B): charla en curso, reencuentro, ya se conocen (también por su situación o por la escena de apertura), de oídas (la deuda, un crimen) o nada. Sabe el nombre del PJ si su situación lo dice o si se le presentó. Nunca pregunta «¿quién eres?» a quien ya conoce.
  3. Cómo le trata: el trato y la escalada (insulto, insistencia, amenaza, violencia). Receloso es un tono, no una negativa: contesta igual. Una disculpa, un regalo o una salida creativa bajan un escalón.
  4. Misiones (hueco D): entrega lo pedido, da una si se la piden o dicen que sí, pregunta cómo va la suya; si la charla está madura, la deja caer y espera a que el jugador muestre interés.
  5. Qué le ha dicho (hueco C): abrir la charla, saludo, quién es quién, contestar a lo que él preguntó, preguntas públicas o delicadas, comercio, trabajo, favores, halagos, disculpas, insultos, amenazas o despedida.

  El hueco E es el cierre (una pregunta suya, un tema suyo o cortar). El cierre comprueba cada hueco sin IA y pide reescribir una vez: que conteste, que no pregunte quién es a quien conoce, que no use un nombre que no sabe, que no conteste a lo que el actor no ha dicho, que no ponga en su boca lo que no escribió, que no suelte una misión sin que la pidan y la longitud. La estructura es la misma con cualquier modelo; en offline hay plantillas. Los vecinos de relleno recorren el mismo flujo con las capas recortadas. Detalle en docs/CONVERSACION-FLUJO.md.

• Las misiones salen de la charla (desde el 04-11). Un NPC solo pide una misión o un encargo en una charla con el PJ que haya llegado a eso: el jugador le habla a él en ese turno y pregunta por trabajo o por lo que le pasa, o llevan un rato hablando. Estar cerca no basta: ni en la escena de apertura, ni en un turno en que el jugador pelea, se mueve o se acerca a otro, ni de dos en dos. El servidor rechaza cualquier otra (too_soon). Los encargos del tablón entran en el Diario al leerlo («leo los avisos», /tablon), no al pasar o pararse delante.

• Director y actor (apagado). Una segunda llamada (el actor, Sonnet) reescribía las palabras del NPC. No era lo que se buscaba: solo cambiaba el modelo, sin reglas de cuándo responder qué. Queda en el código, apagado en producción (ACTOR_MODEL=off).

• Lo que ve el actor: la ficha del NPC, lo que le ronda hoy (su agenda, lo que ha puesto en el tablón, lo que pasa en el pueblo, los encargos del PJ que son suyos o de su gente), el trato con el PJ, lo que recuerda de él y las últimas 10 réplicas literales entre los dos. El secreto, no.

• Lo que se revisa: las líneas del actor pasan el mismo control que el cierre: no repetir frases, no cerrar tratos ni prometer ir a ningún sitio sin que lo haya decidido el máster, no soltar el secreto ni nombres que el jugador no sabe. Si fallan dos veces, se queda lo del máster.

• Reglas de charla: contesta, reacciona a cómo se lo dicen, aporta algo suyo, a veces pregunta y nunca recita el tablón. De 1 a 4 frases por réplica, como en el móvil. Un personaje callado dice poco, pero con intención.

• Trato:

Trato	Cómo habla
Hostil	Corto, frío o amenazante. No da nada gratis.
Receloso	Lo mínimo; pregunta qué quiere y por qué.
Extraño	Pregunta quién es; habla de su trabajo y de lo que sabe todo el mundo; lo delicado lo esquiva.
Conocido	Saluda, recuerda la última charla, chismorrea; con lo delicado duda o pide algo a cambio.
Amigo	Lleva la iniciativa: pregunta cómo va lo tuyo, se preocupa y te dice a quién acudir.
Aliado	De tu parte: te lo cuenta todo lo que puede y te avisa.

• Qué mueve el trato. Sube: cumplir sus encargos, darle lo que necesita, ayudar a los suyos, adularle con gracia (a algunos les sienta mal), persuadirle y volver a charlar con él. Baja: intimidarle, atacarle a él o a los suyos, insultarle, hostigarle, mentirle y que te pille, o un crimen que vea. Ver Confianza.
• Coste: un turno de charla con actor cuesta unas 2,3 veces uno sin él (unos 0,7 céntimos frente a 0,3 con Haiku de máster) y tarda unos 2 s más. ACTOR_MODEL=off lo apaga; en offline no hay actor.

Comprobación del cierre

Antes de enseñar la narración, el motor la revisa. Rechaza (y pide repetir) si:

• narra como hecho una tool que falló;
• se inventa un punto que no existe;
• cierra un trato sin registrarlo;
• el desenlace contradice la tirada;
• hace actuar, hablar o querer algo a otro jugador;
• narra la muerte o la vuelta de un personaje.

Modos de ejecución

Modo	Qué hace	Coste
live	Llama a la API en cada acción	El real
offline	No llama nunca. Responde con un cierre sencillo sacado del contexto («Haces X. Nada cambia.») y 2-3 sugerencias	0
record	Llama a la API y guarda cada respuesta	Solo la grabación
replay	Solo lee lo grabado; si falta algo, responde en offline	0

Una grabación con semilla de dados fija se puede convertir en demo: se repite igual sin gastar tokens.

Coste por acción

Situación	Coste por acción
Opus 5, contexto sin recortar (medido en la demo)	4,1 céntimos
Haiku 5.5, primera acción con escritura de caché (medido)	0,26 céntimos
Haiku 5.5 en régimen (estimado)	0,12 céntimos
Sonnet 5.5 (estimado)	1,2 a 1,6 céntimos
Opus 5.5 (estimado)	2,5 a 3 céntimos

• Recortar el contexto bajó un 34 % de media (42 % en la taberna).
• La salida (razonamiento más cierre) es la mitad del coste.
• Desde el 21 de octubre el modelo por defecto es Haiku, para probar sin gastar. El modelo de la partida real está por decidir con el banco de medición.
• Con máster real, cada personaje tiene un cupo diario (200 acciones por defecto). Al agotarlo sigue en offline hasta medianoche. Ver Multijugador.

Cómo se mide la calidad

• Banco de medición: un recorrido fijo de 10 acciones por modelo, con coste y narraciones lado a lado.
• Partidas automáticas y juez: un jugador automático juega partidas con mundo generado (el 40 % de las veces intenta «liarla»: regatear, mentir, preguntar por lo que no existe). Después, detectores gratuitos y un juez modelo clasifican los errores.
• El piloto de 10 partidas × 20 acciones con Haiku costó 0,38 $ (unos 0,19 céntimos por acción) y clasificó 59 errores.
• Banco de creatividad: ver Creatividad del máster.

Relacionado

• Creatividad del máster · El narrador · Mecánicas · Diseño de juego