rpg-engine 0.19.1 → 0.20.0

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 (150) hide show
  1. package/README.md +9 -6
  2. package/dist/campaign/create-campaign.js +2 -2
  3. package/dist/campaign/find-campaign.d.ts +4 -0
  4. package/dist/campaign/find-campaign.js +5 -1
  5. package/dist/campaign/host-files.js +22 -0
  6. package/dist/campaign/index.d.ts +2 -2
  7. package/dist/campaign/index.js +2 -2
  8. package/dist/campaign/last-choices.d.ts +10 -4
  9. package/dist/campaign/last-choices.js +43 -17
  10. package/dist/campaign/settings.d.ts +10 -2
  11. package/dist/campaign/settings.js +30 -6
  12. package/dist/chats/chat.d.ts +33 -0
  13. package/dist/chats/chat.js +50 -0
  14. package/dist/chats/claude-code.d.ts +5 -0
  15. package/dist/chats/claude-code.js +39 -0
  16. package/dist/chats/codex.d.ts +3 -0
  17. package/dist/chats/codex.js +42 -0
  18. package/dist/chats/index.d.ts +5 -0
  19. package/dist/chats/index.js +12 -0
  20. package/dist/chats/keep.d.ts +10 -0
  21. package/dist/chats/keep.js +50 -0
  22. package/dist/chats/read.d.ts +8 -0
  23. package/dist/chats/read.js +46 -0
  24. package/dist/cli/cli.js +6 -1
  25. package/dist/cli/command-line.js +3 -2
  26. package/dist/commands/book.d.ts +55 -0
  27. package/dist/commands/book.js +105 -0
  28. package/dist/commands/chats.d.ts +38 -0
  29. package/dist/commands/chats.js +93 -0
  30. package/dist/commands/config/config.js +1 -1
  31. package/dist/commands/config/dashboard.d.ts +8 -1
  32. package/dist/commands/config/dashboard.js +63 -15
  33. package/dist/commands/config/words.d.ts +1 -1
  34. package/dist/commands/config/words.js +17 -4
  35. package/dist/commands/find.js +1 -1
  36. package/dist/commands/image.d.ts +9 -0
  37. package/dist/commands/image.js +95 -18
  38. package/dist/commands/index.js +4 -0
  39. package/dist/commands/init.js +3 -3
  40. package/dist/commands/scene/close.d.ts +2 -0
  41. package/dist/commands/scene/close.js +13 -2
  42. package/dist/commands/scene/result.d.ts +2 -0
  43. package/dist/commands/scene/scene.d.ts +2 -0
  44. package/dist/commands/shared/campaign/book.d.ts +29 -0
  45. package/dist/commands/shared/campaign/book.js +95 -0
  46. package/dist/commands/shared/campaign/chats.d.ts +11 -0
  47. package/dist/commands/shared/campaign/chats.js +29 -0
  48. package/dist/commands/shared/campaign/images.js +7 -1
  49. package/dist/commands/shared/campaign/mode.js +3 -1
  50. package/dist/commands/shared/campaign/saves.js +13 -5
  51. package/dist/commands/shared/sheet/sheet.d.ts +7 -0
  52. package/dist/commands/shared/sheet/sheet.js +27 -0
  53. package/dist/commands/status.d.ts +1 -0
  54. package/dist/commands/status.js +4 -0
  55. package/dist/commands/view/page.js +4 -3
  56. package/dist/commands/view/result.d.ts +2 -0
  57. package/dist/commands/view/view.d.ts +1 -0
  58. package/dist/commands/view/view.js +4 -0
  59. package/dist/core/consents.d.ts +2 -2
  60. package/dist/core/consents.js +3 -3
  61. package/dist/core/context.d.ts +38 -2
  62. package/dist/core/download.js +1 -1
  63. package/dist/dashboard/acts/names.js +10 -5
  64. package/dist/dashboard/acts/sending.js +5 -2
  65. package/dist/dashboard/acts/sheet.js +66 -15
  66. package/dist/dashboard/api.js +3 -3
  67. package/dist/dashboard/app.js +2 -2
  68. package/dist/dashboard/guide/ar.md +11 -10
  69. package/dist/dashboard/guide/cs.md +10 -9
  70. package/dist/dashboard/guide/da.md +12 -11
  71. package/dist/dashboard/guide/de.md +12 -11
  72. package/dist/dashboard/guide/el.md +12 -11
  73. package/dist/dashboard/guide/en.md +9 -8
  74. package/dist/dashboard/guide/es.md +10 -9
  75. package/dist/dashboard/guide/fi.md +10 -9
  76. package/dist/dashboard/guide/fr.md +16 -15
  77. package/dist/dashboard/guide/he.md +11 -10
  78. package/dist/dashboard/guide/hi.md +10 -9
  79. package/dist/dashboard/guide/hu.md +14 -13
  80. package/dist/dashboard/guide/is.md +10 -9
  81. package/dist/dashboard/guide/it.md +13 -12
  82. package/dist/dashboard/guide/ja.md +10 -9
  83. package/dist/dashboard/guide/ko.md +11 -10
  84. package/dist/dashboard/guide/nb.md +12 -11
  85. package/dist/dashboard/guide/nl.md +10 -9
  86. package/dist/dashboard/guide/pl.md +11 -10
  87. package/dist/dashboard/guide/pt.md +12 -11
  88. package/dist/dashboard/guide/ro.md +10 -9
  89. package/dist/dashboard/guide/ru.md +12 -11
  90. package/dist/dashboard/guide/sv.md +10 -9
  91. package/dist/dashboard/guide/tr.md +13 -12
  92. package/dist/dashboard/guide/uk.md +13 -12
  93. package/dist/dashboard/guide/zh.md +11 -10
  94. package/dist/dashboard/i18n/ar.json +31 -5
  95. package/dist/dashboard/i18n/cs.json +31 -5
  96. package/dist/dashboard/i18n/da.json +31 -5
  97. package/dist/dashboard/i18n/de.json +31 -5
  98. package/dist/dashboard/i18n/el.json +31 -5
  99. package/dist/dashboard/i18n/es.json +31 -5
  100. package/dist/dashboard/i18n/fi.json +31 -5
  101. package/dist/dashboard/i18n/fr.json +31 -5
  102. package/dist/dashboard/i18n/he.json +31 -5
  103. package/dist/dashboard/i18n/hi.json +31 -5
  104. package/dist/dashboard/i18n/hu.json +31 -5
  105. package/dist/dashboard/i18n/is.json +31 -5
  106. package/dist/dashboard/i18n/it.json +32 -6
  107. package/dist/dashboard/i18n/ja.json +31 -5
  108. package/dist/dashboard/i18n/ko.json +31 -5
  109. package/dist/dashboard/i18n/nb.json +31 -5
  110. package/dist/dashboard/i18n/nl.json +31 -5
  111. package/dist/dashboard/i18n/pl.json +31 -5
  112. package/dist/dashboard/i18n/pt.json +31 -5
  113. package/dist/dashboard/i18n/ro.json +31 -5
  114. package/dist/dashboard/i18n/ru.json +31 -5
  115. package/dist/dashboard/i18n/sv.json +31 -5
  116. package/dist/dashboard/i18n/tr.json +31 -5
  117. package/dist/dashboard/i18n/uk.json +31 -5
  118. package/dist/dashboard/i18n/zh.json +31 -5
  119. package/dist/dashboard/journal/book.js +106 -0
  120. package/dist/dashboard/journal/journal.js +9 -8
  121. package/dist/dashboard/parts/labels.js +6 -0
  122. package/dist/dashboard/parts/widgets.js +1 -1
  123. package/dist/dashboard/place/view.js +1 -1
  124. package/dist/dashboard/settings/settings.js +10 -4
  125. package/dist/dashboard/settings/setup.js +5 -3
  126. package/dist/dashboard/sheet/sheet.js +8 -5
  127. package/dist/dashboard/style.css +459 -96
  128. package/dist/dashboard/world/calendar.js +1 -1
  129. package/dist/dashboard/world/lore.js +1 -1
  130. package/dist/helpers/briefs.d.ts +5 -0
  131. package/dist/helpers/briefs.js +8 -0
  132. package/dist/helpers/chosen.d.ts +8 -2
  133. package/dist/helpers/chosen.js +110 -6
  134. package/dist/helpers/codex.js +2 -1
  135. package/dist/helpers/index.d.ts +2 -2
  136. package/dist/helpers/index.js +2 -2
  137. package/dist/images/images.d.ts +2 -0
  138. package/dist/images/images.js +16 -2
  139. package/dist/images/index.d.ts +1 -1
  140. package/dist/images/index.js +1 -1
  141. package/dist/server/approver.d.ts +6 -0
  142. package/dist/server/approver.js +28 -0
  143. package/dist/server/chats.d.ts +3 -0
  144. package/dist/server/chats.js +27 -0
  145. package/dist/server/dashboard/news.js +36 -5
  146. package/dist/server/mcp.js +37 -6
  147. package/dist/server/player-acts.d.ts +7 -2
  148. package/dist/server/player-acts.js +10 -3
  149. package/instructions/start.md +1 -1
  150. package/package.json +2 -2
