rpg-engine 0.13.0 → 0.14.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 (111) hide show
  1. package/README.md +2 -0
  2. package/dist/campaign/choices.d.ts +30 -0
  3. package/dist/campaign/choices.js +84 -0
  4. package/dist/campaign/index.d.ts +4 -1
  5. package/dist/campaign/index.js +4 -1
  6. package/dist/campaign/last-choices.d.ts +6 -0
  7. package/dist/campaign/last-choices.js +34 -0
  8. package/dist/campaign/levels.d.ts +50 -0
  9. package/dist/campaign/levels.js +189 -0
  10. package/dist/campaign/settings.d.ts +35 -13
  11. package/dist/campaign/settings.js +20 -51
  12. package/dist/commands/ask.d.ts +8 -0
  13. package/dist/commands/ask.js +2 -1
  14. package/dist/commands/change/change.js +6 -4
  15. package/dist/commands/choices.d.ts +64 -0
  16. package/dist/commands/choices.js +216 -0
  17. package/dist/commands/config.d.ts +8 -1
  18. package/dist/commands/config.js +165 -21
  19. package/dist/commands/index.js +2 -0
  20. package/dist/commands/init.d.ts +1 -0
  21. package/dist/commands/init.js +8 -4
  22. package/dist/commands/rename.js +8 -3
  23. package/dist/commands/save.d.ts +1 -1
  24. package/dist/commands/shared/experience.d.ts +9 -2
  25. package/dist/commands/shared/experience.js +42 -7
  26. package/dist/commands/shared/knowledge.d.ts +2 -0
  27. package/dist/commands/shared/knowledge.js +5 -0
  28. package/dist/commands/shared/mode.js +10 -3
  29. package/dist/commands/shared/offers.d.ts +3 -1
  30. package/dist/commands/shared/offers.js +6 -1
  31. package/dist/commands/shared/rules.js +5 -1
  32. package/dist/commands/shared/time.d.ts +6 -0
  33. package/dist/commands/shared/time.js +35 -3
  34. package/dist/commands/shared/upkeep.js +3 -3
  35. package/dist/commands/shared/world.js +7 -4
  36. package/dist/commands/status.d.ts +2 -0
  37. package/dist/commands/status.js +15 -7
  38. package/dist/commands/view/view.js +10 -7
  39. package/dist/commands/write/write.js +5 -2
  40. package/dist/dashboard/address.js +8 -1
  41. package/dist/dashboard/api.js +20 -0
  42. package/dist/dashboard/app.js +18 -6
  43. package/dist/dashboard/choices.js +343 -0
  44. package/dist/dashboard/guide/ar.md +12 -10
  45. package/dist/dashboard/guide/cs.md +12 -10
  46. package/dist/dashboard/guide/da.md +13 -11
  47. package/dist/dashboard/guide/de.md +12 -10
  48. package/dist/dashboard/guide/el.md +14 -12
  49. package/dist/dashboard/guide/en.md +11 -9
  50. package/dist/dashboard/guide/es.md +12 -10
  51. package/dist/dashboard/guide/fi.md +12 -10
  52. package/dist/dashboard/guide/fr.md +12 -10
  53. package/dist/dashboard/guide/he.md +12 -10
  54. package/dist/dashboard/guide/hi.md +12 -10
  55. package/dist/dashboard/guide/hu.md +12 -10
  56. package/dist/dashboard/guide/is.md +13 -11
  57. package/dist/dashboard/guide/it.md +12 -10
  58. package/dist/dashboard/guide/ja.md +12 -10
  59. package/dist/dashboard/guide/ko.md +14 -12
  60. package/dist/dashboard/guide/nb.md +13 -11
  61. package/dist/dashboard/guide/nl.md +12 -10
  62. package/dist/dashboard/guide/pl.md +12 -10
  63. package/dist/dashboard/guide/pt.md +12 -10
  64. package/dist/dashboard/guide/ro.md +12 -10
  65. package/dist/dashboard/guide/ru.md +12 -10
  66. package/dist/dashboard/guide/sv.md +12 -10
  67. package/dist/dashboard/guide/tr.md +12 -10
  68. package/dist/dashboard/guide/uk.md +13 -11
  69. package/dist/dashboard/guide/zh.md +12 -10
  70. package/dist/dashboard/i18n/ar.json +80 -0
  71. package/dist/dashboard/i18n/cs.json +80 -0
  72. package/dist/dashboard/i18n/da.json +80 -0
  73. package/dist/dashboard/i18n/de.json +80 -0
  74. package/dist/dashboard/i18n/el.json +80 -0
  75. package/dist/dashboard/i18n/es.json +80 -0
  76. package/dist/dashboard/i18n/fi.json +80 -0
  77. package/dist/dashboard/i18n/fr.json +80 -0
  78. package/dist/dashboard/i18n/he.json +80 -0
  79. package/dist/dashboard/i18n/hi.json +80 -0
  80. package/dist/dashboard/i18n/hu.json +80 -0
  81. package/dist/dashboard/i18n/is.json +80 -0
  82. package/dist/dashboard/i18n/it.json +80 -0
  83. package/dist/dashboard/i18n/ja.json +80 -0
  84. package/dist/dashboard/i18n/ko.json +80 -0
  85. package/dist/dashboard/i18n/nb.json +80 -0
  86. package/dist/dashboard/i18n/nl.json +80 -0
  87. package/dist/dashboard/i18n/pl.json +80 -0
  88. package/dist/dashboard/i18n/pt.json +80 -0
  89. package/dist/dashboard/i18n/ro.json +80 -0
  90. package/dist/dashboard/i18n/ru.json +80 -0
  91. package/dist/dashboard/i18n/sv.json +80 -0
  92. package/dist/dashboard/i18n/tr.json +80 -0
  93. package/dist/dashboard/i18n/uk.json +80 -0
  94. package/dist/dashboard/i18n/zh.json +80 -0
  95. package/dist/dashboard/icons.js +4 -0
  96. package/dist/dashboard/labels.js +32 -0
  97. package/dist/dashboard/party.js +13 -5
  98. package/dist/dashboard/settings.js +89 -40
  99. package/dist/dashboard/setup.js +1 -1
  100. package/dist/dashboard/sheet.js +3 -2
  101. package/dist/dashboard/style.css +744 -6
  102. package/dist/dashboard/top.js +8 -4
  103. package/dist/server/dashboard/choices.d.ts +41 -0
  104. package/dist/server/dashboard/choices.js +176 -0
  105. package/dist/server/dashboard/index.js +17 -1
  106. package/dist/time/game-date.d.ts +9 -0
  107. package/dist/time/game-date.js +9 -0
  108. package/dist/time/index.d.ts +1 -1
  109. package/dist/time/index.js +1 -1
  110. package/instructions/dashboard-guide.md +1 -1
  111. package/package.json +1 -1
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef c64748a2 019e9516 8e136927 95c609b6 423af5fa 17577253 4c3ea82e 2731ea0e 59c1a762. 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,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,197704ab,de62cd09,f7bd4d35,56b73d9b,d9fbeec2,b8c831ca,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,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,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. -->
2
2
  # RPG Engine: повний посібник
