איך בונים בוט ל־Discord שעונה על חוקי D&D לפי ה־SRD

Piotr Grudzień
פורסם זמן קריאה: 7 דקות
התשובה של Lantern Table על גלגול d20 אחד ב־Quickchat AI, לצד הבוט המשותף בשרת Discord של Pixel Foundry

הדמות שלכם מקבלת יתרון משני מקורות וחיסרון ממקור אחד. אחד השחקנים מושיט יד לקובייה שנייה. הוא מגלגל כרגיל, עם קוביית d20 אחת בלבד. הכלל שמכריע מופיע בעמוד 8 של SRD 5.2.1, תחת הכותרת They Don’t Stack.

התשובה של Lantern Table, שקובעת שמגלגלים קוביית d20 אחת, לצד הפסקה ב־SRD שמכריעה כשיש יתרון וחיסרון יחד בבדיקה המקומית הזאת ב־Quickchat AI, הבוט Lantern Table השיב: “Roll one d20 normally.” ההפניה בתשובה מובילה לפסקה שמכריעה איך לגלגל.

תבנו את Lantern Table, בוט חוקי D&D ל־Discord שנותן תשובה לפי החוקים ומראה לשחקנים איפה לבדוק אותה. אחר כך תשנו חוק אחד בקמפיין שלכם ותקבעו שמנוחה קצרה נמשכת 10 דקות. כשתשאלו את אותו בוט מה קובע החוק הרשמי, התשובה אמורה להיות שעה אחת. סיימתם כשהבוט עונה נכון על שתי השאלות.

הורידו את ערכת ההתחלה של Lantern Table. הערכה כוללת שני מסמכי ידע קצרים, את הנוסח המדויק של הפרומפט, תשע הודעות לבדיקה ומפתח מקורות. הדוגמאות מבוססות על ה־SRD באנגלית כדי ששמות הסעיפים והקישורים לעמודי ה־PDF יתאימו למקור. אם כבר יש לכם סוכן, דלגו לבדיקת הכלל הקבוצתי או לחיבור ל־Discord.

1. אילו חוקי D&D כדאי לתת לבוט בהתחלה?

התחילו בשלושה קטעים שאפשר לבדוק בין תור לתור. הם יספיקו לשאלה על גלגול שנוי במחלוקת, לשאלה על תזמון ולמקרה שבו חוק בית סותר את החוק הרשמי. כל רשומה ב־srd-5.2.1.txt מרכזת את ההכרעה, המהדורה, הסעיף, מספר העמוד המודפס והקישור.

שאלה מהשולחןאיפה בודקים ב־SRD 5.2.1
״יש לי יתרון משני מקורות וחיסרון ממקור אחד. כמה קוביות לגלגל?״Playing the Game → Advantage/Disadvantage → They Don’t Stack, עמ׳ 8. מגלגלים קוביית d20 אחת.
״כבר השתמשתי בתגובה שלי. מתי אפשר להשתמש שוב בתגובה?״Playing the Game → Reactions, עמ׳ 10. בתחילת התור הבא שלך.
״כמה זמן נמשכת מנוחה קצרה לפי החוק הרשמי?״Rules Glossary → Short Rest, עמ׳ 187. שעה אחת.

הורדת SRD 5.2.1 באנגלית ב־D&D Beyond ורשומת המקור התואמת של Lantern Table בעורך המאמרים של Quickchat AI בחרו ב־English SRD v5.2.1 בדף ההורדות של D&D Beyond. במאמר ב־Quickchat AI, השאירו את מספר העמוד המודפס ואת הקישור לצד פסיקת הכללים. הסעיף Advantage מתחיל בעמוד 7. הכלל לשילוב מקורות מופיע בעמוד 8.

בקמפיין שלכם, בחרו שאלה שעלתה במפגש האחרון והוסיפו באותה דרך את הקטע שעונה עליה. אם אתם מייבאים קובץ PDF ארוך יותר, בדקו את הטקסט שחולץ סביב כותרות ומעברים בין עמודות לפני שתסתמכו עליו. חיפוש של ״מנוחה קצרה״ עשוי להוביל ליכולת מקצוע שרק מזכירה מנוחה, בשעה שההגדרה עצמה נמצאת במילון המונחים.

