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 работает за кулисами: он **помнит мир**, **бросает кубики** и **ведёт учёт**. Рядом с чатом в браузере открыта страница, **панель управления**: на ней лист персонажа, кубики, карты и журнал.
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
64
64
 
65
65
  ### 2.4 Подключение ИИ
66
66
 
67
- Мастер работает в **ИИ-агенте**. Это приложение с ИИ, в терминале или на компьютере, которое умеет работать с файлами на твоём компьютере, например 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
+ Мастер работает в **ИИ-агенте**. Это приложение с ИИ, в терминале или на компьютере, которое умеет работать с файлами на твоём компьютере, например 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
- - **Claude Code**: в папке кампании напиши `claude`. Когда он спросит, доверяешь ли ты этой папке, выбери **Yes, I trust this folder**. Осторожно: заранее выбран другой ответ — *No, exit*. В кампании есть и маленький хук, `rpg --listen`, о котором вопрос не говорит: он сразу сообщает мастеру, когда ты что-то делаешь на дашборде.
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 Engine ничего не делает. В кампании есть два маленьких хука. Хук `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**. Всё в нём выключено, пока ты не включишь нужное: коммит в начале каждой сессии, при каждом сохранении и в конце каждой сцены, а по желанию и push после него. Коммит — это снимок кампании на этот момент. Push отправляет снимки в репозиторий в интернете, например на 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: den kompletta guiden
3
3
 
4
4
  **RPG Engine** låter dig spela ett bordsrollspel med en **AI som spelledare**. Du pratar med spelledaren i en **chatt**. RPG Engine arbetar i bakgrunden: det **minns världen**, **slår tärningarna** och **för räkenskaperna**. Bredvid chatten har du en sida öppen i webbläsaren, **dashboarden**, med ditt rollformulär, tärningarna, kartorna och din dagbok.
@@ -64,13 +64,16 @@ Spelledaren kan inte skapa en kampanj åt dig. Före `init` vet din agent inte v
64
64
 
65
65
  ### 2.4 Anslut din AI
66
66
 
67
- Spelledaren körs i en **AI-agent**: en AI-app, i terminalen eller på skrivbordet, som kan arbeta med filerna på din dator, till exempel Claude Code, Codex eller Antigravity. En vanlig chatt som claude.ai eller ChatGPT, eller en app i mobilen, räcker inte: spelledaren måste kunna nå kampanjens filer på din dator. Varje agent kräver sitt eget abonnemang och sin egen inloggning: Claude Code ett betalt Claude-abonnemang, Codex en ChatGPT-inloggning, Antigravity ett Google-konto, vars gratisabonnemang har en liten veckokvot. Du installerar agenten en gång, från dess egen sida: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
67
+ Spelledaren körs i en **AI-agent**: en AI-app, i terminalen eller på skrivbordet, som kan arbeta med filerna på din dator, till exempel Claude Code, Codex, Antigravity eller OpenCode. En vanlig chatt som claude.ai eller ChatGPT, eller en app i mobilen, räcker inte: spelledaren måste kunna nå kampanjens filer på din dator. Varje agent kräver sitt eget abonnemang och sin egen inloggning: Claude Code ett betalt Claude-abonnemang, Codex en ChatGPT-inloggning, Antigravity ett Google-konto, vars gratisabonnemang har en liten veckokvot. OpenCode fungerar med de modeller du ger den, även lokala. Du installerar agenten en gång, från dess egen sida: [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**: skriv `claude` i kampanjmappen. När den frågar om du litar på mappen väljer du **Yes, I trust this folder**. Se upp: svaret som är förvalt är *No, exit*. Kampanjen har också en liten hook, `rpg --listen`, som frågan inte visar. Den talar direkt om för spelledaren när du gör något på dashboarden.
70
70
  - **Codex**: skriv `codex` i kampanjmappen och svara ja när den frågar om du litar på mappen. Kontrollera i inställningarna i skrivbordsappen att minnen är avstängda för spelets chattar.
71
- - **Antigravity**: skriv `agy` i kampanjmappen och svara ja om den frågar om du litar på mappen. Kampanjen har en liten hook, `rpg --approve`, som låter spelledaren använda RPG Engines verktyg utan att fråga dig varje gång. Spelledaren målar bilderna i chatten själv. Antigravity sparar dina tidigare chattar, och dess minne kan inte stängas av: spelledaren har fått instruktion att aldrig läsa dem. Det du skriver går till Google, som kan låta människor läsa det: håll personuppgifter utanför spelet. RPG Engine är inte en produkt från Google.
71
+ - **Antigravity**: skriv `agy` i kampanjmappen och svara ja om den frågar om du litar på mappen, eller öppna kampanjmappen i appen. För appen lägger RPG Engine också till sig själv i Antigravitys egna inställningar, `.gemini/config/mcp_config.json` i din hemmapp. De gäller för varje mapp du öppnar, inte bara kampanjens: utanför en kampanj gör RPG Engine ingenting. Kampanjen har två små hooks: `rpg --approve` låter spelledaren använda RPG Engines verktyg utan att fråga dig varje gång, och `rpg --listen` talar direkt om för spelledaren när du gör något på dashboarden. Spelledaren målar bilderna i chatten själv. När bildverktyget misslyckas ritar spelledaren enkla vektorbilder, som Claude gör. Antigravity sparar dina tidigare chattar, och dess minne kan inte stängas av: spelledaren har fått instruktion att aldrig läsa dem. Det du skriver går till Google, som kan låta människor läsa det: håll personuppgifter utanför spelet. RPG Engine är inte en produkt från Google.
72
+ - **OpenCode**: skriv `opencode` i kampanjmappen. Kampanjen har ett litet plugin, `.opencode/plugins/rpg.js`, som direkt talar om för spelledaren när du gör något på dashboarden. I kampanjen skriver spelledaren filer bara via RPG Engine: OpenCodes eget skrivande och redigerande av filer är avstängt där, och den frågar dig innan den kör ett kommando. Spelledaren ritar bilderna själv, som enkla vektorbilder, som Claude gör. Din OpenCode, med den modell du senast valde i den, översätter också dashboarden och spelets regler och läser dokumenten du importerar, utanför chatten. Om den inte har någon modell den kan använda gör Codex eller Claude Code det, om du har dem.
72
73
  - **En annan agent**: starta den i kampanjmappen och ge den MCP-servern `rpg mcp`. RPG Engine är en standardiserad MCP-server: alla agenter som stöder MCP kan vara spelledare, även lokala.
73
74
 
75
+ Om spelledaren säger att den inte hittar RPG Engines verktyg, skriv `rpg init` i kampanjmappen. I en mapp som redan är en kampanj uppdaterar det bara dessa filer. Öppna sedan en ny chatt.
76
+
74
77
  Vi spelar och testar med **Claude Code**. **Codex** och **Antigravity** är anslutna och kontrollerade, men ingen hel kampanj har ännu spelats med dem. Kampanjen stänger av agentens eget minne: spelet finns i dess filer, så att en återgång till ett sparat spel verkligen tar dig tillbaka.
75
78
 
76
79
  ### 2.5 Den första chatten
@@ -183,6 +186,8 @@ I alla lägen kan du **börja om**, från spelets början eller från session no
183
186
 
184
187
  Efter att du har gått tillbaka ska du **öppna en ny chatt**: den gamla kommer ihåg det som ogjorts. Skriv *fortsätt* i den nya chatten och tryck sedan på **Jag har öppnat en ny chatt** i Sparade spel.
185
188
 
189
+ Om kampanjens mapp är ett git-arkiv har **Inställningar** ett avsnitt **Git**, som är avstängt tills du väljer något: en commit i början av varje session, vid varje sparat spel och i slutet av varje scen, och en push efter den om du vill. En commit är en ögonblicksbild av kampanjen just då. En push skickar ögonblicksbilderna till arkivet på nätet, till exempel på GitHub, så att det finns en kopia utanför den här datorn. De sparade spelen och dina chattar med spelledaren hålls utanför arkivet om du inte släpper in dem. Släpp bara in chattarna om arkivet är privat.
190
+
186
191
  ### 3.9 Sessioner: att sluta och komma tillbaka
187
192
 
188
193
  Sluta när du vill: *[Vi slutar här för ikväll.]* Allt är redan sparat i filerna. För att komma tillbaka startar du din agent i kampanjmappen och skriver *fortsätt*. Spelledaren ger dig en kort sammanfattning och spelet går vidare.
@@ -214,7 +219,7 @@ En sida på din egen dator. Den öppnas bara i webbläsaren på den datorn och
214
219
  - **Dagbok**: uppdrag, berättelsen som en bok, dess tidslinje, dina följeslagares dagböcker och dina anteckningar.
215
220
  - **Värld**: världskartan, det din rollperson vet, de dokument som hittats och kalendern.
216
221
  - **Tärningsbrickan**: välj tärningar och en modifikation, och slå; ×2 fördubblar tärningarna, aldrig modifikationen, som vid en kritisk träff.
217
- - **Sparade spel**, **Hjälp**, **Inställningar** och **Om**, som ikoner i slutet av raden. Inställningar rymmer också sidans egna val: tema, tärningsljud, tärningsset och **Spelets stil**, alltså sidans färger, ansikten och bilder. Stilen kan komma från spelsystemet, från ett tema du lagt till under Packages › Add (från katalogen, en GitHub-länk, en .zip-fil eller en mapp) eller från sidan själv.
222
+ - **Sparade spel**, **Hjälp**, **Inställningar** och **Om**, som ikoner i slutet av raden. **Inställningar** rymmer också sidans egna val: tema, tärningsljud, tärningsset och **Spelets stil**, alltså sidans färger, ansikten och bilder. Stilen kan komma från spelsystemet, från ett tema du lagt till under Packages › Add (från katalogen, en GitHub-länk, en .zip-fil eller en mapp) eller från sidan själv. Om ett temas egen stilmall gör sidan svårläst, stäng av **Temats egen stil** där. **Inställningar** visas alltid utan den, på sidans adress med `#/settings` i slutet.
218
223
 
