rpg-engine 0.21.0 → 0.23.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (165) hide show
  1. package/README.md +5 -5
  2. package/dist/campaign/create-campaign.d.ts +5 -0
  3. package/dist/campaign/create-campaign.js +40 -12
  4. package/dist/campaign/find-campaign.d.ts +5 -0
  5. package/dist/campaign/find-campaign.js +10 -5
  6. package/dist/campaign/host-files.d.ts +15 -4
  7. package/dist/campaign/host-files.js +134 -14
  8. package/dist/campaign/index.d.ts +4 -3
  9. package/dist/campaign/index.js +4 -3
  10. package/dist/campaign/port.d.ts +6 -0
  11. package/dist/campaign/port.js +24 -0
  12. package/dist/campaign/settings.d.ts +17 -0
  13. package/dist/campaign/settings.js +24 -1
  14. package/dist/cli/cli.js +33 -6
  15. package/dist/commands/config/config.js +15 -1
  16. package/dist/commands/config/dashboard.d.ts +4 -0
  17. package/dist/commands/config/dashboard.js +43 -7
  18. package/dist/commands/config/shown.js +4 -0
  19. package/dist/commands/config/words.d.ts +3 -1
  20. package/dist/commands/config/words.js +29 -2
  21. package/dist/commands/image.d.ts +3 -0
  22. package/dist/commands/image.js +31 -4
  23. package/dist/commands/import/import.d.ts +1 -1
  24. package/dist/commands/import/import.js +5 -0
  25. package/dist/commands/init.d.ts +2 -0
  26. package/dist/commands/init.js +21 -3
  27. package/dist/commands/mode.d.ts +1 -1
  28. package/dist/commands/package/data.js +27 -0
  29. package/dist/commands/package/theme.js +2 -1
  30. package/dist/commands/scene/scene.js +6 -1
  31. package/dist/commands/shared/books/adventures.d.ts +1 -0
  32. package/dist/commands/shared/books/adventures.js +1 -1
  33. package/dist/commands/shared/campaign/git.d.ts +25 -0
  34. package/dist/commands/shared/campaign/git.js +104 -0
  35. package/dist/commands/shared/campaign/images.js +5 -3
  36. package/dist/commands/shared/campaign/saves.js +5 -1
  37. package/dist/commands/shared/characters/voices.d.ts +2 -2
  38. package/dist/commands/shared/characters/voices.js +8 -5
  39. package/dist/commands/shared/packages/catalog.js +24 -5
  40. package/dist/commands/status.d.ts +1 -0
  41. package/dist/commands/status.js +8 -4
  42. package/dist/core/context.d.ts +17 -6
  43. package/dist/core/context.js +2 -1
  44. package/dist/core/version.d.ts +2 -0
  45. package/dist/core/version.js +5 -0
  46. package/dist/dashboard/guide/ar.md +12 -7
  47. package/dist/dashboard/guide/cs.md +11 -6
  48. package/dist/dashboard/guide/da.md +11 -6
  49. package/dist/dashboard/guide/de.md +13 -8
  50. package/dist/dashboard/guide/el.md +11 -6
  51. package/dist/dashboard/guide/en.md +10 -5
  52. package/dist/dashboard/guide/es.md +11 -6
  53. package/dist/dashboard/guide/fi.md +11 -6
  54. package/dist/dashboard/guide/fr.md +12 -7
  55. package/dist/dashboard/guide/he.md +11 -6
  56. package/dist/dashboard/guide/hi.md +11 -6
  57. package/dist/dashboard/guide/hu.md +11 -6
  58. package/dist/dashboard/guide/is.md +11 -6
  59. package/dist/dashboard/guide/it.md +42 -37
  60. package/dist/dashboard/guide/ja.md +12 -7
  61. package/dist/dashboard/guide/ko.md +11 -6
  62. package/dist/dashboard/guide/nb.md +12 -7
  63. package/dist/dashboard/guide/nl.md +13 -8
  64. package/dist/dashboard/guide/pl.md +11 -6
  65. package/dist/dashboard/guide/pt.md +11 -6
  66. package/dist/dashboard/guide/ro.md +11 -6
  67. package/dist/dashboard/guide/ru.md +12 -7
  68. package/dist/dashboard/guide/sv.md +11 -6
  69. package/dist/dashboard/guide/tr.md +12 -7
  70. package/dist/dashboard/guide/uk.md +12 -7
  71. package/dist/dashboard/guide/zh.md +11 -6
  72. package/dist/dashboard/i18n/ar.json +30 -2
  73. package/dist/dashboard/i18n/cs.json +30 -2
  74. package/dist/dashboard/i18n/da.json +30 -2
  75. package/dist/dashboard/i18n/de.json +30 -2
  76. package/dist/dashboard/i18n/el.json +30 -2
  77. package/dist/dashboard/i18n/es.json +30 -2
  78. package/dist/dashboard/i18n/fi.json +30 -2
  79. package/dist/dashboard/i18n/fr.json +30 -2
  80. package/dist/dashboard/i18n/he.json +30 -2
  81. package/dist/dashboard/i18n/hi.json +30 -2
  82. package/dist/dashboard/i18n/hu.json +30 -2
  83. package/dist/dashboard/i18n/is.json +30 -2
  84. package/dist/dashboard/i18n/it.json +30 -2
  85. package/dist/dashboard/i18n/ja.json +30 -2
  86. package/dist/dashboard/i18n/ko.json +30 -2
  87. package/dist/dashboard/i18n/nb.json +30 -2
  88. package/dist/dashboard/i18n/nl.json +30 -2
  89. package/dist/dashboard/i18n/pl.json +30 -2
  90. package/dist/dashboard/i18n/pt.json +30 -2
  91. package/dist/dashboard/i18n/ro.json +30 -2
  92. package/dist/dashboard/i18n/ru.json +30 -2
  93. package/dist/dashboard/i18n/sv.json +30 -2
  94. package/dist/dashboard/i18n/tr.json +30 -2
  95. package/dist/dashboard/i18n/uk.json +30 -2
  96. package/dist/dashboard/i18n/zh.json +30 -2
  97. package/dist/dashboard/packages/installed.js +2 -2
  98. package/dist/dashboard/packages/packages.js +1 -1
  99. package/dist/dashboard/parts/labels.js +7 -0
  100. package/dist/dashboard/settings/settings.js +45 -9
  101. package/dist/dashboard/shell/notices.js +1 -1
  102. package/dist/dashboard/shell/system-style.js +89 -5
  103. package/dist/dashboard/shell/tooltip.js +5 -4
  104. package/dist/dashboard/style.css +245 -84
  105. package/dist/git/git.d.ts +12 -0
  106. package/dist/git/git.js +175 -0
  107. package/dist/git/ignore.d.ts +2 -0
  108. package/dist/git/ignore.js +16 -0
  109. package/dist/git/index.d.ts +2 -0
  110. package/dist/git/index.js +2 -0
  111. package/dist/helpers/briefs.d.ts +4 -0
  112. package/dist/helpers/briefs.js +13 -0
  113. package/dist/helpers/chosen.d.ts +8 -4
  114. package/dist/helpers/chosen.js +38 -14
  115. package/dist/helpers/index.d.ts +3 -2
  116. package/dist/helpers/index.js +5 -3
  117. package/dist/helpers/opencode.d.ts +13 -0
  118. package/dist/helpers/opencode.js +202 -0
  119. package/dist/importer/index.d.ts +1 -1
  120. package/dist/importer/index.js +1 -1
  121. package/dist/instructions/index.d.ts +2 -2
  122. package/dist/instructions/index.js +3 -3
  123. package/dist/languages/pack.js +2 -1
  124. package/dist/server/approver.d.ts +4 -2
  125. package/dist/server/approver.js +27 -7
  126. package/dist/server/bell/antigravity.d.ts +10 -0
  127. package/dist/server/bell/antigravity.js +95 -0
  128. package/dist/server/bell/index.d.ts +2 -0
  129. package/dist/server/bell/index.js +2 -0
  130. package/dist/server/bell/listener.d.ts +43 -0
  131. package/dist/server/bell/listener.js +149 -0
  132. package/dist/server/dashboard/files.d.ts +3 -2
  133. package/dist/server/dashboard/files.js +44 -15
  134. package/dist/server/dashboard/index.d.ts +25 -3
  135. package/dist/server/dashboard/index.js +58 -23
  136. package/dist/server/dashboard/news.d.ts +5 -2
  137. package/dist/server/dashboard/news.js +82 -14
  138. package/dist/server/dashboard/ports.d.ts +17 -2
  139. package/dist/server/dashboard/ports.js +60 -4
  140. package/dist/server/mcp.d.ts +6 -4
  141. package/dist/server/mcp.js +66 -18
  142. package/dist/server/player-acts.d.ts +21 -1
  143. package/dist/server/player-acts.js +38 -2
  144. package/dist/server/route/front.d.ts +3 -0
  145. package/dist/server/route/front.js +97 -0
  146. package/dist/server/route/index.d.ts +3 -0
  147. package/dist/server/route/index.js +3 -0
  148. package/dist/server/route/notes.d.ts +8 -0
  149. package/dist/server/route/notes.js +50 -0
  150. package/dist/server/route/router.d.ts +31 -0
  151. package/dist/server/route/router.js +215 -0
  152. package/dist/themes/css.d.ts +1 -1
  153. package/dist/themes/css.js +101 -2
  154. package/dist/themes/index.d.ts +1 -1
  155. package/dist/themes/index.js +1 -1
  156. package/dist/themes/theme.d.ts +34 -3
  157. package/dist/themes/theme.js +176 -19
  158. package/instructions/core.md +1 -0
  159. package/instructions/dashboard-guide.md +1 -1
  160. package/instructions/start.md +1 -1
  161. package/instructions/voices-opencode.md +1 -0
  162. package/package.json +3 -2
  163. package/plugins/opencode.js +174 -0
  164. package/dist/server/bell-listener.d.ts +0 -9
  165. package/dist/server/bell-listener.js +0 -83
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
2
2
  # RPG Engine: המדריך המלא
3
3
 
4
4
  **RPG Engine** מאפשר לשחק משחק תפקידים שולחני עם **בינה מלאכותית בתפקיד המנחה**. מדברים עם המנחה ב**צ'אט**; RPG Engine עובד מאחורי הקלעים: הוא **זוכר את העולם**, **מטיל את הקוביות** ו**מנהל את החשבונות**. לצד הצ'אט משאירים בדפדפן דף פתוח, **הלוח** (dashboard), עם דף הדמות, הקוביות, המפות והיומן.
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
64
64
 
65
65
  ### 2.4 חיבור ה-AI
66
66
 