3
3
 
4
4
  **RPG Engine** дає змогу грати в настільну рольову гру, де **майстром є ШІ**. Ти спілкуєшся з майстром у **чаті**, а RPG Engine працює за лаштунками: він **пам'ятає світ**, **кидає кубики** і **веде облік**. Поруч із чатом у браузері відкрита сторінка, **панель керування**, де є твій аркуш персонажа, кубики, мапи та журнал.
@@ -9,9 +9,9 @@
9
9
 
10
10
  1. Установи **Node.js** з [nodejs.org](https://nodejs.org) (версія LTS).
11
11
  2. Установи **ШІ-агента**, програму, в якій працює майстер, і увійди в обліковий запис: наприклад, Claude Code або Codex ([2.4](#24-connect-your-ai)).
12
- 3. У терміналі встанови RPG Engine: `npm install -g rpg-engine`.
13
- 4. Створи кампанію: `rpg init "The Salt Isles"`.
14
- 5. Зайди в нову теку, `cd "The Salt Isles"`, і запусти там свого агента: `claude` для Claude Code, `codex` для Codex. Погодься, коли він запитає, чи довіряєш ти цій теці ([2.4](#24-connect-your-ai)), а потім напиши *Привіт! Починаймо.* Майстер відповість посиланням на твою панель керування.
12
+ 3. У новому терміналі, відкритому після встановлення Node.js, встанови RPG Engine: `npm install -g rpg-engine`. Якщо Windows повідомляє, що виконання скриптів вимкнено, один раз напиши `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, відповідай «так» і спробуй ще раз.
13
+ 4. Відкрий термінал у папці, де зберігаєш свої ігри (клацни її правою кнопкою миші, **Відкрити в Терміналі**), і створи кампанію, завжди з назвою: `rpg init "The Salt Isles"`. RPG Engine відповість двома рядками англійською: усе гаразд.
14
+ 5. Перейди в нову папку, `cd "The Salt Isles"`, і запусти там свого агента: `claude` для Claude Code, `codex` для Codex. Погодься, коли він запитає, чи довіряєш ти цій папці ([2.4](#24-connect-your-ai)), а потім напиши *Привіт! Починаймо.* Майстер відповість посиланням на твій дашборд.
15
15
 
16
16
  ## 1. Що таке RPG Engine <!-- icon: about -->
17
17
 
@@ -39,7 +39,7 @@
39
39
 
40
40
  - Комп'ютер з Windows, macOS або Linux і веббраузер.
41
41
  - **Node.js 24** або новіша версія, з [nodejs.org](https://nodejs.org). Разом з ним встановлюється `npm`, який встановлює RPG Engine.
42
- - **Термінал**: у Windows це Термінал або PowerShell, у macOS це Термінал. Щоб відкрити термінал у папці, клацни папку правою кнопкою миші й вибери **Відкрити в Терміналі** (Windows) або **Служби > Новий термінал у папці** (macOS).
42
+ - **Термінал**: у Windows це Термінал або PowerShell, у macOS це Термінал. Щоб відкрити термінал у папці, клацни папку правою кнопкою миші й вибери **Відкрити в Терміналі** (Windows) або **Служби > Новий термінал у папці** (macOS). Якщо Windows повідомляє, що виконання скриптів вимкнено, один раз напиши `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` і відповідай «так».
43
43
  - **ШІ-агент** для майстра ([2.4](#24-connect-your-ai)) з **найбільшою моделлю**, яку він пропонує: малу модель легше умовити розкрити секрети або порушити правила.
44
44
 
45
45
  ### 2.2 Встановлення
@@ -48,7 +48,7 @@
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- Команда `rpg --version` перевіряє, чи все вдалося. Команду `rpg` ти використовуєш один раз для кожної кампанії, щоб її створити. Далі твій агент запускає RPG Engine сам.
51
+ Команда `rpg --version` перевіряє, чи все вдалося. Якщо npm пропонує оновити себе, можеш це проігнорувати. Команду `rpg` ти використовуєш один раз для кожної кампанії, щоб її створити. Далі твій агент запускає RPG Engine сам. Сама по собі `rpg` нічого не відкриває: дашборд дає майстер.
52
52
 
53
53
  ### 2.3 Створення кампанії
54
54
 
@@ -58,13 +58,13 @@ npm install -g rpg-engine
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Це створить папку `The Salt Isles` з новою кампанією всередині. Перейди в неї командою `cd "The Salt Isles"`. Запам'ятай, де вона лежить: ти повертатимешся до неї щоразу, коли гратимеш. Усе інше ти оберeш пізніше, в чаті або на дашборді. Команда `rpg init --help` показує параметри, якими можна вибрати дещо вже зараз, наприклад `--language it` або `--difficulty hard`.
61
+ Це створить папку `The Salt Isles` з новою кампанією всередині. Перейди в неї командою `cd "The Salt Isles"`. Завжди пиши назву: без неї папка, в якій ти перебуваєш, стане кампанією, поруч з усім, що в ній уже є. Запам'ятай, де вона лежить: ти повертатимешся до неї щоразу, коли гратимеш. Усе інше ти оберeш пізніше, в чаті або на дашборді.
62
62
 
63
63
  Майстер не може створити кампанію за тебе: до `init` ніщо не підказує твоєму агентові, де RPG Engine.
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://learn.chatgpt.com/docs/codex/cli).
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).
68
68
 
69
69
  - **Claude Code**: у папці кампанії напиши `claude`. Коли він запитає, чи ти довіряєш цій папці, вибери **Yes, I trust this folder**. Будь уважним: попередньо вибрана відповідь — *No, exit*. У кампанії є також невеликий гачок, `rpg --listen`, якого це запитання не показує: він одразу повідомляє майстрові, коли ти робиш щось на дашборді.
70
70
  - **Codex**: у папці кампанії напиши `codex` і погодься, коли він запитає, чи ти довіряєш цій папці. У його застосунку для комп'ютера перевір у налаштуваннях, що пам'ять вимкнена для чатів гри.
@@ -145,7 +145,7 @@ rpg init "The Salt Isles"
145
145
 
146
146
  ### 3.4 Час, подорожі та світ, що рухається
147
147
 
148
- RPG Engine веде дату; між сесіями час не минає. Скажи, що відпочиваєте, *Ми робимо тривалий відпочинок*, і щойно майстер погодиться, відпочинок поверне те, що має. Під час короткого відпочинку майстер може спитати на дашборді, скільки кубиків здоров'я ти витрачаєш: кидай їх по одному, дивись, скільки кожен лікує, і зупинись, коли захочеш. Скажи, куди йдете, *Ми вирушаємо північною дорогою до Рокки*, і RPG Engine розрахує шлях, відстань і дні, зупиняючись, коли щось трапиться дорогою. Гроші рахуються в монетах гри, разом із рештою.
148
+ RPG Engine веде дату. Між сесіями ігровий час не минає, якщо тільки ти не обереш у **Налаштування**, щоб він ішов, наприклад один день гри за кожен тиждень відсутності, або не попросиш про це майстра. Скажи, що вирушаєте на відпочинок, *Ми робимо тривалий відпочинок*, і щойно майстер погодиться, відпочинок поверне те, що має. Під час короткого відпочинку майстер може спитати на дашборді, скільки кубиків здоров'я витрачається: кидай їх по одному, дивись, скільки кожен лікує, і зупинися, коли захочеш. Скажи, куди йдете, *Ми вирушаємо північною дорогою до Рокки*, і RPG Engine розрахує шлях, відстань і дні, зупиняючись, коли щось трапиться дорогою. Гроші рахуються в монетах гри, разом із рештою.
149
149
 
150
150
  У лиходіїв є плани зі строками. Щодня майстер просуває загрози, які час наблизив, а ти бачиш їхні ознаки, але ніколи сам годинник.
151
151
 
@@ -203,7 +203,7 @@ RPG Engine може створювати зображення місць, до
203
203
 
204
204
  Сторінка на твоєму комп'ютері. Вона відкривається лише в браузері цього комп'ютера й працює, поки відкритий чат. Коли чат закривається, вона показує *Not connected*. З наступним чатом вона підключається знову сама.
205
205
 
206
- - **Загін**: твій аркуш персонажа й аркуші супутників. Клацни число, щоб зробити кидок. Наведи на нього курсор, щоб побачити, звідки воно береться. Якщо біля кубика є стрілка, побачиш, що покращує або погіршує кидок. Поруч видно кидки.
206
+ - **Загін**: твій аркуш персонажа й аркуші супутників. Клацни число, щоб зробити кидок. Наведи на нього курсор, щоб побачити, звідки воно береться. Якщо біля кубика є стрілка, побачиш, що покращує або погіршує кидок. Коли майстер готує для тебе вибір, наприклад на новому рівні, повідомлення на аркуші відкриває його: обирай, коли зручно, прочитай сторінки, які називають варіанти, зроби кидок там, де варіант його вимагає, і підтверди. Історія тим часом триває. Поруч видно кидки.
207
207
  - **Сцена**: де ти перебуваєш, її зображення й мапа, хто там є, що відбувається. У бою тут хід за ходом і картка твого персонажа.
208
208
  - **Журнал**: завдання, історія, щоденники супутників, твої нотатки.
209
209
  - **Світ**: мапа світу, те, що знає твій персонаж, знайдені документи й календар.
@@ -304,12 +304,14 @@ RPG Engine працює лише в цій теці: читає й запису
304
304
 
305
305
  **Схоже, майстер не знає гри.** Твій агент не завантажив RPG Engine. Перевір, що ти запустив його в теці кампанії й дозволив довіру до неї. У Claude Code напиши `/mcp` і підключи `rpg` знову. У Codex команда `codex mcp list` у теці кампанії має показати `rpg`. Якщо `rpg --version` не знайдено, встанови RPG Engine знову ([2.2](#22-install)).
306
306
 
307
+ **Windows не знаходить `claude`.** Його інсталятор повідомляє про це в жовтій примітці й вказує папку, куди все встановилось: додай цю папку до PATH (Властивості системи > Змінні середовища), потім відкрий новий термінал.
308
+
307
309
  **Оновлення.** Знову виконай `npm install -g rpg-engine`, потім відкрий новий чат: майстер, що вже працює, зберігає версію, з якою запустився.
308
310
 
309
311
  **Майстер пам'ятає те, що я скасував.** Відкрий новий чат і натисни **Новий чат відкрито** в розділі Збереження.
310
312
 
311
313
  **Зображення не з'являються.** Налаштування > Зображення показує, чи може цей комп'ютер їх створювати, і як це зробити.
312
314
 
313
- **Встановлення не вдається, або `rpg` не запускається.** `node --version` має показувати 22 або новішу версію. У Windows тримай RPG Engine і свої кампанії подалі від шляхів, що містять `&`.
315
+ **Встановлення не вдається, або `rpg` не запускається.** `node --version` має показувати 24 або новішу версію. Якщо Windows повідомляє, що виконання скриптів вимкнено, див. [2.1](#21-what-you-need). У Windows тримай RPG Engine і свої кампанії подалі від шляхів, що містять `&`.
314
316
 
315
317
  **Посилання на панель змінилося.** Іншу програму зайняла звичну адресу, тож майстер дає тобі нове посилання.
@@ -1,4 +1,4 @@
1
- <!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 9f1774ef c64748a2 019e9516 8e136927 95c609b6 423af5fa 17577253 4c3ea82e 2731ea0e 59c1a762. 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,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,197704ab,de62cd09,f7bd4d35,56b73d9b,d9fbeec2,b8c831ca,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,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,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. -->
2
2
  # RPG Engine:完整指南
3
3
 
4
4
  **RPG Engine** 让你和一位 **AI 主持人**一起玩桌面角色扮演游戏。你在**聊天**里和主持人交谈;RPG Engine 在幕后工作:它**记住世界**,**掷骰子**,**记账**。聊天旁边,你在浏览器里开着一个页面,也就是**仪表盘**,上面有你的角色卡、骰子、地图和日志。
@@ -9,8 +9,8 @@
9
9
 
10
10
  1. 从 [nodejs.org](https://nodejs.org) 安装 **Node.js**(LTS 版本)。
11
11
  2. 安装一个 **AI 智能体**,也就是主持人运行所在的程序,并登录:例如 Claude Code 或 Codex([2.4](#24-connect-your-ai))。
12
- 3. 在终端里安装 RPG Engine:`npm install -g rpg-engine`。
13
- 4. 创建战役:`rpg init "The Salt Isles"`。
12
+ 3. 安装好 Node.js 后,打开一个新的终端,在里面安装 RPG Engine:`npm install -g rpg-engine`。如果 Windows 提示已禁止运行脚本,请输入一次 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`,回答“是”,然后再试一次。
13
+ 4. 在你存放游戏的文件夹里打开终端(右键点击该文件夹,选择**在终端中打开**),然后创建战役,一定要带上战役的名字:`rpg init "The Salt Isles"`。RPG Engine 会用英文回复两行:一切正常。
14
14
  5. 进入新文件夹:`cd "The Salt Isles"`,然后在那里启动你的智能体:Claude Code 用 `claude`,Codex 用 `codex`。它问你是否信任这个文件夹时,选择“是”([2.4](#24-connect-your-ai)),然后写下 *你好!我们开始吧。* 主持人会回复你仪表盘的链接。
15
15
 
16
16
  ## 1. RPG Engine 是什么 <!-- icon: about -->
@@ -39,7 +39,7 @@
39
39
 
40
40
  - 一台装有 Windows、macOS 或 Linux 的电脑,以及一个网页浏览器。
41
41
  - **Node.js 24** 或更新版本,从 [nodejs.org](https://nodejs.org) 下载。它自带 `npm`,用来安装 RPG Engine。
42
- - 一个**终端**:在 Windows 上是“终端”或 PowerShell;在 macOS 上是“终端”。要在某个文件夹里打开终端,右键点击该文件夹,选择**在终端中打开**(Windows)或**服务 > 新建位于文件夹位置的终端**(macOS)。
42
+ - 一个**终端**:在 Windows 上是“终端”或 PowerShell;在 macOS 上是“终端”。要在某个文件夹里打开终端,右键点击该文件夹,选择**在终端中打开**(Windows)或**服务 > 新建位于文件夹位置的终端**(macOS)。如果 Windows 提示已禁止运行脚本,请输入一次 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`,并回答“是”。
43
43
  - 一个给主持人用的 **AI 智能体**([2.4](#24-connect-your-ai)),并选用它提供的**最大模型**:小模型更容易被说动,泄露秘密或打破规则。
44
44
 
45
45
  ### 2.2 安装
@@ -48,7 +48,7 @@
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- 输入 `rpg --version` 可以检查是否安装成功。每个战役只需用一次 `rpg`,用来创建战役;之后由你的智能体自动启动 RPG Engine。
51
+ 输入 `rpg --version` 可以检查是否安装成功。如果 npm 提示可以更新自身,不用理会。每个战役只需用一次 `rpg`,用来创建战役;之后由你的智能体自动启动 RPG Engine。单独输入 `rpg` 不会打开任何东西:仪表盘由主持人给你。
52
52
 
53
53
  ### 2.3 创建战役
54
54
 
@@ -58,13 +58,13 @@ npm install -g rpg-engine
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- 这会生成文件夹 `The Salt Isles`,里面是一个新战役。输入 `cd "The Salt Isles"` 进入这个文件夹。记住它在哪里:每次游玩都要回到这里。其余的一切,你之后在聊天或仪表盘里再选。`rpg init --help` 会列出可以现在就选的选项,比如 `--language it` 或 `--difficulty hard`。
61
+ 这会生成文件夹 `The Salt Isles`,里面是一个新战役。输入 `cd "The Salt Isles"` 进入这个文件夹。名字一定要写:不写的话,你当前所在的文件夹会变成战役,和里面原有的内容混在一起。记住它在哪里:每次游玩都要回到这里。其余的一切,你之后在聊天或仪表盘里再选。
62
62
 
63
63
  主持人无法替你创建战役:在 `init` 之前,你的智能体不知道 RPG Engine 在哪里。
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://learn.chatgpt.com/docs/codex/cli)。
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)。
68
68
 
69
69
  - **Claude Code**:在战役文件夹里输入 `claude`。当它询问是否信任这个文件夹时,选择 **Yes, I trust this folder**。注意,默认选中的答案是 *No, exit*。战役里还有一个小钩子 `rpg --listen`,这个询问不会显示它:当你在仪表盘上操作时,它会立刻通知主持人。
70
70
  - **Codex**:在战役文件夹里输入 `codex`,当它询问是否信任这个文件夹时,回答“是”。如果用它的桌面应用,请在设置里确认游戏的聊天已关闭记忆。
@@ -145,7 +145,7 @@ rpg init "The Salt Isles"
145
145
 
146
146
  ### 3.4 时间、旅行与流动的世界
147
147
 
148
- RPG Engine 会记录日期;两次游玩之间不会有时间流逝。说一句你要休息,*我们进行一次长休*,主持人同意后,休息就会恢复该恢复的东西。短休时,主持人可能会在控制面板上问你花费多少生命骰:一颗一颗地掷,看看每颗恢复多少,想停就停。说出你要去哪里,*我们沿路向北去罗卡*,RPG Engine 会算出路线、距离和天数,途中有事发生时会停下来。钱按游戏里的硬币计算,找零也包括在内。
148
+ RPG Engine 会记录日期。两次游玩之间,游戏时间会停止,除非你在**设置**里选择让时间继续流逝(比如每离开一周,游戏里过一天),或者请主持人这样做。说一句你要休息,*我们进行一次长休*,主持人同意后,休息就会恢复该恢复的东西。短休时,主持人可能会在控制面板上问你花费多少生命骰:一颗一颗地掷,看看每颗恢复多少,想停就停。说出你要去哪里,*我们沿路向北去罗卡*,RPG Engine 会算出路线、距离和天数,途中有事发生时会停下来。钱按游戏里的硬币计算,找零也包括在内。
149
149
 
150
150
  反派的计划有期限。每过新的一天,主持人就会推进时间所推动的威胁,你能看到它们的迹象,但看不到时钟本身。
151
151
 
@@ -203,7 +203,7 @@ RPG Engine 可以按**图片**设置,为你到达的地点、接下的任务
203
203
 
204
204
  仪表盘是一个网页,只在你自己的电脑上,通过这台电脑的浏览器打开。聊天开着时,它是活的。聊天关闭后,它会显示 *Not connected*;下次开始聊天,它会自动恢复。
205
205
 
206
- - **队伍**:你的角色卡和同伴的角色卡。点击一个数字即可掷骰;把鼠标悬停在上面,可以看到这个数字的来源。如果数字旁有箭头标出骰子,还能看到什么会让这次掷骰更有利或更不利。旁边是掷骰记录。
206
+ - **队伍**:你的角色卡和同伴的角色卡。点击一个数字即可掷骰;把鼠标悬停在上面,可以看到这个数字的来源。如果数字旁有箭头标出骰子,还能看到什么会让这次掷骰更有利或更不利。主持人为你准备选项时(比如升级的时候),角色卡上会出现一条通知,点开就能查看:你可以随时选择,先读一读选项所指的页面,遇到需要掷骰的选项就掷骰,最后确认;故事会照常继续。旁边是掷骰记录。
207
207
  - **场景**:你所在的地方,以及它的图片和地图、在场的人、正在发生的事。战斗中,这里会显示回合顺序和你的角色的卡片。
208
208
  - **日志**:任务、故事、同伴的日记,还有你的笔记。
209
209
  - **世界**:世界地图、你的角色所知道的事、找到的文件和日历。
@@ -304,12 +304,14 @@ RPG Engine 只在这个文件夹内活动:它只在这里读写游戏,绝不
304
304
 
305
305
  **主持人似乎不懂这个游戏。** 你的智能体没有加载 RPG Engine。请检查你是否在战役文件夹里启动了它,并且选择了信任。在 Claude Code 里,输入 `/mcp` 并重新连接 `rpg`。在 Codex 里,在战役文件夹中运行 `codex mcp list`,必须能看到 `rpg`。如果提示找不到 `rpg --version`,请重新安装 RPG Engine([2.2](#22-install))。
306
306
 
307
+ **Windows 找不到 `claude`。** 它的安装程序会用黄色提示告诉你这一点,并写明它安装到了哪个文件夹:把那个文件夹加入 PATH(系统属性 > 环境变量),然后打开一个新的终端。
308
+
307
309
  **更新。** 再运行一次 `npm install -g rpg-engine`,然后开启新聊天:正在运行的主持人会沿用它启动时的版本。
308
310
 
309
311
  **主持人还记得我撤销过的事。** 开启新聊天,然后在存档里点**我已开启新聊天**。
310
312
 
311
313
  **没有图片出现。** 设置 > 图片会告诉你这台电脑能否生成图片,以及怎么做。
312
314
 
313
- **安装失败,或 `rpg` 无法启动。** `node --version` 必须显示 22 或更新版本。在 Windows 上,请让 RPG Engine 和你的战役远离含有 `&` 的路径。
315
+ **安装失败,或 `rpg` 无法启动。** `node --version` 必须显示 24 或更新版本。如果 Windows 提示已禁止运行脚本,见 [2.1](#21-what-you-need)。在 Windows 上,请让 RPG Engine 和你的战役远离含有 `&` 的路径。
314
316
 
315
317
  **仪表盘链接变了。** 另一个程序占用了常用地址;主持人会给你新的链接。