@@ -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,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,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,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
2
2
  # RPG Engine: полное руководство
3
3
 
4
4
  **RPG Engine** позволяет играть в настольную ролевую игру с **ИИ в роли мастера**. Ты общаешься с мастером в **чате**, а RPG Engine работает за кулисами: он **помнит мир**, **бросает кубики** и **ведёт учёт**. Рядом с чатом в браузере открыта страница, **панель управления**: на ней лист персонажа, кубики, карты и журнал.
@@ -64,13 +64,14 @@ rpg init "The Salt Isles"
64
64
 
65
65
  ### 2.4 Подключение ИИ
66
66
 
67
- Мастер работает в **ИИ-агенте**. Это приложение с ИИ, в терминале или на компьютере, которое умеет работать с файлами на твоём компьютере, например Claude Code или Codex. Обычного чата вроде claude.ai или ChatGPT или приложения на телефоне недостаточно: мастеру нужен доступ к файлам кампании на твоём компьютере. Каждому агенту нужны свой тариф и свой вход: для Claude Code — платный тариф Claude, для Codex — вход через ChatGPT. Агент устанавливается один раз, со своей страницы: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
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).
68
68
 
69
69
  - **Claude Code**: в папке кампании напиши `claude`. Когда он спросит, доверяешь ли ты этой папке, выбери **Yes, I trust this folder**. Осторожно: заранее выбран другой ответ — *No, exit*. В кампании есть и маленький хук, `rpg --listen`, о котором вопрос не говорит: он сразу сообщает мастеру, когда ты что-то делаешь на дашборде.
70
70
  - **Codex**: в папке кампании напиши `codex` и согласись, когда он спросит, доверяешь ли ты папке. В его приложении для компьютера проверь в настройках, что память отключена для чатов игры.
71
+ - **Antigravity**: в папке кампании напиши `agy` и согласись, если он спросит, доверяешь ли ты папке. В кампании есть маленький хук, `rpg --approve`, который позволяет мастеру пользоваться инструментами RPG Engine без вопроса к тебе каждый раз. Картинки мастер рисует прямо в чате. Antigravity хранит твои прошлые чаты, и его память нельзя отключить: мастеру велено никогда их не читать. Всё, что ты пишешь, уходит в Google, а там это могут читать люди. Не пиши в игре личные данные. RPG Engine — не продукт Google.
71
72
  - **Другой агент**: запусти его в папке кампании и подключи к нему MCP-сервер `rpg mcp`. RPG Engine — стандартный MCP-сервер: мастером может стать любой агент с поддержкой MCP, в том числе локальный.
72
73
 
73
- Мы играем и проверяем на **Claude Code**. **Codex** подключён и проверен, но целую кампанию на нём ещё не проходили. Кампания отключает собственную память агента: игра живёт в её файлах, чтобы возврат к сохранению действительно возвращал назад.
74
+ Мы играем и проверяем на **Claude Code**. **Codex** и **Antigravity** подключены и проверены, но целую кампанию на них ещё не проходили. Кампания отключает собственную память агента: игра живёт в её файлах, чтобы возврат к сохранению действительно возвращал назад.
74
75
 
75
76
  ### 2.5 Первый чат
76
77
 
@@ -126,7 +127,7 @@ rpg init "The Salt Isles"
126
127
 
127
128
  Ты говоришь, что пытаешься сделать. Мастер говорит, что происходит. Мастер никогда не решает за твоего персонажа и никогда не говорит о движке. Можно спросить его, как пользоваться панелью.
128
129
 
129
- **Действия с панели**: нажми на название в листе персонажа, например на оружие, заклинание или предмет, а затем выбери, на кого оно направлено. Можно и нажать на персонажа, чтобы поговорить с ним. Панель сама составит фразу, *Я атакую Бандита в капюшоне 1 булавой.*, и перед нажатием **Сказать мастеру** ты можешь её изменить. Мастер слышит её так, будто ты сказал(а) её в чате, и разбирает как любое другое действие. Если твоё ИИ-приложение не может услышать её само, нажми **Копировать**, и фраза будет готова для вставки в чат.
130
+ **Действия с панели**: нажми на название в листе персонажа, например на оружие, заклинание или предмет, и откроется его карточка с описанием. Выбери, что с ним сделать, например **Использовать**, а затем на кого это направлено: в списке или щелчком по карте. Можно и нажать на персонажа, чтобы поговорить с ним. Панель сама составит фразу, *Я атакую Бандита в капюшоне 1 булавой.*, и перед тем как нажать **Сказать мастеру**, ты можешь её изменить. Мастер слышит её так, будто она сказана в чате, и разбирает как любое другое действие. Если твоё ИИ-приложение не может услышать её само, нажми **Копировать**, и фраза будет готова для вставки в чат.
130
131
 
131
132
  ### 3.2 Броски
132
133
 
@@ -142,7 +143,7 @@ rpg init "The Salt Isles"
142
143
 
143
144
  ### 3.3 Сцены и бои
144
145
 
145
- История идёт **сценами**: бой, разговор, исследование, путешествие, отдых. В конце каждой сцены игра сохраняется сама, а сцена попадает в твой журнал.
146
+ История идёт **сценами**: бой, разговор, исследование, путешествие, отдых. В конце каждой сцены игра сохраняется сама, сцена попадает в твой журнал, а мастер записывает её как главу книги твоей истории.
146
147
 
147
148
  В бою мастер рассказывает обо всех ходах, кроме твоего, и останавливается там, где нужно твоё решение. Вкладка **Сцена** показывает сверху, чей сейчас ход и кто следующий, а рядом с картой лежит карточка твоего персонажа. Порядок ходов, здоровье отряда и то, насколько изранены враги (словами), остаются сбоку страницы. Если твой персонаж падает, спасброски от смерти появляются на странице крупно.
148
149
 
@@ -158,11 +159,11 @@ RPG Engine ведёт календарь. Между сессиями игров
158
159
 
159
160
  Вкладка **Мир** показывает места, которые знает твой персонаж, дороги между ними и пройденный путь. Остальное скрыто туманом. Вкладка **Сцена** показывает карту места, где ты находишься, если она есть, и кто где стоит. В бою, на твоём ходу, недоступные клетки закрыты завесой. Когда мастер спрашивает, куда ты идёшь, коснись клетки или напиши её, например *E4*.
160
161
 
161
- Вкладка **Мир** хранит и всё, что знает твой персонаж. В **Знаниях** собраны люди, места, фракции, существа и истории, о которых он знает, и всё так, как знает он: ищи по ним или открывай любую запись, чтобы прочитать целиком. Имя в тексте ведёт на свою страницу. В **Документах** лежат найденные письма, объявления и страницы, чтобы перечитать их. **Календарь** показывает сегодняшний день, сроки твоих заданий с оставшимся временем и дни истории. День со сценами ведёт к своим главам в Журнале.
162
+ **Мир** хранит и всё, что знает твой персонаж. В **Знаниях** собраны люди, места, фракции, существа и истории, о которых он знает, и всё так, как знает он: ищи по ним или открывай любую запись, чтобы прочитать целиком. Имя в тексте ведёт на свою страницу. В **Документах** лежат найденные письма, объявления и страницы, чтобы перечитать их. **Календарь** показывает сегодняшний день, сроки твоих заданий с оставшимся временем и дни истории. День со сценами ведёт к ним в **Хронологии** Журнала.
162
163
 
163
164
  ### 3.6 Задания, журнал и заметки
164
165
 
165
- Задача, которую берёт твой персонаж, становится заданием в **Журнале**: с целями, сроком и тем, что оно измеряет. Отметь его звёздочкой, и оно останется на виду вверху вкладки «Сцена». Журнал также рассказывает твою **историю** по сценам и хранит твои **заметки**. Они личные, пока ты не нажмёшь **Поделиться**: тогда мастер услышит заметку как то, что ты думаешь, но не как факт. В разделе **Спутники** можно прочитать дневники спутников: время от времени, в конце дня или задания, они пишут несколько строк о том, что думают и чувствуют.
166
+ Задача, которую берёт твой персонаж, становится заданием в **Журнале**: с целями, сроком и тем, что оно измеряет. Отметь его звёздочкой, и оно останется на виду вверху **Сцены**. В разделе **История** журнал рассказывает твою историю как книгу: когда сцена заканчивается, мастер пишет для неё главу прозой в выбранном тобой стиле. Читай главу за главой, последняя отмечена закладкой. Книгу можно скачать как Markdown или как веб-страницу, чтобы распечатать или передать другим. Если игра началась раньше, попроси мастера написать историю до этого момента. **Хронология** перечисляет сцены с тем, что произошло в каждой. В Журнале также хранятся твои **заметки**: они личные, пока ты не нажмёшь **Поделиться**. Тогда мастер услышит заметку как то, что ты думаешь, но не как факт. В разделе **Спутники** можно прочитать дневники спутников: время от времени, в конце дня или задания, они пишут несколько строк о том, что думают и чувствуют.
166
167
 