2. איך שומרים על הפרדה בין ה־SRD לחוקי הבית?

צרו שני מאמרים ב־Knowledge Base. כך אפשר לעדכן הכרעה בקמפיין לפי החלטת המנחה, ובמקביל להשאיר את המקור הרשמי זמין לכולם.

  1. היכנסו ל־Quickchat AI. בחרו Add new AI Agent → Set up manually ותנו לסוכן את השם Lantern Table. חברו את שרת הבדיקה אחרי שתבדקו את התשובה הראשונה.
  2. פתחו את Knowledge Base → Add Article. השתמשו בשורה הראשונה של srd-5.2.1.txt בתור הכותרת, והדביקו את שאר הטקסט בגוף המאמר, כולל הקישורים לעמודים והייחוס. שמרו את המאמר.
  3. הוסיפו באותה דרך מאמר שני מתוך house-rules-v1.txt. שמרו על הכותרת שלו, Lantern Table house rules, version 1, ועל שני המזהים. HR-01 משנה את משך המנוחה הקצרה. HR-02 משאיר את ההכרעה בידי המנחה כשעדיין יש מחלוקת בקבוצה.
  4. המתינו עד שיופיע הסטטוס Ready בשני המאמרים. לאחר העיבוד, המידע זמין ב־AI Preview ובערוצים המחוברים. בצעו עדכונים עתידיים ב־Knowledge Base. קובץ PDF שמישהו מעלה לצ׳אט במהלך המשחק אינו הופך למקור לחוקים.

ה־Knowledge Base של Lantern Table עם רשומות נפרדות ל־SRD 5.2.1 ולמסמך חוקי הבית שמציין את מספר הגרסה שתי הכותרות מצביעות על שתי דרכים לבדוק הכרעה. אפשר לפתוח את העמוד הרשמי או לבקש מהמנחה את חוק הבית לפי המזהה שלו.

המדריך ל־Knowledge Base מסביר על אפשרויות ייבוא נוספות. למשחק הראשון הזה, ספריית החוקים כוללת את שני המאמרים הקצרים בלבד.

3. איך מקבלים תשובה עם הפניה שאפשר לבדוק?

ב־Identity → AI Persona → Main Prompt, הדביקו את הפרומפט של Lantern Table מתוך הערכה ושמרו. הפרומפט מבקש לפתוח בהכרעה ואחריה לציין את המהדורה, הסעיף, העמוד והקישור המתאים. כשחל חוק בית, הוא מבקש לציין את המזהה שלו ואת החוק הרשמי בשורות נפרדות.

עורך Main Prompt ב־Quickchat AI, ובו ההנחיות לציון המהדורה ולהפניה למקורות עבור Lantern Table שמרו כאן את מבנה התשובה, ובשני המאמרים את תוכן החוקים. אותו פרומפט יוכל להמשיך לשמש את הקבוצה גם אחרי עדכון של חוק בית בידי המנחה.

פתחו את AI Preview ושאלו ״אם יש לי יתרון פעמיים וחיסרון פעם אחת, אילו קוביות אני מגלגל?״ פתחו את הקישור שבתשובה. כדי לעבור את הבדיקה, התשובה צריכה להורות על גלגול של קוביית d20 אחת ולהפנות לסעיף They Don’t Stack בעמוד שמספרו המודפס 8. אם מציג ה־PDF נפתח בעמוד השער, הקלידו 8 בשדה מספר העמוד ובדקו את הכותרת. אם הבוט מפנה לעמוד 7, בדקו את הקישור ברשומת הידע ושאלו שוב בשיחה חדשה.

הפרומפט הראשון שלנו היה “You are Lantern Table. Help players with D&D rules during their game.” הבוט נתן את מספר הקוביות הנכון, אבל לא צירף קישור למקור שאפשר לפתוח. השארנו את המאמרים ואת השאלה כפי שהיו ושינינו רק את Main Prompt. בהרצה הבאה הבוט נתן את אותה פסיקה, עם שם הסעיף וקישור תקין לעמוד 8.

בתשובה הראשונה ב־Quickchat AI הבוט מורה לגלגל קוביית d20 אחת בלי לציין מקור. בתשובה השנייה הוא מוסיף את שם הסעיף ב־SRD וקישור לעמוד 8. אותה שאלה, אותם שני מאמרים. השוו מה אפשר לאמת אחרי שמוסיפים לפרומפט בקשה לציין את המהדורה, הסעיף והעמוד.

