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 : le guide complet
3
3
 
4
4
  **RPG Engine** te permet de jouer à un jeu de rôle sur table avec une **IA comme MJ**. Tu parles avec le MJ dans un **chat**. RPG Engine travaille en coulisses : il **garde en mémoire le monde**, **lance les dés** et **tient les comptes**. À côté du chat, tu gardes ouverte dans ton navigateur une page, le **tableau de bord**, avec ta fiche, les dés, les cartes et ton journal.
@@ -9,8 +9,8 @@ Ce guide s'adresse aux joueurs et joueuses : tu n'as pas besoin de savoir progra
9
9
 
10
10
  1. Installe **Node.js** depuis [nodejs.org](https://nodejs.org) (la version LTS).
11
11
  2. Installe un **agent IA**, le programme dans lequel le MJ fonctionne, et connecte-toi : par exemple Claude Code ou Codex ([2.4](#24-connect-your-ai)).
12
- 3. Dans un terminal, installe RPG Engine : `npm install -g rpg-engine`.
13
- 4. Crée une campagne : `rpg init "The Salt Isles"`.
12
+ 3. Dans un nouveau terminal, ouvert après l'installation de Node.js, installe RPG Engine : `npm install -g rpg-engine`. Si Windows répond que l'exécution de scripts est désactivée, écris une fois `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, réponds oui et réessaie.
13
+ 4. Ouvre le terminal dans le dossier où tu ranges tes jeux (clic droit sur le dossier, **Ouvrir dans le Terminal**) et crée une campagne, toujours avec son nom : `rpg init "The Salt Isles"`. RPG Engine répond par deux lignes en anglais : tout va bien.
14
14
  5. Entre dans le nouveau dossier, `cd "The Salt Isles"`, et lance ton agent à cet endroit : `claude` pour Claude Code, `codex` pour Codex. Réponds oui quand il demande si tu fais confiance au dossier ([2.4](#24-connect-your-ai)), puis écris *Salut ! On commence.* Le MJ répond avec le lien vers ton tableau de bord.
15
15
 
16
16
  ## 1. Qu'est-ce que RPG Engine <!-- icon: about -->
@@ -39,7 +39,7 @@ Un jeu prend la forme d'un système de jeu, un paquet que le MJ installe pour ta
39
39
 
40
40
  - Un ordinateur sous Windows, macOS ou Linux, et un navigateur web.
41
41
  - **Node.js 24** ou plus récent, sur [nodejs.org](https://nodejs.org). Il apporte `npm`, qui installe RPG Engine.
42
- - Un **terminal** : sous Windows, Terminal ou PowerShell ; sous macOS, Terminal. Pour en ouvrir un dans un dossier, fais un clic droit sur le dossier et choisis **Ouvrir dans le Terminal** (Windows) ou **Services > Nouveau terminal au dossier** (macOS).
42
+ - Un **terminal** : sous Windows, Terminal ou PowerShell ; sous macOS, Terminal. Pour en ouvrir un dans un dossier, fais un clic droit sur le dossier et choisis **Ouvrir dans le Terminal** (Windows) ou **Services > Nouveau terminal au dossier** (macOS). Si Windows répond que l'exécution de scripts est désactivée, écris une fois `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` et réponds oui.
43
43
  - Un **agent IA** pour le MJ ([2.4](#24-connect-your-ai)), avec le **plus grand modèle** qu'il propose : un petit modèle se laisse plus facilement convaincre de révéler des secrets ou de contourner les règles.
44
44
 
45
45
  ### 2.2 Installer
@@ -48,7 +48,7 @@ Un jeu prend la forme d'un système de jeu, un paquet que le MJ installe pour ta
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- `rpg --version` vérifie que tout a fonctionné. Tu utilises `rpg` une seule fois par campagne, pour la créer ; ensuite, ton agent lance RPG Engine tout seul.
51
+ `rpg --version` vérifie que tout a fonctionné. Si npm propose de se mettre à jour, tu peux l'ignorer. Tu utilises `rpg` une seule fois par campagne, pour la créer ; ensuite, ton agent lance RPG Engine tout seul. `rpg` seul n'ouvre rien : c'est le MJ qui te donne le tableau de bord.
52
52
 
53
53
  ### 2.3 Créer une campagne
54
54
 
@@ -58,13 +58,13 @@ Ouvre un terminal dans le dossier où tu ranges tes jeux ([2.1](#21-what-you-nee
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Cela crée le dossier `The Salt Isles` avec une nouvelle campagne dedans ; entres-y avec `cd "The Salt Isles"`. Retiens où il se trouve : tu y reviendras à chaque partie. Tu choisiras tout le reste plus tard, dans le chat ou sur le dashboard ; `rpg init --help` liste les options pour en choisir certaines dès maintenant, comme `--language it` ou `--difficulty hard`.
61
+ Cela crée le dossier `The Salt Isles` avec une nouvelle campagne dedans ; entres-y avec `cd "The Salt Isles"`. Écris toujours le nom : sans nom, le dossier où tu te trouves devient la campagne, à côté de tout ce qu'il contient déjà. Retiens où il se trouve : tu y reviendras à chaque partie. Tu choisiras tout le reste plus tard, dans le chat ou sur le tableau de bord.
62
62
 
63
63
  Le MJ ne peut pas créer une campagne à ta place : avant `init`, rien n'indique à ton agent où se trouve RPG Engine.
64
64
 
65
65
  ### 2.4 Connecter ton IA
66
66
 
67
- Le MJ tourne dans un **agent IA** : une appli d'IA, dans le terminal ou sur le bureau, qui peut travailler avec les fichiers de ton ordinateur, comme Claude Code ou Codex. Un simple chat comme claude.ai ou ChatGPT, ou une appli de téléphone, ne suffit pas : le MJ doit pouvoir accéder aux fichiers de la campagne sur ton ordinateur. Chaque agent demande son propre abonnement et sa propre connexion : Claude Code un abonnement Claude payant, Codex une connexion ChatGPT. Tu l'installes une seule fois, depuis sa propre page : [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
67
+ Le MJ tourne dans un **agent IA** : une appli d'IA, dans le terminal ou sur le bureau, qui peut travailler avec les fichiers de ton ordinateur, comme Claude Code ou Codex. Un simple chat comme claude.ai ou ChatGPT, ou une appli de téléphone, ne suffit pas : le MJ doit pouvoir accéder aux fichiers de la campagne sur ton ordinateur. Chaque agent demande son propre abonnement et sa propre connexion : Claude Code un abonnement Claude payant, Codex une connexion ChatGPT. Tu l'installes une seule fois, depuis sa propre page : [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
68
68
 
69
69
  - **Claude Code** : dans le dossier de la campagne, écris `claude`. Quand il demande si tu fais confiance au dossier, choisis **Yes, I trust this folder** ; attention, la réponse déjà sélectionnée est *No, exit*. La campagne contient aussi un petit hook, `rpg --listen`, que la question ne montre pas : il prévient aussitôt le MJ quand tu agis depuis le dashboard.
70
70
  - **Codex** : dans le dossier de la campagne, écris `codex`, et réponds oui quand il demande si tu fais confiance au dossier. Dans son appli de bureau, vérifie dans les paramètres que les mémoires sont désactivées pour les chats du jeu.
@@ -145,7 +145,7 @@ Dans un combat, le MJ raconte chaque tour qui n'est pas le tien, et s'arrête au
145
145
 
146
146
  ### 3.4 Temps, voyage et monde qui bouge
147
147
 
148
- RPG Engine tient la date ; aucun temps ne passe entre deux sessions. Dis que vous vous reposez, *On fait un long repos*, et quand le MJ est d'accord, le repos rend ce qu'il doit rendre. Pendant un repos court, le MJ peut te demander sur le tableau de bord combien de dés de vie tu dépenses : lance-les un par un, vois ce que chacun soigne, et arrête-toi quand tu veux. Dis où tu vas, *On prend la route du nord vers Rocca*, et RPG Engine calcule le chemin, la distance et les jours, en s'arrêtant quand quelque chose se passe en route. L'argent se compte en pièces du jeu, monnaie rendue comprise.
148
+ RPG Engine tient la date. Entre deux sessions, le temps du jeu s'arrête, sauf si tu choisis dans **Paramètres** de le laisser filer, par exemple un jour de jeu pour chaque semaine d'absence, ou si tu le demandes au MJ. Dis que vous vous reposez, *On fait un long repos*, et quand le MJ est d'accord, le repos rend ce qu'il doit rendre. Pendant un repos court, le MJ peut te demander sur le tableau de bord combien de dés de vie tu dépenses : lance-les un par un, vois ce que chacun soigne, et arrête-toi quand tu veux. Dis où tu vas, *On prend la route du nord vers Rocca*, et RPG Engine calcule le chemin, la distance et les jours, en s'arrêtant quand quelque chose se passe en route. L'argent se compte en pièces du jeu, monnaie rendue comprise.
149
149
 
150
150
  Les méchants ont des plans avec des échéances. Chaque nouveau jour, le MJ fait avancer les menaces que le temps a fait progresser, et tu en vois les signes, jamais l'horloge elle-même.
151
151
 
@@ -203,7 +203,7 @@ Chaque réglage peut changer, dans le chat ou dans **Paramètres**. Une décisio
203
203
 
204
204
  Une page sur ton propre ordinateur, ouverte uniquement dans le navigateur de cet ordinateur, active tant que le chat est ouvert. Quand le chat se ferme, elle affiche *Not connected*. Elle revient toute seule avec le prochain chat.
205
205
 
206
- - **Groupe**&nbsp;: ta fiche et celles de tes compagnons. Clique sur un nombre pour le lancer. Survole-le pour voir d'où il vient et, quand une flèche marque son dé, ce qui améliore ou aggrave le jet. À côté, les jets.
206
+ - **Groupe**&nbsp;: ta fiche et celles de tes compagnons. Clique sur un nombre pour le lancer. Survole-le pour voir d'où il vient et, quand une flèche marque son dé, ce qui améliore ou aggrave le jet. Quand le MJ te prépare des choix, par exemple à un nouveau niveau, un avis sur la fiche les ouvre&nbsp;: choisis quand tu veux, lis les pages que nomment les options, lance les dés là où une option le demande, puis confirme. L'histoire continue pendant ce temps. À côté, les jets.
207
207
  - **Scène**&nbsp;: où tu es, son image et sa carte, qui est là, ce qui se passe. Pendant un combat, les tours et la carte de ton personnage.
208
208
  - **Journal**&nbsp;: les quêtes, l'histoire, les journaux de tes compagnons, tes notes.
209
209
  - **Monde**&nbsp;: la carte du monde, ce que sait ton personnage, les documents trouvés et le calendrier.
@@ -304,12 +304,14 @@ Toutes les commandes que le MJ utilise peuvent aussi être lancées dans le doss
304
304
 
305
305
  **Le MJ ne semble pas connaître le jeu.** Ton agent n'a pas chargé RPG Engine. Vérifie que tu l'as lancé dans le dossier de la campagne et que tu lui as fait confiance. Dans Claude Code, écris `/mcp` et reconnecte `rpg`. Dans Codex, `codex mcp list` dans le dossier de la campagne doit afficher `rpg`. Si `rpg --version` est introuvable, réinstalle RPG Engine ([2.2](#22-install)).
306
306
 
307
+ **Windows ne trouve pas `claude`.** Son installateur le signale dans une note jaune, avec le dossier où il s'est installé : ajoute ce dossier au PATH (Propriétés système > Variables d'environnement), puis ouvre un nouveau terminal.
308
+
307
309
  **Mise à jour.** Relance `npm install -g rpg-engine`, puis ouvre un nouveau chat : un MJ déjà en cours garde la version avec laquelle il a démarré.
308
310
 
309
311
  **Le MJ se souvient de quelque chose que j'ai annulé.** Ouvre un nouveau chat et appuie sur **J'ai ouvert un nouveau chat** dans Sauvegardes.
310
312
 
311
313
  **Aucune image n'apparaît.** Paramètres > Images indique si cet ordinateur peut en créer, et comment.
312
314
 
313
- **L'installation échoue, ou `rpg` ne démarre pas.** `node --version` doit afficher 22 ou plus. Sous Windows, garde RPG Engine et tes campagnes loin des chemins qui contiennent `&`.
315
+ **L'installation échoue, ou `rpg` ne démarre pas.** `node --version` doit afficher 24 ou plus. Si Windows répond que l'exécution de scripts est désactivée, consulte [2.1](#21-what-you-need). Sous Windows, garde RPG Engine et tes campagnes loin des chemins qui contiennent `&`.
314
316
 
315
317
  **Le lien du tableau de bord a changé.** Un autre programme a pris l'adresse habituelle ; le MJ te donne le nouveau lien.
@@ -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 עובד מאחורי הקלעים: הוא **זוכר את העולם**, **מטיל את הקוביות** ו**מנהל את החשבונות**. לצד הצ'אט משאירים בדפדפן דף פתוח, **הלוח** (dashboard), עם דף הדמות, הקוביות, המפות והיומן.
@@ -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`, לענות yes ולנסות שוב.
13
+ 4. לפתוח את הטרמינל בתיקייה שבה שומרים את המשחקים (לחיצה ימנית עליה, **Open in Terminal**) וליצור קמפיין, תמיד עם שם: `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, Terminal. כדי לפתוח טרמינל בתוך תיקייה, לוחצים עליה לחיצה ימנית ובוחרים **Open in Terminal** (ב-Windows) או **Services > New Terminal at Folder** (ב-macOS).
42
+ - **טרמינל**: ב-Windows, Terminal או PowerShell; ב-macOS, Terminal. כדי לפתוח טרמינל בתוך תיקייה, לוחצים עליה לחיצה ימנית ובוחרים **Open in Terminal** (ב-Windows) או **Services > New Terminal at Folder** (ב-macOS). אם Windows משיבה שהרצת סקריפטים מושבתת, לכתוב פעם אחת `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` ולענות yes.
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`, ועונים yes כשהוא שואל אם לסמוך על התיקייה. באפליקציית שולחן העבודה שלו, כדאי לבדוק בהגדרות שהזיכרונות כבויים בצ'אטים של המשחק.
@@ -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 (System Properties > Environment Variables), ואז לפתוח טרמינל חדש.
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. जिस फ़ोल्डर में आप अपने गेम रखते हैं, उसमें टर्मिनल खोलें (उस पर राइट-क्लिक करें, **Open in Terminal**) और कैंपेन बनाएँ, हमेशा उसके नाम के साथ: `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 पर Terminal या PowerShell; macOS पर Terminal। किसी फ़ोल्डर में टर्मिनल खोलने के लिए फ़ोल्डर पर राइट-क्लिक करें और **Open in Terminal** (Windows) या **Services > New Terminal at Folder** (macOS) चुनें।
42
+ - एक **टर्मिनल**: Windows पर Terminal या PowerShell; macOS पर Terminal। किसी फ़ोल्डर में टर्मिनल खोलने के लिए फ़ोल्डर पर राइट-क्लिक करें और **Open in Terminal** (Windows) या **Services > New Terminal at Folder** (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 तारीख़ का हिसाब रखता है; सेशनों के बीच कोई समय नहीं बीतता। आप कहें कि आप आराम करते हैं, *हम लंबा आराम करते हैं*, और गेम मास्टर के मान लेने पर आराम से वह सब लौट आता है जो लौटना चाहिए। छोटे आराम में गेम मास्टर डैशबोर्ड पर पूछ सकता है कि आप कितने हिट डाइस खर्च करते हैं: उन्हें एक-एक करके रोल करें, देखें कि हर एक से कितना ठीक होता है, और जब चाहें रुक जाएँ। बताएँ कि आप कहाँ जाते हैं, *हम उत्तर की सड़क से Rocca जाते हैं*, और RPG Engine रास्ता, दूरी और दिन निकाल लेता है, और रास्ते में कुछ होने पर रुक जाता है। पैसे का हिसाब खेल के सिक्कों में होता है, छुट्टे समेत।
148
+ RPG Engine तारीख़ का हिसाब रखता है। सेशनों के बीच खेल का समय रुक जाता है, जब तक आप **सेटिंग्स** में उसे चलने देना न चुनें, जैसे दूर रहने के हर हफ़्ते के लिए खेल का एक दिन, या गेम मास्टर से न कहें। आप कहें कि आप आराम करते हैं, *हम लंबा आराम करते हैं*, और गेम मास्टर के मान लेने पर आराम से वह सब लौट आता है जो लौटना चाहिए। छोटे आराम में गेम मास्टर डैशबोर्ड पर पूछ सकता है कि आप कितने हिट डाइस खर्च करते हैं: उन्हें एक-एक करके रोल करें, देखें कि हर एक से कितना ठीक होता है, और जब चाहें रुक जाएँ। बताएँ कि आप कहाँ जाते हैं, *हम उत्तर की सड़क से Rocca जाते हैं*, और 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 में जोड़ें (System Properties > Environment Variables), फिर नया टर्मिनल खोलें।
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: a teljes útmutató
3
3
 
4
4
  Az **RPG Engine** lehetővé teszi, hogy asztali szerepjátékot játssz egy **MI mesélővel**. A mesélővel egy **csevegésben** beszélgetsz; az RPG Engine a háttérben dolgozik: **emlékszik a világra**, **dob a kockákkal** és **vezeti a számokat**. A csevegés mellett egy oldalt tartasz nyitva a böngészőben, ez a **vezérlőpult**, rajta a karakterlapoddal, a kockákkal, a térképekkel és a naplóddal.
@@ -9,8 +9,8 @@ Az útmutató játékosoknak szól: nem kell tudnod programozni.
9
9
 
10
10
  1. Telepítsd a **Node.js**-t a [nodejs.org](https://nodejs.org) oldalról (az LTS verziót).
11
11
  2. Telepíts egy **MI-ügynököt**, azt a programot, amelyben a mesélő fut, és jelentkezz be: például Claude Code vagy Codex ([2.4](#24-connect-your-ai)).
12
- 3. Egy terminálban telepítsd az RPG Engine-t: `npm install -g rpg-engine`.
13
- 4. Hozz létre egy kampányt: `rpg init "The Salt Isles"`.
12
+ 3. Egy új terminálban, amelyet a Node.js telepítése után nyitottál, telepítsd az RPG Engine-t: `npm install -g rpg-engine`. Ha a Windows azt válaszolja, hogy a szkriptek futtatása le van tiltva, írd be egyszer: `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, válaszolj igennel, és próbáld újra.
13
+ 4. Nyisd meg a terminált abban a mappában, ahol a játékaidat tartod (kattints rá jobb gombbal, **Megnyitás a Terminalban**), és hozz létre egy kampányt, mindig a nevével: `rpg init "The Salt Isles"`. Az RPG Engine két angol sorral válaszol: minden rendben.
14
14
  5. Lépj be az új mappába: `cd "The Salt Isles"`, és indítsd el ott az ügynöködet: `claude` a Claude Code-hoz, `codex` a Codexhez. Mondj igent, amikor megkérdezi, megbízol-e a mappában ([2.4](#24-connect-your-ai)), aztán írd be: *Szia! Kezdjünk bele.* A mesélő válaszul megadja a vezérlőpulted linkjét.
15
15
 
16
16
  ## 1. Mi az az RPG Engine <!-- icon: about -->
@@ -39,7 +39,7 @@ A játék egy játékrendszerrel érkezik, egy csomaggal, amelyet a mesélő tel
39
39
 
40
40
  - Egy számítógép Windows, macOS vagy Linux rendszerrel, és egy webböngésző.
41
41
  - **Node.js 24** vagy újabb, a [nodejs.org](https://nodejs.org) oldalról. Ezzel jön az `npm`, amely telepíti az RPG Enginet.
42
- - Egy **terminál**: Windowson a Terminal vagy a PowerShell, macOS-en a Terminal. Ha egy mappában akarsz terminált nyitni, kattints a mappára jobb gombbal, és válaszd a **Megnyitás a Terminalban** (Windows) vagy a **Szolgáltatások > Új terminál a mappához** (macOS) lehetőséget.
42
+ - Egy **terminál**: Windowson a Terminal vagy a PowerShell, macOS-en a Terminal. Ha egy mappában akarsz terminált nyitni, kattints a mappára jobb gombbal, és válaszd a **Megnyitás a Terminalban** (Windows) vagy a **Szolgáltatások > Új terminál a mappához** (macOS) lehetőséget. Ha a Windows azt válaszolja, hogy a szkriptek futtatása le van tiltva, írd be egyszer: `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, és válaszolj igennel.
43
43
  - Egy **AI-ügynök** a mesélőnek ([2.4](#24-connect-your-ai)), a hozzá elérhető **legnagyobb modellel**: egy kis modellt könnyebb rávenni a titkok kiadására vagy a szabályok kijátszására.
44
44
 
45
45
  ### 2.2 Telepítés
@@ -48,7 +48,7 @@ A játék egy játékrendszerrel érkezik, egy csomaggal, amelyet a mesélő tel
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- Az `rpg --version` parancs megmutatja, hogy sikerült-e. Az `rpg` parancsot kampányonként egyszer használod, a létrehozáshoz. Ezután az ügynököd magától elindítja az RPG Enginet.
51
+ Az `rpg --version` parancs megmutatja, hogy sikerült-e. Ha az npm felajánlja, hogy frissíti magát, nyugodtan figyelmen kívül hagyhatod. Az `rpg` parancsot kampányonként egyszer használod, a létrehozáshoz. Ezután az ügynököd magától elindítja az RPG Enginet. Az `rpg` önmagában semmit sem nyit meg: a vezérlőpultot a mesélő adja meg.
52
52
 
53
53
  ### 2.3 Kampány létrehozása
54
54
 
@@ -58,13 +58,13 @@ Nyiss egy terminált abban a mappában, ahol a játékaidat tartod (a [2.1](#21-
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Ez létrehozza a `The Salt Isles` mappát egy új kampánnyal. Lépj be a `cd "The Salt Isles"` paranccsal. Jegyezd meg, hol van: minden játékalkalommal ide térsz vissza. Mindent másról később döntesz, a chaten vagy a vezérlőpulton. Az `rpg init --help` felsorolja a lehetőségeket, amelyeket már most megadhatsz, például `--language it` vagy `--difficulty hard`.
61
+ Ez létrehozza a `The Salt Isles` mappát egy új kampánnyal. Lépj be a `cd "The Salt Isles"` paranccsal. Mindig írd be a nevet: név nélkül az a mappa lesz a kampány, amelyben éppen vagy, amellett, ami már benne van. Jegyezd meg, hol van: minden játékalkalommal ide térsz vissza. Mindent másról később döntesz, a chaten vagy a vezérlőpulton.
62
62
 
63
63
  A mesélő nem tud kampányt létrehozni neked: az `init` előtt semmi sem mondja meg az ügynöködnek, hol van az RPG Engine.
64
64
 
65
65
  ### 2.4 Az AI csatlakoztatása
66
66
 
67
- A mesélő egy **AI-ügynökben** fut. Ez egy AI-alkalmazás a terminálban vagy az asztalon, amely a számítógéped fájljaival is tud dolgozni, például a Claude Code vagy a Codex. Egy sima chat, például a claude.ai vagy a ChatGPT, illetve egy telefonos alkalmazás nem elég: a mesélőnek el kell érnie a kampány fájljait a számítógépeden. Minden ügynökhöz saját csomag és bejelentkezés kell: a Claude Code-hoz fizetős Claude-csomag, a Codexhez ChatGPT-bejelentkezés. Egyszer kell telepítened, a saját oldaláról: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
67
+ A mesélő egy **AI-ügynökben** fut. Ez egy AI-alkalmazás a terminálban vagy az asztalon, amely a számítógéped fájljaival is tud dolgozni, például a Claude Code vagy a Codex. Egy sima chat, például a claude.ai vagy a ChatGPT, illetve egy telefonos alkalmazás nem elég: a mesélőnek el kell érnie a kampány fájljait a számítógépeden. Minden ügynökhöz saját csomag és bejelentkezés kell: a Claude Code-hoz fizetős Claude-csomag, a Codexhez ChatGPT-bejelentkezés. Egyszer kell telepítened, a saját oldaláról: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
68
68
 
69
69
  - **Claude Code**: a kampány mappájában írd be: `claude`. Amikor megkérdezi, megbízol-e a mappában, válaszd a **Yes, I trust this folder** lehetőséget. Vigyázz, az előre kijelölt válasz a *No, exit*. A kampányban van egy kis hook is, az `rpg --listen`, amelyet a kérdés nem mutat: azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel.
70
70
  - **Codex**: a kampány mappájában írd be: `codex`, és mondj igent, amikor megkérdezi, megbízol-e a mappában. Az asztali alkalmazásában ellenőrizd a beállításokban, hogy a memóriák ki vannak kapcsolva a játék chatjeinél.
@@ -145,7 +145,7 @@ Harcban a mesélő elmondja az összes kört, amely nem a tiéd, és ott áll me
145
145
 
146
146
  ### 3.4 Idő, utazás és a mozgó világ
147
147
 
148
- Az RPG Engine vezeti a dátumot; az alkalmak között nem telik az idő. Mondd, hogy pihensz, *Hosszú pihenőt tartunk*, és ha a mesélő beleegyezik, a pihenő visszaadja, amit kell. Rövid pihenőnél a mesélő a vezérlőpulton megkérdezheti, hány életerőkockát költesz el: egyenként dobd őket, nézd meg, mennyit gyógyít mindegyik, és állj meg, amikor akarsz. Mondd meg, merre mész, *Észak felé indulunk Roccába*, és az RPG Engine kiszámolja az utat, a távolságot és a napokat, és megáll, ha történik valami az úton. A pénzt a játék érméiben számoljuk, a visszajáróval együtt.
148
+ Az RPG Engine vezeti a dátumot. Az alkalmak között a játékidő megáll, hacsak a **Beállításokban** nem úgy döntesz, hogy teljen, például távolléted minden hetére egy játéknap, vagy nem kéred meg erre a mesélőt. Mondd, hogy pihensz, *Hosszú pihenőt tartunk*, és ha a mesélő beleegyezik, a pihenő visszaadja, amit kell. Rövid pihenőnél a mesélő a vezérlőpulton megkérdezheti, hány életerőkockát költesz el: egyenként dobd őket, nézd meg, mennyit gyógyít mindegyik, és állj meg, amikor akarod. Mondd meg, merre mész, *Észak felé indulunk Roccába*, és az RPG Engine kiszámolja az utat, a távolságot és a napokat, és megáll, ha történik valami az úton. A pénzt a játék érméiben számoljuk, a visszajáróval együtt.
149
149
 
150
150
  A gonoszoknak határidős terveik vannak. Minden új napon a mesélő előrébb mozdítja azokat a fenyegetéseket, amelyeket az idő előrevitt, te pedig a jeleiket látod, az órát sosem.
151
151
 
@@ -203,7 +203,7 @@ Minden beállítás megváltoztatható, a csevegésben vagy a **Beállításokba
203
203
 
204
204
  Egy oldal a saját számítógépeden, amely csak az adott gép böngészőjében nyílik meg, és amíg a csevegés nyitva van, él. Ha a csevegés bezárul, a *Not connected* felirat jelenik meg. A következő csevegéssel magától visszatér.
205
205
 
206
- - **Csapat**: a te karakterlapod és a társaidé. Kattints egy számra, hogy dobj vele. Ha fölé viszed az egeret, láthatod, honnan jön a szám, és ha egy nyíl jelöli a kockáját, azt is, mi teszi jobbá vagy rosszabbá a dobást. Mellette vannak a dobások.
206
+ - **Csapat**: a te karakterlapod és a társaidé. Kattints egy számra, hogy dobj vele. Ha fölé viszed az egeret, láthatod, honnan jön a szám, és ha egy nyíl jelöli a kockáját, azt is, mi teszi jobbá vagy rosszabbá a dobást. Ha a mesélő választásokat készít elő neked, például új szintlépésnél, a karakterlapon egy értesítés megnyitja őket: akkor választasz, amikor akarsz, elolvasod a lapokat, amelyeket a lehetőségek megneveznek, dobsz, ha egy lehetőség dobást kér, aztán megerősíted. A történet közben megy tovább. Mellette vannak a dobások.
207
207
  - **Jelenet**: hol vagy, a jelenet képe és térképe, kik vannak ott, mi történik. Harcban a körök és a karakter lapja.
208
208
  - **Napló**: küldetések, a történet, a társaid naplói, a jegyzeteid.
209
209
  - **Világ**: a világtérkép, amit a karakter tud, a megtalált iratok és a naptár.
@@ -304,12 +304,14 @@ A mesélő által használt minden parancs a kampánymappában is futtatható: a
304
304
 
305
305
  **A mesélő nem ismeri a játékot.** Az ügynököd nem töltötte be az RPG Engine-t. Ellenőrizd, hogy a kampány mappájában indítottad el, és megbíztál benne. Claude Code-ban írd be: `/mcp`, és csatlakoztasd újra az `rpg`-t. Codexben a `codex mcp list` parancsnak a kampány mappájában mutatnia kell az `rpg`-t. Ha az `rpg --version` nem található, telepítsd újra az RPG Engine-t ([2.2](#22-install)).
306
306
 
307
+ **A Windows nem találja a `claude`-ot.** A telepítője ezt egy sárga megjegyzésben jelzi, és megadja a mappát is, ahová települt: add hozzá ezt a mappát a PATH-hoz (Rendszertulajdonságok > Környezeti változók), aztán nyiss egy új terminált.
308
+
307
309
  **Frissítés.** Futtasd újra az `npm install -g rpg-engine` parancsot, aztán nyiss új csevegést: a már futó mesélő azt a verziót tartja, amellyel elindult.
308
310
 
309
311
  **A mesélő emlékszik valamire, amit visszacsináltam.** Nyiss új csevegést, és nyomd meg a **Megnyitottam az új csevegést** gombot a Mentések között.
310
312
 
311
313
  **Nem jelennek meg képek.** A Beállítások > Képek megmutatja, hogy ez a számítógép tudja-e készíteni őket, és hogyan.
312
314
 
313
- **A telepítés nem sikerül, vagy az `rpg` nem indul.** A `node --version` parancsnak 22-t vagy újabbat kell mutatnia. Windowson ne tedd az RPG Engine-t és a kampányaidat olyan útvonalra, amelyben `&` van.
315
+ **A telepítés nem sikerül, vagy az `rpg` nem indul.** A `node --version` parancsnak 24-et vagy újabbat kell mutatnia. Ha a Windows azt válaszolja, hogy a szkriptek futtatása le van tiltva, lásd a [2.1](#21-what-you-need) részt. Windowson ne tedd az RPG Engine-t és a kampányaidat olyan útvonalra, amelyben `&` van.
314
316
 
315
317
  **Megváltozott az irányítópult linkje.** Egy másik program elvette a szokásos címet. A mesélő megadja az új linket.
@@ -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: heildarleiðbeiningar
3
3
 
4
4
  **RPG Engine** lætur þig spila borðhlutverkaleik með **gervigreind sem sögumann**. Þú talar við sögumanninn í **spjalli**; RPG Engine vinnur á bak við tjöldin: það **man heiminn**, **kastar teningunum** og **heldur utan um bókhaldið**. Við hliðina á spjallinu hefurðu síðu opna í vafranum, **mælaborðið**, með persónublaðinu þínu, teningunum, kortunum og dagbókinni.
@@ -9,8 +9,8 @@
9
9
 
10
10
  1. Settu upp **Node.js** frá [nodejs.org](https://nodejs.org) (LTS-útgáfuna).
11
11
  2. Settu upp **gervigreindarforrit**, forritið sem sögumaðurinn keyrir í, og skráðu þig inn: til dæmis Claude Code eða Codex ([2.4](#24-connect-your-ai)).
12
- 3. Settu RPG Engine upp í skipanaglugga: `npm install -g rpg-engine`.
13
- 4. Búðu til herferð: `rpg init "The Salt Isles"`.
12
+ 3. Settu RPG Engine upp í nýjum skipanaglugga, sem þú opnaðir eftir að Node.js var sett upp: `npm install -g rpg-engine`. Ef Windows svarar að keyrsla skripta sé óvirk skaltu skrifa einu sinni `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, svara já og reyna aftur.
13
+ 4. Opnaðu skipanaglugga í möppunni þar sem þú geymir leikina þína (hægrismelltu á hana og veldu **Open in Terminal**) og búðu til herferð, alltaf með nafni: `rpg init "The Salt Isles"`. RPG Engine svarar með tveimur línum á ensku: allt er í lagi.
14
14
  5. Farðu inn í nýju möppuna með `cd "The Salt Isles"` og ræstu forritið þar: `claude` fyrir Claude Code, `codex` fyrir Codex. Segðu já þegar það spyr hvort þú treystir möppunni ([2.4](#24-connect-your-ai)) og skrifaðu svo *Hæ! Byrjum.* Sögumaðurinn svarar með tengli á mælaborðið þitt.
15
15
 
16
16
  ## 1. Hvað RPG Engine er <!-- icon: about -->
@@ -39,8 +39,8 @@ Leikur kemur sem leikjakerfi, pakki sem sögumaður setur upp fyrir herferðina
39
39
 
40
40
  - Tölvu með Windows, macOS eða Linux og vafra.
41
41
  - **Node.js 24** eða nýrra, frá [nodejs.org](https://nodejs.org). Með því fylgir `npm`, sem setur upp RPG Engine.
42
- - **Skipanaglugga**: á Windows Terminal eða PowerShell, á macOS Terminal. Til að opna hann í möppu skaltu hægrismella á möppuna og velja **Open in Terminal** (Windows) eða **Services > New Terminal at Folder** (macOS).
43
- - **gervigreindarforrit** fyrir sögumanninn ([2.4](#24-connect-your-ai)), með **stærsta líkaninu** sem það býður: lítið líkan er auðveldara að fá til að ljóstra upp leyndarmálum eða sveigja reglurnar.
42
+ - **Skipanaglugga**: á Windows Terminal eða PowerShell, á macOS Terminal. Til að opna hann í möppu skaltu hægrismella á möppuna og velja **Open in Terminal** (Windows) eða **Services > New Terminal at Folder** (macOS). Ef Windows svarar að keyrsla skripta sé óvirk skaltu skrifa einu sinni `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` og svara já.
43
+ - **Gervigreindarforrit** fyrir sögumanninn ([2.4](#24-connect-your-ai)), með **stærsta líkaninu** sem það býður: lítið líkan er auðveldara að fá til að ljóstra upp leyndarmálum eða sveigja reglurnar.
44
44
 
45
45
  ### 2.2 Uppsetning
46
46
 
@@ -48,7 +48,7 @@ Leikur kemur sem leikjakerfi, pakki sem sögumaður setur upp fyrir herferðina
48
48
  npm install -g rpg-engine
49
49
  ```
50
50
 
51
- `rpg --version` sýnir hvort þetta tókst. Þú notar `rpg` einu sinni fyrir hverja herferð, til að búa hana til. Eftir það ræsir forritið þitt RPG Engine sjálft.
51
+ `rpg --version` sýnir hvort þetta tókst. Ef npm býðst til að uppfæra sig sjálft geturðu hunsað það. Þú notar `rpg` einu sinni fyrir hverja herferð, til að búa hana til. Eftir það ræsir forritið þitt RPG Engine sjálft. `rpg` eitt og sér opnar ekkert: sögumaðurinn gefur þér stjórnborðið.
52
52
 
53
53
  ### 2.3 Búa til herferð
54
54
 
@@ -58,13 +58,13 @@ Opnaðu skipanaglugga í möppunni þar sem þú geymir leikina þína ([2.1](#2
58
58
  rpg init "The Salt Isles"
59
59
  ```
60
60
 
61
- Þetta býr til möppuna `The Salt Isles` með nýrri herferð. Farðu inn í hana með `cd "The Salt Isles"`. Mundu hvar hún er: þú kemur aftur í hana í hvert sinn sem þú spilar. Allt annað velurðu síðar, í spjallinu eða á stjórnborðinu. `rpg init --help` sýnir valkostina til að velja eitthvað strax, til dæmis `--language it` eða `--difficulty hard`.
61
+ Þetta býr til möppuna `The Salt Isles` með nýrri herferð. Farðu inn í hana með `cd "The Salt Isles"`. Skrifaðu alltaf nafnið: án þess verður mappan sem þú ert í að herferðinni, við hliðina á öllu sem hún geymir nú þegar. Mundu hvar herferðin er: þú kemur aftur í hana í hvert sinn sem þú spilar. Allt annað velurðu síðar, í spjallinu eða á stjórnborðinu.
62
62
 
63
63
  Sögumaðurinn getur ekki búið til herferð fyrir þig: fyrir `init` er ekkert sem segir forritinu þínu hvar RPG Engine er.
64
64
 
65
65
  ### 2.4 Tengja gervigreindina
66
66
 
67
- Sögumaðurinn keyrir í **gervigreindarforriti**: gervigreindarappi, í skipanaglugga eða á skjáborði, sem getur unnið með skrárnar á tölvunni þinni, eins og Claude Code eða Codex. Venjulegt spjall eins og claude.ai eða ChatGPT, eða símaapp, dugar ekki: sögumaðurinn þarf að komast í skrár herferðarinnar á tölvunni þinni. Hvert forrit þarf sína eigin áskrift og innskráningu: Claude Code þarf greidda Claude-áskrift, Codex þarf ChatGPT-innskráningu. Þú setur það upp einu sinni, frá síðunni þess: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
67
+ Sögumaðurinn keyrir í **gervigreindarforriti**: gervigreindarappi, í skipanaglugga eða á skjáborði, sem getur unnið með skrárnar á tölvunni þinni, eins og Claude Code eða Codex. Venjulegt spjall eins og claude.ai eða ChatGPT, eða símaapp, dugar ekki: sögumaðurinn þarf að komast í skrár herferðarinnar á tölvunni þinni. Hvert forrit þarf sína eigin áskrift og innskráningu: Claude Code þarf greidda Claude-áskrift, Codex þarf ChatGPT-innskráningu. Þú setur það upp einu sinni, frá síðunni þess: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex).
68
68
 
69
69
  - **Claude Code**: skrifaðu `claude` í herferðarmöppunni. Þegar það spyr hvort þú treystir möppunni skaltu velja **Yes, I trust this folder**. Farðu varlega: svarið sem er valið fyrirfram er *No, exit*. Herferðin hefur líka lítinn krók (hook), `rpg --listen`, sem spurningin sýnir ekki: hann lætur sögumanninn vita strax þegar þú gerir eitthvað á stjórnborðinu.
70
70
  - **Codex**: skrifaðu `codex` í herferðarmöppunni og svaraðu já þegar það spyr hvort þú treystir möppunni. Í skjáborðsappinu skaltu athuga í stillingunum að minni sé slökkt fyrir spjöll leiksins.
@@ -145,7 +145,7 @@ Sagan gengur fram í **atriðum**: bardaga, samtali, könnun, ferðalagi eða hv
145
145
 
146
146
  ### 3.4 Tími, ferðalög og heimur á hreyfingu
147
147
 
148
- RPG Engine heldur utan um dagsetninguna. Enginn tími líður milli funda. Segðu að þið hvílist, *Við tökum langa hvíld*, og þegar sögumaðurinn samþykkir skilar hvíldin því sem hún á að skila. Í stuttri hvíld getur sögumaðurinn spurt á stjórnborðinu hve marga lífsteninga þú notar: kastaðu þeim einum í einu, sjáðu hvað hver læknar og hættu þegar þú vilt. Segðu hvert þið farið, *Við förum veginn norður til Rocca*, og RPG Engine reiknar út leiðina, vegalengdina og dagana, og stoppar þegar eitthvað gerist á leiðinni. Peningar eru taldir í mynt leiksins, líka afgangurinn.
148
+ RPG Engine heldur utan um dagsetninguna. Milli funda stöðvast leiktíminn, nema þú veljir í **Stillingar** að láta hann líða, til dæmis einn dag í leiknum fyrir hverja viku í burtu, eða biðjir sögumanninn um það. Segðu að þið hvílist, *Við tökum langa hvíld*, og þegar sögumaðurinn samþykkir skilar hvíldin því sem hún á að skila. Í stuttri hvíld getur sögumaðurinn spurt á stjórnborðinu hve marga lífsteninga þú notar: kastaðu þeim einum í einu, sjáðu hvað hver læknar og hættu þegar þú vilt. Segðu hvert þið farið, *Við förum veginn norður til Rocca*, og RPG Engine reiknar út leiðina, vegalengdina og dagana, og stoppar þegar eitthvað gerist á leiðinni. Peningar eru taldir í mynt leiksins, líka afgangurinn.
149
149
 
150
150
  Skúrkar hafa áætlanir með tímamörkum. Með hverjum nýjum degi færir sögumaðurinn ógnirnar sem tíminn hefur þokað áfram. Þú sérð merki þeirra, aldrei sjálfa klukkuna.
151
151
 
@@ -203,7 +203,7 @@ Allar stillingar má breyta, í spjallinu eða í **Stillingar**. Úrskurður se
203
203
 
204
204
  Síða á þinni eigin tölvu, sem opnast aðeins í vafra þeirrar tölvu og er virk meðan spjallið er opið. Þegar spjallinu er lokað sýnir hún *Not connected*; hún kemur aftur af sjálfu sér með næsta spjalli.
205
205
 
206
- - **Hópur**: persónublaðið þitt og blöð félaga þinna. Smelltu á tölu til að kasta henni; haltu bendlinum yfir hana til að sjá hvaðan hún kemur og, þegar ör merkir tening hennar, hvað gerir kastið betra eða verra. Við hliðina eru köstin.
206
+ - **Hópur**: persónublaðið þitt og blöð félaga þinna. Smelltu á tölu til að kasta henni; haltu bendlinum yfir hana til að sjá hvaðan hún kemur og, þegar ör merkir tening hennar, hvað gerir kastið betra eða verra. Þegar sögumaðurinn undirbýr val fyrir þig, til dæmis á nýju stigi, opnar tilkynning á persónublaðinu það: veldu þegar þér hentar, lestu síðurnar sem valkostirnir nefna, kastaðu þar sem valkostur krefst kasts og staðfestu svo; sagan heldur áfram á meðan. Við hliðina eru köstin.
207
207
  - **Atriði**: hvar þú ert, mynd þess og kort, hverjir eru þar, hvað er að gerast; í bardaga eru það raðirnar og spjald persónunnar þinnar.
208
208
  - **Dagbók**: verkefni, sagan, dagbækur félaga þinna, minnisblöðin þín.
209
209
  - **Heimur**: heimskortið, það sem persónan þín veit, skjölin sem hafa fundist og dagatalið.
@@ -304,12 +304,14 @@ Sérhver skipun sem sögumaður notar má líka keyra í herferðarmöppunni: `r
304
304
 
305
305
  **Sögumaðurinn virðist ekki þekkja leikinn.** Gervigreindarforritið þitt hlóð ekki RPG Engine. Athugaðu að þú ræstir það í herferðarmöppunni og treystir henni. Í Claude Code skaltu skrifa `/mcp` og tengja `rpg` aftur. Í Codex verður `codex mcp list` í herferðarmöppunni að sýna `rpg`. Ef `rpg --version` finnst ekki skaltu setja RPG Engine upp aftur ([2.2](#22-install)).
306
306
 
307
+ **Windows finnur ekki `claude`.** Uppsetningarforritið segir frá því í gulum reit, ásamt möppunni sem það fór í: bættu þeirri möppu við PATH (System Properties > Environment Variables) og opnaðu síðan nýjan skipanaglugga.
308
+
307
309
  **Uppfærsla.** Keyrðu `npm install -g rpg-engine` aftur og opnaðu síðan nýtt spjall: sögumaður sem er í gangi heldur þeirri útgáfu sem hann ræsti með.
308
310
 
309
311
  **Sögumaðurinn man eitthvað sem ég afturkallaði.** Opnaðu nýtt spjall og ýttu á **Ég opnaði nýtt spjall** í Vistanir.
310
312
 
311
313
  **Engar myndir birtast.** Stillingar > Myndir segir hvort þessi tölva getur gert þær og hvernig.
312
314
 
313
- **Uppsetning mistekst, eða `rpg` ræsist ekki.** `node --version` verður að sýna 22 eða nýrra. Á Windows skaltu halda RPG Engine og herferðunum þínum frá slóðum sem innihalda `&`.
315
+ **Uppsetning mistekst, eða `rpg` ræsist ekki.** `node --version` verður að sýna 24 eða nýrra. Ef Windows svarar að keyrsla skripta sé óvirk, sjá [2.1](#21-what-you-need). Á Windows skaltu halda RPG Engine og herferðunum þínum frá slóðum sem innihalda `&`.
314
316
 
315
317
  **Hlekkurinn á mælaborðið breyttist.** Annað forrit tók venjulega vistfangið. Sögumaðurinn gefur þér nýja hlekkinn.