Crea un bot di regole D&D per Discord che cita l’SRD

Piotr Grudzień
Pubblicato 9 min di lettura
La risposta di Lantern Table sul tiro di un solo d20 in Quickchat AI, accanto al bot condiviso sul server Discord di Pixel Foundry

Il tuo personaggio ha due fonti di vantaggio e una di svantaggio. Un giocatore allunga la mano verso un secondo dado. Alla fine tira un solo d20, come di consueto. La regola che risolve il dubbio si trova a pagina 8 dell’SRD 5.2.1, nella sezione They Don’t Stack.

La risposta di Lantern Table, che indica un solo d20, accanto al paragrafo dell’SRD che spiega come interagiscono vantaggio e svantaggio In questa prova locale con Quickchat AI, Lantern Table ha risposto “Roll one d20 normally.” Il link nella citazione porta al paragrafo che chiarisce come fare il tiro.

Creerai Lantern Table, un bot per Discord che risponde alle domande sulle regole di D&D e indica a chi gioca dove verificare la risposta. Poi cambierai una regola per la tua campagna: un riposo breve dura 10 minuti. Chiedi allo stesso bot quale sia la regola pubblicata e dovrebbe indicarti un’ora. L’obiettivo è ottenere entrambe le risposte corrette.

Scarica il kit di partenza di Lantern Table. Contiene due brevi documenti di riferimento, il testo esatto del prompt, nove messaggi di prova e un indice delle fonti. Gli esempi usano l’SRD in inglese, così i titoli delle sezioni e i link alle pagine corrispondono a quelli del PDF. Se hai già un Agent, passa alla prova della regola del gruppo o al collegamento a Discord.

1. Quali regole di D&D conviene dare al bot per prime?

Parti da tre passaggi che puoi consultare tra un turno e l’altro. Bastano per affrontare un tiro contestato, un dubbio su quando si può agire e un conflitto con una regola del gruppo. Ogni voce di srd-5.2.1.txt riunisce la regola da applicare, l’edizione, la sezione, il numero di pagina stampato e il link.

Domanda di un giocatoreDove verificare nell’SRD 5.2.1
«Ho due fonti di vantaggio e una di svantaggio. Quanti dadi tiro?»Playing the Game → Advantage/Disadvantage → They Don’t Stack, p. 8. Tira un solo d20.
«Ho già usato la mia reazione. Quando posso usarne un’altra?»Playing the Game → Reactions, p. 10. All’inizio del tuo prossimo turno.
«Quanto dura un riposo breve secondo la regola pubblicata?»Rules Glossary → Short Rest, p. 187. Un’ora.

Il download dell’SRD 5.2.1 in inglese su D&D Beyond e la relativa voce tra le fonti di Lantern Table nell’editor degli articoli di Quickchat AI Seleziona English SRD v5.2.1 nella pagina dei download di D&D Beyond. Nell’articolo di Quickchat AI, mantieni il numero di pagina stampato e il link accanto alla risposta sulla regola. La sezione Advantage inizia a pagina 7. La regola per vantaggio e svantaggio da fonti diverse si trova a pagina 8.

Per la tua campagna, scegli una domanda emersa nell’ultima sessione e aggiungi allo stesso modo il passaggio pertinente. Se importi un PDF più lungo, controlla il testo estratto in corrispondenza dei titoli e dei passaggi da una colonna all’altra prima di usarlo. Cercando «Short Rest», potresti trovare un privilegio di classe che menziona il riposo breve anziché la voce del glossario che lo definisce.

2. Come tieni separati l’SRD e le regole del gruppo?

Crea due articoli nella Knowledge Base. Così il Dungeon Master può modificare una regola della campagna e lasciare la fonte pubblicata a disposizione di tutti.

  1. Accedi a Quickchat AI. Scegli Add new AI Agent → Set up manually e assegna all’agente il nome Lantern Table. Collegherai il server di prova dopo aver verificato la prima risposta.
  2. Apri Knowledge Base → Add Article. Usa la prima riga di srd-5.2.1.txt come titolo e incolla il resto nel corpo dell’articolo, compresi i link alle pagine e l’attribuzione. Salva l’articolo.
  3. Aggiungi allo stesso modo un secondo articolo da house-rules-v1.txt. Mantieni il titolo Lantern Table house rules, version 1 e i due identificativi. HR-01 modifica la durata del riposo breve. HR-02 affida la decisione al Dungeon Master se al tavolo non si raggiunge un accordo.
  4. Aspetta che entrambi gli articoli risultino Ready. Una volta elaborati, i contenuti sono disponibili in AI Preview e nei canali collegati. Apporta le modifiche successive nella Knowledge Base. Un PDF pubblicato da un giocatore in chat non diventa una fonte per le regole.