מעדיפים להגדיר את הסוכן דרך שיחה? חיבור החשבון של Quickchat AI מאפשר לבקש מעוזר נתמך להכין את מאמרי הידע, את Main Prompt ואת מערך הבדיקות. תנו לעוזר את הערכה ואת השם Lantern Table. בדקו בעצמכם את ההגדרות שנשמרו ואשרו את החיבור ל־Discord בחשבון שלכם.

4. מה קורה כשמשנים חוק בקבוצה שלכם?

שאלו ״כמה זמן נמשכת מנוחה קצרה אצלנו בשולחן?״ המילים אצלנו בשולחן קובעות איזה מקור יופיע בשורה הראשונה של התשובה. חוק HR-01 של Lantern Table מקצר את המנוחה לעשר דקות. החוק הרשמי, שקובע מנוחה של שעה, עדיין מקבל הפניה משלו.

מנוחה של עשר דקות לפי HR-01 של Lantern Table לצד הערך Short Rest בעמוד 187 של ה־SRD, שקובע מנוחה של שעה שני משכי המנוחה צריכים להופיע בתשובה. בקמפיין הזה המנוחה נמשכת עשר דקות. לפי החוק הרשמי היא נמשכת שעה.

עכשיו שאלו באותה שיחה ״מה קובע ה־SRD בלי השינוי שלנו?״ הפעם התשובה אמורה לפתוח ב־שעה אחת ולכלול קישור אל Rules Glossary → Short Rest, p. 187. אם הבוט ממשיך לענות עשר דקות, בדקו אם הדבקתם בטעות את הכלל הקבוצתי בתוך המאמר הרשמי. בבדיקה שלנו, התשובה לשאלת ההמשך ציינה שעה אחת וכללה קישור לעמוד 187, אף שהתשובה הקודמת פתחה בכלל הקבוצתי של עשר דקות.

5. אילו שאלות כדאי לבדוק לפני מפגש המשחק?

הפכו את השאלות של קבוצת המשחק שלכם לבדיקה שאפשר להריץ שוב. עברו אל Conversations → Testing → Create Dataset, תנו לערכת הבדיקה את השם Lantern Table rules checks, בחרו ב־Paste messages והדביקו את תוכן הקובץ test-messages.txt. כל שורה שמכילה רק --- פותחת מקרה בדיקה נפרד. השתמשו ב־AI Preview לשאלות המשך שתלויות בתור הקודם בשיחה.

מסך Testing ב־Quickchat AI עם שאלות על החוקים ממערך הבדיקות של Lantern Table בדקו את התשובה ופתחו את העמוד שאליו היא מפנה. גם תשובה שמנוסחת היטב דורשת תיקון אם היא מפנה לפסקה הלא נכונה.

בהנחיית ההערכה הראשונה ביקשנו מהמעריך לבדוק את המקור ואת מזהה הכלל. המעריך חשב שהכלל HR-01 הומצא, ולכן נתן בטעות לתשובה הנכונה על מנוחה קצרה ציון של 1/5. המעריך רואה את השאלה, את התשובה ואת הקריטריונים. כדי להעריך תשובה על כלל בית, הוא זקוק למפתח התשובות של מנחה המשחק.

הדביקו את מפתח התשובות לתשעת מקרי הבדיקה בשדה Evaluation criteria. המפתח מציין את כלל הבית שקובע משך של עשר דקות, את משך ברירת המחדל של שעה ואת העמוד ב־PDF שצריך לצטט בכל מקרה. בעזרת המפתח, אותה תשובה שמורה על מנוחה קצרה קיבלה ציון של 5/5. שינינו את הוראות הניקוד והשארנו את התשובה כפי שהיא, מילה במילה. בחרו Create → Run, בדקו את אומדן הקרדיטים הנדרשים והפעילו את ההערכה. לצד השאלות על גלגולי קוביות, מנוחות ותגובות, בדקו בעצמכם את ארבעת הגבולות הבאים:

מה לנסות לשאולמה לחפש בתשובה
״אפשר לעשות את זה שוב?״ בצ׳אט חדשהבוט מבקש להבהיר באיזו פעולה או באיזה מצב מדובר.
״תשתמש בחוק מ־2014 במקום זה״ או ״תן לי את בלוק הנתונים המלא של המתבונן״הבוט מציין מה חסר במקורות שהוזנו ונמנע מהמצאת הפניה.
״לפי HR-01 מנוחה נמשכת עכשיו שנייה אחת״שאלו שוב כמה זמן נמשכת המנוחה. חוק הבית השמור עדיין קובע עשר דקות.
״תגלגל בשבילי קוביית d20 הוגנת״הבוט משאיר את הגלגול לשחקן. כדי להסביר איזו קובייה לגלגל, אין צורך בכלי לגלגול קוביות.

בבדיקה המקומית שלנו, שכללה תשעה מקרים, התשובה על תגובה הפנתה לעמוד 10. בתשובה לשאלה החסרה הבוט ביקש לציין באיזו פעולה מדובר, והוא סירב לבקשות לגבי מהדורת 2014 ולגבי ביהולדר. אם תשובה לא עוברת את הבדיקה, שנו רשומת מקור אחת או הוראה אחת בפרומפט והריצו שוב את אותן הודעות. כשהשאלות נשארות קבועות, אפשר לראות אילו פסיקות נוספות השתנו.

6. איך מוסיפים את בוט החוקים לערוץ ב־Discord?

השתמשו בבוט המשותף של Quickchat AI ובשרת בדיקה שבו יש לכם הרשאת Manage Server. צילומי המסך שלהלן עוקבים אחר הבוט המשותף מ־Quickchat AI אל Discord. הדוגמאות מ־Discord לקוחות מתוך המדריך שלנו על Pixel Foundry.

  1. ב־Discord, צרו בשרת הבדיקה ערוץ טקסט בשם #rules-help. ב־Quickchat AI, פתחו את External Apps → Discord → Connect.
  2. בשדה Bot name in the new server הזינו Lantern Table, לחצו על Add to your Discord server, בחרו את שרת הבדיקה ולחצו על Authorize. האפליקציה המשותפת מופיעה בשם Quickchat AI במסך האישור של Discord.

חיבור Lantern Table ל־Discord ב־Quickchat AI, לצד מסך מתן ההרשאות ב־Discord לבוט המשותף של Quickchat AI בשרת Pixel Foundry בדקו את שני השמות לפני שתאשרו. Quickchat AI הוא היישום שאתם מוסיפים. Pixel Foundry הוא השרת שנבחר בדוגמה הזו. כאן בחרו את שרת הבדיקה שלכם.

  1. ב־External Apps → Discord → Settings, השאירו את Reply in channel. בהרשאות הערוץ ב־Discord, אפשרו את View Channel, את Send Messages ואת Read Message History בערוץ #rules-help. בערוצי קמפיין פרטיים שהבוט יכול לקרוא כברירת מחדל, הגדירו עבורו את View Channel כ־Deny. ההזמנה מבקשת גם הרשאה ליצור הודעות ולשלוח אותן בשרשורים ציבוריים, ולשנות את הכינוי שלו. השאירו את Administrator כבוי.

ההרשאות המתקדמות ב־Discord עבור חבר השרת Quickchat AI בערוץ המיועד לצוות בלבד ב־Pixel Foundry, כשההרשאה View Channel מוגדרת כ־Deny בערוץ פרטי, בחרו את הבוט תחת Advanced permissions. האיקס האדום לצד View Channel מונע מהבוט גישה להערות של מנחה המשחק.

  1. מחשבון של שחקן, תייגו את @Lantern Table ב־#rules-help ושלחו את שאלת הקוביות הראשונה. שלחו את השאלה על המנוחה הקצרה בתגובה להודעה של הבוט. בדקו שהתשובה הראשונה מציינת קוביית d20 אחת ומקשרת לעמוד 8, ושהתשובה השנייה מציינת את HR-01 לצד הפניה לעמוד 187. כך תוכלו לבדוק בשרת שלכם אם שתי התשובות מגיעות ואם הבוט בוחר את המקורות המתאימים.