167
168
  ### 3.7 История и портрет персонажа
168
169
 
@@ -208,12 +209,12 @@ RPG Engine умеет создавать картинки мест, до кот
208
209
 
209
210
  Страница на твоём компьютере. Она открывается только в браузере этого компьютера и работает, пока открыт чат. Когда чат закрывается, на ней появляется надпись *Not connected*. С новым чатом страница подключается сама.
210
211
 
211
- - **Отряд**: твой лист персонажа и листы спутников. Нажми на число, чтобы сделать бросок. Наведи на него курсор, чтобы увидеть, откуда оно берётся. Если у кубика числа есть стрелка, будет видно, что улучшает или ухудшает бросок. Когда мастер готовит для тебя выбор, например при получении нового уровня, на листе появляется уведомление, которое открывает этот выбор. Выбирай, когда удобно: прочитай страницы, на которые указывают варианты, сделай бросок там, где его требует вариант, и подтверди выбор. История тем временем продолжается. Рядом показаны броски.
212
+ - **Отряд**: твой лист персонажа и листы спутников. Нажми на число, чтобы сделать бросок. Наведи на него курсор, чтобы увидеть, откуда оно берётся. Если у кубика стоит стрелка, будет видно, что улучшает или ухудшает бросок. Когда мастер готовит для тебя выбор, например при получении нового уровня, на листе появляется уведомление, которое открывает этот выбор. Выбирай, когда удобно: прочитай страницы, на которые указывают варианты, сделай бросок там, где его требует вариант, и подтверди выбор. История тем временем продолжается. Рядом показаны броски.
212
213
  - **Сцена**: где ты находишься, картинка и карта места, кто рядом, что происходит. В бою здесь видны ходы и карточка твоего персонажа.
213
- - **Журнал**: задания, история, дневники спутников, твои заметки.
214
+ - **Журнал**: задания, история как книга, хронология, дневники спутников, твои заметки.
214
215
  - **Мир**: карта мира, то, что известно твоему персонажу, найденные документы и календарь.
215
216
  - **Лоток для кубиков**: выбери кубики и модификатор, затем брось их. Кнопка ×2 удваивает кубики, но не модификатор, как при критическом попадании.
216
- - **Сохранения**, **Справка**, **Настройки** и **О программе**: значки в конце ряда. В настройках также есть параметры самой страницы: тема, звук кубиков, набор кубиков.
217
+ - **Сохранения**, **Справка**, **Настройки** и **О программе**: значки в конце ряда. В Настройках также есть параметры самой страницы: тема, звук кубиков, набор кубиков.
217
218
 
218
219
  Когда мастер задаёт тебе вопрос, его баннер остаётся вверху, в каком бы разделе ты ни был.
219
220
 
@@ -271,7 +272,7 @@ RPG Engine умеет создавать картинки мест, до кот
271
272
 
272
273
  ## 8. Для любопытных: папка кампании <!-- icon: list -->
273
274
 
274
- Открывать её тебе никогда не нужно. В ней хранятся секреты твоей кампании. В ней лежат `campaign.yaml` (твои настройки), `state.yaml` (текущее состояние игры), `world/` (по одной markdown-странице для каждого персонажа, места, задания и всего остального), `rules/` (твои домашние правила), `images/`, `log.jsonl` (каждое изменение), `.saves/`, `.player/` (твои заметки) и маленькие файлы, которые подсказывают ИИ-агентам, где находится RPG Engine. Страницы написаны в формате Obsidian. Если ты изменишь страницу вручную, мастер узнает об этом при следующем ответе.
275
+ Открывать её тебе никогда не нужно. В ней хранятся секреты твоей кампании. В ней лежат `campaign.yaml` (твои настройки), `state.yaml` (текущее состояние игры), `world/` (по одной markdown-странице для каждого персонажа, места, задания и всего остального), `rules/` (твои домашние правила), `images/`, `log.jsonl` (каждое изменение), `sessions/` (твои чаты с мастером в виде текста, из Claude Code и Codex), `.saves/`, `.player/` (твои заметки) и маленькие файлы, которые подсказывают ИИ-агентам, где находится RPG Engine. Страницы написаны в формате Obsidian. Если ты изменишь страницу вручную, мастер узнает об этом при следующем ответе.
275
276
 
276
277
  RPG Engine работает только в этой папке: читает и записывает игру лишь здесь и никогда не трогает другие твои файлы. Папки с твоими руководствами он только читает. Вне кампании он хранит лишь собственные папки с данными (переводы панели, текст, прочитанный из твоих руководств, а также Codex или Claude Code, если ты разрешишь их установить) и временные папки на время, пока рисуется картинка. Всё остальное, что агент захочет сделать на твоём компьютере, он сначала спросит у тебя. Игровая система или расширение — это код, как и любой пакет npm. Пакет не от нас работает на твоём компьютере с твоими правами, и RPG Engine устанавливает его только с твоего «да», в форме у твоего агента или в окне компьютера. Говори «да» только пакетам, чьим авторам доверяешь.
277
278
 
@@ -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,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,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,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. 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,14 @@ 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 eller Codex. 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. 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).
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).
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
72
  - **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.
72
73
 
73
- Vi spelar och testar med **Claude Code**. **Codex** är ansluten och kontrollerad, men ingen hel kampanj har ännu spelats med den. 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.
74
+ 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.
74
75
 
75
76
  ### 2.5 Den första chatten
76
77
 