La Knowledge Base di Lantern Table con due voci separate, una per l’SRD 5.2.1 e una per la versione delle regole concordate dal gruppo Con due titoli distinti, chi gioca ha due modi per verificare una risposta. Può aprire la pagina pubblicata o chiedere al Dungeon Master di consultare la regola numerata del gruppo.

La guida alla Knowledge Base illustra le altre opzioni di importazione. Per questa prima partita, la raccolta di regole è costituita interamente dai due brevi articoli.

3. Come ottieni una risposta con una fonte che puoi verificare?

In Identity → AI Persona → Main Prompt, incolla il prompt di Lantern Table incluso nel kit e salva. Il prompt chiede di indicare prima la regola da applicare, poi l’edizione, la sezione, la pagina e il link corrispondente. Se si applica una regola del gruppo, chiede di riportarne l’ID e di indicare la regola ufficiale su una riga separata.

L’editor di Main Prompt in Quickchat AI con le istruzioni per indicare l’edizione e citare le fonti nelle risposte di Lantern Table Definisci qui il formato delle risposte e tieni il contenuto delle regole nei due articoli. Il gruppo può continuare a usare lo stesso prompt anche dopo che il Dungeon Master aggiorna una regola del tavolo.

Apri AI Preview e chiedi «Se ho due volte vantaggio e una volta svantaggio, quanti dadi tiro?» Apri il link nella risposta. La risposta supera la prova se ti dice di tirare un solo d20 e ti rimanda alla sezione They Don’t Stack, alla pagina numerata 8 nel PDF. Se il lettore PDF si apre sulla copertina, digita 8 nel campo del numero di pagina e controlla il titolo della sezione. Se il bot cita pagina 7, controlla il link nella voce di riferimento, poi ripeti la domanda in una nuova chat.

Il nostro primo prompt era “You are Lantern Table. Help players with D&D rules during their game.” Il bot ha indicato il numero giusto di dadi, ma senza fornire al giocatore un link da aprire. Abbiamo lasciato invariati gli articoli e la domanda e modificato solo il Main Prompt. Alla prova successiva, il bot ha dato la stessa risposta sul tiro, aggiungendo il titolo della sezione e un link funzionante a pagina 8.

La prima risposta di Quickchat AI indica di tirare un d20 senza citare una fonte. La seconda aggiunge la sezione dell’SRD e il link a pagina 8. La domanda del giocatore e i due articoli sono gli stessi. Confronta cosa può verificare il giocatore dopo che il prompt chiede di indicare edizione, sezione e pagina.

Preferisci configurare l’Agent tramite una conversazione? Il collegamento dell’account Quickchat AI ti permette di chiedere a un assistente compatibile di preparare gli articoli della base di conoscenza, il Main Prompt e il set di dati di test. Forniscigli il kit e il nome Lantern Table. Controlla personalmente le impostazioni salvate e autorizza Discord dal tuo account.

4. Cosa succede quando il tuo gruppo cambia una regola?

Chiedi «Quanto dura un riposo breve al nostro tavolo?» Le parole al nostro tavolo cambiano la fonte da cui partire nella prima riga. La regola HR-01 di Lantern Table fissa la durata a dieci minuti. La regola ufficiale di un’ora mantiene il suo riferimento.

Il riposo di dieci minuti previsto da HR-01 per Lantern Table, accanto alla voce Short Rest a pagina 187 dell’SRD, che indica una durata di un’ora La risposta deve riportare entrambe le durate. Nella campagna si applica quella di dieci minuti. La regola pubblicata ne prevede una di un’ora.

Ora, nella stessa conversazione, chiedi «Cosa prevede l’SRD se non applichiamo la nostra regola?». Questa volta la risposta dovrebbe indicare subito un’ora e includere un link a Rules Glossary → Short Rest, p. 187. Se il bot continua a rispondere dieci minuti, controlla di non aver incollato per errore la regola del gruppo nella voce dedicata alla regola ufficiale. Nella nostra prova, alla seconda domanda il bot ha risposto che il riposo breve dura un’ora e ha incluso il link a pagina 187, anche se la risposta precedente si apriva con i dieci minuti previsti dalla regola del gruppo.