219
224
  När spelledaren frågar dig något ligger dess banderoll kvar högst upp, oavsett vilken del du befinner dig i.
220
225
 
@@ -308,7 +313,7 @@ Varje kommando som spelledaren använder kan också köras i kampanjmappen: `rpg
308
313
 
309
314
  ### Problem
310
315
 
311
- **Dashboarden öppnas inte.** Fråga spelledaren: `[OOC: Vad är länken till dashboarden?]`. Den fungerar bara medan en chatt är öppen i den kampanjen, efter spelledarens första svar.
316
+ **Dashboarden öppnas inte.** Fråga spelledaren: `[OOC: Vad är länken till dashboarden?]`. Den fungerar bara medan en chatt i den kampanjen är öppen. I Claude Code och Codex startar den när chatten öppnas, i Antigravity med ditt första meddelande. I Claude-appen somnar en chatt som har legat en stund i bakgrunden, och sidan med den: klicka på chatten, så kommer sidan tillbaka på samma adress.
312
317
 
313
318
  **Spelledaren verkar inte kunna spelet.** Din agent laddade inte RPG Engine. Kontrollera att du startade den i kampanjmappen och att du litade på den. I Claude Code skriver du `/mcp` och återansluter `rpg`. I Codex måste `codex mcp list` i kampanjmappen visa `rpg`. Om `rpg --version` inte hittas, installera RPG Engine igen ([2.2](#22-install)).
314
319
 
@@ -322,4 +327,4 @@ Varje kommando som spelledaren använder kan också köras i kampanjmappen: `rpg
322
327
 
