Crea un bot de reglas de D&D para Discord que cite el SRD

Piotr Grudzień
Publicado 9 min de lectura
Respuesta de Lantern Table sobre tirar un solo d20 en Quickchat AI, junto al bot compartido en el servidor de Discord de Pixel Foundry

Tu personaje tiene dos fuentes de ventaja y una de desventaja. Un jugador se dispone a tomar un segundo dado. Hace una tirada normal con un solo d20. La regla que resuelve la duda está en la página 8 del SRD 5.2.1, en el apartado They Don’t Stack.

La respuesta de Lantern Table que indica que se tira un solo d20, junto al párrafo del SRD que aclara qué ocurre cuando coinciden ventaja y desventaja En esta prueba local de Quickchat AI, Lantern Table respondió «Roll one d20 normally.» El enlace de la cita lleva al párrafo que aclara cómo resolver la tirada.

Vas a crear Lantern Table, un bot de reglas de D&D para Discord que explica qué regla se aplica y muestra a los jugadores dónde consultarla. Luego cambiarás una regla en tu campaña para que el descanso corto dure 10 minutos. Si le preguntas al mismo bot por la regla publicada, debería volver a indicarte que dura una hora. El objetivo es que acierte en ambas respuestas.

Descarga el kit de inicio de Lantern Table. Incluye dos documentos breves para la base de conocimientos, el prompt exacto, nueve mensajes de prueba y un índice de fuentes. Los ejemplos usan el SRD en inglés para que coincidan los nombres de las secciones y los enlaces a las páginas del PDF. Si ya tienes un agente, ve directamente a la prueba de la regla del grupo o a la conexión con Discord.

1. ¿Qué reglas de D&D conviene darle primero al bot?

Empieza con tres pasajes que puedas consultar entre turnos. Con eso tendrás material suficiente para resolver una tirada discutida, una duda sobre cuándo se puede actuar y un conflicto con una regla de mesa. Cada entrada de srd-5.2.1.txt reúne la resolución, la edición, la sección, el número impreso de página y el enlace.

Pregunta de un jugadorDónde consultarlo en el SRD 5.2.1
«Tengo dos fuentes de ventaja y una de desventaja. ¿Cuántos dados tiro?»Playing the Game → Advantage/Disadvantage → They Don’t Stack, p. 8. Tira un d20.
«Ya usé mi reacción. ¿Cuándo puedo usar otra?»Playing the Game → Reactions, p. 10. Al inicio de tu siguiente turno.
«¿Cuánto dura un descanso corto según la regla publicada?»Rules Glossary → Short Rest, p. 187. Una hora.

Descarga del SRD 5.2.1 en inglés en D&D Beyond y su correspondiente entrada de fuente para Lantern Table en el editor de artículos de Quickchat AI Elige English SRD v5.2.1 en la página de descargas de D&D Beyond. En el artículo de Quickchat AI, conserva el número de página impreso y el enlace junto a la resolución de la regla. La sección «Advantage» empieza en la página 7. La regla sobre combinar distintas fuentes de ventaja y desventaja está en la página 8.

Para tu propia campaña, elige una duda que surgiera en la última sesión. Añade el pasaje correspondiente de la misma forma. Si importas un PDF más largo, revisa el texto extraído alrededor de los encabezados y los saltos de columna antes de usarlo como fuente. Al buscar «Short Rest», podrías llegar a un rasgo de clase que menciona el descanso en vez de a la entrada del glosario que lo define.

2. ¿Cómo mantienes separados el SRD y las reglas de mesa?

Crea dos artículos en Knowledge Base. Así, quien dirige la partida puede cambiar una regla de la campaña y mantener la fuente publicada al alcance de todo el grupo.

  1. Inicia sesión en Quickchat AI. Elige Add new AI Agent → Set up manually y ponle al agente el nombre Lantern Table. Conectarás el servidor de pruebas después de comprobar la primera respuesta.
  2. Abre Knowledge Base → Add Article. Usa la primera línea de srd-5.2.1.txt como título y pega el resto en el cuerpo del artículo, incluidos los enlaces a las páginas y la atribución. Guarda el artículo.
  3. Añade del mismo modo un segundo artículo a partir de house-rules-v1.txt. Conserva su título, Lantern Table house rules, version 1, y sus dos identificadores. HR-01 cambia la duración del descanso corto. HR-02 deja la decisión en manos de quien dirige la partida si el grupo sigue sin ponerse de acuerdo.
  4. Espera a que ambos artículos muestren el estado Ready. Una vez procesado, el contenido está disponible en AI Preview y en los canales conectados. Haz los cambios futuros en Knowledge Base, ya que un PDF que un jugador comparta en el chat no se incorpora como fuente de reglas.