@@ -126,7 +127,7 @@ Skriv inom hakparenteser när du pratar utanför berättelsen: *[Hur fungerar br
126
127
 
127
128
  Du säger vad du försöker göra. Spelledaren säger vad som händer. Spelledaren bestämmer aldrig något åt din rollperson och pratar aldrig om motorn. Du kan fråga spelledaren hur du använder dashboarden.
128
129
 
129
- **Agera från dashboarden**: klicka på ett namn på ditt rollformulär, till exempel ett vapen, en besvärjelse eller något du bär på. Välj sedan vem det gäller. Du kan också klicka på en person för att prata med den. Dashboarden skriver din mening, *Jag attackerar Hooded Bandit 1 med Mace.*, och du kan ändra den innan du väljer **Säg till spelledaren**. Spelledaren hör den som om den sagts i chatten och dömer den som vilken annan handling som helst. Där din AI-app inte kan höra den själv gör **Kopiera** den klar att klistra in i chatten.
130
+ **Agera från dashboarden**: klicka på ett namn på ditt rollformulär, till exempel ett vapen, en besvärjelse eller något du bär på. Kortet säger vad det är. Välj vad du gör med det, till exempel **Använd**, och sedan vem det gäller, i listan eller med ett klick på kartan. Du kan också klicka på en person för att prata med den. Dashboarden skriver din mening, *Jag attackerar Hooded Bandit 1 med Mace.*, och du kan ändra den innan du väljer **Säg till spelledaren**. Spelledaren hör den som om den sagts i chatten och dömer den som vilken annan handling som helst. Där din AI-app inte kan höra den själv gör **Kopiera** den klar att klistra in i chatten.
130
131
 
131
132
  ### 3.2 Slag
132
133
 
@@ -142,7 +143,7 @@ Spelledaren ber om ett slag bara när utgången är osäker och spelar roll. Fö
142
143
 
143
144
  ### 3.3 Scener och strider
144
145
 
145
- Berättelsen går i **scener**: en strid, ett samtal, utforskning, resa eller vila. I slutet av varje scen sparas spelet av sig självt, och scenen hamnar i din dagbok.
146
+ Berättelsen går i **scener**: en strid, ett samtal, utforskning, resa eller vila. I slutet av varje scen sparas spelet av sig självt, scenen hamnar i din dagbok, och spelledaren skriver den som ett kapitel i din berättelses bok.
146
147
 
147
148
  I en strid berättar spelledaren varje tur som inte är din, och stannar där du kan bestämma. **Scen** visar högst upp vems tur det är och vem som kommer härnäst, och din rollpersons kort bredvid kartan. Turordningen, gruppens träffpoäng och hur skadade fienderna ser ut, i ord, står kvar bredvid sidan. Om din rollperson faller visas dödsslagen stort på sidan.
148
149
 
@@ -158,11 +159,11 @@ Skurkar har planer med tidsfrister. Varje ny dag flyttar spelledaren fram de hot
158
159
 
159
160
  **Värld** visar de platser din rollperson känner till, vägarna mellan dem och spåret du har gått, med dimma över resten. **Scen** visar kartan över platsen där du är, när det finns en, och vem som står var. I en strid, på din tur, är de rutor du inte kan nå dolda. När spelledaren frågar vart du går, tryck på en ruta eller skriv den, till exempel *E4*.
160
161
 
161
- **Värld** rymmer också det din rollperson vet. **Kunskap** listar de personer, platser, fraktioner, varelser och berättelser som rollpersonen känner till, var och en så som rollpersonen känner till den. Sök i listan, eller öppna en post för att läsa den helt. Ett namn i texten leder till sin sida. **Dokument** sparar breven, kungörelserna och sidorna som rollpersonen hittade, så att du kan läsa dem igen. **Kalender** visar dagens datum, dina uppdrags tidsfrister med tiden som är kvar, och berättelsens dagar. En dag med scener leder till sina kapitel i dagboken.
162
+ **Värld** rymmer också det din rollperson vet. **Kunskap** listar de personer, platser, fraktioner, varelser och berättelser som rollpersonen känner till, var och en så som rollpersonen känner till den. Sök i listan, eller öppna en post för att läsa den helt. Ett namn i texten leder till sin sida. **Dokument** sparar breven, kungörelserna och sidorna som rollpersonen hittade, så att du kan läsa dem igen. **Kalender** visar dagens datum, dina uppdrags tidsfrister med tiden som är kvar, och berättelsens dagar. En dag med scener leder till dem i dagbokens tidslinje.
162
163
 
163
164
  ### 3.6 Uppdrag, dagbok och anteckningar
164
165
 
165
- En uppgift som din rollperson tar sig an blir ett uppdrag i **Dagbok**, med sina mål, sin tidsfrist och det den mäter. Stjärnmärk det för att ha det i sikte högst upp i Scen. Dagboken berättar också din **berättelse**, scen för scen, och sparar dina **anteckningar**. De är privata, om du inte väljer **Dela** för en av dem. Spelledaren hör den då som något du tänker, aldrig som ett faktum. Under **Följeslagare** läser du dina följeslagares dagböcker. Då och då, i slutet av en dag eller ett uppdrag, skriver de några rader om vad de tänker och känner.
166
+ En uppgift som din rollperson tar sig an blir ett uppdrag i **Dagbok**, med sina mål, sin tidsfrist och det den mäter. Stjärnmärk det för att ha det i sikte högst upp i **Scen**. Under **Berättelse** berättar dagboken din berättelse som en bok: spelledaren skriver ett kapitel i prosa för varje scen när den är slut, i den stil du har valt. Läs den kapitel för kapitel, där det senaste är markerat med sitt bokmärke, och ladda ner den som Markdown eller som en webbsida att skriva ut eller dela vidare. I ett spel som du började på tidigare ber du spelledaren skriva berättelsen hittills. **Tidslinje** listar scenerna med det som hände i var och en. Dagboken sparar också dina **Anteckningar**: de är privata, om du inte väljer **Dela** för en av dem. Spelledaren hör den då som något du tänker, aldrig som ett faktum. Under **Följeslagare** läser du dina följeslagares dagböcker. Då och då, i slutet av en dag eller ett uppdrag, skriver de några rader om vad de tänker och känner.
166
167
 
167
168
  ### 3.7 Din rollpersons historia och bild
168
169
 
@@ -210,7 +211,7 @@ En sida på din egen dator. Den öppnas bara i webbläsaren på den datorn och
210
211
 
211
212
  - **Grupp**: ditt rollformulär och dina följeslagares. Klicka på ett tal för att slå det. Håll muspekaren över det för att se var det kommer ifrån och, när en pil markerar tärningen, vad som gör slaget bättre eller sämre. När spelledaren förbereder val åt dig, till exempel vid en ny nivå, öppnar du dem med en notis på rollformuläret. Välj när du vill, läs de sidor som alternativen nämner, slå där ett alternativ kräver slag och bekräfta sedan. Berättelsen fortsätter under tiden. Bredvid ser du slagen.
212
213
  - **Scen**: var du är, dess bild och karta, vem som är där och vad som händer. I en strid visas turerna och din rollpersons kort.
213
- - **Dagbok**: uppdrag, berättelsen, dina följeslagares dagböcker och dina anteckningar.
214
+ - **Dagbok**: uppdrag, berättelsen som en bok, dess tidslinje, dina följeslagares dagböcker och dina anteckningar.
214
215
  - **Värld**: världskartan, det din rollperson vet, de dokument som hittats och kalendern.
215
216
  - **Tärningsbrickan**: välj tärningar och en modifikation, och slå; ×2 fördubblar tärningarna, aldrig modifikationen, som vid en kritisk träff.
216
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 och tärningsset.
@@ -271,7 +272,7 @@ Ett språk per kampanj, spelledarens, som dashboarden följer. Dashboarden lever
271
272
 
272
273
  ## 8. För de nyfikna: kampanjmappen <!-- icon: list -->
273
274
 
274
- Du behöver aldrig öppna den, och den innehåller kampanjens hemligheter. Där finns `campaign.yaml` (dina inställningar), `state.yaml` (hur spelet står), `world/` (en markdownsida för varje rollperson, plats, uppdrag och allt annat), `rules/` (dina husregler), `images/`, `log.jsonl` (varje ändring), `.saves/`, `.player/` (dina anteckningar) och de små filerna som talar om för AI-agenter var RPG Engine finns. Sidorna använder Obsidians format. Om du ändrar en sida för hand får spelledaren veta det vid sitt nästa svar.
275
+ Du behöver aldrig öppna den, och den innehåller kampanjens hemligheter. Där finns `campaign.yaml` (dina inställningar), `state.yaml` (hur spelet står), `world/` (en markdownsida för varje rollperson, plats, uppdrag och allt annat), `rules/` (dina husregler), `images/`, `log.jsonl` (varje ändring), `sessions/` (dina chattar med spelledaren som text, från Claude Code och Codex), `.saves/`, `.player/` (dina anteckningar) och de små filerna som talar om för AI-agenter var RPG Engine finns. Sidorna använder Obsidians format. Om du ändrar en sida för hand får spelledaren veta det vid sitt nästa svar.
275
276
 
276
277
  RPG Engine stannar i den här mappen: det läser och skriver spelet bara här och rör aldrig dina andra filer. Mapparna med dina regelböcker läser det bara. Utanför mappen sparar det bara egna datamappar (instrumentpanelens översättningar, texten det har läst ur dina regelböcker, samt Codex eller Claude Code om du låter det installera dem) och tillfälliga mappar medan en bild ritas. Allt annat som din agent vill göra på din dator frågar den dig om först. Ett spelsystem eller ett tillägg är kod, som varje npm-paket: ett som inte är vårt körs på din dator med dina behörigheter, och RPG Engine installerar det bara med ditt ja, i ett formulär från din agent eller i ett fönster på din dator. Säg bara ja till paket vars upphovspersoner du litar på.
277
278
 
@@ -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,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,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,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. 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,14 @@ 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 ve Codex 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. Ajanı kendi sayfasından bir kez kurarsın: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
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).
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; panodan 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; dashboard'dan 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
72
  - **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.
72
73
 
73
- Biz **Claude Code** ile oynuyor ve test ediyoruz. **Codex** bağlı ve kontrol edildi, ama onunla 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.
74
+ 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.
74
75
 
75
76
  ### 2.5 İlk sohbet
76
77
 