323
328
  **Installationen misslyckas, eller `rpg` startar inte.** `node --version` måste visa 24 eller senare. Om Windows svarar att det är inaktiverat att köra skript, se [2.1](#21-what-you-need). I Windows: håll RPG Engine och dina kampanjer borta från sökvägar som innehåller `&`.
324
329
 
325
- **Dashboardlänken ändrades.** Ett annat program tog den vanliga adressen. Spelledaren ger dig den nya länken.
330
+ **Dashboardlänken ändrades.** Varje kampanj har sin egen adress, densamma chatt efter chatt. Den ändras bara när ett annat program redan använder den: spelledaren ger dig den nya länken, och sedan ligger den fast. En andra chatt i samma kampanj behåller sidan på samma adress och tar över den när du stänger den första.
@@ -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: eksiksiz kılavuz
3
3
 
4
4
  **RPG Engine**, masa başı rol yapma oyununu **yapay zekâ oyun yöneticisiyle** oynamanı sağlar. Oyun yöneticisiyle bir **sohbette** konuşursun; RPG Engine ise arka planda çalışır: **dünyayı hatırlar**, **zarları atar** ve **hesapları tutar**. Sohbetin yanında tarayıcında bir sayfa açık tutarsın: **gösterge paneli**. Orada karakter kağıdın, zarların, haritaların ve günlüğün durur.
@@ -64,13 +64,16 @@ Oyun yöneticisi senin için kampanya oluşturamaz: `init` çalışmadan önce a
64
64
 
65
65
  ### 2.4 Yapay zekânı bağla
66
66
 
67
- Oyun yöneticisi bir **yapay zekâ ajanında** çalışır. Bu, terminalde ya da masaüstünde çalışan, bilgisayarındaki dosyalarla iş yapabilen bir yapay zekâ uygulamasıdır; Claude Code, Codex veya Antigravity gibi. claude.ai ya da ChatGPT gibi düz bir sohbet veya bir telefon uygulaması yetmez: oyun yöneticisinin bilgisayarındaki kampanya dosyalarına erişmesi gerekir. Her ajanın kendi planı ve girişi vardır: Claude Code için ücretli bir Claude planı, Codex için bir ChatGPT girişi, Antigravity için bir Google hesabı; ücretsiz planın haftalık kotası küçüktür. Ajanı kendi sayfasından bir kez kurarsın: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
67
+ Oyun yöneticisi bir **yapay zekâ ajanında** çalışır. Bu, terminalde ya da masaüstünde çalışan, bilgisayarındaki dosyalarla iş yapabilen bir yapay zekâ uygulamasıdır; Claude Code, Codex, Antigravity veya OpenCode gibi. claude.ai ya da ChatGPT gibi düz bir sohbet veya bir telefon uygulaması yetmez: oyun yöneticisinin bilgisayarındaki kampanya dosyalarına erişmesi gerekir. Her ajanın kendi planı ve girişi vardır: Claude Code için ücretli bir Claude planı, Codex için bir ChatGPT girişi, Antigravity için bir Google hesabı; ücretsiz planın haftalık kotası küçüktür. OpenCode, verdiğin modellerle çalışır; yerel modeller de dahildir. Ajanı kendi sayfasından bir kez kurarsın: [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**: kampanya klasöründe `claude` yaz. Klasöre güvenip güvenmediğini sorduğunda **Yes, I trust this folder** seçeneğini seç; dikkat, önceden seçili gelen cevap *No, exit* olur. Kampanyada ayrıca küçük bir kanca (hook) vardır: `rpg --listen`. Soruda görünmez; dashboard'dan bir şey yaptığında oyun yöneticisine hemen haber verir.
69
+ - **Claude Code**: kampanya klasöründe `claude` yaz. Klasöre güvenip güvenmediğini sorduğunda **Yes, I trust this folder** seçeneğini seç; dikkat, önceden seçili gelen cevap *No, exit* olur. Kampanyada ayrıca küçük bir kanca (hook) vardır: `rpg --listen`. Soruda görünmez; gösterge panelinden bir şey yaptığında oyun yöneticisine hemen haber verir.
70
70
  - **Codex**: kampanya klasöründe `codex` yaz ve klasöre güvenip güvenmediğini sorduğunda evet de. Masaüstü uygulamasında, ayarlardan oyunun sohbetleri için belleklerin kapalı olduğunu kontrol et.
71
- - **Antigravity**: kampanya klasöründe `agy` yaz ve klasöre güvenip güvenmediğini sorarsa evet de. Kampanyada küçük bir kanca vardır: `rpg --approve`. Oyun yöneticisinin RPG Engine araçlarını her seferinde sana sormadan kullanmasını sağlar. Görselleri oyun yöneticisi sohbetin içinde kendisi çizer. Antigravity geçmiş sohbetlerini saklar ve belleği kapatılamaz: oyun yöneticisine bunları asla okumaması söylenir. Yazdıkların Google'a gider ve Google bunları insanlara okutabilir: kişisel verilerini oyunun dışında tut. RPG Engine bir Google ürünü değildir.
71
+ - **Antigravity**: kampanya klasöründe `agy` yaz ve klasöre güvenip güvenmediğini sorarsa evet de; ya da uygulamasında kampanya klasörünü aç. Uygulama için RPG Engine kendini Antigravity'nin kendi ayarlarına da ekler: bunlar ana dizinindeki `.gemini/config/mcp_config.json` dosyasındadır ve yalnızca kampanyanın değil, açtığın her klasörün ayarıdır. Kampanyanın dışında hiçbir şey yapmaz. Kampanyada iki küçük kanca vardır: `rpg --approve`, oyun yöneticisinin RPG Engine araçlarını her seferinde sana sormadan kullanmasını sağlar; `rpg --listen` ise gösterge panelinden bir şey yaptığında oyun yöneticisine hemen haber verir. Oyun yöneticisi görselleri sohbetin içinde kendisi çizer; görsel aracı çalışmazsa Claude'un yaptığı gibi basit vektör görseller çizer. Antigravity geçmiş sohbetlerini saklar ve belleği kapatılamaz: oyun yöneticisine bunları asla okumaması söylenir. Yazdıkların Google'a gider ve Google bunları insanlara okutabilir: kişisel verilerini oyunun dışında tut. RPG Engine bir Google ürünü değildir.
72
+ - **OpenCode**: kampanya klasöründe `opencode` yaz. Kampanyada küçük bir eklenti vardır: `.opencode/plugins/rpg.js`. Gösterge panelinden bir şey yaptığında oyun yöneticisine hemen haber verir. Kampanyada oyun yöneticisi dosyaları yalnızca RPG Engine üzerinden yazar: OpenCode'un kendi dosya yazma ve düzenleme özelliği orada kapalıdır ve OpenCode bir komut çalıştırmadan önce sana sorar. Oyun yöneticisi görselleri Claude'un yaptığı gibi, basit vektör görseller olarak kendisi çizer. OpenCode'un, en son seçtiğin modelle, gösterge panelini ve oyunun kurallarını çevirmesi ve içe aktardığın belgeleri okuması da sohbetin dışında gerçekleşir; kullanabileceği bir model yoksa, varsa Codex ya da Claude Code bunu yapar.
72
73
  - **Başka bir ajan**: ajanı kampanya klasöründe başlat ve ona `rpg mcp` MCP sunucusunu ver. RPG Engine standart bir MCP sunucusudur: MCP destekleyen her ajan oyun yöneticisi olabilir, yerel olanlar da.
73
74
 
75
+ Oyun yöneticisi RPG Engine'in araçlarını bulamadığını söylerse kampanya klasöründe `rpg init` yaz: zaten kampanya olan bir klasörde bu komut yalnızca bu dosyaları günceller. Sonra yeni bir sohbet aç.
76
+
74
77
  Biz **Claude Code** ile oynuyor ve test ediyoruz. **Codex** ve **Antigravity** bağlı ve kontrol edildi, ama onlarla henüz tam bir kampanya oynanmadı. Kampanya, ajanın kendi belleğini kapatır: oyun dosyalarında yaşar, böylece bir kayda dönmek gerçekten geri dönmek olur.
75
78
 
76
79
  ### 2.5 İlk sohbet
@@ -183,6 +186,8 @@ Her kipte **baştan başlayabilirsin**: oyunun başından ya da sıfırıncı ot
183
186
 
184
187
  Geri döndükten sonra **yeni bir sohbet aç**: eski sohbet geri alınanı hâlâ hatırlar. Yeni sohbete *devam* yaz, sonra Kayıtlar'da **Yeni sohbet açtım**'a bas.
185
188
 
189
+ Kampanyanın klasörü bir git deposuysa **Ayarlar**'da bir **Git** bölümü bulunur. Sen seçene kadar hepsi kapalıdır: her oturumun başında, her kayıtta ve her sahnenin sonunda bir commit, istersen ardından bir push. Commit, kampanyanın o andaki anlık görüntüsüdür. Push ise bu görüntüleri çevrimiçi depoya, örneğin GitHub'a gönderir; böylece bir kopya bu bilgisayarın dışında durur. Kayıtlar ve oyun yöneticisiyle yaptığın sohbetler, sen izin vermedikçe depoya girmez. Sohbetlere yalnızca depo özelse izin ver.
190
+
186
191
  ### 3.9 Oturumlar: durmak ve geri dönmek
187
192
 
188
193
  İstediğin zaman dur: *[Bu gecelik burada bırakalım.]* Her şey zaten dosyalara kayıtlı. Geri dönmek için ajanını kampanya klasöründe başlat ve *devam* yaz: oyun yöneticisi sana kısa bir özet verir ve kaldığınız yerden sürdürür.
@@ -214,7 +219,7 @@ Kendi bilgisayarındaki bir sayfa. Yalnızca o bilgisayarın tarayıcısında a
214
219
  - **Günlük**: görevler, kitap olarak hikâye, zaman çizelgesi, yoldaşlarının günlükleri, notların.
215
220
  - **Dünya**: dünya haritası, karakterinin bildikleri, bulunan belgeler ve takvim.
216
221
  - **Zar tepsisi**: zarları ve bir değiştirici seç, sonra at. ×2 zarları ikiye katlar, değiştiriciyi asla katlamaz; kritik vuruşta olduğu gibi.
217
- - **Kayıtlar**, **Yardım**, **Ayarlar** ve **Hakkında**: satırın sonunda simge olarak durur. **Ayarlar** sayfanın kendi tercihlerini de içerir: tema, zar sesi, zar seti ve **Oyunun stili**. Oyunun stili, sayfanın renkleri, yüzleri ve resimleridir. Bunlar oyun sisteminin stili olabilir, Packages › Add ile eklediğin bir tema olabilir (katalogdan, bir GitHub bağlantısından, bir .zip dosyasından ya da bir klasörden) ya da sayfanın kendi stili olabilir.
222
+ - **Kayıtlar**, **Yardım**, **Ayarlar** ve **Hakkında**: satırın sonunda simge olarak durur. **Ayarlar** sayfanın kendi tercihlerini de içerir: tema, zar sesi, zar seti ve **Oyunun stili**. Oyunun stili, sayfanın renkleri, yüzleri ve resimleridir. Bunlar oyun sisteminin stili olabilir, Packages › Add ile eklediğin bir tema olabilir (katalogdan, bir GitHub bağlantısından, bir .zip dosyasından ya da bir klasörden) ya da sayfanın kendi stili olabilir. Bir temanın kendi stil sayfası sayfayı okumayı zorlaştırırsa orada **Temanın kendi stili** seçeneğini kapat. Ayarlar her zaman o stil olmadan görünür: sayfanın adresinin sonuna `#/settings` ekleyerek aç.
218
223
 
219
224
  Oyun yöneticisi sana bir şey sorduğunda, afişi hangi bölümde olursan ol en üstte kalır.
220
225
 
@@ -308,7 +313,7 @@ Oyun yöneticisinin kullandığı her komut kampanya klasöründe de çalıştı
308
313
 
309
314
  ### Sorunlar
310
315
 
311
- **Gösterge paneli açılmıyor.** Oyun yöneticisine sor: `[OOC: Gösterge panelinin bağlantısı ne?]`. Yalnızca o kampanyada bir sohbet açıkken, oyun yöneticisinin ilk yanıtından sonra çalışır.
316
+ **Gösterge paneli açılmıyor.** Oyun yöneticisine sor: `[OOC: Gösterge panelinin bağlantısı ne?]`. Panel yalnızca o kampanyanın bir sohbeti açıkken çalışır. Claude Code ve Codex'te sohbet açılınca başlar, Antigravity'de ilk mesajınla başlar. Claude uygulamasında bir süre arka planda bırakılan sohbet uykuya geçer, sayfa da onunla birlikte. Sohbete tıkla, sayfa aynı adreste geri gelir.
312
317
 
313
318
  **Oyun yöneticisi oyunu bilmiyor gibi.** Ajanın RPG Engine'i yüklemedi. Onu kampanya klasöründe başlattığını ve klasöre güvendiğini kontrol et. Claude Code'da `/mcp` yaz ve `rpg`'yi yeniden bağla. Codex'te kampanya klasöründe `codex mcp list` çıktısında `rpg` görünmelidir. `rpg --version` bulunamıyorsa RPG Engine'i yeniden kur ([2.2](#22-install)).
314
319
 
@@ -322,4 +327,4 @@ Oyun yöneticisinin kullandığı her komut kampanya klasöründe de çalıştı
322
327
 
323
328
  **Kurulum başarısız oluyor veya `rpg` başlamıyor.** `node --version` çıktısı 24 veya daha yeni olmalı. Windows betiklerin çalıştırılmasının devre dışı olduğunu söylerse [2.1](#21-what-you-need) bölümüne bak. Windows'ta RPG Engine'i ve kampanyalarını `&` içeren yollardan uzak tut.
324
329
 
325
- **Panel bağlantısı değişti.** Başka bir program olağan adresi aldı; oyun yöneticisi sana yeni bağlantıyı verir.
330
+ **Gösterge paneli bağlantısı değişti.** Her kampanyanın kendi adresi vardır ve bu adres sohbetten sohbete aynı kalır. Adres yalnızca başka bir program onu zaten kullanıyorsa değişir. Oyun yöneticisi sana yeni bağlantıyı verir ve bundan sonra o kalır. Aynı kampanyanın ikinci bir sohbeti sayfayı aynı adreste tutar, birincisini kapattığında da sayfayı devralır.
@@ -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 працює за лаштунками: він **пам'ятає світ**, **кидає кубики** і **веде облік**. Поруч із чатом у браузері відкрита сторінка, **панель керування**, де є твій аркуш персонажа, кубики, мапи та журнал.
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
64
64
 
65
65
  ### 2.4 Підключення ШІ
66
66
 
67
- Майстер працює в **ШІ-агенті**: це застосунок зі ШІ, в терміналі або на робочому столі, який уміє працювати з файлами на твоєму комп'ютері, наприклад 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
+ Майстер працює в **ШІ-агенті**: це застосунок зі ШІ, в терміналі або на робочому столі, який уміє працювати з файлами на твоєму комп'ютері, наприклад 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
- - **Claude Code**: у папці кампанії напиши `claude`. Коли він запитає, чи ти довіряєш цій папці, вибери **Yes, I trust this folder**. Будь обережний: попередньо вибрана відповідь — *No, exit*. У кампанії є також невеликий гачок, `rpg --listen`, якого це запитання не показує: він одразу повідомляє майстрові, коли ти робиш щось на дашборді.
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 Engine нічого не робить. У кампанії є два невеликі гачки: `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**, де все вимкнено, доки ти не обереш. Можна ввімкнути коміт на початку кожної сесії, під час кожного збереження й наприкінці кожної сцени, а за бажання ще й push після нього. Коміт — це знімок кампанії на цей момент. Push надсилає знімки до репозиторію в мережі, наприклад на 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,Google 可能安排人员查看:请不要在游戏里写入个人信息。RPG Engine 不是 Google 的产品。
71
+ - **Antigravity**:在战役文件夹里输入 `agy`,如果它询问是否信任这个文件夹,回答“是”;或者在它的应用里打开战役文件夹。使用应用时,RPG Engine 还会把自己添加到 Antigravity 自己的设置中,即你主目录下的 `.gemini/config/mcp_config.json`。这些设置对你打开的每个文件夹都有效,不只是战役文件夹:在战役之外,它什么也不做。战役里有两个小钩子:`rpg --approve` 让主持人使用 RPG Engine 的工具时不必每次都问你,`rpg --listen` 则在你于仪表盘上操作时立刻通知主持人。主持人直接在聊天里画图;如果图像工具出错,就像 Claude 一样,改画简单的矢量图。Antigravity 会保留你过去的聊天,它的记忆无法关闭:主持人已被告知绝不读取这些内容。你写的内容会发送给 Google,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** 部分,在你选择之前全部关闭:可以在每次游玩开始时、每次存档时和每个场景结束时提交(commit),也可以在提交之后推送(push)。提交是战役在那一刻的快照;推送是把快照发送到线上的仓库(比如 GitHub),这样在这台电脑之外也留有一份副本。存档和你与主持人的聊天记录不会进入仓库,除非你允许;只有仓库是私有的,才允许聊天记录进入。
190
+
186
191
  ### 3.9 游玩时段:停下与回来
187
192
 
188
193
  想停就停:*[今晚就到这里吧。]* 一切都已保存在文件里。想回来时,在战役文件夹里启动你的 AI 应用,写 *继续*:主持人会给你一段简短的回顾,然后接着往下玩。
@@ -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
+ **仪表盘链接变了。** 每个战役都有自己的地址,一场聊天接一场聊天都不变。只有当另一个程序已经占用了这个地址时,它才会变:主持人会给你新的链接,之后就一直用这个新链接。同一个战役的第二个聊天会让页面保持在同一个地址,等你关掉第一个聊天后,才会接管这个页面。