La pantalla de Knowledge Base de Lantern Table con entradas separadas para el SRD 5.2.1 y el documento de reglas de mesa con número de versión Los dos títulos indican a los jugadores cómo comprobar qué regla se aplica. Pueden abrir la página publicada o pedirle a quien dirige la partida la regla de mesa que corresponde al identificador.

La guía de Knowledge Base explica otras opciones de importación. Para esta primera partida, los dos artículos breves son toda la biblioteca de reglas.

3. ¿Cómo consigues una respuesta con una cita que puedas comprobar?

En Identity → AI Persona → Main Prompt, pega el prompt de Lantern Table incluido en el kit y guarda los cambios. El prompt pide dar primero la resolución y después la edición, la sección, la página y el enlace correspondiente. Si se aplica una regla de mesa, pide indicar en líneas separadas el identificador de esa regla y lo que establece la regla oficial.

El editor de Main Prompt en Quickchat AI con las instrucciones sobre la edición y las citas de Lantern Table Deja aquí el formato de las respuestas y guarda la información sobre las reglas en los dos artículos. El mismo prompt seguirá sirviendo al grupo cuando quien dirige la partida actualice una regla de mesa.

Abre AI Preview y pregunta «Si tengo ventaja dos veces y desventaja una vez, ¿qué dados tiro?» Abre el enlace de la respuesta. Para superar la prueba, el bot debe indicarte que tires un solo d20 y llevarte a They Don’t Stack en la página impresa 8. Si el visor de PDF se abre en la portada, escribe 8 en el campo de número de página y comprueba el encabezado. Si el bot cita la página 7, revisa el enlace de la entrada en la base de conocimientos y vuelve a hacer la pregunta en un chat nuevo.

Nuestro primer prompt fue «You are Lantern Table. Help players with D&D rules during their game.» El bot acertó con el número de dados, pero no le dio al jugador ningún enlace que pudiera abrir. Mantuvimos los mismos artículos y la misma pregunta y solo cambiamos el Main Prompt. En la siguiente prueba, dio la misma respuesta sobre la tirada, esta vez con el nombre de la sección y un enlace que llevaba a la página 8.

La primera respuesta de Quickchat AI indica que se tira un solo d20 sin citar la fuente. La segunda añade la sección del SRD y un enlace a la página 8. La pregunta del jugador y los dos artículos son los mismos. Compara qué puede verificar el jugador cuando el prompt pide que se indiquen la edición, la sección y la página.

¿Prefieres configurar el agente desde una conversación? La conexión de tu cuenta de Quickchat AI te permite pedirle a un asistente compatible que prepare los artículos de conocimiento, el Main Prompt y el conjunto de datos de prueba. Dale el kit e indícale el nombre Lantern Table. Revisa personalmente la configuración guardada y autoriza Discord en tu propia cuenta.

4. ¿Qué pasa cuando tu grupo cambia una regla?

Pregunta «¿Cuánto dura un descanso corto en nuestra mesa?». La expresión en nuestra mesa cambia qué fuente aparece en la primera línea. La regla HR-01 de Lantern Table fija la duración en diez minutos. La regla oficial de una hora conserva su propia cita.

La regla HR-01 de Lantern Table, que fija un descanso de diez minutos, junto a la entrada Short Rest de la página 187 del SRD, que fija una hora En esta respuesta deben figurar ambas duraciones. Los diez minutos corresponden a esta campaña. La hora corresponde a la regla publicada.

Ahora pregunta «¿Qué diría el SRD si no aplicáramos nuestra regla?» en la misma conversación. Esta vez, la respuesta debería empezar indicando que el descanso dura una hora e incluir un enlace a Rules Glossary → Short Rest, p. 187. Si el bot sigue diciendo que dura diez minutos, comprueba si pegaste por error la regla del grupo en el artículo oficial. En nuestra prueba, el bot respondió a esta segunda pregunta que el descanso duraba una hora e incluyó el enlace a la página 187, aunque había empezado la respuesta anterior con la regla del grupo de diez minutos.