@@ -126,7 +127,7 @@ Hikâyenin dışına çıkmak için köşeli parantez kullan: *[Tutuşma nasıl
126
127
 
127
128
  Sen neyi denediğini söylersin, ne olacağını oyun yöneticisi söyler. Oyun yöneticisi karakterin adına asla karar vermez ve motordan asla söz etmez. Gösterge panelini nasıl kullanacağını ona sorabilirsin.
128
129
 
129
- **Gösterge panelinden eylem yapmak**: karakter kağıdındaki bir ada tıkla; bu bir silah, bir büyü ya da taşıdığın bir şey olabilir. Sonra kimin için olduğunu seç. Biriyle konuşmak için de kişiye tıklayabilirsin. Gösterge paneli cümleni yazar, örneğin *Kapüşonlu Haydut 1'e Gürz ile saldırıyorum.* **Oyun yöneticisine söyle**'ye basmadan önce cümleyi değiştirebilirsin. Oyun yöneticisi bunu sohbette söylenmiş gibi duyar ve diğer her şey gibi karara bağlar. Yapay zekâ uygulaman cümleyi kendi başına duyamıyorsa **Kopyala** cümleyi sohbete yapıştırmaya hazırlar.
130
+ **Gösterge panelinden eylem yapmak**: Karakter kağıdındaki bir ada tıkla; bu bir silah, bir büyü ya da taşıdığın bir şey olabilir. Kartı bunun ne olduğunu söyler. Onunla ne yapacağını seç, örneğin **Kullan**. Sonra kimin için olduğunu listeden ya da haritaya tıklayarak seç. Biriyle konuşmak için de kişiye tıklayabilirsin. Gösterge paneli cümleni yazar, örneğin *Kapüşonlu Haydut 1'e Gürz ile saldırıyorum.* **Oyun yöneticisine söyle**'ye basmadan önce cümleyi değiştirebilirsin. Oyun yöneticisi bunu sohbette söylenmiş gibi duyar ve diğer her şey gibi karara bağlar. Yapay zekâ uygulaman cümleyi kendi başına duyamıyorsa **Kopyala** cümleyi sohbete yapıştırmaya hazırlar.
130
131
 
131
132
  ### 3.2 Atışlar
132
133
 
@@ -142,7 +143,7 @@ Oyun yöneticisi atış istemeyi yalnızca sonuç belirsizse ve önemliyse yapar
142
143
 
143
144
  ### 3.3 Sahneler ve çatışmalar
144
145
 
145
- Hikâye **sahneler** halinde ilerler: bir çatışma, bir konuşma, keşif, yolculuk, bir dinlenme. Her sahnenin sonunda oyun kendiliğinden kaydeder ve sahne günlüğüne girer.
146
+ Hikâye **sahneler** halinde ilerler: bir çatışma, bir konuşma, keşif, yolculuk, bir dinlenme. Her sahnenin sonunda oyun kendiliğinden kaydeder, sahne günlüğüne girer ve oyun yöneticisi onu hikâyenin kitabına bir bölüm olarak yazar.
146
147
 
147
148
  Bir çatışmada, sırası sende olmayan her sırayı oyun yöneticisi anlatır ve karar verebileceğin yerde durur. **Sahne** üstte sırasının kimde olduğunu ve sonra kimin geldiğini, haritanın yanında da karakterinin kartını gösterir. Sıraların düzeni, grubunun can puanları ve düşmanların ne kadar yaralı göründüğü ise sözcüklerle sayfanın yanında durur. Karakterin düşerse ölüm kurtarmaları sayfada büyük görünür.
148
149
 
@@ -158,11 +159,11 @@ Kötülerin son tarihli planları vardır. Her yeni günde oyun yöneticisi, zam
158
159
 
159
160
  **Dünya**, karakterinin bildiği yerleri, aralarındaki yolları ve yürüdüğün izi gösterir; gerisi sisle örtülüdür. **Sahne**, bulunduğun yerin haritasını, varsa, kimin nerede durduğuyla birlikte gösterir. Çatışmada, sıran geldiğinde ulaşamayacağın kareler örtülür. Oyun yöneticisi nereye gideceğini sorduğunda bir kareye dokun ya da *E4* gibi yaz.
160
161
 
161
- **Dünya** ayrıca karakterinin bildiklerini de tutar. **Bilgiler**, karakterin tanıdığı kişileri, yerleri, hizipleri, yaratıkları ve hikâyeleri listeler; her biri karakterin bildiği haliyle yazılır. İçinde arama yapabilir ya da birini açıp tamamını okuyabilirsin. Metindeki bir ad, kendi sayfasına götürür. **Belgeler**, bulunan mektupları, duyuruları ve sayfaları tekrar okuman için saklar. **Takvim** bugünü, görevlerinin kalan süreyle birlikte son tarihlerini ve hikâyenin günlerini gösterir. Sahnesi olan bir gün, Günlük'teki bölümlerine götürür.
162
+ **Dünya** ayrıca karakterinin bildiklerini de tutar. **Bilgiler**, karakterin tanıdığı kişileri, yerleri, hizipleri, yaratıkları ve hikâyeleri listeler; her biri karakterin bildiği haliyle yazılır. İçinde arama yapabilir ya da birini açıp tamamını okuyabilirsin. Metindeki bir ad, kendi sayfasına götürür. **Belgeler**, bulunan mektupları, duyuruları ve sayfaları tekrar okuman için saklar. **Takvim** bugünü, görevlerinin kalan süreyle birlikte son tarihlerini ve hikâyenin günlerini gösterir. Sahnesi olan bir gün, seni Günlük'teki zaman çizelgesinde o sahnelere götürür.
162
163
 
163
164
  ### 3.6 Görevler, günlük ve notlar
164
165
 
165
- Karakterinin üstlendiği bir iş, **Günlük**'te hedefleri, son tarihi ve neyi ölçtüğüyle bir görev olur. Görünür kalması için yıldızla; Sahne'nin en üstünde durur. Günlük ayrıca **hikâyeni** sahne sahne anlatır ve **notlarını** tutar. Notlar özeldir; bir notu **Paylaş**mazsan oyun yöneticisi onu görmez. Paylaşırsan oyun yöneticisi bunu senin düşüncen olarak duyar, asla bir gerçek olarak değil. **Yoldaşlar** altında yoldaşlarının günlüklerini okursun: arada bir, bir günün ya da görevin sonunda, düşündükleri ve hissettikleri hakkında birkaç satır yazarlar.
166
+ Karakterinin üstlendiği bir iş, **Günlük**'te hedefleri, son tarihi ve neyi ölçtüğüyle bir görev olur. Sahne'nin en üstünde görünür kalması için görevi yıldızla. **Hikâye** altında Günlük, hikâyeni bir kitap gibi anlatır: oyun yöneticisi her sahne bitince seçtiğin üslupla düzyazı bir bölüm yazar. Bölüm bölüm oku; sonuncusu yer imiyle işaretlidir. Hikâyeyi Markdown olarak ya da yazdırmak veya paylaşmak için web sayfası olarak indirebilirsin. Daha önce başlamış bir oyunda oyun yöneticisinden şimdiye kadarki hikâyeyi yazmasını iste. **Zaman çizelgesi**, sahneleri her birinde olanlarla listeler. Günlük, **Notlar**'ı da tutar. Notlar özeldir; bir notu **Paylaş**ırsan oyun yöneticisi bunu senin düşüncen olarak duyar, asla bir gerçek olarak değil. **Yoldaşlar** altında yoldaşlarının günlüklerini okursun: arada bir, bir günün ya da görevin sonunda, düşündükleri ve hissettikleri hakkında birkaç satır yazarlar.
166
167
 
167
168
  ### 3.7 Karakterinin hikâyesi ve resmi
168
169
 
@@ -208,11 +209,11 @@ Her ayar değiştirilebilir, sohbette ya da **Ayarlar**'da. Oyun yöneticisinin
208
209
 
209
210
  Kendi bilgisayarındaki bir sayfa. Yalnızca o bilgisayarın tarayıcısında açılır ve sohbet açık olduğu sürece canlıdır. Sohbet kapanınca *Bağlı değil* yazar. Bir sonraki sohbetle kendiliğinden geri gelir.
210
211
 
211
- - **Grup**: senin karakter kağıdın ve yoldaşlarınınkiler. Bir sayıya tıklayarak onu atabilirsin. Üzerine gelirsen sayının nereden geldiğini görürsün. Bir ok zarını işaretliyorsa atışı neyin iyileştirdiğini ya da kötüleştirdiğini de görürsün. Oyun yöneticisi sana seçimler hazırladığında, örneğin yeni bir seviyede, karakter kağıdındaki bir bildirim bunları açar. İstediğin zaman seç, seçeneklerin adını verdiği sayfaları oku, bir seçenek atış istiyorsa at, sonra onayla. Hikâye bu sırada devam eder. Yanında atışlar yer alır.
212
+ - **Grup**: senin karakter kağıdın ve yoldaşlarınınkiler. Bir sayıya tıklayarak onu at; üzerine gelirsen sayının nereden geldiğini görürsün. Bir ok zarını işaretliyorsa atışı neyin iyileştirdiğini ya da kötüleştirdiğini de görürsün. Oyun yöneticisi sana seçimler hazırladığında, örneğin yeni bir seviyede, karakter kağıdındaki bir bildirim bunları açar. İstediğin zaman seç, seçeneklerin adını verdiği sayfaları oku, bir seçenek atış istiyorsa at, sonra onayla. Hikâye bu sırada devam eder. Yanında atışlar yer alır.
212
213
  - **Sahne**: bulunduğun yer, resmi ve haritası, orada kimlerin olduğu, neler olduğu. Çatışmada sıralar ve karakterinin kartı da burada görünür.
213
- - **Günlük**: görevler, hikâye, yoldaşlarının günlükleri, notların.
214
+ - **Günlük**: görevler, kitap olarak hikâye, zaman çizelgesi, yoldaşlarının günlükleri, notların.
214
215
  - **Dünya**: dünya haritası, karakterinin bildikleri, bulunan belgeler ve takvim.
215
- - **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.
216
+ - **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.
216
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.
217
218
 
218
219
  Oyun yöneticisi sana bir şey sorduğunda, afişi hangi bölümde olursan ol en üstte kalır.
@@ -271,7 +272,7 @@ Kampanya başına tek dil vardır: oyun yöneticisinin dili; panel onu izler. Pa
271
272
 
272
273
  ## 8. Merak edenler için: kampanya klasörü <!-- icon: list -->
273
274
 
274
- Onu açman gerekmez. Kampanyanın sırlarını da içerir. İçinde şunlar var: `campaign.yaml` (ayarların), `state.yaml` (oyunun geldiği yer), `world/` (her karakter, yer, görev ve diğerleri için birer markdown sayfası), `rules/` (ev kuralların), `images/`, `log.jsonl` (her değişiklik), `.saves/`, `.player/` (notların) ve yapay zekâ ajanlarına RPG Engine'in nerede olduğunu söyleyen küçük dosyalar. Sayfalar Obsidian biçimini kullanır. Bir sayfayı elle değiştirirsen oyun yöneticisi bunu bir sonraki cevabında öğrenir.
275
+ Onu açman hiç gerekmez; kampanyanın sırlarını içerir. İçinde şunlar var: `campaign.yaml` (ayarların), `state.yaml` (oyunun geldiği yer), `world/` (her karakter, yer, görev ve diğerleri için birer markdown sayfası), `rules/` (ev kuralların), `images/`, `log.jsonl` (her değişiklik), `sessions/` (oyun yöneticisiyle sohbetlerin metin olarak, Claude Code ve Codex'ten), `.saves/`, `.player/` (notların) ve yapay zekâ ajanlarına RPG Engine'in nerede olduğunu söyleyen küçük dosyalar. Sayfalar Obsidian biçimini kullanır. Bir sayfayı elle değiştirirsen oyun yöneticisi bunu bir sonraki cevabında öğrenir.
275
276
 
276
277
  RPG Engine bu klasörde kalır. Oyunu yalnızca burada okur ve yazar, diğer dosyalarına hiç dokunmaz. Kılavuzlarının klasörlerini ise yalnızca okur. Bunun dışında yalnızca kendi veri klasörlerini tutar (panonun çevirileri, kılavuzlarından okuduğu metin, izin verirsen kurduğu Codex veya Claude Code) ve bir resim çizilirken geçici klasörler kullanır. Ajanının bilgisayarında yapmak istediği başka her şey için önce sana sorar. Bir oyun sistemi ya da eklenti koddur, her npm paketi gibi. Bizim olmayan bir paket bilgisayarında senin izinlerinle çalışır. RPG Engine onu yalnızca senin evetinle kurar. Bu onayı ajanının bir formunda ya da bilgisayarının bir penceresinde verirsin. Yalnızca yazarlarına güvendiğin paketlere evet de.
277
278
 
@@ -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,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,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,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
2
2
  # RPG Engine: повний посібник
3
3
 
4
4
  **RPG Engine** дає змогу грати в настільну рольову гру, де **майстром є ШІ**. Ти спілкуєшся з майстром у **чаті**, а RPG Engine працює за лаштунками: він **пам'ятає світ**, **кидає кубики** і **веде облік**. Поруч із чатом у браузері відкрита сторінка, **панель керування**, де є твій аркуш персонажа, кубики, мапи та журнал.
@@ -64,13 +64,14 @@ rpg init "The Salt Isles"
64
64
 
65
65
  ### 2.4 Підключення ШІ
66
66
 
67
- Майстер працює в **ШІ-агенті**: це застосунок зі ШІ, в терміналі або на робочому столі, який уміє працювати з файлами на твоєму комп'ютері, наприклад Claude Code або Codex. Звичайного чату на кшталт claude.ai чи ChatGPT або застосунку на телефоні недостатньо: майстрові потрібен доступ до файлів кампанії на твоєму комп'ютері. Кожен агент потребує свого тарифу й входу в обліковий запис: Claude Code потребує платного тарифу Claude, Codex потребує входу через ChatGPT. Встановлюєш його один раз, зі сторінки самого агента: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
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).
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
72
  - **Інший агент**: запусти його в папці кампанії й підключи до нього MCP-сервер `rpg mcp`. RPG Engine — це стандартний MCP-сервер: майстром може стати будь-який агент, що підтримує MCP, зокрема локальні.
72
73
 
73
- Ми граємо й тестуємо з **Claude Code**. **Codex** підключено й перевірено, але цілої кампанії з ним ще не зіграно. Кампанія вимикає власну пам'ять агента: гра живе в його файлах, тож повернення до збереження справді повертає назад.
74
+ Ми граємо й тестуємо з **Claude Code**. **Codex** і **Antigravity** підключено й перевірено, але цілої кампанії з ними ще не зіграно. Кампанія вимикає власну пам'ять агента: гра живе в його файлах, тож повернення до збереження справді повертає назад.
74
75
 
75
76
  ### 2.5 Перший чат
76
77
 
@@ -126,7 +127,7 @@ rpg init "The Salt Isles"
126
127
 
127
128
  Ти кажеш, що пробуєш зробити, а майстер каже, що відбувається. Майстер ніколи не вирішує за твого персонажа і ніколи не говорить про рушій гри. Можеш питати в майстра, як користуватися дашбордом.
128
129
 
129
- **Дії з дашборда**: клацни на назву в аркуші персонажа, наприклад на зброю, заклинання чи річ, яку носиш, а потім обери, на кого це спрямовано. Або клацни на особу, з якою хочеш поговорити. Дашборд складе твоє речення, *Я атакую Бандита в каптурі 1 булавою.*, і ти зможеш його змінити перед тим, як натиснеш **Сказати майстру**. Майстер сприймає його так, ніби ти сказав(ла) його в чаті, і розглядає як будь-яку іншу дію. Якщо твій застосунок з ШІ не може почути його сам, **Копіювати** підготує речення, щоб вставити його в чат.
130
+ **Дії з дашборда**: клацни на назву в аркуші персонажа, наприклад на зброю, заклинання чи річ, яку носиш: її картка пояснює, що це. Обери, що з нею робити, наприклад **Використати**, а потім на кого це спрямовано: у списку або клацанням на мапі. Або клацни на особу, з якою хочеш поговорити. Дашборд складе твоє речення, *Я атакую Бандита в каптурі 1 булавою.*, і його можна змінити, перш ніж натиснути **Сказати майстру**. Майстер сприймає його так, ніби його написано в чаті, і розглядає як будь-яку іншу дію. Якщо застосунок з ШІ не може отримати речення сам, **Копіювати** підготує його, щоб вставити в чат.
130
131
 
131
132
  ### 3.2 Кидки
132
133
 
@@ -142,7 +143,7 @@ rpg init "The Salt Isles"
142
143
 
143
144
  ### 3.3 Сцени та бої
144
145
 
145
- Історія розгортається в **сценах**: бій, розмова, дослідження, подорож, відпочинок. Наприкінці кожної сцени гра зберігається сама, а сцена потрапляє до твого журналу.
146
+ Історія розгортається в **сценах**: бій, розмова, дослідження, подорож, відпочинок. Наприкінці кожної сцени гра зберігається сама, сцена потрапляє до твого журналу, а майстер записує її як розділ книжки твоєї історії.
146
147
 
147
148
  У бою майстер розповідає про кожен хід, що не належить тобі, і зупиняється там, де ти можеш вирішувати. **Сцена** показує вгорі, чий зараз хід і хто йде наступним, а картка твого персонажа лежить біля мапи. Порядок ходів, очки здоров'я твого загону та те, наскільки поранені вороги (словами), залишаються збоку сторінки. Якщо твій персонаж падає, на сторінці з'являються великі кидки проти смерті.
148
149
 
@@ -158,11 +159,11 @@ RPG Engine веде дату. Між сесіями ігровий час не
158
159
 
159
160
  **Світ** показує місця, які знає твій персонаж, дороги між ними та пройдений шлях, а решту вкриває туман. **Сцена** показує мапу місця, де ти перебуваєш, якщо вона є, і хто де стоїть. У бою, на твій хід, клітинки, до яких не дістатися, затінені. Коли майстер питає, куди ти йдеш, торкнись клітинки або напиши її, наприклад *E4*.
160
161
 
161
- **Світ** також зберігає те, що знає твій персонаж. **Знання** перелічують людей, місця, угруповання, істот та історії, які він знає, кожне так, як він це знає: шукай у них або відкрий запис, щоб прочитати повністю. Ім'я в тексті веде на його сторінку. **Документи** зберігають листи, оголошення та сторінки, які знайдено, щоб перечитати їх. **Календар** показує сьогодні, строки твоїх завдань із часом, що лишився, і дні історії: день зі сценами веде до його розділів у Журналі.
162
+ **Світ** також зберігає те, що знає твій персонаж. У **Знаннях** зібрано людей, місця, угруповання, істот та історії, відомі персонажу, кожне саме так, як персонаж про це знає: шукай серед них або відкрий запис, щоб прочитати повністю. Ім'я в тексті веде на його сторінку. **Документи** зберігають листи, оголошення та сторінки, які знайшов персонаж, щоб перечитати їх. **Календар** показує сьогоднішній день, строки твоїх завдань із часом, що лишився, і дні історії: день зі сценами веде до них у хронології Журналу.
162
163
 
163
164
  ### 3.6 Завдання, журнал і нотатки
164
165
 
165
- Справа, за яку береться твій персонаж, стає завданням у **Журналі**, зі своїми цілями, строком і тим, що воно вимірює. Познач його зірочкою, щоб тримати на виду вгорі Сцени. Журнал також розповідає твою **історію**, сцену за сценою, і зберігає твої **нотатки**: вони приватні, доки ти не натиснеш **Поділитися** на одній із них. Майстер сприймає її як те, що ти думаєш, а не як факт. У розділі **Супутники** ти читаєш щоденники своїх супутників: час від часу, наприкінці дня чи завдання, вони записують кілька рядків про те, що думають і відчувають.
166
+ Справа, за яку береться твій персонаж, стає завданням у **Журналі**, зі своїми цілями, строком і тим, що воно вимірює. Познач його зірочкою, щоб воно лишалося на виду вгорі **Сцени**. У розділі **Історія** Журнал розповідає твою історію як книжку: після кожної сцени майстер пише розділ прози у стилі за твоїм вибором. Читай розділ за розділом, останній позначено закладкою, а завантажити історію можна як Markdown або як вебсторінку, щоб надрукувати чи передати комусь. У грі, яку розпочато раніше, попроси майстра написати історію на цей момент. **Хронологія** перелічує сцени з тим, що сталося в кожній. Журнал також зберігає твої **нотатки**: вони приватні, доки ти не натиснеш **Поділитися** на одній із них. Майстер сприймає її як те, що ти думаєш, а не як факт. У розділі **Супутники** ти читаєш щоденники супутників: час від часу, наприкінці дня чи завдання, вони записують кілька рядків про те, що думають і відчувають.
166
167
 
167
168
  ### 3.7 Історія та зображення персонажа
168
169
 
@@ -209,10 +210,10 @@ RPG Engine може створювати зображення місць, до
209
210
  Сторінка на твоєму комп'ютері. Вона відкривається лише в браузері цього комп'ютера й працює, поки відкритий чат. Коли чат закривається, вона показує *Not connected*. З наступним чатом вона підключається знову сама.
210
211
 
211
212
  - **Загін**: твій аркуш персонажа й аркуші супутників. Клацни число, щоб зробити кидок. Наведи на нього курсор, щоб побачити, звідки воно береться. Якщо біля кубика є стрілка, побачиш, що покращує або погіршує кидок. Коли майстер готує для тебе вибір, наприклад на новому рівні, повідомлення на аркуші відкриває його: обирай, коли зручно, прочитай сторінки, які називають варіанти, зроби кидок там, де варіант його вимагає, і підтверди. Історія тим часом триває. Поруч видно кидки.
212
- - **Сцена**: де ти перебуваєш, її зображення й мапа, хто там є, що відбувається. У бою тут хід за ходом і картка твого персонажа.
213
- - **Журнал**: завдання, історія, щоденники супутників, твої нотатки.
213
+ - **Сцена**: де ти перебуваєш, її зображення й мапа, хто там є, що відбувається. У бою тут ходи й картка твого персонажа.
214
+ - **Журнал**: завдання, історія як книжка, її хронологія, щоденники супутників, твої нотатки.
214
215
  - **Світ**: мапа світу, те, що знає твій персонаж, знайдені документи й календар.
215
- - **Лоток для кубиків**: вибери кубики та модифікатор і кидай. ×2 подвоює кубики, але не модифікатор, як при критичному влучанні.
216
+ - **Лоток для кубиків**: вибери кубики та модифікатор і кидай. ×2 подвоює кубики, але ніколи модифікатор, як при критичному влучанні.
216
217
  - **Збереження**, **Довідка**, **Налаштування** й **Про гру**: значки в кінці рядка. У Налаштуваннях також є параметри самої сторінки: тема, звук кубиків, набір кубиків.
217
218
 
218
219
  Коли майстер про щось питає, його банер лишається вгорі в будь-якому розділі.
@@ -271,7 +272,7 @@ RPG Engine може створювати зображення місць, до
271
272
 
272
273
  ## 8. Для допитливих: тека кампанії <!-- icon: list -->
273
274
 
274
- Відкривати її тобі ніколи не потрібно, а ще в ній зберігаються секрети твоєї кампанії. У ній є `campaign.yaml` (твої налаштування), `state.yaml` (поточний стан гри), `world/` (по одній сторінці markdown для кожного персонажа, місця, завдання та решти), `rules/` (твої домашні правила), `images/`, `log.jsonl` (кожна зміна), `.saves/`, `.player/` (твої нотатки) і невеликі файли, що кажуть ШІ-агентам, де RPG Engine. Сторінки мають формат Obsidian. Якщо ти змінюєш сторінку вручну, майстер дізнається про це в наступній відповіді.
275
+ Відкривати її не потрібно, а ще в ній зберігаються секрети твоєї кампанії. У ній є `campaign.yaml` (твої налаштування), `state.yaml` (поточний стан гри), `world/` (по одній сторінці markdown для кожного персонажа, місця, завдання та решти), `rules/` (твої домашні правила), `images/`, `log.jsonl` (кожна зміна), `sessions/` (твої розмови з майстром у вигляді тексту, з Claude Code і Codex), `.saves/`, `.player/` (твої нотатки) і невеликі файли, що кажуть ШІ-агентам, де RPG Engine. Сторінки мають формат Obsidian. Якщо змінити сторінку вручну, майстер дізнається про це в наступній відповіді.
275
276
 
276
277
  RPG Engine працює лише в цій теці: читає й записує гру тільки тут і ніколи не чіпає інших твоїх файлів; теки з твоїми посібниками він тільки читає. Поза нею він зберігає лише власні теки з даними (переклади панелі, текст, прочитаний із твоїх посібників, а також Codex або Claude Code, якщо дозволиш їх встановити) і тимчасові теки, поки малюється картинка. Усе інше, що агент захоче зробити на твоєму комп'ютері, він спершу спитає в тебе. Ігрова система чи розширення — це код, як і будь-який пакет npm: пакет не від нас запускається на твоєму комп'ютері з твоїми правами, а RPG Engine встановлює його лише з твоєї згоди, у формі твого агента або у вікні комп'ютера. Погоджуйся лише на пакети, чиїм авторам довіряєш.
277
278
 
@@ -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,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,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,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,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,4c052d2b,8b310594,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,6bd01b74,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,36cfcada,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,b3f85edd,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,105b4a93,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,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
2
2
  # RPG Engine:完整指南
3
3
 
4
4
  **RPG Engine** 让你和一位 **AI 主持人**一起玩桌面角色扮演游戏。你在**聊天**里和主持人交谈;RPG Engine 在幕后工作:它**记住世界**,**掷骰子**,**记账**。聊天旁边,你在浏览器里开着一个页面,也就是**仪表盘**,上面有你的角色卡、骰子、地图和日志。
@@ -64,13 +64,14 @@ rpg init "The Salt Isles"
64
64
 
65
65
  ### 2.4 连接你的 AI
66
66
 
67
- 主持人运行在一个 **AI 智能体**里:这是一个在终端或桌面上运行的 AI 应用,能处理你电脑上的文件,比如 Claude Code 或 Codex。像 claude.ai 或 ChatGPT 这样的普通聊天,或者手机应用,都不够用:主持人需要读取你电脑上的战役文件。每个智能体都需要自己的套餐和登录:Claude Code 需要付费的 Claude 套餐,Codex 需要 ChatGPT 登录。你只需安装一次,从它自己的页面安装:[Claude Code](https://code.claude.com/docs/en/setup),[Codex](https://developers.openai.com/codex)。
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)。
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
72
  - **其他智能体**:在战役文件夹里启动它,并给它 MCP 服务器 `rpg mcp`。RPG Engine 是标准的 MCP 服务器:任何支持 MCP 的智能体都可以当主持人,本地运行的也行。
72
73
 
73
- 我们用 **Claude Code** 来游玩和测试;**Codex** 已经接入并检查过,但还没有用它完整玩过一个战役。战役会关闭智能体自带的记忆:游戏存在它的文件里,这样回到某个存档时,才是真正回到过去。
74
+ 我们用 **Claude Code** 来游玩和测试;**Codex** 和 **Antigravity** 已经接入并检查过,但还没有用它们完整玩过一个战役。战役会关闭智能体自带的记忆:游戏存在它的文件里,这样回到某个存档时,才是真正回到过去。
74
75
 
75
76
  ### 2.5 第一次聊天
76
77
 
@@ -126,7 +127,7 @@ rpg init "The Salt Isles"
126
127
 
127
128
  你说出想做的尝试,主持人说出结果。主持人不会替你的角色做决定,也不会谈论引擎。你可以问主持人怎么使用控制面板。
128
129
 
129
- **在控制面板上行动**:点击角色卡上的名称,比如武器、法术或随身物品,再选择对象;也可以点击一个人,与其交谈。控制面板会替你写好句子,例如 *我用硬头锤攻击兜帽强盗 1。*,你可以在**告诉主持人**之前修改。主持人听到的就像你在聊天里说的一样,也会照常裁定。如果你的 AI 应用无法自动接收,点击**复制**,再粘贴到聊天里。
130
+ **在控制面板上行动**:点击角色卡上的名称,比如武器、法术或随身物品,它的卡片会说明这是什么。再选择要对它做什么,比如**使用**,然后在列表里选择对象,或者在地图上点一下;也可以点击一个人,与其交谈。控制面板会替你写好句子,例如 *我用硬头锤攻击兜帽强盗 1。*,你可以在**告诉主持人**之前修改。主持人听到的就像你在聊天里说的一样,也会照常裁定。如果你的 AI 应用无法自动接收,点击**复制**,再粘贴到聊天里。
130
131
 
131
132
  ### 3.2 掷骰
132
133
 
@@ -142,7 +143,7 @@ rpg init "The Salt Isles"
142
143
 
143
144
  ### 3.3 场景与战斗
144
145
 
145
- 故事以**场景**推进:一场战斗、一次对话、探索、旅行、休息。每个场景结束时,游戏会自动存档,这个场景也会记入你的日志。
146
+ 故事以**场景**推进:一场战斗、一次对话、探索、旅行、休息。每个场景结束时,游戏会自动存档,这个场景会记入你的日志,主持人还会把它写成你的故事之书中的一章。
146
147
 
147
148
  在战斗中,主持人会讲述每个不属于你的回合,并在需要你决定时停下。**场景**顶部会显示轮到谁,以及下一个是谁;你的角色卡在地图旁边。回合顺序、队伍的生命值,以及敌人的伤势(用文字描述),都留在页面一侧。如果你的角色倒下,死亡豁免会大大地显示在页面上。
148
149
 
@@ -158,11 +159,11 @@ RPG Engine 会记录日期。两次游玩之间,游戏时间会停止,除非
158
159
 
159
160
  **世界**显示你的角色所知道的地点、地点之间的道路,以及你走过的路径,其余部分笼罩在迷雾中。**场景**显示你所在之处的地图(如果有的话),以及谁站在哪里;战斗中轮到你时,你到不了的格子会被遮住。主持人问你往哪里移动时,点一下格子,或者直接写出来,比如 *E4*。
160
161
 
161
- **世界**还保存着你的角色所知道的事。**见闻**列出角色所知道的人物、地点、派系、生物和故事,每条都按角色的了解来写:可以搜索,也可以打开一条完整阅读;文中的名称可以跳转到对应页面。**文档**保存角色找到的信件、告示和纸页,可以随时重读。**日历**显示今天、任务的期限和剩余时间,以及故事中的日子:有场景的那一天会通向日志里对应的章节。
162
+ **世界**还保存着你的角色所知道的事。**见闻**列出角色所知道的人物、地点、派系、生物和故事,每条都按角色的了解来写:可以搜索,也可以打开一条完整阅读;文中的名称可以跳转到对应页面。**文档**保存角色找到的信件、告示和纸页,可以随时重读。**日历**显示今天、任务的期限和剩余时间,以及故事中的日子:有场景的那一天会通向日志时间线里对应的场景。
162
163
 
163
164
  ### 3.6 任务、日志与笔记
164
165
 
165
- 角色接下的事务,会在**日志**里成为一个任务,附有目标、期限和衡量方式;给它加星,就会一直显示在场景顶部。日志还会一个场景一个场景地讲述你的**故事**,并保存你的**笔记**:笔记是私人的,除非你**分享**一条,主持人会把它当作你的想法来听,而不是事实。在**同伴**下,你可以读到同伴们的日记:他们会不时在一天或一个任务结束时,写下几行所思所感。
166
+ 角色接下的事务,会在**日志**里成为一个任务,附有目标、期限和衡量方式;给它加星,就会一直显示在场景顶部。在**故事**下,日志会把你的故事讲成一本书:每个场景结束后,主持人会按你选择的风格,为它写一章文字;你可以一章一章地读,最后读到的一章会有书签标记,也可以下载为 Markdown 或网页,用来打印或分享给别人。如果游戏是之前开始的,可以请主持人写出到目前为止的故事。**时间线**列出各个场景,以及每个场景中发生的事。日志还保存着你的**笔记**:笔记是私人的,除非你**分享**一条,主持人会把它当作你的想法来听,而不是事实。在**同伴**下,你可以读到同伴们的日记:他们会不时在一天或一个任务结束时,写下几行所思所感。
166
167
 
167
168
  ### 3.7 你的角色的故事与画像
168
169
 
@@ -210,8 +211,8 @@ RPG Engine 可以按**图片**设置,为你到达的地点、接下的任务
210
211
 
211
212
  - **队伍**:你的角色卡和同伴的角色卡。点击一个数字即可掷骰;把鼠标悬停在上面,可以看到这个数字的来源。如果数字旁有箭头标出骰子,还能看到什么会让这次掷骰更有利或更不利。主持人为你准备选项时(比如升级的时候),角色卡上会出现一条通知,点开就能查看:你可以随时选择,先读一读选项所指的页面,遇到需要掷骰的选项就掷骰,最后确认;故事会照常继续。旁边是掷骰记录。
212
213
  - **场景**:你所在的地方,以及它的图片和地图、在场的人、正在发生的事。战斗中,这里会显示回合顺序和你的角色的卡片。
213
- - **日志**:任务、故事、同伴的日记,还有你的笔记。
214
- - **世界**:世界地图、你的角色所知道的事、找到的文件和日历。
214
+ - **日志**:任务、书一般的故事、时间线、同伴的日记,还有你的笔记。
215
+ - **世界**:世界地图、你的角色所知道的事、找到的文档和日历。
215
216
  - **骰盘**:选择骰子和调整值,然后掷出。×2 会让骰子数量加倍,调整值不加倍,就像重击时那样。
216
217
  - **存档**、**帮助**、**设置**和**关于**,以图标的形式排在这一行的末尾。设置里还有页面自己的偏好:主题、骰子音效、骰子款式。
217
218
 
@@ -271,7 +272,7 @@ SRD 里没有的内容,你也可以玩,只要来自你自己拥有的书:
271
272
 
272
273
  ## 8. 好奇者专区:战役文件夹 <!-- icon: list -->
273
274
 
274
- 你完全不需要打开它,而且里面存着你战役的秘密。其中有 `campaign.yaml`(你的设置)、`state.yaml`(游戏进行到哪里)、`world/`(每个角色、地点、任务等各占一页 markdown)、`rules/`(你的房规)、`images/`、`log.jsonl`(每一次改动)、`.saves/`、`.player/`(你的笔记),以及告诉 AI 助手 RPG Engine 在哪里的几个小文件。页面采用 Obsidian 的格式。如果你手动修改了某个页面,主持人会在下一次回答时得知。
275
+ 你完全不需要打开它,而且里面存着你战役的秘密。其中有 `campaign.yaml`(你的设置)、`state.yaml`(游戏进行到哪里)、`world/`(每个角色、地点、任务等各占一页 markdown)、`rules/`(你的房规)、`images/`、`log.jsonl`(每一次改动)、`sessions/`(你与主持人的聊天文字记录,来自 Claude Code 和 Codex)、`.saves/`、`.player/`(你的笔记),以及告诉 AI 助手 RPG Engine 在哪里的几个小文件。页面采用 Obsidian 的格式。如果你手动修改了某个页面,主持人会在下一次回答时得知。
275
276
 
276
277
  RPG Engine 只在这个文件夹内活动:它只在这里读写游戏,绝不会碰你的其他文件;你的手册所在的文件夹,它只读取。在这个文件夹之外,它只保留自己的数据文件夹(仪表盘的翻译、它从你的手册中读出的文字,以及你允许安装的 Codex 或 Claude Code),还有绘制图片时用到的临时文件夹。你的 AI 助手若想在电脑上做别的事,都会先征求你的同意。游戏系统或扩展就是代码,和所有 npm 包一样:不是我们提供的包,会以你的权限在你的电脑上运行,RPG Engine 只有在你同意后才会安装,你可以在 AI 助手的表单或电脑的窗口中确认。只对你信任其作者的包说“是”。
277
278