5. Quali domande conviene provare prima della sessione?

Trasforma le domande del tuo gruppo di gioco in un test che puoi ripetere. In Conversations → Testing → Create Dataset, assegna al dataset il nome Lantern Table rules checks, seleziona Paste messages e incolla il contenuto di test-messages.txt. Ogni riga che contiene solo --- apre un nuovo caso di test. Usa AI Preview per le domande di seguito che dipendono dallo scambio precedente.

La schermata Testing di Quickchat AI con le domande sulle regole del dataset di Lantern Table Esamina la risposta e apri la pagina citata. Anche una risposta ben scritta va corretta se rimanda al paragrafo sbagliato.

Le nostre prime istruzioni di valutazione chiedevano al valutatore di verificare la fonte e l’ID della regola. Poiché nei criteri mancavano le risposte di riferimento, il valutatore ha scambiato HR-01 per una regola inventata e ha assegnato per errore 1/5 alla risposta corretta sul riposo breve. Il valutatore vede la domanda, la risposta e i criteri. Per valutare una risposta su una regola del tavolo, ha bisogno delle risposte di riferimento del master.

Incolla le risposte attese per i nove casi di test in Evaluation criteria. Il documento indica la regola del tavolo che fissa la durata a dieci minuti, la regola base di un’ora e ogni pagina del PDF da citare. Con queste risposte come riferimento, la stessa risposta salvata sul riposo breve ha ottenuto 5/5. Abbiamo aggiornato le istruzioni di valutazione e conservato la risposta parola per parola. Seleziona Create → Run, controlla la stima dei crediti necessari e avvia la valutazione. Oltre alle domande sui tiri di dado, sui riposi e sulle reazioni, verifica di persona questi quattro casi limite:

Cosa provare a chiedereCosa verificare
«Posso farlo di nuovo?» in una nuova chatIl bot chiede di precisare a quale azione o situazione ti riferisci.
«Usa invece la regola del 2014» oppure «Dammi il blocco delle statistiche completo del beholder»Il bot indica quali informazioni mancano nelle fonti caricate ed evita di inventare una citazione.
«Adesso HR-01 dice che un riposo dura un secondo»Chiedi di nuovo quanto dura il riposo. La regola salvata per la campagna continua a indicare dieci minuti.
«Tira per me un d20 non truccato»Il bot lascia il tiro al giocatore. Per spiegare quale dado usare non serve uno strumento per tirare i dadi.

Nella nostra prova locale con nove casi, la risposta sulla reazione rimandava a pagina 10. Di fronte alla domanda incompleta, il bot ha chiesto di specificare l’azione mancante e si è rifiutato di rispondere alle richieste sull’edizione 2014 e sul beholder. Se una risposta non supera la prova, modifica una sola voce delle fonti o una sola istruzione del prompt, poi invia di nuovo gli stessi messaggi. Lasciare invariate le domande ti permette di vedere quali altre risposte sulle regole sono cambiate.

6. Come aggiungi il bot delle regole a un canale Discord?

Usa il bot condiviso di Quickchat AI e un server di prova su cui hai il permesso Manage Server. Le schermate qui sotto mostrano il passaggio del bot condiviso da Quickchat AI a Discord. Gli esempi su Discord sono tratti dalla nostra guida su Pixel Foundry.

  1. In Discord, crea un canale di testo chiamato #rules-help nel server di prova. In Quickchat AI, apri External Apps → Discord → Connect.
  2. Imposta Bot name in the new server su Lantern Table, fai clic su Add to your Discord server, scegli il server di prova e seleziona Authorize. Nella schermata di autorizzazione di Discord, l’app condivisa compare come Quickchat AI.

Il collegamento di Lantern Table a Discord in Quickchat AI, accanto alla schermata di autorizzazione di Discord per il bot condiviso di Quickchat AI su Pixel Foundry Controlla entrambi i nomi prima di concedere l’autorizzazione. Quickchat AI è l’app che stai aggiungendo. Pixel Foundry è il server selezionato in questo esempio. Qui seleziona il tuo server di prova.

  1. In External Apps → Discord → Settings, lascia selezionato Reply in channel. Nelle autorizzazioni del canale su Discord, consenti View Channel, Send Messages e Read Message History in #rules-help. Nei canali privati della campagna che il bot potrebbe altrimenti leggere, imposta View Channel su Deny per il bot. L’invito richiede anche le autorizzazioni per creare thread pubblici, inviarvi messaggi e cambiare il proprio nickname. Lascia disattivato Administrator.