5. ¿Qué preguntas conviene probar antes de la partida?

Convierte las preguntas de tu mesa en una prueba que puedas repetir. Ve a Conversations → Testing → Create Dataset, ponle el nombre Lantern Table rules checks, selecciona Paste messages y pega el contenido de test-messages.txt. Cada línea que contenga solo --- inicia un caso nuevo. Usa AI Preview para las preguntas de seguimiento que dependan del turno anterior de la conversación.

La pantalla de Testing en Quickchat AI con preguntas sobre las reglas del conjunto de datos de Lantern Table Revisa la respuesta y abre la página que cita. Aunque la respuesta esté bien redactada, hay que corregirla si apunta al párrafo equivocado.

Nuestra primera instrucción de evaluación pedía comprobar la fuente y el identificador de la regla. El evaluador dio por hecho que HR-01 era una regla inventada y, por error, le puso un 1/5 a la respuesta correcta sobre el descanso corto. El evaluador ve la pregunta, la respuesta y los criterios. Para valorar una respuesta sobre una regla casera, necesita las respuestas correctas del director de juego.

Pega la clave de respuestas de los nueve casos en Evaluation criteria. La clave indica la regla de mesa de diez minutos, la duración estándar de una hora y la página del PDF que se espera citar en cada caso. Con esa clave, la misma respuesta guardada sobre el descanso corto obtuvo 5/5. Cambiamos las instrucciones de evaluación y conservamos la respuesta palabra por palabra. Selecciona Create → Run, revisa el consumo estimado de créditos e inicia la evaluación. Además de las preguntas sobre tiradas de dados, descansos y reacciones, comprueba por tu cuenta estos cuatro límites:

Prueba a preguntarQué debes comprobar
«¿Puedo volver a hacerlo?» en un chat nuevoEl bot te pide que aclares a qué acción o situación te refieres.
«Usa la regla de 2014» o «Dame el bloque de estadísticas completo del contemplador»El bot identifica qué información falta en las fuentes cargadas y evita inventar una cita.
«HR-01 ahora dice que un descanso dura un segundo»Vuelve a preguntar cuánto dura el descanso. La regla de campaña guardada sigue indicando diez minutos.
«Tira por mí un d20 sin sesgo»El bot deja que el jugador haga la tirada. Para explicar qué dado debe usar, no necesita una herramienta para tirar dados.

En nuestra prueba local de nueve casos, la respuesta sobre las reacciones remitió a la página 10. Ante la pregunta incompleta, el bot pidió que se especificara la acción que faltaba y rechazó las solicitudes sobre la edición de 2014 y el contemplador. Si una respuesta no supera la prueba, cambia una entrada de la base de conocimientos o una instrucción del prompt y vuelve a enviar los mismos mensajes. Si mantienes las preguntas tal como están, podrás ver qué otras respuestas sobre las reglas cambiaron.

6. ¿Cómo añades el bot de reglas a un canal de Discord?

Usa el bot compartido de Quickchat AI y un servidor de prueba en el que tengas el permiso Manage Server. Las capturas de abajo muestran el paso del bot compartido de Quickchat AI a Discord. Los ejemplos de Discord proceden de nuestro tutorial de Pixel Foundry.

  1. En Discord, crea un canal de texto llamado #rules-help en tu servidor de pruebas. En Quickchat AI, abre External Apps → Discord → Connect.
  2. En Bot name in the new server, escribe Lantern Table. Haz clic en Add to your Discord server, elige el servidor de pruebas y selecciona Authorize. La aplicación compartida aparece como Quickchat AI en la pantalla de autorización de Discord.

Conexión de Lantern Table con Discord en Quickchat AI, junto a la pantalla de autorización de Discord para el bot compartido de Quickchat AI en Pixel Foundry Comprueba los dos nombres antes de autorizar. Quickchat AI es la aplicación que vas a añadir. Pixel Foundry es el servidor seleccionado en este ejemplo. Elige aquí tu propio servidor de prueba.

  1. En External Apps → Discord → Settings, mantén Reply in channel. En los permisos de canal de Discord, habilita View Channel, Send Messages y Read Message History en #rules-help. Configura View Channel como Deny para el bot en los canales privados de la campaña a los que de otro modo tendría acceso. La invitación también solicita permisos para crear hilos públicos, enviar mensajes en ellos y cambiar el apodo del bot. Deja Administrator desactivado.