67
- המנחה פועל בתוך **סוכן AI**: אפליקציית AI, בטרמינל או בשולחן העבודה, שיכולה לעבוד עם הקבצים שבמחשב, כמו Claude Code, Codex או Antigravity. צ'אט רגיל כמו claude.ai או ChatGPT, או אפליקציה בטלפון, אינם מספיקים: המנחה צריך לגשת לקבצי הקמפיין שבמחשב. לכל סוכן יש מנוי והתחברות משלו: ל-Claude Code דרוש מנוי בתשלום של Claude, ל-Codex התחברות עם ChatGPT, ול-Antigravity חשבון Google, שהמנוי החינמי שלו כולל מכסה שבועית קטנה. מתקינים אותו פעם אחת, מהדף שלו: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
67
+ המנחה פועל בתוך **סוכן AI**: אפליקציית AI, בטרמינל או בשולחן העבודה, שיכולה לעבוד עם הקבצים שבמחשב, כמו Claude Code, Codex, Antigravity או OpenCode. צ'אט רגיל כמו claude.ai או ChatGPT, או אפליקציה בטלפון, אינם מספיקים: המנחה צריך לגשת לקבצי הקמפיין שבמחשב. לכל סוכן יש מנוי והתחברות משלו: ל-Claude Code דרוש מנוי בתשלום של Claude, ל-Codex התחברות עם ChatGPT, ול-Antigravity חשבון Google, שהמנוי החינמי שלו כולל מכסה שבועית קטנה. OpenCode עובד עם המודלים שנותנים לו, כולל מודלים מקומיים. מתקינים אותו פעם אחת, מהדף שלו: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
68
68
 
69
69
  - **Claude Code**: בתיקיית הקמפיין כותבים `claude`. כשהוא שואל אם לסמוך על התיקייה, בוחרים **Yes, I trust this folder**. זהירות: התשובה שמסומנת מראש היא *No, exit*. לקמפיין יש גם הוק קטן, `rpg --listen`, שהשאלה לא מציגה: הוא מודיע למנחה מיד כשפועלים מהדשבורד.
70
70
  - **Codex**: בתיקיית הקמפיין כותבים `codex`, ועונים yes כשהוא שואל אם לסמוך על התיקייה. באפליקציית שולחן העבודה שלו, כדאי לבדוק בהגדרות שהזיכרונות כבויים בצ'אטים של המשחק.
71
- - **Antigravity**: בתיקיית הקמפיין כותבים `agy`, ועונים yes אם הוא שואל אם לסמוך על התיקייה. לקמפיין יש הוק קטן, `rpg --approve`, שמאפשר למנחה להשתמש בכלים של RPG Engine בלי לשאול אותך בכל פעם. המנחה מצייר את התמונות בצ'אט עצמו. Antigravity שומר את הצ'אטים הקודמים שלך, ואי אפשר לכבות את הזיכרון שלו: המנחה מקבל הוראה לא לקרוא אותם לעולם. מה שכותבים נשלח ל-Google, שעשויה לתת לאנשים לקרוא אותו: לא לכלול במשחק מידע אישי. RPG Engine אינו מוצר של Google.
71
+ - **Antigravity**: בתיקיית הקמפיין כותבים `agy`, ועונים yes אם הוא שואל אם לסמוך על התיקייה; או, באפליקציה שלו, פותחים את תיקיית הקמפיין. עבור האפליקציה, RPG Engine מוסיף את עצמו גם להגדרות של Antigravity עצמו, `.gemini/config/mcp_config.json` בתיקיית הבית שלך, שחלות על כל תיקייה שפותחים, לא רק על תיקיית הקמפיין: מחוץ לקמפיין הוא לא עושה דבר. לקמפיין יש שני הוקים קטנים: `rpg --approve` מאפשר למנחה להשתמש בכלים של RPG Engine בלי לשאול אותך בכל פעם, ו-`rpg --listen` מודיע למנחה מיד כשפועלים מהדשבורד. המנחה מצייר את התמונות בצ'אט עצמו; כשכלי התמונות שלו נכשל, הוא מצייר תמונות וקטוריות פשוטות, כמו Claude. Antigravity שומר את הצ'אטים הקודמים שלך, ואי אפשר לכבות את הזיכרון שלו: המנחה מקבל הוראה לא לקרוא אותם לעולם. מה שכותבים נשלח ל-Google, שעשויה לתת לאנשים לקרוא אותו: לא לכלול במשחק מידע אישי. RPG Engine אינו מוצר של Google.
72
+ - **OpenCode**: בתיקיית הקמפיין כותבים `opencode`. לקמפיין יש תוסף קטן, `.opencode/plugins/rpg.js`, שמודיע למנחה מיד כשפועלים מהדשבורד. בקמפיין המנחה כותב קבצים רק דרך RPG Engine: הכתיבה והעריכה של קבצים ב-OpenCode עצמו כבויות שם, ו-OpenCode שואל אותך לפני שהוא מריץ פקודה. המנחה מצייר את התמונות בעצמו, כתמונות וקטוריות פשוטות, כמו Claude. ה-OpenCode שלך, עם המודל שבחרת בו לאחרונה, מתרגם גם את הדשבורד ואת חוקי המשחק וקורא את המסמכים שמייבאים, מחוץ לצ'אט; אם אין מודל שהוא יכול להשתמש בו, Codex או Claude Code עושים זאת, אם הם מותקנים.
72
73
  - **סוכן אחר**: מפעילים אותו בתיקיית הקמפיין ונותנים לו את שרת ה-MCP `rpg mcp`. RPG Engine הוא שרת MCP סטנדרטי: כל סוכן שתומך ב-MCP יכול להיות המנחה, כולל סוכנים מקומיים.
73
74
 
75
+ אם המנחה אומר שהוא לא מוצא את הכלים של RPG Engine, כותבים `rpg init` בתיקיית הקמפיין: בתיקייה שכבר היא קמפיין, הפקודה רק מעדכנת את הקבצים האלה. אחר כך פותחים צ'אט חדש.
76
+
74
77
  אנחנו משחקים ובודקים עם **Claude Code**. **Codex** ו-**Antigravity** מחוברים ונבדקים, אבל עוד לא שוחק איתם קמפיין שלם. הקמפיין מכבה את הזיכרון של הסוכן עצמו: המשחק חי בקבצים שלו, כך שחזרה לשמירה באמת מחזירה אחורה.
75
78
 
76
79
  ### 2.5 הצ'אט הראשון
@@ -183,6 +186,8 @@ RPG Engine שומר את כל הקמפיין בסוף כל סצנה. הגדרת
183
186
 
184
187
  אחרי חזרה אחורה, **פותחים צ'אט חדש**: הצ'אט הישן זוכר את מה שבוטל. כותבים *המשך* בצ'אט החדש, ואז לוחצים על **נפתח צ'אט חדש** בשמירות.
185
188
 
189
+ אם תיקיית הקמפיין היא מאגר git, ב**הגדרות** יש חלק **Git**, שכולו כבוי עד שבוחרים: קומיט בתחילת כל סשן, בכל שמירה ובסוף כל סצנה, ודחיפה אחריו אם רוצים. קומיט הוא תצלום של הקמפיין ברגע מסוים. דחיפה שולחת את התצלומים למאגר ברשת, למשל ב-GitHub, כך שעותק נשמר גם מחוץ למחשב הזה. השמירות והצ'אטים עם המנחה נשארים מחוץ למאגר אלא אם מכניסים אותם. כדאי להכניס את הצ'אטים רק אם המאגר פרטי.
190
+
186
191
  ### 3.9 סשנים: לעצור ולחזור
187
192
 
188
193
  אפשר לעצור מתי שרוצים: *[בואו נעצור כאן להערב.]* הכול כבר שמור בקבצים. כדי לחזור, מפעילים את הסוכן בתיקיית הקמפיין וכותבים *המשך*: המנחה נותן סיכום קצר וממשיך.
@@ -214,7 +219,7 @@ RPG Engine יכול ליצור תמונות של המקומות שמגיעים
214
219
  - **יומן**: משימות, הסיפור כספר, ציר הזמן שלו, היומנים של בני הלוויה והפתקים שלך.
215
220
  - **עולם**: מפת העולם, מה שהדמות יודעת, המסמכים שנמצאו ולוח השנה.
216
221
  - **מגש הקוביות**: בוחרים קוביות ומתאם, ומטילים. ‏×2 מכפיל את הקוביות ולא את המתאם, כמו בפגיעה קריטית.
217
- - **שמירות**, **עזרה**, **הגדרות** ו**אודות**: סמלים בסוף השורה. ב**הגדרות** יש גם את ההעדפות של הדף עצמו: ערכת נושא, צליל הקוביות, סוג הקוביות ו**סגנון המשחק**, כלומר הצבעים, הפנים והתמונות של הדף. אפשר לבחור את הסגנון של מערכת המשחק, ערכת נושא שנוספה ב-Packages › Add (מהקטלוג, מקישור GitHub, מקובץ .zip או מתיקייה), או את הסגנון של הדף עצמו.
222
+ - **שמירות**, **עזרה**, **הגדרות** ו**אודות**: סמלים בסוף השורה. ב**הגדרות** יש גם את ההעדפות של הדף עצמו: ערכת נושא, צליל הקוביות, סוג הקוביות ו**סגנון המשחק**, כלומר הצבעים, הפנים והתמונות של הדף. אפשר לבחור את הסגנון של מערכת המשחק, ערכת נושא שנוספה ב-Packages › Add (מהקטלוג, מקישור GitHub, מקובץ .zip או מתיקייה), או את הסגנון של הדף עצמו. אם הסגנון של ערכת נושא מקשה על הקריאה בדף, אפשר לכבות שם את **הסגנון הייחודי של ערכת הנושא**. ההגדרות תמיד מופיעות בלעדיו, בכתובת של הדף עם `#/settings` בסופה.
218
223
 
219
224
  כשהמנחה שואל משהו, הבאנר שלו נשאר בראש הדף, בכל חלק שבו נמצאים.
220
225
 
@@ -308,7 +313,7 @@ RPG Engine נשאר בתיקייה הזאת: הוא קורא וכותב את ה
308
313
 
309
314
  ### בעיות
310
315
 
311
- **לוח הבקרה לא נפתח.** לשאול את המנחה: `[OOC: מה הקישור ללוח הבקרה?]`. הוא עובד רק כשצ'אט פתוח באותו קמפיין, אחרי התשובה הראשונה של המנחה.
316
+ **לוח הבקרה לא נפתח.** לשאול את המנחה: `[OOC: מה הקישור ללוח הבקרה?]`. הוא עובד רק כשצ'אט של אותו קמפיין פתוח: ב-Claude Code וב-Codex הוא מתחיל עם פתיחת הצ'אט, וב-Antigravity עם ההודעה הראשונה שלך. באפליקציית Claude צ'אט שנשאר זמן מה ברקע נרדם, והדף איתו: ללחוץ על הצ'אט, והדף חוזר לאותה כתובת.
312
317
 