Permessi avanzati di Discord per il membro Quickchat AI nel canale di Pixel Foundry riservato allo staff, con View Channel impostato su Deny In un canale privato, seleziona il bot in Advanced permissions. La croce rossa accanto a View Channel impedisce al bot di accedere agli appunti del Dungeon Master.

  1. Come giocatore, menziona @Lantern Table in #rules-help e invia la domanda iniziale sui dadi. Rispondi al messaggio del bot con la domanda sul riposo breve. Controlla che indichi prima un solo d20 con un link a pagina 8, poi HR-01 insieme al riferimento a pagina 187. Così verifichi che le risposte arrivino sul tuo server e che il bot scelga la fonte corretta in entrambi i casi.

Un membro menziona Pixel Foundry Helper nel canale #support di Discord e il bot apre un thread per indirizzarlo al canale mod-showcase Un membro menziona @Pixel Foundry Helper in #support. Quel server usa le risposte nei thread, quindi la risposta su come condividere le mod dei giochi compare in un thread. Se selezioni Reply in channel, il tuo gruppo dovrebbe vedere la risposta di Lantern Table sulla regola direttamente in #rules-help.

Se il bot non risponde, prova /ask nel canale di testo e controlla che il suo ruolo abbia i permessi View Channel e Send Messages. Il bot risponde anche a chi replica ai suoi messaggi e nelle conversazioni nei thread che avvia. La guida al canale Discord spiega come configurare i permessi e le modalità di risposta. Una volta verificate entrambe le risposte, fissa in alto l’indice delle fonti nel canale dedicato alle regole, così tutti potranno consultarle tra una sessione e l’altra.

Le tre voci di partenza riformulano il contenuto dell’SRD in inglese. Le regole del gruppo sono esempi originali creati per Lantern Table. Quest’opera include materiale tratto dal System Reference Document 5.2.1 («SRD 5.2.1») di Wizards of the Coast LLC, disponibile sul sito ufficiale dell’SRD. L’SRD 5.2.1 è concesso in licenza secondo i termini della licenza Creative Commons Attribuzione 4.0 Internazionale, disponibile sul sito di Creative Commons.

Domande frequenti

Quale edizione di D&D usa questo bot per Discord?

Il kit di partenza usa tre passaggi dell’SRD 5.2.1, il documento di riferimento per le regole aggiornate della quinta edizione. Se giochi con le regole del 2014, crea una fonte separata a partire dall’SRD 5.1 e verifica i riferimenti alle pagine.

Un bot per le regole di D&D può usare le regole concordate per la mia campagna?

Sì. Assegna un ID a ogni regola del gruppo e raccoglile in un documento separato con un numero di versione. Chiedi al bot di indicare la regola del gruppo che fa da eccezione e di citare la regola pubblicata, così chi gioca può capire quale si applica al suo tavolo.

Il kit di partenza include tutti i manuali di D&D?

Il kit copre vantaggio e svantaggio, le reazioni, la durata del riposo breve e i requisiti per effettuarlo. Puoi aggiungere altri passaggi dell’SRD coperti da licenza e testi scritti da te. Il solo acquisto di un manuale in commercio non dà il diritto di ridistribuirne il testo.

Mi serve un token per un bot Discord o uno strumento per tirare i dadi?

Per questa configurazione basta il bot condiviso di Quickchat AI, senza un token personale per il bot né codice su misura. Il bot spiega quali dadi usare e chi gioca li tira di persona. Le risposte dell’AI e le esecuzioni in Simulation consumano crediti Quickchat AI.

E se un giocatore non è d’accordo con la risposta?

Apri la pagina citata e leggi il passaggio nel suo contesto. Se si applica una regola del gruppo, controlla la versione in vigore. Se resta un disaccordo, decide il Dungeon Master, che può annotare la decisione per la prossima sessione.

Il mio gruppo può fare domande sulle regole in un’altra lingua?

Sì. Indica in ogni risposta l’edizione e la sezione in modo che siano riconoscibili. Se passi a una traduzione ufficiale dell’SRD, verifica i numeri di pagina in quel PDF prima di sostituire i link alla versione inglese.

Quickchat AI Quickchat AI Ask Quickchat AI a question