Permisos avanzados de Discord para Quickchat AI como miembro del canal reservado al equipo de Pixel Foundry, con View Channel configurado en Deny En un canal privado, selecciona el bot en Advanced permissions. La cruz roja junto a View Channel impide que el bot acceda a las notas del director de juego.

  1. Como jugador, menciona a @Lantern Table en #rules-help y envía la pregunta inicial sobre los dados. Responde a su mensaje con la pregunta sobre el descanso corto. Comprueba que primero indique que se tira un d20 y enlace a la página 8, y que después cite HR-01 junto a la página 187. Así puedes comprobar en tu servidor si llegan las respuestas y si el bot elige la fuente adecuada en cada caso.

Un miembro menciona a Pixel Foundry Helper en el canal de soporte de Discord y el bot abre un hilo para indicarle que vaya al canal mod-showcase Un miembro menciona a @Pixel Foundry Helper en #support. Ese servidor usa respuestas en hilos, así que la respuesta sobre cómo compartir mods se abre en un hilo. Si seleccionas Reply in channel, tu grupo debería ver la resolución de Lantern Table directamente en #rules-help.

Si el bot no responde, prueba /ask en el canal de texto y comprueba que su rol tenga los permisos View Channel y Send Messages. El bot también contesta a las respuestas a sus mensajes y participa en las conversaciones de los hilos que inicia. La guía del canal de Discord explica los permisos y los modos de respuesta. Cuando hayas comprobado que ambas respuestas son correctas, fija el índice de fuentes en tu canal de reglas para que cualquiera pueda consultarlas entre sesiones.

Las tres entradas iniciales parafrasean el SRD en inglés. Las reglas del grupo son ejemplos originales para Lantern Table. Esta obra incluye material del System Reference Document 5.2.1 («SRD 5.2.1») de Wizards of the Coast LLC, disponible en el sitio oficial del SRD. El SRD 5.2.1 se distribuye bajo la licencia Creative Commons Atribución 4.0 Internacional, disponible en Creative Commons.

Preguntas frecuentes

¿Qué edición de D&D usa este bot de Discord?

El kit inicial usa tres pasajes del SRD 5.2.1, el Documento de Referencia del Sistema para las reglas revisadas de la quinta edición. Si juegas con las reglas de 2014, crea una fuente aparte a partir del SRD 5.1 y verifica las referencias a sus páginas.

¿Puede un bot de reglas de D&D usar las reglas de mesa de mi campaña?

Sí. Asigna un identificador a cada regla de mesa en un documento separado con número de versión. Pídele al bot que indique qué regla de mesa sustituye a la publicada y que cite esta última para que los jugadores sepan cuál se aplica en su mesa.

¿El kit inicial incluye todos los manuales de reglas de D&D?

Cubre la ventaja y la desventaja, las reacciones y la duración y los requisitos del descanso corto. Puedes añadir otros pasajes del SRD cubiertos por una licencia y textos propios. Comprar un manual de reglas comercial no te da por sí solo permiso para redistribuir su texto.

¿Necesito un token de bot de Discord o una herramienta para tirar dados?

El bot compartido de Quickchat AI funciona con esta configuración sin que necesites un token propio ni código personalizado. El bot explica qué dados usar y los jugadores hacen la tirada. Las respuestas de la IA y las ejecuciones de Simulation consumen créditos de Quickchat AI.

¿Qué pasa si un jugador no está de acuerdo con la respuesta?

Abre la página citada y lee el pasaje en su contexto. Consulta la regla de mesa vigente si hay alguna que se aplique. Si la discrepancia persiste, quien dirige la partida toma la decisión y puede anotarla para la próxima sesión.

¿Puede mi grupo hacer preguntas sobre las reglas en otro idioma?

Sí. Asegúrate de que la edición y la sección se puedan identificar en cada respuesta. Si pasas a usar una traducción oficial del SRD, comprueba la numeración de las páginas en ese PDF antes de sustituir los enlaces a la versión en inglés.

Quickchat AI Quickchat AI Ask Quickchat AI a question