313
318
  **נראה שהמנחה לא מכיר את המשחק.** הסוכן לא טען את RPG Engine. לבדוק שהפעלת אותו בתיקיית הקמפיין ואישרת אמון. ב-Claude Code, לכתוב `/mcp` ולחבר מחדש את `rpg`. ב-Codex, הפקודה `codex mcp list` בתיקיית הקמפיין חייבת להציג את `rpg`. אם `rpg --version` לא נמצא, להתקין את RPG Engine שוב ([2.2](#22-install)).
314
319
 
@@ -322,4 +327,4 @@ RPG Engine נשאר בתיקייה הזאת: הוא קורא וכותב את ה
322
327
 
323
328
  **ההתקנה נכשלת, או ש-`rpg` לא עולה.** `node --version` חייב להראות 24 או חדש יותר. אם Windows משיבה שהרצת סקריפטים מושבתת, ראו [2.1](#21-what-you-need). ב-Windows, להרחיק את RPG Engine ואת הקמפיינים מנתיבים שמכילים `&`.
324
329
 
325
- **הקישור ללוח הבקרה השתנה.** תוכנה אחרת תפסה את הכתובת הרגילה; המנחה נותן לך את הקישור החדש.
330
+ **הקישור ללוח הבקרה השתנה.** לכל קמפיין יש כתובת משלו, והיא נשארת זהה מצ'אט לצ'אט. היא משתנה רק כשתוכנה אחרת כבר משתמשת בה: המנחה נותן את הקישור החדש, ומאותו רגע הוא נשאר. צ'אט שני של אותו קמפיין משאיר את הדף באותה כתובת, ומשתלט עליו אחרי שסוגרים את הראשון.
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
2
2
  # RPG Engine: पूरी गाइड
3
3
 
4
4
  **RPG Engine** आपको **AI को अपना गेम मास्टर** बनाकर टेबलटॉप रोल-प्लेइंग गेम खेलने देता है। आप गेम मास्टर से **चैट** में बात करते हैं। RPG Engine पर्दे के पीछे काम करता है: वह **दुनिया को याद रखता है**, **पासे रोल करता है** और **हिसाब-किताब रखता है**। चैट के साथ आप ब्राउज़र में एक पेज खुला रखते हैं, यानी **डैशबोर्ड**, जिसमें आपकी कैरेक्टर शीट, पासे, नक्शे और आपकी डायरी होती है।
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
64
64
 
65
65
  ### 2.4 अपना AI जोड़ें
66
66
 
67
- गेम मास्टर एक **AI एजेंट** में चलता है: टर्मिनल या डेस्कटॉप पर चलने वाला ऐसा AI ऐप, जो आपके कंप्यूटर की फ़ाइलों के साथ काम कर सके, जैसे Claude Code, Codex या Antigravity। claude.ai या ChatGPT जैसी सादी चैट, या फ़ोन ऐप काफ़ी नहीं है: गेम मास्टर को आपके कंप्यूटर पर कैंपेन की फ़ाइलों तक पहुँचना होता है। हर एजेंट को अपना प्लान और लॉगिन चाहिए: Claude Code के लिए Claude का पेड प्लान, Codex के लिए ChatGPT लॉगिन, Antigravity के लिए Google अकाउंट, जिसके फ़्री प्लान में हफ़्ते का कोटा कम है। इसे आप एक बार इंस्टॉल करते हैं, उसके अपने पेज से: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google)।
67
+ गेम मास्टर एक **AI एजेंट** में चलता है: टर्मिनल या डेस्कटॉप पर चलने वाला ऐसा AI ऐप, जो आपके कंप्यूटर की फ़ाइलों के साथ काम कर सके, जैसे Claude Code, Codex, Antigravity या OpenCode। claude.ai या ChatGPT जैसी सादी चैट, या फ़ोन ऐप काफ़ी नहीं है: गेम मास्टर को आपके कंप्यूटर पर कैंपेन की फ़ाइलों तक पहुँचना होता है। हर एजेंट को अपना प्लान और लॉगिन चाहिए: Claude Code के लिए Claude का पेड प्लान, Codex के लिए ChatGPT लॉगिन, Antigravity के लिए Google अकाउंट, जिसके फ़्री प्लान में हफ़्ते का कोटा कम है; OpenCode उन मॉडलों के साथ चलता है जो आप उसे देते हैं, लोकल मॉडल भी। इसे आप एक बार इंस्टॉल करते हैं, उसके अपने पेज से: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai)।
68
68
 
69
69
  - **Claude Code**: कैंपेन फ़ोल्डर में `claude` लिखें। जब वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो **Yes, I trust this folder** चुनें; ध्यान रहे, पहले से चुना हुआ जवाब *No, exit* होता है। कैंपेन में एक छोटा हुक भी है, `rpg --listen`, जिसे यह सवाल नहीं दिखाता: जब आप डैशबोर्ड से कुछ करते हैं, तो वह गेम मास्टर को तुरंत बता देता है।
70
70
  - **Codex**: कैंपेन फ़ोल्डर में `codex` लिखें, और जब वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें। उसके डेस्कटॉप ऐप में सेटिंग्स में देखें कि गेम की चैट के लिए मेमोरी बंद हो।
71
- - **Antigravity**: कैंपेन फ़ोल्डर में `agy` लिखें, और अगर वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें। कैंपेन में एक छोटा हुक है, `rpg --approve`, जो गेम मास्टर को RPG Engine के टूल इस्तेमाल करने देता है, हर बार आपसे पूछे बिना। चित्र गेम मास्टर चैट में खुद बनाता है। Antigravity आपकी पुरानी चैट सहेजकर रखता है, और उसकी मेमोरी बंद नहीं की जा सकती: गेम मास्टर को कहा गया है कि वह उन्हें कभी न पढ़े। आप जो लिखते हैं वह Google के पास जाता है, जहाँ लोग उसे पढ़ सकते हैं: निजी जानकारी को खेल से बाहर रखें। RPG Engine Google का प्रोडक्ट नहीं है।
71
+ - **Antigravity**: कैंपेन फ़ोल्डर में `agy` लिखें, और अगर वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें; या उसके ऐप में कैंपेन फ़ोल्डर खोलें। ऐप के लिए RPG Engine खुद को Antigravity की अपनी सेटिंग्स में भी जोड़ देता है, आपके होम फ़ोल्डर की `.gemini/config/mcp_config.json` में, जो आपके खोले हर फ़ोल्डर पर लागू होती हैं, सिर्फ़ कैंपेन पर नहीं: कैंपेन के बाहर वह कुछ नहीं करता। कैंपेन में दो छोटे हुक हैं: `rpg --approve` गेम मास्टर को RPG Engine के टूल इस्तेमाल करने देता है, हर बार आपसे पूछे बिना, और `rpg --listen` जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। चित्र गेम मास्टर चैट में खुद बनाता है; जब उसका इमेज टूल नहीं चलता, तो वह सादे वेक्टर चित्र बनाता है, जैसा Claude करता है। Antigravity आपकी पुरानी चैट सहेजकर रखता है, और उसकी मेमोरी बंद नहीं की जा सकती: गेम मास्टर को कहा गया है कि वह उन्हें कभी न पढ़े। आप जो लिखते हैं वह Google के पास जाता है, जहाँ लोग उसे पढ़ सकते हैं: निजी जानकारी को खेल से बाहर रखें। RPG Engine Google का प्रोडक्ट नहीं है।
72
+ - **OpenCode**: कैंपेन फ़ोल्डर में `opencode` लिखें। कैंपेन में एक छोटा प्लगइन है, `.opencode/plugins/rpg.js`, जो जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। कैंपेन में गेम मास्टर फ़ाइलें सिर्फ़ RPG Engine के ज़रिए लिखता है: OpenCode की अपनी फ़ाइल लिखने और बदलने की सुविधा वहाँ बंद रहती है, और कोई कमांड चलाने से पहले वह आपसे पूछता है। गेम मास्टर चित्र खुद बनाता है, सादे वेक्टर चित्रों के रूप में, जैसा Claude करता है। आपका OpenCode, उसमें आपके आख़िरी चुने मॉडल के साथ, डैशबोर्ड और खेल के नियमों का अनुवाद भी करता है और आप जो दस्तावेज़ इम्पोर्ट करते हैं उन्हें चैट के बाहर पढ़ता है; अगर उसके पास इस्तेमाल करने लायक कोई मॉडल न हो, तो Codex या Claude Code यह काम करते हैं, अगर वे आपके पास हों।
72
73
  - **कोई और एजेंट**: उसे कैंपेन फ़ोल्डर में शुरू करें और उसे MCP सर्वर `rpg mcp` दें। RPG Engine एक मानक MCP सर्वर है: MCP को सपोर्ट करने वाला कोई भी एजेंट गेम मास्टर बन सकता है, लोकल एजेंट भी।
73
74
 
75
+ अगर गेम मास्टर कहे कि उसे RPG Engine के टूल नहीं मिल रहे, तो कैंपेन फ़ोल्डर में `rpg init` लिखें: जो फ़ोल्डर पहले से कैंपेन है, उसमें यह सिर्फ़ इन फ़ाइलों को अपडेट करता है; फिर नई चैट खोलें।
76
+
74
77
  हम इसे **Claude Code** के साथ खेलते और टेस्ट करते हैं; **Codex** और **Antigravity** जुड़े हुए हैं और जाँचे गए हैं, पर उनके साथ अभी तक कोई पूरा कैंपेन नहीं खेला गया। कैंपेन एजेंट की अपनी मेमोरी बंद कर देता है: गेम उसकी फ़ाइलों में रहता है, ताकि किसी सेव पर लौटने का मतलब सचमुच वहीं लौटना हो।
75
78
 
76
79
  ### 2.5 पहली चैट
@@ -183,6 +186,8 @@ RPG Engine हर दृश्य के अंत में पूरी कै
183
186
 
184
187
  पीछे लौटने के बाद, **नई चैट खोलें**: पुरानी चैट को वह सब याद रहता है जो पलट दिया गया। नई चैट में *जारी रखो* लिखें, फिर सेव में **मैंने नई चैट खोल ली है** दबाएँ।
185
188
 
189
+ अगर कैंपेन का फ़ोल्डर एक git रिपॉज़िटरी है, तो **सेटिंग्स** में एक **Git** सेक्शन होता है, जो आपके चुनने तक पूरा बंद रहता है: हर सेशन की शुरुआत में, हर सेव पर और हर दृश्य के अंत में एक कमिट, और आप चाहें तो उसके बाद एक पुश। कमिट उस पल में कैंपेन का एक स्नैपशॉट होता है; पुश इन स्नैपशॉट को ऑनलाइन रिपॉज़िटरी में भेजता है, जैसे GitHub पर, ताकि एक कॉपी इस कंप्यूटर के बाहर भी रहे। सेव और गेम मास्टर के साथ आपकी चैट रिपॉज़िटरी से बाहर रहती हैं, जब तक आप उन्हें अंदर न आने दें; चैट को अंदर तभी आने दें जब रिपॉज़िटरी निजी हो।
190
+
186
191
  ### 3.9 सेशन: रुकना और लौटना
187
192
 
188
193
  जब चाहें रुक जाएँ: *[आज रात यहीं रुकते हैं।]* सब कुछ पहले से फ़ाइलों में सेव है। लौटने के लिए, कैंपेन फ़ोल्डर में अपना एजेंट शुरू करें और *जारी रखो* लिखें: गेम मास्टर आपको छोटा सा सार सुनाता है और खेल आगे बढ़ाता है।
@@ -214,7 +219,7 @@ RPG Engine उन जगहों, उन मिशनों और उन ल
214
219
  - **डायरी**: मिशन, किताब के रूप में कहानी, उसकी टाइमलाइन, आपके साथियों की डायरियाँ और आपके नोट।
215
220
  - **दुनिया**: दुनिया का नक्शा, आपके किरदार को जो पता है, मिले हुए दस्तावेज़ और कैलेंडर।
216
221
  - **पासा ट्रे**: पासे और मॉडिफ़ायर चुनें, फिर उन्हें फेंकें। ×2 पासों को दोगुना करता है, मॉडिफ़ायर को कभी नहीं। क्रिटिकल हिट में भी यही होता है।
217
- - **सेव**, **सहायता**, **सेटिंग्स** और **जानकारी**: ये पंक्ति के आख़िर में आइकन के रूप में हैं। सेटिंग्स में पेज की अपनी पसंद भी मिलती हैं: थीम, पासों की आवाज़, पासों का सेट और **खेल की शैली**, यानी पेज के रंग, चेहरे और तस्वीरें। यह शैली खेल सिस्टम की अपनी हो सकती है, या Packages › Add से जोड़ी गई थीम, जो कैटलॉग, GitHub लिंक, .zip फ़ाइल या फ़ोल्डर से आती है, या फिर पेज की अपनी शैली।
222
+ - **सेव**, **सहायता**, **सेटिंग्स** और **जानकारी**: ये पंक्ति के आख़िर में आइकन के रूप में हैं। सेटिंग्स में पेज की अपनी पसंद भी मिलती हैं: थीम, पासों की आवाज़, पासों का सेट और **खेल की शैली**, यानी पेज के रंग, चेहरे और तस्वीरें। यह शैली खेल सिस्टम की अपनी हो सकती है, या Packages › Add से जोड़ी गई थीम, जो कैटलॉग, GitHub लिंक, .zip फ़ाइल या फ़ोल्डर से आती है, या फिर पेज की अपनी शैली। अगर किसी थीम की अपनी स्टाइल शीट से पेज पढ़ने में मुश्किल हो, तो वहाँ **थीम की अपनी शैली** बंद कर दें। सेटिंग्स हमेशा उसके बिना दिखती हैं, पेज के पते के आख़िर में `#/settings` जोड़कर।
218
223
 
219
224
  जब गेम मास्टर आपसे कुछ पूछता है, तो उसका बैनर सबसे ऊपर बना रहता है, चाहे आप किसी भी सेक्शन में हों।
220
225
 
@@ -308,7 +313,7 @@ RPG Engine इसी फ़ोल्डर में रहता है: वह
308
313
 
309
314
  ### समस्याएँ
310
315
 
311
- **डैशबोर्ड नहीं खुलता।** गेम मास्टर से पूछें: `[OOC: डैशबोर्ड का लिंक क्या है?]`। यह तभी काम करता है जब उस कैंपेन में चैट खुली हो, गेम मास्टर के पहले जवाब के बाद।
316
+ **डैशबोर्ड नहीं खुलता।** गेम मास्टर से पूछें: `[OOC: डैशबोर्ड का लिंक क्या है?]`। यह तभी काम करता है जब उस कैंपेन की कोई चैट खुली हो: Claude Code और Codex में यह चैट खुलते ही शुरू हो जाता है, Antigravity में आपके पहले संदेश के साथ। Claude ऐप में कुछ देर बैकग्राउंड में छोड़ी गई चैट सो जाती है, और उसके साथ पेज भी: चैट पर क्लिक करें, और पेज उसी पते पर लौट आता है।
312
317
 
313
318
  **गेम मास्टर को खेल की जानकारी नहीं लगती।** आपके एजेंट ने RPG Engine लोड नहीं किया। जाँचें कि आपने उसे कैंपेन फ़ोल्डर में शुरू किया और उस पर भरोसा किया। Claude Code में `/mcp` लिखें और `rpg` को फिर से जोड़ें। Codex में, कैंपेन फ़ोल्डर में `codex mcp list` को `rpg` दिखाना चाहिए। अगर `rpg --version` नहीं मिलता, तो RPG Engine फिर से इंस्टॉल करें ([2.2](#22-install))।
314
319
 
@@ -322,4 +327,4 @@ RPG Engine इसी फ़ोल्डर में रहता है: वह
322
327
 
323
328
  **इंस्टॉल नहीं होता, या `rpg` शुरू नहीं होता।** `node --version` को 24 या उससे नया बताना चाहिए। अगर Windows कहे कि स्क्रिप्ट चलाना बंद है, तो [2.1](#21-what-you-need) देखें। Windows पर RPG Engine और अपने कैंपेन को ऐसे पाथ से बाहर रखें जिनमें `&` हो।
324
329
 
325
- **डैशबोर्ड का लिंक बदल गया।** किसी दूसरे प्रोग्राम ने आम पता ले लिया; गेम मास्टर आपको नया लिंक देता है।
330
+ **डैशबोर्ड का लिंक बदल गया।** हर कैंपेन का अपना पता होता है, जो चैट-दर-चैट वही रहता है। यह तभी बदलता है जब उस पते को कोई दूसरा प्रोग्राम पहले से इस्तेमाल कर रहा हो: गेम मास्टर आपको नया लिंक देता है, और उसके बाद वही बना रहता है। उसी कैंपेन की दूसरी चैट पेज को उसी पते पर रखती है, और पहली चैट बंद करने पर उसे अपने हाथ में ले लेती है।
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
2
2
  # RPG Engine: a teljes útmutató
3
3
 
4
4
  Az **RPG Engine** lehetővé teszi, hogy asztali szerepjátékot játssz egy **MI mesélővel**. A mesélővel egy **csevegésben** beszélgetsz; az RPG Engine a háttérben dolgozik: **emlékszik a világra**, **dob a kockákkal** és **vezeti a számokat**. A csevegés mellett egy oldalt tartasz nyitva a böngészőben, ez a **vezérlőpult**, rajta a karakterlapoddal, a kockákkal, a térképekkel és a naplóddal.
@@ -64,13 +64,16 @@ A mesélő nem tud kampányt létrehozni neked: az `init` előtt semmi sem mondj
64
64
 
65
65
  ### 2.4 Az AI csatlakoztatása
66
66
 
67
- A mesélő egy **AI-ügynökben** fut. Ez egy AI-alkalmazás a terminálban vagy az asztalon, amely a számítógéped fájljaival is tud dolgozni, például a Claude Code, a Codex vagy az Antigravity. Egy sima chat, például a claude.ai vagy a ChatGPT, illetve egy telefonos alkalmazás nem elég: a mesélőnek el kell érnie a kampány fájljait a számítógépeden. Minden ügynökhöz saját csomag és bejelentkezés kell: a Claude Code-hoz fizetős Claude-csomag, a Codexhez ChatGPT-bejelentkezés, az Antigravityhez Google-fiók, amelynek ingyenes csomagjában kicsi a heti keret. Egyszer kell telepítened, a saját oldaláról: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
67
+ A mesélő egy **AI-ügynökben** fut. Ez egy AI-alkalmazás a terminálban vagy az asztalon, amely a számítógéped fájljaival is tud dolgozni, például a Claude Code, a Codex, az Antigravity vagy az OpenCode. Egy sima chat, például a claude.ai vagy a ChatGPT, illetve egy telefonos alkalmazás nem elég: a mesélőnek el kell érnie a kampány fájljait a számítógépeden. Minden ügynökhöz saját csomag és bejelentkezés kell: a Claude Code-hoz fizetős Claude-csomag, a Codexhez ChatGPT-bejelentkezés, az Antigravityhez Google-fiók, amelynek ingyenes csomagjában kicsi a heti keret. Az OpenCode azokkal a modellekkel működik, amelyeket megadsz neki, a helyiekkel is. Egyszer kell telepítened, a saját oldaláról: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
68
68
 
69
69
  - **Claude Code**: a kampány mappájában írd be: `claude`. Amikor megkérdezi, megbízol-e a mappában, válaszd a **Yes, I trust this folder** lehetőséget. Vigyázz, az előre kijelölt válasz a *No, exit*. A kampányban van egy kis hook is, az `rpg --listen`, amelyet a kérdés nem mutat: azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel.
70
70
  - **Codex**: a kampány mappájában írd be: `codex`, és mondj igent, amikor megkérdezi, megbízol-e a mappában. Az asztali alkalmazásában ellenőrizd a beállításokban, hogy a memóriák ki vannak kapcsolva a játék chatjeinél.
71
- - **Antigravity**: a kampány mappájában írd be: `agy`, és mondj igent, ha megkérdezi, megbízol-e a mappában. A kampányban van egy kis hook, az `rpg --approve`, amely lehetővé teszi, hogy a mesélő az RPG Engine eszközeit minden alkalommal kérdezés nélkül használja. A képeket a mesélő maga festi meg a chatben. Az Antigravity megőrzi a korábbi chatjeidet, és a memóriája nem kapcsolható ki: a mesélő azt az utasítást kapja, hogy soha ne olvassa el őket. Amit írsz, a Google-hoz kerül, ahol emberek is elolvashatják: ne vigyél személyes adatot a játékba. Az RPG Engine nem a Google terméke.
71
+ - **Antigravity**: a kampány mappájában írd be: `agy`, és mondj igent, ha megkérdezi, megbízol-e a mappában; vagy az alkalmazásában nyisd meg a kampány mappáját. Az alkalmazáshoz az RPG Engine az Antigravity saját beállításaiba is beírja magát: a saját mappádban lévő `.gemini/config/mcp_config.json` fájlba. Ezek minden megnyitott mappára érvényesek, nem csak a kampányéra: kampányon kívül az RPG Engine nem csinál semmit. A kampányban két kis hook van: az `rpg --approve` lehetővé teszi, hogy a mesélő az RPG Engine eszközeit minden alkalommal kérdezés nélkül használja, az `rpg --listen` pedig azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel. A képeket a mesélő maga festi meg a chatben; ha a képkészítő eszköze nem működik, egyszerű vektorképeket rajzol, ahogy a Claude is. Az Antigravity megőrzi a korábbi chatjeidet, és a memóriája nem kapcsolható ki: a mesélő azt az utasítást kapja, hogy soha ne olvassa el őket. Amit írsz, a Google-hoz kerül, ahol emberek is elolvashatják: ne vigyél személyes adatot a játékba. Az RPG Engine nem a Google terméke.
72
+ - **OpenCode**: a kampány mappájában írd be: `opencode`. A kampányban van egy kis bővítmény, a `.opencode/plugins/rpg.js`, amely azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel. A kampányban a mesélő csak az RPG Engine-en keresztül ír fájlokat: az OpenCode saját fájlírása és -szerkesztése ott ki van kapcsolva, és parancs futtatása előtt rákérdez nálad. A képeket a mesélő maga rajzolja, egyszerű vektorképekként, ahogy a Claude is. Az OpenCode a benne legutóbb választott modellel a chaten kívül a vezérlőpultot és a játék szabályait is lefordítja, és az importált dokumentumokat is beolvassa; ha nincs használható modellje, ezt a Codex vagy a Claude Code végzi el, ha megvannak neked.
72
73
  - **Másik ügynök**: indítsd el a kampány mappájában, és add meg neki az `rpg mcp` MCP-szervert. Az RPG Engine szabványos MCP-szerver: bármelyik MCP-t támogató ügynök lehet a mesélő, a helyiek is.
73
74
 
75
+ Ha a mesélő azt mondja, hogy nem találja az RPG Engine eszközeit, írd be az `rpg init` parancsot a kampány mappájában: egy olyan mappában, amely már kampány, ez csak frissíti ezeket a fájlokat. Utána nyiss egy új chatet.
76
+
74
77
  **Claude Code-dal** játszunk és tesztelünk. A **Codex** és az **Antigravity** csatlakoztatva és ellenőrizve van, de még egyikükkel sem játszottunk végig egy kampányt. A kampány kikapcsolja az ügynök saját memóriáját: a játék a fájljaiban él, így egy mentéshez való visszatérés tényleg visszavisz.
75
78
 
76
79
  ### 2.5 Az első chat
@@ -183,6 +186,8 @@ Minden módban **újrakezdheted** a játékot a játék elejéről vagy a nullad
183
186
 
184
187
  Visszalépés után **nyiss új csevegést**: a régi emlékszik arra, ami visszacsinálódott. Írd az új csevegésbe, hogy *folytatjuk*, majd nyomd meg a **Megnyitottam az új csevegést** gombot a Mentésekben.
185
188
 
189
+ Ha a kampány mappája git-tároló, a **Beállítások** között van egy **Git** szakasz, amelyben minden kikapcsolt, amíg nem döntesz: egy commit minden alkalom kezdetén, minden mentésnél és minden jelenet végén, és ha szeretnéd, utána egy push is. A commit a kampány pillanatnyi állapotának pillanatképe; a push elküldi a pillanatképeket az online tárolóba, például a GitHubra, így egy másolat ezen a számítógépen kívül is megvan. A mentések és a mesélővel folytatott csevegéseid kívül maradnak a tárolón, hacsak nem engeded be őket; a csevegéseket csak akkor engedd be, ha a tároló privát.
190
+
186
191
  ### 3.9 Alkalmak: abbahagyás és visszatérés
187
192
 
188
193
  Hagyd abba, amikor akarod: *[Mára álljunk meg itt.]* Minden már el van mentve a fájlokban. A visszatéréshez indítsd el az ügynöködet a kampány mappájában, és írd: *folytatjuk*; a mesélő rövid összefoglalót ad, és megy tovább.
@@ -214,7 +219,7 @@ Egy oldal a saját számítógépeden, amely csak az adott gép böngészőjébe
214
219
  - **Napló**: küldetések, a történet könyvként, az idővonala, a társaid naplói, a jegyzeteid.
215
220
  - **Világ**: a világtérkép, amit a karaktered tud, a megtalált dokumentumok és a naptár.
216
221
  - **A dobótálca**: válassz kockákat és módosítót, aztán dobj; a ×2 megduplázza a kockákat, a módosítót soha, mint kritikus találatnál.
217
- - **Mentések**, **Súgó**, **Beállítások** és **Névjegy**: ikonok a sor végén. A **Beállítások** az oldal saját módosításait is tartalmazza: téma, kockahang, kockakészlet, és **A játék stílusa**, vagyis az oldal színei, arcai és képei: a játékrendszeré, egy téma, amelyet a Packages › Add alatt adtál hozzá a katalógusból, GitHub-linkkel, .zip fájlból vagy mappából, vagy az oldal saját stílusa.
222
+ - **Mentések**, **Súgó**, **Beállítások** és **Névjegy**: ikonok a sor végén. A **Beállítások** az oldal saját módosításait is tartalmazza: téma, kockahang, kockakészlet, és **A játék stílusa**, vagyis az oldal színei, arcai és képei: a játékrendszeré, egy téma, amelyet a Packages › Add alatt adtál hozzá a katalógusból, GitHub-linkkel, .zip fájlból vagy mappából, vagy az oldal saját stílusa. Ha egy téma saját stíluslapja nehezen olvashatóvá teszi az oldalt, kapcsold ki ott a következőt: **A téma saját stílusa**. A **Beállítások** mindig ez nélkül jelennek meg, az oldal címével, amelynek a végén `#/settings` áll.
218
223
 
219
224
  Ha a mesélő kérdez tőled valamit, a kérdése szalagként a képernyő tetején marad, bármelyik részben jársz.
220
225
 
@@ -308,7 +313,7 @@ A mesélő által használt minden parancs a kampánymappában is futtatható: a
308
313
 
309
314
  ### Problémák
310
315
 
311
- **Az irányítópult nem nyílik meg.** Kérdezd meg a mesélőt: `[OOC: Mi az irányítópult linkje?]`. Csak akkor működik, amíg abban a kampányban nyitva van egy csevegés, a mesélő első válasza után.
316
+ **Az irányítópult nem nyílik meg.** Kérdezd meg a mesélőt: `[OOC: Mi az irányítópult linkje?]`. Csak akkor működik, amíg abban a kampányban nyitva van egy csevegés: Claude Code-ban és Codexben a csevegés megnyitásakor indul el, Antigravityben az első üzenetedkor. A Claude appban a háttérben egy ideje hagyott csevegés elalszik, és vele az oldal is: kattints a csevegésre, és az oldal ugyanazon a címen visszajön.
312
317
 
313
318
  **A mesélő nem ismeri a játékot.** Az ügynököd nem töltötte be az RPG Engine-t. Ellenőrizd, hogy a kampány mappájában indítottad el, és megbíztál benne. Claude Code-ban írd be: `/mcp`, és csatlakoztasd újra az `rpg`-t. Codexben a `codex mcp list` parancsnak a kampány mappájában mutatnia kell az `rpg`-t. Ha az `rpg --version` nem található, telepítsd újra az RPG Engine-t ([2.2](#22-install)).
314
319
 
@@ -322,4 +327,4 @@ A mesélő által használt minden parancs a kampánymappában is futtatható: a
322
327
 
323
328
  **A telepítés nem sikerül, vagy az `rpg` nem indul.** A `node --version` parancsnak 24-et vagy újabbat kell mutatnia. Ha a Windows azt válaszolja, hogy a szkriptek futtatása le van tiltva, lásd a [2.1](#21-what-you-need) részt. Windowson ne tedd az RPG Engine-t és a kampányaidat olyan útvonalra, amelyben `&` van.
324
329
 
325
- **Megváltozott az irányítópult linkje.** Egy másik program elvette a szokásos címet. A mesélő megadja az új linket.
330
+ **Megváltozott az irányítópult linkje.** Minden kampánynak saját címe van, csevegésről csevegésre ugyanaz. Csak akkor változik meg, ha egy másik program már használja: a mesélő megadja az új linket, és attól kezdve az marad. Ugyanannak a kampánynak egy második csevegése ugyanazon a címen tartja az oldalt, és átveszi, amint bezárod az elsőt.
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
2
2
  # RPG Engine: heildarleiðbeiningar
3
3
 
4
4
  **RPG Engine** lætur þig spila borðhlutverkaleik með **gervigreind sem sögumann**. Þú talar við sögumanninn í **spjalli**; RPG Engine vinnur á bak við tjöldin: það **man heiminn**, **kastar teningunum** og **heldur utan um bókhaldið**. Við hliðina á spjallinu hefurðu síðu opna í vafranum, **mælaborðið**, með persónublaðinu þínu, teningunum, kortunum og dagbókinni.
@@ -64,13 +64,16 @@ Sögumaðurinn getur ekki búið til herferð fyrir þig: fyrir `init` er ekkert
64
64
 
65
65
  ### 2.4 Tengja gervigreindina
66
66
 
67
- Sögumaðurinn keyrir í **gervigreindarforriti**: gervigreindarappi, í skipanaglugga eða á skjáborði, sem getur unnið með skrárnar á tölvunni þinni, eins og Claude Code, Codex eða Antigravity. Venjulegt spjall eins og claude.ai eða ChatGPT, eða símaapp, dugar ekki: sögumaðurinn þarf að komast í skrár herferðarinnar á tölvunni þinni. Hvert forrit þarf sína eigin áskrift og innskráningu: Claude Code þarf greidda Claude-áskrift, Codex þarf ChatGPT-innskráningu, Antigravity þarf Google-reikning, en ókeypis áskrift hans hefur lítinn vikulegan kvóta. Þú setur það upp einu sinni, frá síðunni þess: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
67
+ Sögumaðurinn keyrir í **gervigreindarforriti**: gervigreindarappi, í skipanaglugga eða á skjáborði, sem getur unnið með skrárnar á tölvunni þinni, eins og Claude Code, Codex, Antigravity eða OpenCode. Venjulegt spjall eins og claude.ai eða ChatGPT, eða símaapp, dugar ekki: sögumaðurinn þarf að komast í skrár herferðarinnar á tölvunni þinni. Hvert forrit þarf sína eigin áskrift og innskráningu: Claude Code þarf greidda Claude-áskrift, Codex þarf ChatGPT-innskráningu, Antigravity þarf Google-reikning, en ókeypis áskrift hans hefur lítinn vikulegan kvóta. OpenCode virkar með þeim líkönum sem þú gefur því, líka staðbundnum. Þú setur það upp einu sinni, frá síðunni þess: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
68
68
 
69
69
  - **Claude Code**: skrifaðu `claude` í herferðarmöppunni. Þegar það spyr hvort þú treystir möppunni skaltu velja **Yes, I trust this folder**. Farðu varlega: svarið sem er valið fyrirfram er *No, exit*. Herferðin hefur líka lítinn krók (hook), `rpg --listen`, sem spurningin sýnir ekki: hann lætur sögumanninn vita strax þegar þú gerir eitthvað á stjórnborðinu.
70
70
  - **Codex**: skrifaðu `codex` í herferðarmöppunni og svaraðu já þegar það spyr hvort þú treystir möppunni. Í skjáborðsappinu skaltu athuga í stillingunum að minni sé slökkt fyrir spjöll leiksins.
71
- - **Antigravity**: skrifaðu `agy` í herferðarmöppunni og svaraðu já ef það spyr hvort þú treystir möppunni. Herferðin hefur lítinn krók, `rpg --approve`, sem leyfir sögumanninum að nota verkfæri RPG Engine án þess að spyrja þig í hvert sinn. Sögumaðurinn málar myndirnar sjálfur í spjallinu. Antigravity geymir fyrri spjöll þín og ekki er hægt að slökkva á minni þess: sögumanninum er sagt að lesa þau aldrei. Það sem þú skrifar fer til Google, sem gæti látið fólk lesa það: haltu persónuupplýsingum utan leiksins. RPG Engine er ekki vara frá Google.
71
+ - **Antigravity**: skrifaðu `agy` í herferðarmöppunni og svaraðu já ef það spyr hvort þú treystir möppunni, eða opnaðu herferðarmöppuna í appinu þess. Fyrir appið bætir RPG Engine sér líka við í stillingar Antigravity sjálfs, `.gemini/config/mcp_config.json` í heimamöppunni þinni, sem gilda fyrir hverja möppu sem þú opnar, ekki aðeins herferðarmöppuna: utan herferðar gerir það ekkert. Herferðin hefur tvo litla króka: `rpg --approve` leyfir sögumanninum að nota verkfæri RPG Engine án þess að spyrja þig í hvert sinn og `rpg --listen` lætur sögumanninn vita strax þegar þú gerir eitthvað á stjórnborðinu. Sögumaðurinn málar myndirnar sjálfur í spjallinu. Ef myndaverkfæri hans bregst teiknar sögumaðurinn einfaldar vigurmyndir, eins og Claude gerir. Antigravity geymir fyrri spjöll þín og ekki er hægt að slökkva á minni þess: sögumanninum er sagt að lesa þau aldrei. Það sem þú skrifar fer til Google, sem gæti látið fólk lesa það: haltu persónuupplýsingum utan leiksins. RPG Engine er ekki vara frá Google.
72
+ - **OpenCode**: skrifaðu `opencode` í herferðarmöppunni. Herferðin hefur litla viðbót (plugin), `.opencode/plugins/rpg.js`, sem lætur sögumanninn vita strax þegar þú gerir eitthvað á stjórnborðinu. Í herferðinni skrifar sögumaðurinn skrár aðeins í gegnum RPG Engine: eigin skráarritun og skráarbreytingar OpenCode eru óvirkar þar og það spyr þig áður en það keyrir skipun. Sögumaðurinn teiknar myndirnar sjálfur, sem einfaldar vigurmyndir, eins og Claude gerir. OpenCode hjá þér, með líkaninu sem þú valdir síðast í því, þýðir líka stjórnborðið og reglur leiksins og les skjölin sem þú flytur inn, utan spjallsins. Ef það hefur ekkert líkan til að nota gera Codex eða Claude Code það, ef þú ert með þau.
72
73
  - **Annað forrit**: ræstu það í herferðarmöppunni og gefðu því MCP-þjóninn `rpg mcp`. RPG Engine er hefðbundinn MCP-þjónn: hvaða forrit sem styður MCP getur verið sögumaðurinn, líka staðbundin.
73
74
 
75
+ Ef sögumaðurinn segist ekki finna verkfæri RPG Engine skaltu skrifa `rpg init` í herferðarmöppunni: í möppu sem er nú þegar herferð færir það aðeins þessar skrár til nýjustu útgáfu. Opnaðu síðan nýtt spjall.
76
+
74
77
  Við spilum og prófum með **Claude Code**. **Codex** og **Antigravity** eru tengd og athuguð, en engin heil herferð hefur enn verið spiluð með þeim. Herferðin slekkur á eigin minni forritsins: leikurinn býr í skrám þess, svo að það að fara aftur í vistun fari raunverulega aftur.
75
78
 
76
79
  ### 2.5 Fyrsta spjallið
@@ -183,6 +186,8 @@ RPG Engine vistar alla herferðina í lok hvers atriðis. Stillingin **vistanir*
183
186
 
184
187
  Eftir að hafa farið til baka skaltu **opna nýtt spjall**: gamla spjallið man það sem var afturkallað. Skrifaðu *haltu áfram* í nýja spjallið og ýttu síðan á **Ég opnaði nýtt spjall** í Vistanir.
185
188
 
189
+ Ef herferðarmappan er git-geymsla, er í **Stillingar** hlutinn **Git**. Allt í honum er slökkt þar til þú velur: framlag (commit) í upphafi hverrar lotu, við hverja vistun og í lok hvers atriðis, og ýting (push) á eftir ef þú vilt. Framlag er skyndimynd af herferðinni á þeirri stundu. Ýting sendir skyndimyndirnar í geymsluna á netinu, til dæmis á GitHub, svo að afrit sé til utan þessarar tölvu. Vistanir og spjall þitt við sögumanninn haldast utan geymslunnar nema þú hleypir þeim inn. Hleyptu spjallinu aðeins inn ef geymslan er einkageymsla.
190
+
186
191
  ### 3.9 Fundir: að hætta og koma aftur
187
192
 
188
193
  Hættu hvenær sem þú vilt: *[Hættum hér í kvöld.]* Allt er þegar vistað í skrárnar. Til að koma aftur skaltu ræsa forritið þitt í herferðarmöppunni og skrifa *haltu áfram*: sögumaðurinn gefur þér stutt yfirlit og heldur áfram.
@@ -214,7 +219,7 @@ Síða á þinni eigin tölvu, sem opnast aðeins í vafra þeirrar tölvu og er
214
219
  - **Dagbók**: verkefni, sagan sem bók, tímalína hennar, dagbækur félaga þinna, minnisblöðin þín.
215
220
  - **Heimur**: heimskortið, það sem persónan þín veit, skjölin sem hafa fundist og dagatalið.
216
221
  - **Teningabakkinn**: veldu teninga og breyti og kastaðu; ×2 tvöfaldar teningana, aldrei breytinn, eins og við critical hit.
217
- - **Vistanir**, **Hjálp**, **Stillingar** og **Um**, sem tákn aftast í röðinni. Stillingar geyma líka eigin valkosti síðunnar: þema, teningahljóð, teningasett og **Stíll leiksins**, það er litina, svipina og myndirnar á síðunni: þá sem leikjakerfið býður, þema sem þú bættir við í Packages › Add, úr skránni, með GitHub-hlekk, .zip-skrá eða möppu, eða þá sem síðan sjálf hefur.
222
+ - **Vistanir**, **Hjálp**, **Stillingar** og **Um**, sem tákn aftast í röðinni. Stillingar geyma líka eigin valkosti síðunnar: þema, teningahljóð, teningasett og **Stíll leiksins**, það er litina, svipina og myndirnar á síðunni: þá sem leikjakerfið býður, þema sem þú bættir við í Packages › Add, úr safninu, með GitHub-hlekk, .zip-skrá eða möppu, eða þá sem síðan sjálf hefur. Ef eigin stílblað þema gerir síðuna erfiða aflestrar skaltu slökkva þar á valkostinum **Eigin stíll þemans**: Stillingar birtast alltaf án hans, á slóð síðunnar með `#/settings` aftan við.
218
223
 
219
224
  Þegar sögumaðurinn spyr þig einhvers helst borðinn hans efst, sama í hvaða hluta þú ert.
220
225
 
@@ -308,7 +313,7 @@ Sérhver skipun sem sögumaður notar má líka keyra í herferðarmöppunni: `r
308
313
 
309
314
  ### Vandamál
310
315
 
311
- **Stjórnborðið opnast ekki.** Spurðu sögumanninn: `[OOC: Hver er hlekkurinn á stjórnborðið?]`. Það virkar aðeins meðan spjall er opið í þeirri herferð, eftir fyrsta svar sögumannsins.
316
+ **Mælaborðið opnast ekki.** Spurðu sögumanninn: `[OOC: Hver er hlekkurinn á mælaborðið?]`. Það virkar aðeins meðan spjall er opið í þeirri herferð: í Claude Code og Codex ræsist það um leið og spjallið opnast, í Antigravity með fyrstu skilaboðunum þínum. Í Claude appinu fer spjall sem hefur verið látið liggja í bakgrunni um tíma að sofa, og síðan með því: smelltu á spjallið og þá kemur síðan aftur á sama vistfangi.
312
317
 
313
318
  **Sögumaðurinn virðist ekki þekkja leikinn.** Gervigreindarforritið þitt hlóð ekki RPG Engine. Athugaðu að þú ræstir það í herferðarmöppunni og treystir henni. Í Claude Code skaltu skrifa `/mcp` og tengja `rpg` aftur. Í Codex verður `codex mcp list` í herferðarmöppunni að sýna `rpg`. Ef `rpg --version` finnst ekki skaltu setja RPG Engine upp aftur ([2.2](#22-install)).
314
319
 
@@ -322,4 +327,4 @@ Sérhver skipun sem sögumaður notar má líka keyra í herferðarmöppunni: `r
322
327
 
323
328
  **Uppsetning mistekst, eða `rpg` ræsist ekki.** `node --version` verður að sýna 24 eða nýrra. Ef Windows svarar að keyrsla skripta sé óvirk, sjá [2.1](#21-what-you-need). Á Windows skaltu halda RPG Engine og herferðunum þínum frá slóðum sem innihalda `&`.
324
329
 
325
- **Hlekkurinn á mælaborðið breyttist.** Annað forrit tók venjulega vistfangið. Sögumaðurinn gefur þér nýja hlekkinn.
330
+ **Hlekkurinn á mælaborðið breyttist.** Hver herferð heldur sínu eigin vistfangi, spjall eftir spjall. Það breytist aðeins þegar annað forrit er þegar að nota það: sögumaðurinn gefur þér nýja hlekkinn og eftir það helst hann. Annað spjall í sömu herferð heldur síðunni á sama vistfangi og tekur hana yfir þegar þú lokar því fyrsta.
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,ca84faa7,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,27458948,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
1
+ <!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
2
2
  # RPG Engine: la guida completa
3
3
 
4
4
  **RPG Engine** ti permette di giocare a un gioco di ruolo da tavolo con una **IA come master**. Parli con il master in una **chat**; RPG Engine lavora dietro le quinte: **ricorda il mondo**, **tira i dadi** e **tiene i conti**. Accanto alla chat tieni aperta nel browser una pagina, la **dashboard**, con la tua scheda, i dadi, le mappe e il tuo diario.
@@ -33,85 +33,88 @@ Un gioco arriva come sistema di gioco, un pacchetto che il master installa per l
33
33
 
34
34
  ---
35
35
 
36
- ## 2. Per cominciare <!-- icon: path -->
36
+ ## 2. Per iniziare <!-- icon: path -->
37
37
 
38
38
  ### 2.1 Cosa ti serve
39
39
 
40
40
  - Un computer con Windows, macOS o Linux, e un browser.
41
- - **Node.js 24** o più recente, da [nodejs.org](https://nodejs.org). Porta con sé `npm`, che installa RPG Engine.
42
- - Un **terminale**: su Windows, Terminale o PowerShell; su macOS, Terminale. Per aprirne uno in una cartella, clic destro sulla cartella e **Apri nel terminale** (Windows) o **Servizi > Nuovo terminale nella cartella** (macOS). Se Windows risponde che l'esecuzione di script è disabilitata, scrivi una volta `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` e rispondi di sì.
43
- - Un **agente IA** per il master ([2.4](#24-connect-your-ai)), con il **modello più grande** che offre: un modello piccolo si lascia convincere più facilmente a svelare segreti o a piegare le regole.
41
+ - **Node.js 24** o più recente, da [nodejs.org](https://nodejs.org). Include `npm`, che installa RPG Engine.
42
+ - Un **terminale**: su Windows, Terminale o PowerShell; su macOS, Terminale. Per aprirne uno in una cartella, fai clic con il tasto destro sulla cartella e scegli **Apri in Terminale** (Windows) o **Servizi > Nuovo Terminale nella cartella** (macOS). Se Windows risponde che l'esecuzione degli script è disattivata, scrivi una volta `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` e rispondi di sì.
43
+ - Un **agente AI** per il master ([2.4](#24-connect-your-ai)), con il **modello più grande** che offre: un modello piccolo si lascia convincere più facilmente a rivelare segreti o a piegare le regole.
44
44
 
45
- ### 2.2 Installare
45
+ ### 2.2 Installazione
46
46
 
47
47
  ```text
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- `rpg --version` controlla che abbia funzionato. Se npm si offre di aggiornarsi da solo, puoi ignorarlo. Usi `rpg` una volta per campagna, per crearla; dopo, il tuo agente avvia RPG Engine da solo. `rpg` da solo non apre niente: la dashboard te la dà il master.
51
+ Con `rpg --version` controlli che sia andato tutto bene. Se npm propone di aggiornarsi, puoi ignorarlo. Usi `rpg` una volta per campagna, per crearla; dopo, il tuo agente avvia RPG Engine da solo. `rpg` da solo non apre niente: la dashboard te la dà il master.
52
52
 
53
53
  ### 2.3 Creare una campagna
54
54
 
55
- Apri un terminale nella cartella dove tieni i tuoi giochi (come, lo dice la [2.1](#21-what-you-need)):
55
+ Apri un terminale nella cartella dove tieni i tuoi giochi ([2.1](#21-what-you-need) spiega come):
56
56
 
57
57
  ```text
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Crea la cartella `The Salt Isles` con dentro una campagna nuova; entraci con `cd "The Salt Isles"`. Scrivi sempre il nome: senza, la cartella in cui ti trovi diventa la campagna, accanto a tutto ciò che contiene già. Ricorda dov'è: ci torni ogni volta che giochi. Tutto il resto lo scegli dopo, in chat o sulla dashboard.
61
+ Questo crea la cartella `The Salt Isles` con una nuova campagna dentro; entraci con `cd "The Salt Isles"`. Scrivi sempre il nome: senza, la cartella in cui ti trovi diventa la campagna, accanto a tutto quello che contiene già. Ricorda dove si trova: ci torni ogni volta che giochi. Tutto il resto lo scegli dopo, nella chat o nella dashboard.
62
62
 
63
- Il master non può creare una campagna per te: prima di `init`, niente dice al tuo agente dov'è RPG Engine.
63
+ Il master non può creare una campagna al posto tuo: prima di `init`, niente dice al tuo agente dove si trova RPG Engine.
64
64
 
65
- ### 2.4 Collegare la tua IA
65
+ ### 2.4 Collegare la tua AI
66
66
 
67
- Il master gira in un **agente IA**: un'app di IA, nel terminale o sul desktop, che sa lavorare con i file del tuo computer, come Claude Code, Codex o Antigravity. Una chat semplice come claude.ai o ChatGPT, o un'app del telefono, non basta: il master deve arrivare ai file della campagna sul tuo computer. Ogni agente vuole il suo piano e il suo accesso: Claude Code un piano Claude a pagamento, Codex un accesso ChatGPT, Antigravity un account Google, il cui piano gratuito ha una piccola quota settimanale. Si installa una volta sola, dalla sua pagina: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
67
+ Il master gira in un **agente AI**: un'app AI, nel terminale o sul desktop, che può lavorare con i file del tuo computer, come Claude Code, Codex, Antigravity o OpenCode. Una chat semplice come claude.ai o ChatGPT, o un'app per telefono, non basta: il master deve poter raggiungere i file della campagna sul tuo computer. Ogni agente ha bisogno del suo piano e del suo accesso: Claude Code di un piano Claude a pagamento, Codex di un accesso ChatGPT, Antigravity di un account Google, il cui piano gratuito ha una piccola quota settimanale; OpenCode funziona con i modelli che gli dai, anche quelli locali. Lo installi una volta sola, dalla sua pagina: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
68
68
 
69
- - **Claude Code**: nella cartella della campagna scrivi `claude`. Quando chiede se ti fidi della cartella, scegli **Yes, I trust this folder**; attento, la risposta già selezionata è *No, exit*. La campagna ha anche un piccolo hook, `rpg --listen`, che la domanda non mostra: avvisa subito il master quando agisci dalla dashboard.
70
- - **Codex**: nella cartella della campagna scrivi `codex`, e rispondi di sì quando chiede se ti fidi della cartella. Nella sua app desktop, controlla nelle impostazioni che le memorie siano spente per le chat del gioco.
71
- - **Antigravity**: nella cartella della campagna scrivi `agy`, e rispondi di sì se chiede se ti fidi della cartella. La campagna ha un piccolo hook, `rpg --approve`, che lascia al master gli strumenti di RPG Engine senza chiederti ogni volta. Il master dipinge le immagini da sé, nella chat. Antigravity conserva le tue chat passate, e la sua memoria non si può spegnere: al master è detto di non leggerle mai. Ciò che scrivi va a Google, che può farlo leggere a delle persone: tieni fuori dal gioco i dati personali. RPG Engine non è un prodotto Google.
72
- - **Un altro agente**: avvialo nella cartella della campagna e dagli il server MCP `rpg mcp`. RPG Engine è un server MCP standard: qualsiasi agente che supporta MCP può fare il master, anche uno locale.
69
+ - **Claude Code**: nella cartella della campagna scrivi `claude`. Quando chiede se ti fidi della cartella, scegli **Yes, I trust this folder**; attenzione, la risposta già selezionata è *No, exit*. La campagna ha anche un piccolo hook, `rpg --listen`, che la domanda non mostra: avvisa subito il master quando agisci dalla dashboard.
70
+ - **Codex**: nella cartella della campagna scrivi `codex` e rispondi di sì quando chiede se ti fidi della cartella. Nella sua app desktop, controlla nelle impostazioni che le memorie siano disattivate per le chat del gioco.
71
+ - **Antigravity**: nella cartella della campagna scrivi `agy` e rispondi di sì se chiede se ti fidi della cartella; oppure, nella sua app, apri la cartella della campagna. Per l'app, RPG Engine si aggiunge anche alle impostazioni di Antigravity, `.gemini/config/mcp_config.json` nella tua home, che valgono per ogni cartella che apri, non solo per quella della campagna: fuori da una campagna non fa nulla. La campagna ha due piccoli hook: `rpg --approve` lascia che il master usi gli strumenti di RPG Engine senza chiederti ogni volta il permesso, e `rpg --listen` avvisa subito il master quando agisci dalla dashboard. Il master dipinge le immagini direttamente nella chat; quando il suo strumento per le immagini non funziona, disegna semplici immagini vettoriali, come fa Claude. Antigravity conserva le tue chat passate e la sua memoria non si può disattivare: al master viene detto di non leggerle mai. Quello che scrivi va a Google, che potrebbe farlo leggere a delle persone: tieni i dati personali fuori dal gioco. RPG Engine non è un prodotto Google.
72
+ - **OpenCode**: nella cartella della campagna scrivi `opencode`. La campagna ha un piccolo plugin, `.opencode/plugins/rpg.js`, che avvisa subito il master quando agisci dalla dashboard. Nella campagna il master scrive i file solo attraverso RPG Engine: la scrittura e la modifica dei file di OpenCode stesso lì sono spente, e prima di lanciare un comando te lo chiede. Le immagini le disegna il master stesso, come semplici immagini vettoriali, come fa Claude. Il tuo OpenCode, con il modello che hai scelto per ultimo, traduce anche la dashboard e le regole del gioco e legge i documenti che importi, fuori dalla chat; senza un modello che possa usare, lo fanno Codex o Claude Code, se li hai.
73
+ - **Un altro agente**: avvialo nella cartella della campagna e dagli il server MCP `rpg mcp`. RPG Engine è un normale server MCP: qualsiasi agente che supporti MCP può fare da master, anche quelli locali.
73
74
 
74
- Noi lo giochiamo e lo proviamo con **Claude Code**; **Codex** e **Antigravity** sono collegati e verificati, ma non ci abbiamo ancora giocato una campagna intera. La campagna spegne la memoria propria dell'agente: il gioco vive nei suoi file, così tornare a un salvataggio torna davvero indietro.
75
+ Se il master dice di non trovare gli strumenti di RPG Engine, scrivi `rpg init` nella cartella della campagna: in una cartella che è già una campagna aggiorna soltanto questi file; poi apri una nuova chat.
76
+
77
+ Noi giochiamo e proviamo con **Claude Code**; **Codex** e **Antigravity** sono collegati e verificati, ma con loro non è ancora stata giocata una campagna intera. La campagna disattiva la memoria propria dell'agente: il gioco vive nei suoi file, così tornare a un salvataggio significa davvero tornare indietro.
75
78
 
76
79
  ### 2.5 La prima chat
77
80
 
78
- Scrivi qualsiasi cosa, come *Ciao! Cominciamo.* Nella prima risposta di ogni chat il master ti dà il **link alla tua dashboard**, qualcosa come `http://127.0.0.1:4750`: aprilo e tienilo accanto alla chat.
81
+ Scrivi quello che vuoi, per esempio *Ciao! Iniziamo.* Nella sua prima risposta di ogni chat il master ti dà il **link alla tua dashboard**, qualcosa come `http://127.0.0.1:4750`: aprilo e tienilo accanto alla chat.
79
82
 
80
- Tra i messaggi del master il tuo agente mostra i tool che usa: non aprirne i dettagli (in Claude Code, ctrl+o), possono mostrare dei segreti.
83
+ Tra un messaggio e l'altro del master, il tuo agente mostra gli strumenti che usa: non aprirne i dettagli (in Claude Code, ctrl+o), perché possono mostrare segreti.
81
84
 
82
- Una campagna nuova passa per tre fasi, che la dashboard mostra in alto: **1 Impostazioni** (come vuoi giocare), **2 Sessione zero** (crei il tuo personaggio, giocando), **3 Gioco**.
85
+ Una nuova campagna passa per tre fasi, mostrate in cima alla dashboard: **1 Impostazioni** (come vuoi giocare), **2 Sessione zero** (crei il tuo personaggio, giocando), **3 Gioco**.
83
86
 
84
87
  ### 2.6 Impostazioni: scegliere come giocare
85
88
 
86
- Il master chiede solo ciò che manca, poche domande alla volta; il passo **Impostazioni** della dashboard mostra le stesse domande come carte. Scrivi "decidi tu" e il master sceglie. Tutto si può cambiare dopo, in chat o nelle **Impostazioni**.
89
+ Il master chiede solo ciò che manca ancora, poche domande alla volta; il passo **Impostazioni** della dashboard mostra le stesse domande come schede. Scrivi "decidi tu" e il master sceglie. Tutto si può cambiare dopo, nella chat o in **Impostazioni**.
87
90
 
88
91
  | Impostazione | Cosa decide | Valori |
89
92
  |---|---|---|
90
93
  | **Mentore** | Quanto il master ti insegna le regole | spento, suggerimenti, tutorial |
91
94
  | **Difficoltà** | Quanto è duro il mondo | storia, facile, normale, difficile, brutale |
92
- | **Letalità** | Cosa vuol dire cadere in uno scontro | narrativa (non si muore), epica (solo quando conta), dadi |
95
+ | **Letalità** | Cosa significa cadere in uno scontro | narrativa (non si muore mai), epica (solo quando conta), dadi |
93
96
  | **Salvataggi** | Quando puoi tornare indietro | morte permanente, checkpoint, libero ([3.8](#38-saves-and-going-back)) |
94
- | **Rigore** | Quanto cibo, luce e viaggi seguono le regole | scorrevole, regole, simulazione |
97
+ | **Rigore** | Quanto cibo, luce e viaggio seguono da vicino le regole | fluido, regole, simulazione |
95
98
  | **Dadi** | Chi tira i tuoi dadi | digitali, fisici |
96
- | **Unità di misura** | Distanze e pesi | metrico, imperiale |
97
- | **Voci dei personaggi** | Chi dà voce ai personaggi che incontri, dal master ai personaggi: sempre il master; nei momenti chiave il personaggio stesso, che sa solo ciò che sa, quando il master lo sceglie; oppure sempre il personaggio, per i principali o per tutti, più lento e costoso, dove la tua app di IA lo permette | il master, a volte, i principali, tutti |
98
- | **Il tuo personaggio** | Come si crea il tuo personaggio nella sessione zero | con il master, dal master, il tuo ([2.7](#27-session-zero-your-character)) |
99
- | **Compagni** | Chi viaggia con te | nessuno, creati con te, fatti dal master, incontrati in gioco |
100
- | **Immagini** | Immagini di luoghi, missioni e di chi incontri | niente, su richiesta, nuovi luoghi, missioni e chi incontri ([3.11](#311-pictures)) |
101
- | **Linee** e **Veli** | Cosa non compare mai, e cosa succede solo fuori scena | elenchi |
99
+ | **Unità di misura** | Distanze e pesi | metriche, imperiali |
100
+ | **Voci dei personaggi** | Chi parla per i personaggi che incontri, dal master ai personaggi stessi: sempre il master; nei momenti chiave il personaggio in persona, che sa solo ciò che sa lui, a scelta del master; oppure sempre il personaggio, per quelli principali o per tutti, in modo più lento e più costoso, dove la tua app AI lo permette | il master, a volte, personaggi principali, tutti |
101
+ | **Il tuo personaggio** | Come viene creato il tuo personaggio nella sessione zero | con il master, dal master, il tuo ([2.7](#27-session-zero-your-character)) |
102
+ | **Compagni** | Chi viaggia con te | nessuno, creati con te, creati dal master, incontrati giocando |
103
+ | **Immagini** | Immagini di luoghi, missioni e di chi incontri | nessuna, su richiesta, nuovi luoghi, missioni e chi incontri ([3.11](#311-pictures)) |
104
+ | **Linee** e **Veli** | Ciò che non appare mai e ciò che accade solo fuori scena | elenchi |
102
105
  | **Lingua** | La lingua del gioco e della dashboard | qualsiasi |
103
106
 
104
- La quinta edizione aggiunge l'**avanzamento**: punti esperienza o traguardi.
107
+ La quinta edizione aggiunge l'**avanzamento**: punti esperienza o tappe.
105
108
 
106
- Senza un mondo scritto, il master chiede anche una **premessa** (genere, tono, qualche elemento e cosa ti piace di più in un gioco, come gli scontri, i misteri, le conversazioni o l'esplorazione, con parole tue), la **preparazione**: costruire il mondo al momento, man mano, o tutto all'inizio; e la **durata**: una sera, qualche sessione (da tre a cinque serate), o senza fine, un'avventura dopo l'altra. Alla fine di una storia con una durata puoi sempre continuare.
109
+ Se non c'è un mondo già scritto, il master chiede anche una **Premessa** (genere, tono, qualche elemento e ciò che ti piace di più in un gioco, come scontri, misteri, dialoghi o esplorazione, **A parole tue**), la **Preparazione**: costruire il mondo al volo, man mano, oppure tutto all'inizio; e la **Durata**: una sera, qualche sessione (da tre a cinque sere), oppure aperta, un'avventura dopo l'altra. Alla fine di una storia con una durata puoi sempre continuare.
107
110
 
108
- **Lo stile del master** non viene chiesto, ma puoi cambiarlo in chat o nelle **Impostazioni**: la **narrazione** (asciutta, letteraria, pulp, ironica), le **storie** che inventa (situazioni, archi, episodi, mistero), **scrivi come** un autore, o altro **a parole tue**.
111
+ **Lo stile del master** non viene mai chiesto, ma puoi cambiarlo nella chat o in **Impostazioni**: la **Narrazione** (sobria, letteraria, pulp, ironica), le **Storie** che inventa (situazioni, archi, episodi, mistero), un autore da cui **Scrivi come**, o qualsiasi altra cosa **A parole tue**.
109
112
 
110
113
  ### 2.7 Sessione zero: il tuo personaggio
111
114
 
112
- Crei il tuo personaggio con il master, come al tavolo. Ogni scelta è tua, a meno che tu non chieda al master di farla: vieni con un'idea completa, una vaga, o nessuna; oppure chiedi al master di fare tutto partendo da poche parole. In un gioco con i livelli il master ti chiede da quale livello parti: il primo, a meno che tu non ne voglia un altro. Il master ti dice come si calcolano le caratteristiche prima di tirare qualsiasi dado. La tua storia non è mai obbligatoria; se ne dai una, il master la scrive con le tue parole. Poi il master ti chiede un'immagine del tuo personaggio ([3.7](#37-your-characters-story-and-picture)). La scheda la calcola RPG Engine: tu non fai mai i conti.
115
+ Crei il tuo personaggio insieme al master, come a un tavolo. Ogni scelta è tua, a meno che tu non chieda al master di farla: puoi arrivare con un'idea completa, con una vaga o con niente; oppure chiedere al master di creare tutto partendo da poche parole. In un gioco con i livelli il master ti chiede da quale livello vuoi partire: il primo, a meno che tu non ne voglia un altro. Il master ti spiega come si determinano i punteggi di caratteristica prima che venga tirato qualsiasi dado. La tua storia non è mai obbligatoria; se ne dai una, il master la scrive con le tue parole. Poi il master ti chiede un'immagine del tuo personaggio ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcola la scheda: i conti non li fai mai tu.
113
116
 
114
- Hai già un personaggio, di un altro gioco o di un'altra campagna? Scegli **Ce l'ho già** nelle **Impostazioni** e dallo al master: incolla la scheda in chat, oppure di' dove si trova il suo file sul tuo computer (un PDF, un'immagine, un testo). Il master lo scrive così com'è, al suo livello, lo confronta con le regole e con il mondo, e concorda con te tutto ciò che non torna.
117
+ Hai già un personaggio, di un altro gioco o di un'altra campagna? Scegli **Ce l'ho già** nella configurazione e consegnalo al master: incolla la scheda nella chat, oppure di' dove si trova il suo file sul tuo computer (un PDF, un'immagine, un testo). Il master lo scrive così com'è, al suo livello, lo confronta con le regole e con il mondo, e concorda con te tutto ciò che non torna.
115
118
 
116
119
  ---
117
120
 
@@ -183,6 +186,8 @@ In ogni modalità puoi **ricominciare**, dall'inizio del gioco o dalla sessione
183
186
 
184
187
  Dopo essere tornato indietro, **apri una chat nuova**: quella vecchia ricorda ciò che è stato annullato. Scrivi *continua* nella chat nuova, poi premi **Ho aperto una chat nuova** in Salvataggi.
185
188
 
189
+ Se la cartella della campagna è un repository git, le **Impostazioni** hanno una sezione **Git**, tutta disattivata finché non scegli tu: un commit all'inizio di ogni sessione, a ogni salvataggio e alla fine di ogni scena, e se vuoi anche un push dopo. Un commit è una foto della campagna in quel momento; un push manda le foto al repository online, per esempio su GitHub, così ne hai una copia fuori dal computer. I salvataggi e le tue chat con il master restano fuori dal repository, a meno che tu non li faccia entrare; fai entrare le chat solo se il repository è privato.
190
+
186
191
  ### 3.9 Sessioni: fermarsi e tornare
187
192
 
188
193
  Fermati quando vuoi: *[Fermiamoci qui per stasera.]* È già tutto salvato nei file. Per tornare, avvia il tuo agente nella cartella della campagna e scrivi *continua*: il master ti fa un breve riassunto e va avanti.
@@ -214,7 +219,7 @@ Una pagina sul tuo computer, che si apre solo nel browser di quel computer, viva
214
219
  - **Diario**: le missioni, la storia come un libro, la sua cronologia, i diari dei compagni, le tue note.
215
220
  - **Mondo**: la mappa del mondo, ciò che il tuo personaggio sa, i documenti trovati e il calendario.
216
221
  - **Il vassoio dei dadi**: scegli dadi e modificatore, e tira; ×2 raddoppia i dadi, mai il modificatore, come per un colpo critico.
217
- - **Salvataggi**, **Guida**, **Impostazioni** e **Info**, come icone in fondo alla riga. Le Impostazioni tengono anche le preferenze della pagina: tema, suono dei dadi, set di dadi, e lo **Stile del gioco**, cioè colori, caratteri e figure della pagina: quelli del sistema di gioco, di un tema che hai aggiunto in Pacchetti › Aggiungi, dal catalogo, da un link GitHub, da uno .zip o da una cartella, o quelli della pagina.
222
+ - **Salvataggi**, **Guida**, **Impostazioni** e **Info**, come icone in fondo alla riga. Le Impostazioni tengono anche le preferenze della pagina: tema, suono dei dadi, set di dadi, e lo **Stile del gioco**, cioè colori, caratteri e figure della pagina: quelli del sistema di gioco, di un tema che hai aggiunto in Pacchetti › Aggiungi, dal catalogo, da un link GitHub, da uno .zip o da una cartella, o quelli della pagina. Se il foglio di stile di un tema rende la pagina difficile da leggere, spegni lì lo **Stile proprio del tema**: le Impostazioni si mostrano sempre senza, all'indirizzo della pagina con `#/settings` in fondo.
218
223
 
219
224
  Quando il master ti chiede qualcosa, il suo banner resta in alto, in qualsiasi sezione tu sia.
220
225
 
@@ -308,7 +313,7 @@ Ogni comando che usa il master si può lanciare anche nella cartella della campa
308
313
 
309
314
  ### Problemi
310
315
 
311
- **La dashboard non si apre.** Chiedi al master: `[OOC: Qual è il link della dashboard?]`. Funziona solo mentre una chat è aperta in quella campagna, dopo la prima risposta del master.
316
+ **La dashboard non si apre.** Chiedi al master: `[OOC: Qual è il link della dashboard?]`. Funziona solo mentre è aperta una chat di quella campagna: in Claude Code e in Codex parte appena si apre la chat, in Antigravity con il tuo primo messaggio. Nell'app di Claude una chat lasciata a lungo in secondo piano si addormenta, e la pagina con essa: clicca sulla chat, e la pagina torna allo stesso indirizzo.
312
317
 
313
318
  **Il master non sembra conoscere il gioco.** Il tuo agente non ha caricato RPG Engine. Controlla di averlo avviato nella cartella della campagna e di esserti fidato. In Claude Code, scrivi `/mcp` e ricollega `rpg`. In Codex, `codex mcp list` nella cartella della campagna deve mostrare `rpg`. Se `rpg --version` non viene trovato, installa di nuovo RPG Engine ([2.2](#22-install)).
314
319
 
@@ -322,4 +327,4 @@ Ogni comando che usa il master si può lanciare anche nella cartella della campa
322
327
 
323
328
  **L'installazione fallisce, o `rpg` non parte.** `node --version` deve dire 24 o più. Se Windows risponde che l'esecuzione di script è disabilitata, vedi la [2.1](#21-what-you-need). Su Windows, tieni RPG Engine e le campagne fuori da percorsi che contengono `&`.
324
329
 
325
- **Il link della dashboard è cambiato.** Un altro programma ha preso l'indirizzo solito; il master ti dà il link nuovo.
330
+ **Il link della dashboard è cambiato.** Ogni campagna ha il suo indirizzo, sempre lo stesso da una chat all'altra. Cambia solo se un altro programma lo sta già usando: il master ti dà il link nuovo, e da lì in poi resta quello. Una seconda chat della stessa campagna lascia la pagina allo stesso indirizzo, e ne prende il posto quando chiudi la prima.