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.
- package/README.md +5 -5
- package/dist/campaign/create-campaign.d.ts +5 -0
- package/dist/campaign/create-campaign.js +40 -12
- package/dist/campaign/find-campaign.d.ts +5 -0
- package/dist/campaign/find-campaign.js +10 -5
- package/dist/campaign/host-files.d.ts +15 -4
- package/dist/campaign/host-files.js +134 -14
- package/dist/campaign/index.d.ts +4 -3
- package/dist/campaign/index.js +4 -3
- package/dist/campaign/port.d.ts +6 -0
- package/dist/campaign/port.js +24 -0
- package/dist/campaign/settings.d.ts +17 -0
- package/dist/campaign/settings.js +24 -1
- package/dist/cli/cli.js +33 -6
- package/dist/commands/config/config.js +15 -1
- package/dist/commands/config/dashboard.d.ts +4 -0
- package/dist/commands/config/dashboard.js +43 -7
- package/dist/commands/config/shown.js +4 -0
- package/dist/commands/config/words.d.ts +3 -1
- package/dist/commands/config/words.js +29 -2
- package/dist/commands/image.d.ts +3 -0
- package/dist/commands/image.js +31 -4
- package/dist/commands/import/import.d.ts +1 -1
- package/dist/commands/import/import.js +5 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +21 -3
- package/dist/commands/mode.d.ts +1 -1
- package/dist/commands/package/data.js +27 -0
- package/dist/commands/package/theme.js +2 -1
- package/dist/commands/scene/scene.js +6 -1
- package/dist/commands/shared/books/adventures.d.ts +1 -0
- package/dist/commands/shared/books/adventures.js +1 -1
- package/dist/commands/shared/campaign/git.d.ts +25 -0
- package/dist/commands/shared/campaign/git.js +104 -0
- package/dist/commands/shared/campaign/images.js +5 -3
- package/dist/commands/shared/campaign/saves.js +5 -1
- package/dist/commands/shared/characters/voices.d.ts +2 -2
- package/dist/commands/shared/characters/voices.js +8 -5
- package/dist/commands/shared/packages/catalog.js +24 -5
- package/dist/commands/status.d.ts +1 -0
- package/dist/commands/status.js +8 -4
- package/dist/core/context.d.ts +17 -6
- package/dist/core/context.js +2 -1
- package/dist/core/version.d.ts +2 -0
- package/dist/core/version.js +5 -0
- package/dist/dashboard/guide/ar.md +12 -7
- package/dist/dashboard/guide/cs.md +11 -6
- package/dist/dashboard/guide/da.md +11 -6
- package/dist/dashboard/guide/de.md +13 -8
- package/dist/dashboard/guide/el.md +11 -6
- package/dist/dashboard/guide/en.md +10 -5
- package/dist/dashboard/guide/es.md +11 -6
- package/dist/dashboard/guide/fi.md +11 -6
- package/dist/dashboard/guide/fr.md +12 -7
- package/dist/dashboard/guide/he.md +11 -6
- package/dist/dashboard/guide/hi.md +11 -6
- package/dist/dashboard/guide/hu.md +11 -6
- package/dist/dashboard/guide/is.md +11 -6
- package/dist/dashboard/guide/it.md +42 -37
- package/dist/dashboard/guide/ja.md +12 -7
- package/dist/dashboard/guide/ko.md +11 -6
- package/dist/dashboard/guide/nb.md +12 -7
- package/dist/dashboard/guide/nl.md +13 -8
- package/dist/dashboard/guide/pl.md +11 -6
- package/dist/dashboard/guide/pt.md +11 -6
- package/dist/dashboard/guide/ro.md +11 -6
- package/dist/dashboard/guide/ru.md +12 -7
- package/dist/dashboard/guide/sv.md +11 -6
- package/dist/dashboard/guide/tr.md +12 -7
- package/dist/dashboard/guide/uk.md +12 -7
- package/dist/dashboard/guide/zh.md +11 -6
- package/dist/dashboard/i18n/ar.json +30 -2
- package/dist/dashboard/i18n/cs.json +30 -2
- package/dist/dashboard/i18n/da.json +30 -2
- package/dist/dashboard/i18n/de.json +30 -2
- package/dist/dashboard/i18n/el.json +30 -2
- package/dist/dashboard/i18n/es.json +30 -2
- package/dist/dashboard/i18n/fi.json +30 -2
- package/dist/dashboard/i18n/fr.json +30 -2
- package/dist/dashboard/i18n/he.json +30 -2
- package/dist/dashboard/i18n/hi.json +30 -2
- package/dist/dashboard/i18n/hu.json +30 -2
- package/dist/dashboard/i18n/is.json +30 -2
- package/dist/dashboard/i18n/it.json +30 -2
- package/dist/dashboard/i18n/ja.json +30 -2
- package/dist/dashboard/i18n/ko.json +30 -2
- package/dist/dashboard/i18n/nb.json +30 -2
- package/dist/dashboard/i18n/nl.json +30 -2
- package/dist/dashboard/i18n/pl.json +30 -2
- package/dist/dashboard/i18n/pt.json +30 -2
- package/dist/dashboard/i18n/ro.json +30 -2
- package/dist/dashboard/i18n/ru.json +30 -2
- package/dist/dashboard/i18n/sv.json +30 -2
- package/dist/dashboard/i18n/tr.json +30 -2
- package/dist/dashboard/i18n/uk.json +30 -2
- package/dist/dashboard/i18n/zh.json +30 -2
- package/dist/dashboard/packages/installed.js +2 -2
- package/dist/dashboard/packages/packages.js +1 -1
- package/dist/dashboard/parts/labels.js +7 -0
- package/dist/dashboard/settings/settings.js +45 -9
- package/dist/dashboard/shell/notices.js +1 -1
- package/dist/dashboard/shell/system-style.js +89 -5
- package/dist/dashboard/shell/tooltip.js +5 -4
- package/dist/dashboard/style.css +245 -84
- package/dist/git/git.d.ts +12 -0
- package/dist/git/git.js +175 -0
- package/dist/git/ignore.d.ts +2 -0
- package/dist/git/ignore.js +16 -0
- package/dist/git/index.d.ts +2 -0
- package/dist/git/index.js +2 -0
- package/dist/helpers/briefs.d.ts +4 -0
- package/dist/helpers/briefs.js +13 -0
- package/dist/helpers/chosen.d.ts +8 -4
- package/dist/helpers/chosen.js +38 -14
- package/dist/helpers/index.d.ts +3 -2
- package/dist/helpers/index.js +5 -3
- package/dist/helpers/opencode.d.ts +13 -0
- package/dist/helpers/opencode.js +202 -0
- package/dist/importer/index.d.ts +1 -1
- package/dist/importer/index.js +1 -1
- package/dist/instructions/index.d.ts +2 -2
- package/dist/instructions/index.js +3 -3
- package/dist/languages/pack.js +2 -1
- package/dist/server/approver.d.ts +4 -2
- package/dist/server/approver.js +27 -7
- package/dist/server/bell/antigravity.d.ts +10 -0
- package/dist/server/bell/antigravity.js +95 -0
- package/dist/server/bell/index.d.ts +2 -0
- package/dist/server/bell/index.js +2 -0
- package/dist/server/bell/listener.d.ts +43 -0
- package/dist/server/bell/listener.js +149 -0
- package/dist/server/dashboard/files.d.ts +3 -2
- package/dist/server/dashboard/files.js +44 -15
- package/dist/server/dashboard/index.d.ts +25 -3
- package/dist/server/dashboard/index.js +58 -23
- package/dist/server/dashboard/news.d.ts +5 -2
- package/dist/server/dashboard/news.js +82 -14
- package/dist/server/dashboard/ports.d.ts +17 -2
- package/dist/server/dashboard/ports.js +60 -4
- package/dist/server/mcp.d.ts +6 -4
- package/dist/server/mcp.js +66 -18
- package/dist/server/player-acts.d.ts +21 -1
- package/dist/server/player-acts.js +38 -2
- package/dist/server/route/front.d.ts +3 -0
- package/dist/server/route/front.js +97 -0
- package/dist/server/route/index.d.ts +3 -0
- package/dist/server/route/index.js +3 -0
- package/dist/server/route/notes.d.ts +8 -0
- package/dist/server/route/notes.js +50 -0
- package/dist/server/route/router.d.ts +31 -0
- package/dist/server/route/router.js +215 -0
- package/dist/themes/css.d.ts +1 -1
- package/dist/themes/css.js +101 -2
- package/dist/themes/index.d.ts +1 -1
- package/dist/themes/index.js +1 -1
- package/dist/themes/theme.d.ts +34 -3
- package/dist/themes/theme.js +176 -19
- package/instructions/core.md +1 -0
- package/instructions/dashboard-guide.md +1 -1
- package/instructions/start.md +1 -1
- package/instructions/voices-opencode.md +1 -0
- package/package.json +3 -2
- package/plugins/opencode.js +174 -0
- package/dist/server/bell-listener.d.ts +0 -9
- 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,
|
|
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 או
|
|
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 אם הוא שואל אם לסמוך על
|
|
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,
|
|
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 या
|
|
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` लिखें, और अगर वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ
|
|
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,
|
|
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
|
|
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
|
|
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
|
|
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.**
|
|
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,
|
|
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
|
|
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
|
|
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
|
|
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
|
-
**
|
|
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.**
|
|
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,
|
|
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
|
|
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).
|
|
42
|
-
- Un **terminale**: su Windows, Terminale o PowerShell; su macOS, Terminale. Per aprirne uno in una cartella, clic destro sulla cartella e **Apri
|
|
43
|
-
- Un **agente
|
|
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
|
|
45
|
+
### 2.2 Installazione
|
|
46
46
|
|
|
47
47
|
```text
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
`rpg --version`
|
|
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 (
|
|
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
|
-
|
|
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
|
|
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
|
|
65
|
+
### 2.4 Collegare la tua AI
|
|
66
66
|
|
|
67
|
-
Il master gira in un **agente
|
|
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**;
|
|
70
|
-
- **Codex**: nella cartella della campagna scrivi `codex
|
|
71
|
-
- **Antigravity**: nella cartella della campagna scrivi `agy
|
|
72
|
-
- **
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 |
|
|
97
|
-
| **Voci dei personaggi** | Chi
|
|
98
|
-
| **Il tuo personaggio** | Come
|
|
99
|
-
| **Compagni** | Chi viaggia con te | nessuno, creati con te,
|
|
100
|
-
| **Immagini** | Immagini di luoghi, missioni e di chi incontri |
|
|
101
|
-
| **Linee** e **Veli** |
|
|
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
|
|
107
|
+
La quinta edizione aggiunge l'**avanzamento**: punti esperienza o tappe.
|
|
105
108
|
|
|
106
|
-
|
|
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
|
|
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
|
|
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à**
|
|
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
|
|
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.**
|
|
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.
|