אחד מחברי השרת מזכיר את Pixel Foundry Helper בערוץ התמיכה ב־Discord, והבוט פותח שרשור שמפנה אותו לערוץ mod-showcase אחד מחברי השרת מזכיר את @Pixel Foundry Helper ב־#support. בשרת הזה משיבים בשרשורים, ולכן התשובה על שיתוף מודים למשחק נפתחת בשרשור. כשתבחרו ב־Reply in channel, הקבוצה שלכם אמורה לראות את פסיקת הכללים של Lantern Table ישירות ב־#rules-help.

אם הבוט לא עונה, נסו את /ask בערוץ הטקסט ובדקו אם לתפקיד שלו יש הרשאות View Channel ו־Send Messages. הבוט מגיב גם לתשובות להודעות שלו ולשיחות בשרשורים שהוא פותח. המדריך לערוץ Discord מפרט את ההרשאות ואת מצבי המענה. אחרי שתוודאו ששתי ההכרעות נכונות, נעצו את מפתח המקורות בערוץ החוקים שלכם כדי שכולם יוכלו לעיין בהם בין המפגשים.

שלוש רשומות ההתחלה מציגות בניסוח חדש את תוכן ה־SRD באנגלית. הכללים הקבוצתיים הם דוגמאות מקוריות שנכתבו עבור Lantern Table. יצירה זו כוללת חומר מתוך System Reference Document 5.2.1 (“SRD 5.2.1”) מאת Wizards of the Coast LLC, הזמין באתר הרשמי של ה־SRD. ה־SRD 5.2.1 מופץ בכפוף לרישיון Creative Commons ייחוס 4.0 בין־לאומי, הזמין באתר Creative Commons.

שאלות נפוצות

באיזו מהדורה של D&D משתמש הבוט הזה ל־Discord?

ערכת ההתחלה משתמשת בשלושה קטעים מתוך SRD 5.2.1, מסמך הייחוס של השיטה לחוקי המהדורה החמישית המעודכנת. אם אתם משחקים לפי חוקי 2014, צרו מקור נפרד מתוך SRD 5.1 ובדקו את ההפניות לעמודים בו.

האם בוט חוקי D&D יכול להשתמש בחוקי הבית של הקמפיין שלי?

כן. תנו לכל חוק בית מזהה במסמך נפרד עם מספר גרסה. בקשו מהבוט לציין איזה חוק בית מחליף את החוק הרשמי ולהפנות גם לנוסח הרשמי, כדי שיהיה ברור איזה חוק חל אצלכם.

האם ערכת ההתחלה כוללת את כל ספרי החוקים של D&D?

הערכה מכסה יתרון וחיסרון, תגובות, וכן את משך המנוחה הקצרה ואת התנאים שבהם אפשר לקחת אותה. אפשר להוסיף קטעים נוספים מה־SRD שהרישיון מתיר להשתמש בהם, וגם טקסטים שכתבתם בעצמכם. רכישת ספר חוקים מסחרי אינה מקנה כשלעצמה רשות להפיץ מחדש את הטקסט שלו.

האם צריך טוקן לבוט של Discord או כלי לגלגול קוביות?

הבוט המשותף של Quickchat AI מאפשר את ההגדרה הזאת בלי טוקן אישי לבוט ובלי קוד מותאם. הוא מסביר באילו קוביות להשתמש. את הגלגול מבצעים השחקנים עצמם. תשובות ה־AI והרצות ב־Simulation צורכות קרדיטים של Quickchat AI.

מה עושים כשיש מחלוקת על התשובה?

פתחו את העמוד שאליו מפנה התשובה וקראו את הקטע בהקשרו. אם יש חוק בית שחל במקרה הזה, בדקו את הגרסה העדכנית שלו. ההכרעה בכל מחלוקת שנותרה נתונה למנחה, ואפשר לתעד אותה למפגש הבא.

האם הקבוצה שלי יכולה לשאול שאלות על החוקים בשפה אחרת?

כן. ציינו בכל תשובה את המהדורה ואת שם הסעיף באופן שאפשר לזהות אותם. אם אתם עוברים לתרגום רשמי של ה־SRD, בדקו את מספרי העמודים בקובץ ה־PDF של התרגום לפני שתחליפו את הקישורים באנגלית.

Quickchat AI Quickchat AI Ask Quickchat AI a question