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: o guia completo
3
3
 
4
4
  **RPG Engine** permite que você jogue um jogo de RPG de mesa com uma **IA como mestre**. Você conversa com o mestre em um **chat**; o RPG Engine trabalha nos bastidores: ele **lembra do mundo**, **rola os dados** e **faz as contas**. Ao lado do chat, você mantém aberta uma página no navegador, o **painel**, com sua ficha, os dados, os mapas e seu diário.
@@ -9,8 +9,8 @@ Este guia é para quem joga: você não precisa saber programar.
9
9
 
10
10
  1. Instale o **Node.js** em [nodejs.org](https://nodejs.org) (a versão LTS).
11
11
  2. Instale um **agente de IA**, o programa em que o mestre roda, e entre na sua conta: por exemplo, Claude Code ou Codex ([2.4](#24-connect-your-ai)).
12
- 3. Em um terminal, instale o RPG Engine: `npm install -g rpg-engine`.
13
- 4. Crie uma campanha: `rpg init "The Salt Isles"`.
12
+ 3. Em um terminal novo, aberto depois de instalar o Node.js, instale o RPG Engine: `npm install -g rpg-engine`. Se o Windows responder que a execução de scripts está desabilitada, escreva uma vez `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, responda sim e tente de novo.
13
+ 4. Abra o terminal na pasta onde você guarda seus jogos (clique com o botão direito nela, **Abrir no Terminal**) e crie uma campanha, sempre com o nome dela: `rpg init "The Salt Isles"`. O RPG Engine responde com duas linhas em inglês: está tudo certo.
14
14
  5. Entre na nova pasta, `cd "The Salt Isles"`, e inicie seu agente nela: `claude` para o Claude Code, `codex` para o Codex. Diga sim quando ele perguntar se você confia na pasta ([2.4](#24-connect-your-ai)) e escreva *Oi! Vamos começar.* O mestre responde com o link do seu painel.
15
15
 
16
16
  ## 1. O que é o RPG Engine <!-- icon: about -->
@@ -39,7 +39,7 @@ Um jogo vem como um sistema de jogo, um pacote que o mestre instala para a sua c
39
39
 
40
40
  - Um computador com Windows, macOS ou Linux, e um navegador.
41
41
  - **Node.js 24** ou mais recente, de [nodejs.org](https://nodejs.org). Ele traz o `npm`, que instala o RPG Engine.
42
- - Um **terminal**: no Windows, Terminal ou PowerShell; no macOS, Terminal. Para abrir um terminal em uma pasta, clique com o botão direito na pasta e escolha **Abrir no Terminal** (Windows) ou **Serviços > Novo Terminal na Pasta** (macOS).
42
+ - Um **terminal**: no Windows, Terminal ou PowerShell; no macOS, Terminal. Para abrir um terminal em uma pasta, clique com o botão direito na pasta e escolha **Abrir no Terminal** (Windows) ou **Serviços > Novo Terminal na Pasta** (macOS). Se o Windows responder que a execução de scripts está desabilitada, escreva uma vez `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` e responda sim.
43
43
  - Um **agente de IA** para o mestre ([2.4](#24-connect-your-ai)), com o **maior modelo** que ele oferecer: um modelo pequeno é mais fácil de convencer a revelar segredos ou a quebrar as regras.
44
44
 
45
45
  ### 2.2 Instalar
@@ -48,7 +48,7 @@ Um jogo vem como um sistema de jogo, um pacote que o mestre instala para a sua c
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- `rpg --version` confirma que deu certo. Você usa `rpg` uma vez por campanha, para criá-la; depois disso, seu agente inicia o RPG Engine sozinho.
51
+ `rpg --version` confirma que deu certo. Se o npm se oferecer para se atualizar, você pode ignorar. Você usa `rpg` uma vez por campanha, para criá-la; depois disso, seu agente inicia o RPG Engine sozinho. O `rpg` sozinho não abre nada: o mestre dá a você o dashboard.
52
52
 
53
53
  ### 2.3 Criar uma campanha
54
54
 
@@ -58,13 +58,13 @@ Abra um terminal na pasta onde você guarda seus jogos ([2.1](#21-what-you-need)
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Isso cria a pasta `The Salt Isles` com uma campanha nova dentro. Entre nela com `cd "The Salt Isles"`. Lembre onde ela fica: você volta a ela toda vez que for jogar. Todo o resto você escolhe depois, no chat ou no dashboard; `rpg init --help` lista as opções para escolher algumas agora, como `--language it` ou `--difficulty hard`.
61
+ Isso cria a pasta `The Salt Isles` com uma campanha nova dentro; entre nela com `cd "The Salt Isles"`. Escreva sempre o nome: sem ele, a pasta em que você está vira a campanha, junto com tudo o que já houver nela. Lembre onde ela fica: você volta a ela toda vez que for jogar. Todo o resto você escolhe depois, no chat ou no dashboard.
62
62
 
63
63
  O mestre não pode criar uma campanha para você: antes do `init`, nada diz ao seu agente onde está o RPG Engine.
64
64
 
65
65
  ### 2.4 Conectar sua IA
66
66
 
67
- O mestre roda em um **agente de IA**: um app de IA, no terminal ou no desktop, que consegue trabalhar com os arquivos do seu computador, como o Claude Code ou o Codex. Um chat simples, como o claude.ai ou o ChatGPT, ou um app de celular, não basta: o mestre precisa acessar os arquivos da campanha no seu computador. Cada agente exige seu próprio plano e login: o Claude Code, um plano pago do Claude; o Codex, um login do ChatGPT. Você instala o agente uma vez, pela página dele: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
67
+ O mestre roda em um **agente de IA**: um app de IA, no terminal ou no desktop, que consegue trabalhar com os arquivos do seu computador, como o Claude Code ou o Codex. Um chat simples, como o claude.ai ou o ChatGPT, ou um app de celular, não basta: o mestre precisa acessar os arquivos da campanha no seu computador. Cada agente exige seu próprio plano e login: o Claude Code, um plano pago do Claude; o Codex, um login do ChatGPT. Você instala o agente uma vez, pela página dele: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
68
68
 
69
69
  - **Claude Code**: na pasta da campanha, escreva `claude`. Quando ele perguntar se você confia na pasta, escolha **Yes, I trust this folder**; atenção, a resposta já selecionada é *No, exit*. A campanha também tem um pequeno hook, `rpg --listen`, que a pergunta não mostra: ele avisa o mestre na hora quando você age pelo dashboard.
70
70
  - **Codex**: na pasta da campanha, escreva `codex` e diga sim quando ele perguntar se você confia na pasta. No app de desktop, confira nas configurações se as memórias estão desligadas para os chats do jogo.
@@ -145,7 +145,7 @@ Em um combate, o mestre narra todos os turnos que não são seus e para quando v
145
145
 
146
146
  ### 3.4 Tempo, viagens e o mundo que se move
147
147
 
148
- O RPG Engine controla a data; nenhum tempo passa entre as sessões. Diga que vai descansar, *Fazemos um descanso longo*, e, quando o mestre concordar, o descanso devolve o que deve. Em um descanso curto, o mestre pode perguntar no dashboard quantos dados de vida você gasta: role um de cada vez, veja quanto cada um cura e pare quando quiser. Diga para onde vai, *Pegamos a estrada ao norte, rumo a Rocca*, e o RPG Engine calcula o caminho, a distância e os dias, parando quando algo acontecer no trajeto. O dinheiro é contado nas moedas do jogo, troco incluído.
148
+ O RPG Engine controla a data. Entre as sessões, o tempo do jogo para, a menos que você escolha em **Configurações** deixá-lo correr, como um dia de jogo para cada semana fora, ou peça ao mestre. Diga que vai descansar, *Fazemos um descanso longo*, e, quando o mestre concordar, o descanso devolve o que deve. Em um descanso curto, o mestre pode perguntar no dashboard quantos dados de vida você gasta: role um de cada vez, veja quanto cada um cura e pare quando quiser. Diga para onde vai, *Pegamos a estrada ao norte, rumo a Rocca*, e o RPG Engine calcula o caminho, a distância e os dias, parando quando algo acontecer no trajeto. O dinheiro é contado nas moedas do jogo, troco incluído.
149
149
 
150
150
  Os vilões têm planos com prazos. A cada novo dia, o mestre move as ameaças que o tempo fez avançar, e você vê os sinais delas, nunca o relógio em si.
151
151
 
@@ -203,7 +203,7 @@ Toda configuração pode mudar, no chat ou em **Configurações**. Uma decisão
203
203
 
204
204
  Uma página no seu próprio computador, aberta apenas no navegador desse computador e ativa enquanto o chat estiver aberto. Quando o chat é fechado, ela mostra *Not connected*; ela volta sozinha no próximo chat.
205
205
 
206
- - **Grupo**: sua ficha e as dos seus companheiros. Clique em um número para rolá-lo; passe o mouse sobre ele para ver de onde vem e, quando uma seta marca o dado, o que melhora ou piora a rolagem. Ao lado, as rolagens.
206
+ - **Grupo**: sua ficha e as dos seus companheiros. Clique em um número para rolá-lo; passe o mouse sobre ele para ver de onde vem e, quando uma seta marca o dado, o que melhora ou piora a rolagem. Quando o mestre prepara escolhas para você, como ao subir de nível, um aviso na ficha as abre: escolha quando quiser, leia as páginas que as opções indicam, role onde uma opção pedir uma rolagem e depois confirme; a história continua enquanto isso. Ao lado, as rolagens.
207
207
  - **Cena**: onde você está, a imagem e o mapa do lugar, quem está presente, o que está acontecendo; em um combate, os turnos e a carta do seu personagem.
208
208
  - **Diário**: missões, a história, os diários dos seus companheiros, suas notas.
209
209
  - **Mundo**: o mapa do mundo, o que seu personagem sabe, os documentos encontrados e o calendário.
@@ -304,12 +304,14 @@ Todo comando que o mestre usa também pode ser executado na pasta da campanha: `
304
304
 
305
305
  **O mestre parece não conhecer o jogo.** Seu agente não carregou o RPG Engine. Confira se você o iniciou na pasta da campanha e se confiou nela. No Claude Code, escreva `/mcp` e reconecte o `rpg`. No Codex, `codex mcp list` na pasta da campanha deve mostrar `rpg`. Se o `rpg --version` não for encontrado, instale o RPG Engine de novo ([2.2](#22-install)).
306
306
 
307
+ **O Windows não encontra o `claude`.** O instalador avisa isso em uma nota amarela, com a pasta onde ele foi instalado: adicione essa pasta ao PATH (Propriedades do Sistema > Variáveis de Ambiente) e abra um novo terminal.
308
+
307
309
  **Atualizando.** Rode `npm install -g rpg-engine` de novo e depois abra um novo chat: um mestre em andamento mantém a versão com que começou.
308
310
 
309
311
  **O mestre lembra algo que eu desfiz.** Abra um novo chat e clique em **Abri um novo chat** em Jogos salvos.
310
312
 
311
313
  **Nenhuma imagem aparece.** Configurações > Imagens diz se este computador consegue gerá-las e como.
312
314
 
313
- **A instalação falha, ou o `rpg` não inicia.** `node --version` deve mostrar 22 ou mais recente. No Windows, mantenha o RPG Engine e suas campanhas fora de caminhos que contenham `&`.
315
+ **A instalação falha, ou o `rpg` não inicia.** `node --version` deve mostrar 24 ou mais recente. Se o Windows responder que a execução de scripts está desabilitada, veja [2.1](#21-what-you-need). No Windows, mantenha o RPG Engine e suas campanhas fora de caminhos que contenham `&`.
314
316
 
315
317
  **O link do painel mudou.** Outro programa ocupou o endereço habitual; o mestre dá a você o novo link.
@@ -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: ghidul complet
3
3
 
4
4
  **RPG Engine** îți permite să joci un joc de rol de masă cu o **IA în rolul de maestru de joc**. Vorbești cu maestrul de joc într-un **chat**; RPG Engine lucrează în spate: **își amintește lumea**, **aruncă zarurile** și **ține socotelile**. Lângă chat ții deschisă în browser o pagină, **dashboardul**, cu fișa ta, zarurile, hărțile și jurnalul.
@@ -9,8 +9,8 @@ Ghidul este pentru jucători: nu e nevoie să știi să programezi.
9
9
 
10
10
  1. Instalează **Node.js** de pe [nodejs.org](https://nodejs.org) (versiunea LTS).
11
11
  2. Instalează un **agent IA**, programul în care rulează maestrul de joc, și autentifică-te: de exemplu Claude Code sau Codex ([2.4](#24-connect-your-ai)).
12
- 3. Într-un terminal, instalează RPG Engine: `npm install -g rpg-engine`.
13
- 4. Creează o campanie: `rpg init "The Salt Isles"`.
12
+ 3. Într-un terminal nou, deschis după instalarea Node.js, instalează RPG Engine: `npm install -g rpg-engine`. Dacă Windows răspunde că rularea scripturilor este dezactivată, scrie o singură dată `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, răspunde da și încearcă din nou.
13
+ 4. Deschide terminalul în dosarul în care ții jocurile tale (dă clic dreapta pe dosar, **Open in Terminal**) și creează o campanie, mereu cu numele ei: `rpg init "The Salt Isles"`. RPG Engine răspunde cu două rânduri în engleză: totul este în regulă.
14
14
  5. Intră în folderul nou, `cd "The Salt Isles"`, și pornește agentul acolo: `claude` pentru Claude Code, `codex` pentru Codex. Spune da când te întreabă dacă ai încredere în folder ([2.4](#24-connect-your-ai)), apoi scrie *Salut! Hai să începem.* Maestrul de joc răspunde cu linkul către dashboard.
15
15
 
16
16
  ## 1. Ce este RPG Engine <!-- icon: about -->
@@ -39,7 +39,7 @@ Un joc vine sub forma unui sistem de joc, un pachet pe care maestrul de joc îl
39
39
 
40
40
  - Un calculator cu Windows, macOS sau Linux și un browser web.
41
41
  - **Node.js 24** sau mai nou, de pe [nodejs.org](https://nodejs.org). Vine cu `npm`, care instalează RPG Engine.
42
- - Un **terminal**: pe Windows, Terminal sau PowerShell; pe macOS, Terminal. Ca să deschizi unul într-un dosar, dă clic dreapta pe dosar și alege **Open in Terminal** (Windows) sau **Services > New Terminal at Folder** (macOS).
42
+ - Un **terminal**: pe Windows, Terminal sau PowerShell; pe macOS, Terminal. Ca să deschizi unul într-un dosar, dă clic dreapta pe dosar și alege **Open in Terminal** (Windows) sau **Services > New Terminal at Folder** (macOS). Dacă Windows răspunde că rularea scripturilor este dezactivată, scrie o singură dată `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` și răspunde da.
43
43
  - Un **agent AI** pentru maestrul de joc ([2.4](#24-connect-your-ai)), cu **cel mai mare model** pe care îl oferă: un model mic poate fi convins mai ușor să dezvăluie secrete sau să încalce regulile.
44
44
 
45
45
  ### 2.2 Instalare
@@ -48,7 +48,7 @@ Un joc vine sub forma unui sistem de joc, un pachet pe care maestrul de joc îl
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- `rpg --version` verifică dacă a mers. Folosești `rpg` o singură dată pentru fiecare campanie, ca s-o creezi; după aceea, agentul tău pornește singur RPG Engine.
51
+ `rpg --version` verifică dacă a mers. Dacă npm se oferă să se actualizeze singur, poți ignora oferta. Folosești `rpg` o singură dată pentru fiecare campanie, ca s-o creezi; după aceea, agentul tău pornește singur RPG Engine. `rpg` de unul singur nu deschide nimic: dashboardul ți-l dă maestrul de joc.
52
52
 
53
53
  ### 2.3 Crearea unei campanii
54
54
 
@@ -58,13 +58,13 @@ Deschide un terminal în dosarul în care ții jocurile tale ([2.1](#21-what-you
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Comanda creează dosarul `The Salt Isles`, cu o campanie nouă în el; intră în el cu `cd "The Salt Isles"`. Ține minte unde se află: te întorci aici de fiecare dată când joci. Pe toate celelalte le alegi mai târziu, în chat sau pe dashboard; `rpg init --help` listează opțiunile prin care poți alege câteva acum, cum ar fi `--language it` sau `--difficulty hard`.
61
+ Comanda creează dosarul `The Salt Isles`, cu o campanie nouă în el; intră în el cu `cd "The Salt Isles"`. Scrie întotdeauna numele: fără nume, dosarul în care te afli devine campania, alături de tot ce conține deja. Ține minte unde se află: te întorci aici de fiecare dată când joci. Pe toate celelalte le alegi mai târziu, în chat sau pe dashboard.
62
62
 
63
63
  Maestrul de joc nu poate crea o campanie în locul tău: înainte de `init`, nimic nu-i spune agentului tău unde se află RPG Engine.
64
64
 
65
65
  ### 2.4 Conectarea AI-ului
66
66
 
67
- Maestrul de joc rulează într-un **agent AI**: o aplicație AI, în terminal sau pe desktop, care poate lucra cu fișierele de pe calculatorul tău, cum ar fi Claude Code sau Codex. Un chat obișnuit, precum claude.ai sau ChatGPT, sau o aplicație de telefon nu ajunge: maestrul de joc trebuie să poată accesa fișierele campaniei de pe calculatorul tău. Fiecare agent are nevoie de propriul abonament și de propria autentificare: Claude Code, un abonament Claude cu plată; Codex, o autentificare ChatGPT. Îl instalezi o singură dată, de pe pagina lui: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
67
+ Maestrul de joc rulează într-un **agent AI**: o aplicație AI, în terminal sau pe desktop, care poate lucra cu fișierele de pe calculatorul tău, cum ar fi Claude Code sau Codex. Un chat obișnuit, precum claude.ai sau ChatGPT, sau o aplicație de telefon nu ajunge: maestrul de joc trebuie să poată accesa fișierele campaniei de pe calculatorul tău. Fiecare agent are nevoie de propriul abonament și de propria autentificare: Claude Code, un abonament Claude cu plată; Codex, o autentificare ChatGPT. Îl instalezi o singură dată, de pe pagina lui: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
68
68
 
69
69
  - **Claude Code**: în dosarul campaniei scrie `claude`. Când te întreabă dacă ai încredere în dosar, alege **Yes, I trust this folder**; atenție, răspunsul deja selectat este *No, exit*. Campania are și un mic hook, `rpg --listen`, pe care întrebarea nu-l arată: îi spune maestrului de joc pe loc când acționezi din dashboard.
70
70
  - **Codex**: în dosarul campaniei scrie `codex` și răspunde da când te întreabă dacă ai încredere în dosar. În aplicația lui desktop, verifică în setări că memoriile sunt oprite pentru chaturile jocului.
@@ -145,7 +145,7 @@ Povestea se desfășoară în **scene**: o luptă, o conversație, o explorare,
145
145
 
146
146
  ### 3.4 Timpul, călătoriile și lumea care se mișcă
147
147
 
148
- RPG Engine ține socoteala datei; între sesiuni nu trece timp. Spune că vă odihniți, *Ne odihnim îndelung*, și, odată ce maestrul de joc este de acord, odihna aduce înapoi ce trebuie. La o odihnă scurtă, maestrul de joc îți poate cere pe tabloul de bord câte zaruri de viață cheltuiești: le arunci pe rând, vezi cât vindecă fiecare și te oprești când vrei. Spune încotro mergeți, *Pornim pe drumul spre nord, către Rocca*, iar RPG Engine calculează drumul, distanța și zilele, oprindu-se când se întâmplă ceva pe cale. Banii se numără în monedele jocului, inclusiv restul.
148
+ RPG Engine ține socoteala datei. Între sesiuni, timpul jocului se oprește, dacă nu alegi în **Setări** să îl lași să treacă, de exemplu o zi de joc pentru fiecare săptămână de absență, sau dacă nu îi ceri maestrului de joc acest lucru. Spune că vă odihniți, *Ne odihnim îndelung*, și, odată ce maestrul de joc este de acord, odihna aduce înapoi ce trebuie. La o odihnă scurtă, maestrul de joc îți poate cere pe tabloul de bord câte zaruri de viață cheltuiești: le arunci pe rând, vezi cât vindecă fiecare și te oprești când vrei. Spune încotro mergeți, *Pornim pe drumul spre nord, către Rocca*, iar RPG Engine calculează drumul, distanța și zilele, oprindu-se când se întâmplă ceva pe cale. Banii se numără în monedele jocului, inclusiv restul.
149
149
 
150
150
  Răufăcătorii au planuri cu termene limită. În fiecare zi nouă, maestrul de joc mișcă amenințările pe care timpul le-a făcut să avanseze, iar tu le vezi semnele, niciodată ceasul în sine.
151
151
 
@@ -203,7 +203,7 @@ Orice setare poate fi schimbată, în chat sau în **Setări**. O decizie pe car
203
203
 
204
204
  O pagină de pe propriul tău calculator, deschisă doar în browserul acelui calculator, activă cât timp chatul este deschis. Când chatul se închide, afișează *Not connected*; revine singură la următorul chat.
205
205
 
206
- - **Grup**: fișa ta și fișele însoțitorilor tăi. Dă clic pe un număr ca să faci o aruncare; ține cursorul deasupra lui ca să vezi de unde vine și, când o săgeată marchează zarul, ce îmbunătățește sau înrăutățește aruncarea. Alături, aruncările.
206
+ - **Grup**: fișa ta și fișele însoțitorilor tăi. Dă clic pe un număr ca să faci o aruncare; ține cursorul deasupra lui ca să vezi de unde vine și, când o săgeată marchează zarul, ce îmbunătățește sau înrăutățește aruncarea. Când maestrul de joc pregătește alegeri pentru tine, de exemplu la un nivel nou, o notificare de pe fișă le deschide: alege când vrei, citește paginile pe care le numesc opțiunile, aruncă acolo unde o opțiune cere o aruncare, apoi confirmă; povestea merge mai departe între timp. Alături, aruncările.
207
207
  - **Scenă**: unde te afli, imaginea și harta ei, cine este de față, ce se întâmplă; într-o luptă, turele și cartonașul personajului tău.
208
208
  - **Jurnal**: misiuni, povestea, jurnalele însoțitorilor tăi, notițele tale.
209
209
  - **Lume**: harta lumii, ce știe personajul tău, documentele găsite și calendarul.
@@ -304,12 +304,14 @@ Fiecare comandă pe care o folosește maestrul de joc poate fi rulată și în f
304
304
 
305
305
  **Maestrul pare să nu cunoască jocul.** Agentul tău nu a încărcat RPG Engine. Verifică dacă l-ai pornit în folderul campaniei și dacă ai avut încredere în el. În Claude Code, scrie `/mcp` și reconectează `rpg`. În Codex, `codex mcp list` în folderul campaniei trebuie să arate `rpg`. Dacă `rpg --version` nu e găsit, instalează din nou RPG Engine ([2.2](#22-install)).
306
306
 
307
+ **Windows nu găsește `claude`.** Programul lui de instalare spune asta într-o notă galbenă, cu dosarul în care s-a instalat: adaugă dosarul respectiv la PATH (System Properties > Environment Variables), apoi deschide un terminal nou.
308
+
307
309
  **Actualizare.** Rulează din nou `npm install -g rpg-engine`, apoi deschide un chat nou: un maestru aflat în rulare păstrează versiunea cu care a pornit.
308
310
 
309
311
  **Maestrul își amintește ceva ce am anulat.** Deschide un chat nou și apasă **Am deschis un chat nou** în Salvări.
310
312
 
311
313
  **Nu apare nicio imagine.** Setări > Imagini arată dacă acest calculator le poate face și cum.
312
314
 
313
- **Instalarea eșuează sau `rpg` nu pornește.** `node --version` trebuie să arate 22 sau mai nou. Pe Windows, ține RPG Engine și campaniile tale departe de căi care conțin `&`.
315
+ **Instalarea eșuează sau `rpg` nu pornește.** `node --version` trebuie să arate 24 sau mai nou. Dacă Windows răspunde că rularea scripturilor este dezactivată, vezi [2.1](#21-what-you-need). Pe Windows, ține RPG Engine și campaniile tale departe de căi care conțin `&`.
314
316
 
315
317
  **Linkul dashboardului s-a schimbat.** Alt program a luat adresa obișnuită; maestrul îți dă noul link.
@@ -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,8 +9,8 @@
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"`.
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` для Claude Code, `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 это Terminal или PowerShell, в macOS — Терминал. Чтобы открыть терминал в нужной папке, щёлкни по папке правой кнопкой мыши и выбери **Открыть в Терминале** (Windows) или **Службы > Новый терминал в папке** (macOS).
42
+ - **Терминал**: в Windows это Terminal или 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"`. Запомни, где она лежит: ты будешь возвращаться в неё каждый раз, когда захочешь играть. Всё остальное ты выберешь позже, в чате или на дашборде. Команда `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 Подключение ИИ
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: 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.
@@ -9,8 +9,8 @@ Den här guiden är till för spelare: du behöver inte kunna programmera.
9
9
 
10
10
  1. Installera **Node.js** från [nodejs.org](https://nodejs.org) (LTS-versionen).
11
11
  2. Installera en **AI-agent**, programmet som spelledaren körs i, och logga in: till exempel Claude Code eller Codex ([2.4](#24-connect-your-ai)).
12
- 3. Installera RPG Engine i en terminal: `npm install -g rpg-engine`.
13
- 4. Skapa en kampanj: `rpg init "The Salt Isles"`.
12
+ 3. Installera RPG Engine i en ny terminal, öppnad efter att Node.js har installerats: `npm install -g rpg-engine`. Om Windows svarar att det är inaktiverat att köra skript, skriv en gång `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, svara ja och försök igen.
13
+ 4. Öppna terminalen i mappen där du förvarar dina spel (högerklicka på mappen och välj **Öppna i Terminal**) och skapa en kampanj, alltid med ett namn: `rpg init "The Salt Isles"`. RPG Engine svarar med två rader på engelska: allt är bra.
14
14
  5. Gå in i den nya mappen med `cd "The Salt Isles"` och starta din agent där: `claude` för Claude Code, `codex` för Codex. Svara ja när den frågar om du litar på mappen ([2.4](#24-connect-your-ai)) och skriv sedan *Hej! Nu börjar vi.* Spelledaren svarar med länken till din dashboard.
15
15
 
16
16
  ## 1. Vad RPG Engine är <!-- icon: about -->
@@ -39,7 +39,7 @@ Ett spel kommer som ett spelsystem, ett paket som spelledaren installerar för d
39
39
 
40
40
  - En dator med Windows, macOS eller Linux, och en webbläsare.
41
41
  - **Node.js 24** eller nyare, från [nodejs.org](https://nodejs.org). Där ingår `npm`, som installerar RPG Engine.
42
- - En **terminal**: i Windows Terminal eller PowerShell, i macOS Terminal. Så öppnar du en i en mapp: högerklicka på mappen och välj **Öppna i Terminal** (Windows) eller **Tjänster > Ny terminal i mappen** (macOS).
42
+ - En **terminal**: i Windows Terminal eller PowerShell, i macOS Terminal. Så öppnar du en i en mapp: högerklicka på mappen och välj **Öppna i Terminal** (Windows) eller **Tjänster > Ny terminal i mappen** (macOS). Om Windows svarar att det är inaktiverat att köra skript, skriv en gång `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` och svara ja.
43
43
  - En **AI-agent** till spelledaren ([2.4](#24-connect-your-ai)), med den **största modellen** den erbjuder: en liten modell går lättare att prata till rätta, så att den avslöjar hemligheter eller bryter mot reglerna.
44
44
 
45
45
  ### 2.2 Installera
@@ -48,7 +48,7 @@ Ett spel kommer som ett spelsystem, ett paket som spelledaren installerar för d
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- Med `rpg --version` kontrollerar du att det gick bra. Du använder `rpg` en gång per kampanj, för att skapa den. Sedan startar din agent RPG Engine själv.
51
+ Med `rpg --version` kontrollerar du att det gick bra. Om npm erbjuder sig att uppdatera sig själv kan du strunta i det. Du använder `rpg` en gång per kampanj, för att skapa den. Sedan startar din agent RPG Engine själv. Enbart `rpg` öppnar ingenting: dashboarden får du av spelledaren.
52
52
 
53
53
  ### 2.3 Skapa en kampanj
54
54
 
@@ -58,13 +58,13 @@ Med `rpg --version` kontrollerar du att det gick bra. Du använder `rpg` en gån
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Det skapar mappen `The Salt Isles` med en ny kampanj i. Gå in i den med `cd "The Salt Isles"`. Kom ihåg var den ligger: du återvänder dit varje gång du spelar. Allt annat väljer du senare, i chatten eller på dashboarden. `rpg init --help` listar alternativen om du vill välja något redan nu, till exempel `--language it` eller `--difficulty hard`.
61
+ Det skapar mappen `The Salt Isles` med en ny kampanj i. Gå in i den med `cd "The Salt Isles"`. Skriv alltid namnet: utan namn blir mappen du står i till kampanjen, bredvid det som redan finns där. Kom ihåg var kampanjen ligger: du återvänder dit varje gång du spelar. Allt annat väljer du senare, i chatten eller på dashboarden.
62
62
 
63
63
  Spelledaren kan inte skapa en kampanj åt dig. Före `init` vet din agent inte var RPG Engine finns.
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://learn.chatgpt.com/docs/codex/cli).
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).
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.
@@ -145,7 +145,7 @@ I en strid berättar spelledaren varje tur som inte är din, och stannar där du
145
145
 
146
146
  ### 3.4 Tid, resor och världen som rör sig
147
147
 
148
- RPG Engine håller reda på datumet. Ingen tid går mellan sessionerna. Säg att ni vilar, *Vi tar en lång vila*, så ger vilan tillbaka det den ska när spelledaren går med på den. Vid en kort vila kan spelledaren fråga på dashboarden hur många träffterningar du använder: slå dem en i taget, se hur mycket var och en läker och sluta när du vill. Säg vart ni går, *Vi tar vägen norrut mot Rocca*, så räknar RPG Engine ut vägen, avståndet och dagarna, och stannar när något händer på vägen. Pengar räknas i spelets mynt, med växel.
148
+ RPG Engine håller reda på datumet. Mellan sessionerna står speltiden still, om du inte väljer i **Inställningar** att låta den gå, till exempel en speldag för varje vecka ni är borta, eller ber spelledaren om det. Säg att ni vilar, *Vi tar en lång vila*, så ger vilan tillbaka det den ska när spelledaren går med på den. Vid en kort vila kan spelledaren fråga på dashboarden hur många träffterningar du använder: slå dem en i taget, se hur mycket var och en läker och sluta när du vill. Säg vart ni går, *Vi tar vägen norrut mot Rocca*, så räknar RPG Engine ut vägen, avståndet och dagarna, och stannar när något händer på vägen. Pengar räknas i spelets mynt, med växel.
149
149
 
150
150
  Skurkar har planer med tidsfrister. Varje ny dag flyttar spelledaren fram de hot som tiden har fört framåt. Du ser tecknen på dem, aldrig själva klockan.
151
151
 
@@ -203,7 +203,7 @@ Varje inställning kan ändras, i chatten eller i **Inställningar**. Ett avgör
203
203
 
204
204
  En sida på din egen dator. Den öppnas bara i webbläsaren på den datorn och är aktiv medan chatten är öppen. När chatten stängs visar den *Not connected*. Den kommer tillbaka av sig själv med nästa chatt.
205
205
 
206
- - **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. Bredvid ser du slagen.
206
+ - **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.
207
207
  - **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.
208
208
  - **Dagbok**: uppdrag, berättelsen, dina följeslagares dagböcker och dina anteckningar.
209
209
  - **Värld**: världskartan, det din rollperson vet, de dokument som hittats och kalendern.
@@ -304,12 +304,14 @@ Varje kommando som spelledaren använder kan också köras i kampanjmappen: `rpg
304
304
 
305
305
  **Spelledaren verkar inte kunna spelet.** Din agent laddade inte RPG Engine. Kontrollera att du startade den i kampanjmappen och att du litade på den. I Claude Code skriver du `/mcp` och återansluter `rpg`. I Codex måste `codex mcp list` i kampanjmappen visa `rpg`. Om `rpg --version` inte hittas, installera RPG Engine igen ([2.2](#22-install)).
306
306
 
307
+ **Windows hittar inte `claude`.** Installationsprogrammet säger till i en gul ruta, med mappen som programmet hamnade i: lägg till den mappen i PATH (Systemegenskaper > Miljövariabler) och öppna sedan en ny terminal.
308
+
307
309
  **Uppdatera.** Kör `npm install -g rpg-engine` igen och öppna sedan en ny chatt: en spelledare som redan körs behåller den version den startade med.
308
310
 
309
311
  **Spelledaren minns något jag ångrade.** Öppna en ny chatt och tryck på **Jag har öppnat en ny chatt** i Sparade spel.
310
312
 
311
313
  **Inga bilder visas.** Inställningar > Bilder visar om den här datorn kan göra dem, och hur.
312
314
 
313
- **Installationen misslyckas, eller `rpg` startar inte.** `node --version` måste visa 22 eller senare. I Windows: håll RPG Engine och dina kampanjer borta från sökvägar som innehåller `&`.
315
+ **Installationen misslyckas, eller `rpg` startar inte.** `node --version` måste visa 24 eller senare. Om Windows svarar att det är inaktiverat att köra skript, se [2.1](#21-what-you-need). I Windows: håll RPG Engine och dina kampanjer borta från sökvägar som innehåller `&`.
314
316
 
315
317
  **Dashboardlänken ändrades.** Ett annat program tog den vanliga adressen. Spelledaren ger dig den nya länken.
@@ -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: 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.
@@ -9,8 +9,8 @@ Bu kılavuz oyuncular için yazıldı: program yazmayı bilmen gerekmez.
9
9
 
10
10
  1. [nodejs.org](https://nodejs.org) adresinden **Node.js** kur (LTS sürümü).
11
11
  2. Bir **yapay zekâ ajanı** kur ve giriş yap. Oyun yöneticisi bu programın içinde çalışır. Örneğin Claude Code ya da Codex ([2.4](#24-connect-your-ai)).
12
- 3. Bir terminalde RPG Engine'i kur: `npm install -g rpg-engine`.
13
- 4. Bir kampanya oluştur: `rpg init "The Salt Isles"`.
12
+ 3. Node.js kurulduktan sonra açtığın yeni bir terminalde RPG Engine'i kur: `npm install -g rpg-engine`. Windows betiklerin çalıştırılmasının devre dışı olduğunu söylerse, bir kez `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` yaz, evet de ve yeniden dene.
13
+ 4. Terminali oyunlarını tuttuğun klasörde aç (klasöre sağ tıkla, **Terminalde Aç**) ve her zaman adını yazarak bir kampanya oluştur: `rpg init "The Salt Isles"`. RPG Engine İngilizce iki satırla yanıt verir: her şey yolunda.
14
14
  5. Yeni klasöre gir, `cd "The Salt Isles"`, ve ajanını orada başlat: Claude Code için `claude`, Codex için `codex`. Klasöre güvenip güvenmediğini sorduğunda evet de ([2.4](#24-connect-your-ai)), sonra *Merhaba! Başlayalım.* yaz. Oyun yöneticisi gösterge panelinin bağlantısıyla yanıt verir.
15
15
 
16
16
  ## 1. RPG Engine nedir <!-- icon: about -->
@@ -39,7 +39,7 @@ Bir oyun, oyun sistemiyle gelir. Oyun sistemi, oyun yöneticisinin macerana kurd
39
39
 
40
40
  - Windows, macOS veya Linux yüklü bir bilgisayar ve bir web tarayıcısı.
41
41
  - [nodejs.org](https://nodejs.org) adresinden **Node.js 24** veya daha yenisi. Yanında `npm` gelir; RPG Engine'i o kurar.
42
- - Bir **terminal**: Windows'ta Terminal ya da PowerShell; macOS'ta Terminal. Terminali bir klasörde açmak için klasöre sağ tıkla ve **Terminalde Aç** (Windows) ya da **Servisler > Klasörde Yeni Terminal** (macOS) seçeneğini seç.
42
+ - Bir **terminal**: Windows'ta Terminal ya da PowerShell; macOS'ta Terminal. Terminali bir klasörde açmak için klasöre sağ tıkla ve **Terminalde Aç** (Windows) ya da **Servisler > Klasörde Yeni Terminal** (macOS) seçeneğini seç. Windows betiklerin çalıştırılmasının devre dışı olduğunu söylerse, bir kez `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` yaz ve evet de.
43
43
  - Oyun yöneticisi için bir **yapay zekâ ajanı** ([2.4](#24-connect-your-ai)). Ajanın sunduğu **en büyük modeli** kullan: küçük bir modeli sır vermeye ya da kuralları esnetmeye ikna etmek daha kolaydır.
44
44
 
45
45
  ### 2.2 Kurulum
@@ -48,7 +48,7 @@ Bir oyun, oyun sistemiyle gelir. Oyun sistemi, oyun yöneticisinin macerana kurd
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- `rpg --version` komutu kurulumun işe yaradığını doğrular. `rpg` komutunu kampanya başına bir kez, kampanyayı oluşturmak için kullanırsın. Sonrasında ajanın RPG Engine'i kendisi başlatır.
51
+ `rpg --version` komutu kurulumun işe yaradığını doğrular. npm kendini güncellemeyi önerirse bunu yok sayabilirsin. `rpg` komutunu kampanya başına bir kez, kampanyayı oluşturmak için kullanırsın. Sonrasında ajanın RPG Engine'i kendisi başlatır. Tek başına `rpg` hiçbir şey açmaz: gösterge panelini oyun yöneticisi verir.
52
52
 
53
53
  ### 2.3 Kampanya oluşturma
54
54
 
@@ -58,13 +58,13 @@ Oyunlarını tuttuğun klasörde bir terminal aç ([2.1](#21-what-you-need) nas
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Bu komut `The Salt Isles` adında bir klasör ve içinde yeni bir kampanya oluşturur. `cd "The Salt Isles"` ile klasörün içine gir. Yerini unutma: oynadığın her seferde buraya döneceksin. Geri kalan her şeyi sonra, sohbette ya da panoda seçersin. `rpg init --help` komutu, bazılarını şimdiden seçmen için seçenekleri listeler; örneğin `--language it` ya da `--difficulty hard`.
61
+ Bu komut `The Salt Isles` adında bir klasör ve içinde yeni bir kampanya oluşturur. `cd "The Salt Isles"` ile klasörün içine gir. Adı her zaman yaz: adı yazmazsan içinde bulunduğun klasör kampanya olur ve içindeki her şeyin yanında yer alır. Yerini unutma: oynadığın her seferde buraya döneceksin. Geri kalan her şeyi sonra, sohbette ya da gösterge panelinde seçersin.
62
62
 
63
63
  Oyun yöneticisi senin için kampanya oluşturamaz: `init` çalışmadan önce ajanına RPG Engine'in nerede olduğunu söyleyen hiçbir şey yoktur.
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://learn.chatgpt.com/docs/codex/cli).
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).
68
68
 
69
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.
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.
@@ -145,7 +145,7 @@ Bir çatışmada, sırası sende olmayan her sırayı oyun yöneticisi anlatır
145
145
 
146
146
  ### 3.4 Zaman, yolculuk ve hareket eden dünya
147
147
 
148
- RPG Engine tarihi tutar; oturumlar arasında zaman geçmez. Dinlendiğini söyle, *Uzun bir dinlenme yapıyoruz*; oyun yöneticisi kabul edince dinlenme geri getirmesi gerekeni geri getirir. Kısa bir dinlenmede oyun yöneticisi gösterge panelinden kaç can zarı harcadığını sorabilir: zarları tek tek at, her birinin ne kadar iyileştirdiğini gör ve istediğin zaman dur. Nereye gittiğini söyle, *Kuzeye, Rocca'ya giden yola çıkıyoruz*; RPG Engine yolu, mesafeyi ve günleri hesaplar, yolda bir şey olursa durur. Para oyunun madeni paralarıyla sayılır, para üstü dahil.
148
+ RPG Engine tarihi tutar. Oturumlar arasında oyun zamanı durur; ama **Ayarlar**'dan zamanın akmasına izin verebilirsin, örneğin uzakta geçen her hafta için oyunda bir gün, ya da bunu oyun yöneticisinden isteyebilirsin. Dinlendiğini söyle, *Uzun bir dinlenme yapıyoruz*; oyun yöneticisi kabul edince dinlenme geri getirmesi gerekeni geri getirir. Kısa bir dinlenmede oyun yöneticisi gösterge panelinden kaç can zarı harcadığını sorabilir: zarları tek tek at, her birinin ne kadar iyileştirdiğini gör ve istediğin zaman dur. Nereye gittiğini söyle, *Kuzeye, Rocca'ya giden yola çıkıyoruz*; RPG Engine yolu, mesafeyi ve günleri hesaplar, yolda bir şey olursa durur. Para oyunun madeni paralarıyla sayılır, para üstü dahil.
149
149
 
150
150
  Kötülerin son tarihli planları vardır. Her yeni günde oyun yöneticisi, zamanın ilerlettiği tehditleri hareket ettirir. Sen onların izlerini görürsün, saatin kendisini asla.
151
151
 
@@ -203,7 +203,7 @@ Her ayar değiştirilebilir, sohbette ya da **Ayarlar**'da. Oyun yöneticisinin
203
203
 
204
204
  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.
205
205
 
206
- - **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. Yanında atışlar yer alır.
206
+ - **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.
207
207
  - **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.
208
208
  - **Günlük**: görevler, hikâye, yoldaşlarının günlükleri, notların.
209
209
  - **Dünya**: dünya haritası, karakterinin bildikleri, bulunan belgeler ve takvim.
@@ -304,12 +304,14 @@ Oyun yöneticisinin kullandığı her komut kampanya klasöründe de çalıştı
304
304
 
305
305
  **Oyun yöneticisi oyunu bilmiyor gibi.** Ajanın RPG Engine'i yüklemedi. Onu kampanya klasöründe başlattığını ve klasöre güvendiğini kontrol et. Claude Code'da `/mcp` yaz ve `rpg`'yi yeniden bağla. Codex'te kampanya klasöründe `codex mcp list` çıktısında `rpg` görünmelidir. `rpg --version` bulunamıyorsa RPG Engine'i yeniden kur ([2.2](#22-install)).
306
306
 
307
+ **Windows `claude` komutunu bulamıyor.** Kurulum programı bunu sarı bir notla söyler ve programın girdiği klasörü gösterir. O klasörü PATH'e ekle (Sistem Özellikleri > Ortam Değişkenleri), sonra yeni bir terminal aç.
308
+
307
309
  **Güncelleme.** `npm install -g rpg-engine` komutunu yeniden çalıştır, sonra yeni bir sohbet aç: çalışan bir oyun yöneticisi başladığı sürümü korur.
308
310
 
309
311
  **Oyun yöneticisi geri aldığım bir şeyi hatırlıyor.** Yeni bir sohbet aç ve Kayıtlar'da **Yeni sohbet açtım** düğmesine bas.
310
312
 
311
313
  **Hiç görsel çıkmıyor.** Ayarlar > Görseller, bu bilgisayarın görsel yapıp yapamadığını ve nasıl yapabileceğini söyler.
312
314
 
313
- **Kurulum başarısız oluyor veya `rpg` başlamıyor.** `node --version` çıktısı 22 veya daha yeni olmalı. Windows'ta RPG Engine'i ve kampanyalarını `&` içeren yollardan uzak tut.
315
+ **Kurulum başarısız oluyor veya `rpg` başlamıyor.** `node --version` çıktısı 24 veya daha yeni olmalı. Windows betiklerin çalıştırılmasının devre dışı olduğunu söylerse [2.1](#21-what-you-need) bölümüne bak. Windows'ta RPG Engine'i ve kampanyalarını `&` içeren yollardan uzak tut.
314
316
 
315
317
  **Panel bağlantısı değişti.** Başka bir program olağan adresi aldı; oyun yöneticisi sana yeni bağlantıyı verir.