rpg-engine 0.23.1 → 0.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/campaign/create-campaign.d.ts +1 -1
- package/dist/campaign/create-campaign.js +1 -1
- package/dist/campaign/find-campaign.js +11 -1
- package/dist/campaign/host-files.d.ts +5 -6
- package/dist/campaign/host-files.js +100 -60
- package/dist/campaign/settings.d.ts +3 -3
- package/dist/campaign/settings.js +5 -4
- package/dist/cli/cli.js +11 -2
- package/dist/commands/config/config.js +1 -1
- package/dist/commands/config/dashboard.js +23 -6
- package/dist/commands/config/words.js +1 -0
- package/dist/commands/image.js +3 -3
- package/dist/commands/import/import.d.ts +3 -1
- package/dist/commands/import/import.js +13 -5
- package/dist/commands/instructions.js +1 -1
- package/dist/commands/shared/campaign/images.js +3 -2
- package/dist/commands/shared/campaign/mode.js +1 -1
- package/dist/commands/shared/characters/voices.d.ts +2 -2
- package/dist/commands/shared/characters/voices.js +9 -9
- package/dist/commands/shared/sheet/sheet.d.ts +2 -2
- package/dist/commands/shared/sheet/sheet.js +3 -3
- package/dist/core/context.d.ts +8 -2
- package/dist/dashboard/acts/acts.js +39 -11
- package/dist/dashboard/acts/head.js +7 -0
- package/dist/dashboard/acts/names.js +4 -2
- package/dist/dashboard/acts/sending.js +23 -22
- package/dist/dashboard/acts/sheet.js +7 -149
- package/dist/dashboard/acts/strip.js +10 -14
- package/dist/dashboard/acts/talk.js +51 -0
- package/dist/dashboard/acts/thing.js +169 -0
- package/dist/dashboard/app.js +3 -3
- package/dist/dashboard/guide/ar.md +13 -13
- package/dist/dashboard/guide/cs.md +12 -12
- package/dist/dashboard/guide/da.md +12 -12
- package/dist/dashboard/guide/de.md +11 -11
- package/dist/dashboard/guide/el.md +11 -11
- package/dist/dashboard/guide/en.md +10 -10
- package/dist/dashboard/guide/es.md +11 -11
- package/dist/dashboard/guide/fi.md +11 -11
- package/dist/dashboard/guide/fr.md +12 -12
- package/dist/dashboard/guide/he.md +11 -11
- package/dist/dashboard/guide/hi.md +11 -11
- package/dist/dashboard/guide/hu.md +11 -11
- package/dist/dashboard/guide/is.md +11 -11
- package/dist/dashboard/guide/it.md +38 -38
- package/dist/dashboard/guide/ja.md +11 -11
- package/dist/dashboard/guide/ko.md +12 -12
- package/dist/dashboard/guide/nb.md +11 -11
- package/dist/dashboard/guide/nl.md +11 -11
- package/dist/dashboard/guide/pl.md +11 -11
- package/dist/dashboard/guide/pt.md +11 -11
- package/dist/dashboard/guide/ro.md +12 -12
- package/dist/dashboard/guide/ru.md +12 -12
- package/dist/dashboard/guide/sv.md +12 -12
- package/dist/dashboard/guide/tr.md +12 -12
- package/dist/dashboard/guide/uk.md +11 -11
- package/dist/dashboard/guide/zh.md +12 -12
- package/dist/dashboard/i18n/ar.json +24 -10
- package/dist/dashboard/i18n/cs.json +24 -10
- package/dist/dashboard/i18n/da.json +24 -10
- package/dist/dashboard/i18n/de.json +24 -10
- package/dist/dashboard/i18n/el.json +24 -10
- package/dist/dashboard/i18n/es.json +24 -10
- package/dist/dashboard/i18n/fi.json +24 -10
- package/dist/dashboard/i18n/fr.json +24 -10
- package/dist/dashboard/i18n/he.json +24 -10
- package/dist/dashboard/i18n/hi.json +24 -10
- package/dist/dashboard/i18n/hu.json +24 -10
- package/dist/dashboard/i18n/is.json +24 -10
- package/dist/dashboard/i18n/it.json +102 -88
- package/dist/dashboard/i18n/ja.json +24 -10
- package/dist/dashboard/i18n/ko.json +24 -10
- package/dist/dashboard/i18n/nb.json +24 -10
- package/dist/dashboard/i18n/nl.json +24 -10
- package/dist/dashboard/i18n/pl.json +24 -10
- package/dist/dashboard/i18n/pt.json +24 -10
- package/dist/dashboard/i18n/ro.json +24 -10
- package/dist/dashboard/i18n/ru.json +24 -10
- package/dist/dashboard/i18n/sv.json +24 -10
- package/dist/dashboard/i18n/tr.json +24 -10
- package/dist/dashboard/i18n/uk.json +24 -10
- package/dist/dashboard/i18n/zh.json +24 -10
- package/dist/dashboard/packages/packages.js +1 -1
- package/dist/dashboard/parts/icons.js +2 -0
- package/dist/dashboard/parts/labels.js +1 -0
- package/dist/dashboard/parts/layout.js +34 -0
- package/dist/dashboard/parts/widgets.js +6 -2
- package/dist/dashboard/settings/language-choice.js +1 -1
- package/dist/dashboard/settings/settings.js +61 -36
- package/dist/dashboard/settings/tabs.js +14 -0
- package/dist/dashboard/sheet/sheet.js +54 -33
- package/dist/dashboard/shell/notices.js +2 -2
- package/dist/dashboard/style.css +122 -47
- package/dist/helpers/antigravity.d.ts +47 -0
- package/dist/helpers/antigravity.js +434 -0
- package/dist/helpers/chosen.d.ts +11 -7
- package/dist/helpers/chosen.js +64 -37
- package/dist/helpers/index.d.ts +1 -0
- package/dist/helpers/index.js +2 -1
- package/dist/helpers/opencode.js +117 -24
- package/dist/helpers/programs.d.ts +8 -0
- package/dist/helpers/programs.js +35 -2
- package/dist/helpers/stop.d.ts +2 -0
- package/dist/helpers/stop.js +20 -1
- package/dist/helpers/svg.d.ts +4 -1
- package/dist/helpers/svg.js +16 -4
- package/dist/instructions/index.d.ts +4 -2
- package/dist/instructions/index.js +6 -3
- package/dist/server/bell/antigravity.d.ts +7 -2
- package/dist/server/bell/antigravity.js +24 -6
- package/dist/server/bell/index.d.ts +1 -1
- package/dist/server/bell/index.js +1 -1
- package/dist/server/bell/listener.js +6 -1
- package/dist/server/fence.d.ts +21 -0
- package/dist/server/fence.js +69 -0
- package/dist/server/mcp.js +26 -0
- package/dist/server/player-acts.js +1 -1
- package/dist/server/subagent.d.ts +4 -0
- package/dist/server/subagent.js +30 -0
- package/instructions/voices-antigravity.md +1 -0
- package/instructions/voices-codex.md +1 -0
- package/instructions/voices-opencode.md +1 -1
- package/package.json +1 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,44018911,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. 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.
|
|
@@ -66,15 +66,15 @@ Le MJ ne peut pas créer une campagne à ta place : avant `init`, rien n'indique
|
|
|
66
66
|
|
|
67
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, Codex, Antigravity ou OpenCode. 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, Antigravity un compte Google, dont l'offre gratuite a un petit quota hebdomadaire ; OpenCode fonctionne avec les modèles que tu lui donnes, y compris les modèles locaux. 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), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
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
|
|
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.
|
|
71
|
-
- **Antigravity** : dans le dossier de la campagne, écris `agy`, et réponds oui s'il demande si tu fais confiance au dossier ; ou, dans son appli, ouvre le dossier de la campagne. Pour l'appli, RPG Engine s'ajoute aussi aux paramètres propres d'Antigravity, `.gemini/config/mcp_config.json` dans ton dossier personnel, qui valent pour tous les dossiers que tu ouvres, pas seulement celui de la campagne : en dehors d'une campagne, il ne fait rien. La campagne contient deux petits hooks : `rpg --approve` permet au MJ d'utiliser les outils de RPG Engine sans te demander à chaque fois, et `rpg --listen` prévient aussitôt le MJ quand tu agis depuis le
|
|
72
|
-
- **OpenCode** : dans le dossier de la campagne, écris `opencode`. La campagne contient un petit plugin, `.opencode/plugins/rpg.js`, qui prévient aussitôt le MJ quand tu agis depuis le
|
|
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 tableau de bord.
|
|
70
|
+
- **Codex** : dans le dossier de la campagne, écris `codex`, et réponds oui quand il demande si tu fais confiance au dossier. Aux moments clés, un personnage parle par un agent à lui, `.codex/agents/rpg-character.toml`, qui ne sait que ce que le personnage sait. Dans son appli de bureau, vérifie dans les paramètres que les mémoires sont désactivées pour les chats du jeu.
|
|
71
|
+
- **Antigravity** : dans le dossier de la campagne, écris `agy`, et réponds oui s'il demande si tu fais confiance au dossier ; ou, dans son appli, ouvre le dossier de la campagne. Pour l'appli, RPG Engine s'ajoute aussi aux paramètres propres d'Antigravity, `.gemini/config/mcp_config.json` dans ton dossier personnel, qui valent pour tous les dossiers que tu ouvres, pas seulement celui de la campagne : en dehors d'une campagne, il ne fait rien. La campagne contient deux petits hooks : `rpg --approve` permet au MJ d'utiliser les outils de RPG Engine sans te demander à chaque fois, et `rpg --listen` prévient aussitôt le MJ quand tu agis depuis le tableau de bord. Le MJ peint lui-même les images dans le chat, avec une offre Google payante ; avec l'offre gratuite, son outil d'images échoue, et il dessine de simples images vectorielles, comme le fait Claude. Aux moments clés, un personnage parle par un agent à lui, `.agents/agents/rpg-character.md` : le MJ écrit une réplique de l'histoire, et la réponse du personnage arrive un instant plus tard. Ton Antigravity traduit aussi le tableau de bord et les règles du jeu, et lit les documents que tu importes, en dehors du chat, sur le quota de ton compte Google : RPG Engine le lance à part de tes propres chats, donc il n'y laisse rien. Antigravity garde tes anciens chats, et sa mémoire ne peut pas être désactivée : le MJ a pour consigne de ne jamais les lire. Ce que tu écris part chez Google, qui peut le faire relire par des personnes : ne mets pas de données personnelles dans la partie. RPG Engine n'est pas un produit Google.
|
|
72
|
+
- **OpenCode** : dans le dossier de la campagne, écris `opencode`. La campagne contient un petit plugin, `.opencode/plugins/rpg.js`, qui prévient aussitôt le MJ quand tu agis depuis le tableau de bord. Dans la campagne, le MJ n'écrit des fichiers que par RPG Engine : l'écriture et la modification de fichiers propres à OpenCode y sont désactivées, et OpenCode te demande ton accord avant de lancer une commande. Le MJ dessine lui-même les images, sous forme de simples images vectorielles, comme le fait Claude. Aux moments clés, un personnage parle par un agent à lui, `.opencode/agents/rpg-character.md` : le MJ écrit une réplique de l'histoire, et la réponse du personnage arrive un instant plus tard ; un petit modèle local peut ne pas l'appeler. Ton OpenCode, avec le modèle que tu y as choisi en dernier, traduit aussi le tableau de bord et les règles du jeu, et lit les documents que tu importes, en dehors du chat ; sans modèle utilisable, Codex ou Claude Code s'en chargent si tu les as.
|
|
73
73
|
- **Un autre agent** : lance-le dans le dossier de la campagne et donne-lui le serveur MCP `rpg mcp`. RPG Engine est un serveur MCP standard : tout agent compatible MCP peut être le MJ, y compris les agents locaux.
|
|
74
74
|
|
|
75
75
|
Si le MJ dit qu'il ne trouve pas les outils de RPG Engine, écris `rpg init` dans le dossier de la campagne : dans un dossier qui est déjà une campagne, cela ne fait que mettre ces fichiers à jour ; ouvre ensuite un nouveau chat.
|
|
76
76
|
|
|
77
|
-
Nous jouons et testons avec **Claude Code** ; **Codex** et **
|
|
77
|
+
Nous jouons et testons avec **Claude Code** ; **Codex**, **Antigravity** et **OpenCode** sont connectés et vérifiés, mais aucune campagne entière n'a encore été jouée avec eux. La campagne désactive la mémoire propre de l'agent : la partie vit dans ses fichiers, pour qu'un retour à une sauvegarde revienne vraiment en arrière.
|
|
78
78
|
|
|
79
79
|
### 2.5 Le premier chat
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ Pour parler hors de l'histoire, écris `[OOC: …]` (hors personnage) : *[OOC: C
|
|
|
130
130
|
|
|
131
131
|
Tu dis ce que tu tentes ; le MJ dit ce qui arrive. Le MJ ne décide jamais à la place de ton personnage, et ne parle jamais du moteur de jeu. Tu peux lui demander comment utiliser le tableau de bord.
|
|
132
132
|
|
|
133
|
-
**Agir depuis le tableau de bord** : clique sur un nom de ta fiche, comme une arme, un sort ou un objet que tu portes : sa carte explique ce que c'est. Choisis ce que tu en fais,
|
|
133
|
+
**Agir depuis le tableau de bord** : clique sur un nom de ta fiche, comme une arme, un sort ou un objet que tu portes : sa carte explique ce que c'est. Un sac s'ouvre avec sa flèche, et son ⓘ montre sa carte. Choisis ce que tu en fais. Une action qui ne vise personne, comme **Équiper**, te demande de confirmer sur le même bouton, *Confirmer : j'équipe Bouclier* : appuie encore une fois et elle part au MJ. Une action faite à quelqu'un, comme **Attaquer**, demande qui est visé, dans la liste ou d'un clic sur la carte ; le bouton dit alors la phrase entière, *J'attaque Bandit encapuchonné 1 avec Masse*, et un clic l'envoie. Pour le dire à ta façon, clique sur une personne pour lui parler, ou écris dans le chat. Le MJ l'entend comme si tu l'avais dit dans le chat, tranche comme pour toute autre action, et te demande avec des boutons ce que tu as laissé de côté. Si ton appli d'IA ne peut pas prévenir le MJ toute seule, il le lit dès que tu écris dans le chat ; si le chat était fermé avant, **Le redire** l'envoie une fois de plus.
|
|
134
134
|
|
|
135
135
|
### 3.2 Jets
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ Le robot en haut du tableau de bord, c'est le MJ : son visage suit le ton de l'h
|
|
|
198
198
|
|
|
199
199
|
### 3.11 Images
|
|
200
200
|
|
|
201
|
-
RPG Engine peut faire créer des images des lieux que tu atteins, des quêtes que tu acceptes et des personnes que tu rencontres, selon le réglage **Images**, ainsi que le portrait de ton personnage quand tu le demandes.
|
|
201
|
+
RPG Engine peut faire créer des images des lieux que tu atteins, des quêtes que tu acceptes et des personnes que tu rencontres, selon le réglage **Images**, ainsi que le portrait de ton personnage quand tu le demandes. Ton appli d'IA les crée avec ses propres moyens, avec ta connexion, sur ton abonnement et ses limites : **Claude** les dessine en images vectorielles, **Codex** et **Antigravity** les peignent, **OpenCode** dessine de simples images vectorielles dans le chat. Dans **Paramètres > Campagne > Images**, tu peux faire peindre les images par Codex ou Antigravity même quand ton MJ est une autre appli : là où celle que tu as choisie ne peut pas, ton chat les crée. **Paramètres** indique si cet ordinateur peut les créer, et comment le configurer si ce n'est pas le cas. Tu peux toujours donner une image à toi, pour ton personnage ou pour n'importe quelle page que tu vois : passe le pointeur sur l'une de ses images et un petit bouton image apparaît dans son coin (au clavier aussi, et toujours sur téléphone) ; dans **Monde**, la page que tu ouvres a aussi **Changer l'image…**, ou **Ajouter une image…** tant qu'elle n'en a pas. La tienne prend la place de celle qui existe. Ou dépose le fichier dans le dossier **inbox** de la campagne et dis au MJ pour quelle page il est.
|
|
202
202
|
|
|
203
203
|
### 3.12 Sécurité : lignes, voiles et stop
|
|
204
204
|
|
|
@@ -219,7 +219,7 @@ Une page sur ton propre ordinateur, ouverte uniquement dans le navigateur de cet
|
|
|
219
219
|
- **Journal** : les quêtes, l'histoire comme un livre, sa chronologie, les journaux de tes compagnons, tes notes.
|
|
220
220
|
- **Monde** : la carte du monde, ce que sait ton personnage, les documents trouvés et le calendrier.
|
|
221
221
|
- **La piste de dés** : choisis les dés et un modificateur, puis lance. ×2 double les dés, jamais le modificateur, comme pour un coup critique.
|
|
222
|
-
- **Sauvegardes**, **Aide**, **Paramètres** et **À propos**, sous forme d'icônes au bout de la rangée. Les **Paramètres** contiennent aussi les préférences propres à la page : thème, son des dés, jeu de dés, et le **Style du jeu**, c'est-à-dire les couleurs, les faces et les images de la page : ceux du système de jeu, un thème que tu as ajouté dans Packages › Add, depuis le catalogue, un lien GitHub, un .zip ou un dossier, ou ceux de la page elle-même. Si le style propre à un thème rend la page difficile à lire, désactive **Style propre au thème**
|
|
222
|
+
- **Sauvegardes**, **Aide**, **Paramètres** et **À propos**, sous forme d'icônes au bout de la rangée. Les **Paramètres** contiennent aussi les préférences propres à la page, sous **Cette page** : thème, son des dés, jeu de dés, et le **Style du jeu**, c'est-à-dire les couleurs, les faces et les images de la page : ceux du système de jeu, un thème que tu as ajouté dans Packages › Add, depuis le catalogue, un lien GitHub, un .zip ou un dossier, ou ceux de la page elle-même. Si le style propre à un thème rend la page difficile à lire, désactive **Style propre au thème** à cet endroit : les **Paramètres** s'affichent toujours sans lui, à l'adresse de la page terminée par `#/settings/page`.
|
|
223
223
|
|
|
224
224
|
Quand le MJ te pose une question, sa bannière reste en haut, quelle que soit la section où tu te trouves.
|
|
225
225
|
|
|
@@ -265,13 +265,13 @@ Une extension ajoute quelque chose à une campagne, en plus de son système de j
|
|
|
265
265
|
|
|
266
266
|
- **Créé au fil du jeu** : à partir de ta prémisse, le MJ construit chaque lieu, chaque personne et chaque intrigue juste avant que tu en aies besoin, et les garde.
|
|
267
267
|
- **Préparé au début** : pareil, mais avec le monde construit avant le jeu.
|
|
268
|
-
- **À partir de ta propre aventure ou de ton propre livre** : donne son fichier au MJ, *[Importe cette aventure comme notre campagne : D:\Books\adventure.pdf. Ne me dis rien de ce qu'elle contient.]* Elle se lit mieux en texte, en EPUB, en document Word ou en PDF dont on peut sélectionner le texte ; un PDF scanné est lu à partir des images de ses pages, sous Windows uniquement, lentement et avec quelques erreurs. Ton
|
|
268
|
+
- **À partir de ta propre aventure ou de ton propre livre** : donne son fichier au MJ, *[Importe cette aventure comme notre campagne : D:\Books\adventure.pdf. Ne me dis rien de ce qu'elle contient.]* Elle se lit mieux en texte, en EPUB, en document Word ou en PDF dont on peut sélectionner le texte ; un PDF scanné est lu à partir des images de ses pages, sous Windows uniquement, lentement et avec quelques erreurs. Ton appli d'IA la lit en dehors du chat, ou sinon le MJ dans le chat, sur ton abonnement : dans Claude Code ou Codex, l'un des deux la lit ; dans Antigravity, ton Antigravity ; dans OpenCode, le modèle que tu y as choisi en dernier. Le document entier part chez le fabricant de celui qui le lit, selon les conditions de ton compte et son choix concernant l'entraînement. Le tableau de bord montre l'avancement ; pour un roman, le MJ propose par où commencer. Il écrit les lieux, les personnages et les secrets.
|
|
269
269
|
|
|
270
270
|
Une campagne se joue une seule fois : pour rejouer la même aventure, crée une nouvelle campagne.
|
|
271
271
|
|
|
272
272
|
### 7.2 Langues
|
|
273
273
|
|
|
274
|
-
Une langue par campagne, celle du MJ, que le tableau de bord suit. Le tableau de bord est fourni en 26 langues. Toute autre est traduite sur ton ordinateur par Codex ou Claude Code, ou,
|
|
274
|
+
Une langue par campagne, celle du MJ, que le tableau de bord suit. Le tableau de bord est fourni en 26 langues. Toute autre est traduite sur ton ordinateur par ton appli d'IA, en dehors du chat (Codex ou Claude Code ; dans Antigravity et OpenCode, la leur), ou, quand aucune ne le peut, par le MJ dans le chat. Les termes de la cinquième édition en italien viennent du SRD italien officiel ; le texte des règles reste en anglais, et le MJ le raconte dans ta langue.
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ Toutes les commandes que le MJ utilise peuvent aussi être lancées dans le doss
|
|
|
323
323
|
|
|
324
324
|
**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.
|
|
325
325
|
|
|
326
|
-
**Aucune image n'apparaît.** Paramètres > Images indique si cet ordinateur peut en créer, et comment.
|
|
326
|
+
**Aucune image n'apparaît.** Paramètres > Campagne > Images indique si cet ordinateur peut en créer, et comment.
|
|
327
327
|
|
|
328
328
|
**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 `&`.
|
|
329
329
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,44018911,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: המדריך המלא
|
|
3
3
|
|
|
4
4
|
**RPG Engine** מאפשר לשחק משחק תפקידים שולחני עם **בינה מלאכותית בתפקיד המנחה**. מדברים עם המנחה ב**צ'אט**; RPG Engine עובד מאחורי הקלעים: הוא **זוכר את העולם**, **מטיל את הקוביות** ו**מנהל את החשבונות**. לצד הצ'אט משאירים בדפדפן דף פתוח, **הלוח** (dashboard), עם דף הדמות, הקוביות, המפות והיומן.
|
|
@@ -67,14 +67,14 @@ rpg init "The Salt Isles"
|
|
|
67
67
|
המנחה פועל בתוך **סוכן AI**: אפליקציית AI, בטרמינל או בשולחן העבודה, שיכולה לעבוד עם הקבצים שבמחשב, כמו Claude Code, Codex, Antigravity או OpenCode. צ'אט רגיל כמו claude.ai או ChatGPT, או אפליקציה בטלפון, אינם מספיקים: המנחה צריך לגשת לקבצי הקמפיין שבמחשב. לכל סוכן יש מנוי והתחברות משלו: ל-Claude Code דרוש מנוי בתשלום של Claude, ל-Codex התחברות עם ChatGPT, ול-Antigravity חשבון Google, שהמנוי החינמי שלו כולל מכסה שבועית קטנה. OpenCode עובד עם המודלים שנותנים לו, כולל מודלים מקומיים. מתקינים אותו פעם אחת, מהדף שלו: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: בתיקיית הקמפיין כותבים `claude`. כשהוא שואל אם לסמוך על התיקייה, בוחרים **Yes, I trust this folder**. זהירות: התשובה שמסומנת מראש היא *No, exit*. לקמפיין יש גם הוק קטן, `rpg --listen`, שהשאלה לא מציגה: הוא מודיע למנחה מיד כשפועלים מהדשבורד.
|
|
70
|
-
- **Codex**: בתיקיית הקמפיין כותבים `codex`, ועונים yes כשהוא שואל אם לסמוך על התיקייה. באפליקציית שולחן העבודה
|
|
71
|
-
- **Antigravity**: בתיקיית הקמפיין כותבים `agy`, ועונים yes אם הוא שואל אם לסמוך על התיקייה; או, באפליקציה שלו, פותחים את תיקיית הקמפיין. עבור האפליקציה, RPG Engine מוסיף את עצמו גם להגדרות של Antigravity עצמו, `.gemini/config/mcp_config.json` בתיקיית הבית שלך, שחלות על כל תיקייה שפותחים, לא רק על תיקיית הקמפיין: מחוץ לקמפיין הוא לא עושה דבר. לקמפיין יש שני הוקים קטנים: `rpg --approve` מאפשר למנחה להשתמש בכלים של RPG Engine בלי לשאול
|
|
72
|
-
- **OpenCode**: בתיקיית הקמפיין כותבים `opencode`. לקמפיין יש תוסף קטן, `.opencode/plugins/rpg.js`, שמודיע למנחה מיד כשפועלים מהדשבורד. בקמפיין המנחה כותב קבצים רק דרך RPG Engine: הכתיבה והעריכה של קבצים ב-OpenCode עצמו כבויות שם, ו-OpenCode שואל
|
|
70
|
+
- **Codex**: בתיקיית הקמפיין כותבים `codex`, ועונים yes כשהוא שואל אם לסמוך על התיקייה. ברגעים מרכזיים דמות מדברת דרך סוכן משלה, `.codex/agents/rpg-character.toml`, שיודע רק את מה שהדמות יודעת. באפליקציית שולחן העבודה שלו כדאי לבדוק בהגדרות שהזיכרונות כבויים בצ'אטים של המשחק.
|
|
71
|
+
- **Antigravity**: בתיקיית הקמפיין כותבים `agy`, ועונים yes אם הוא שואל אם לסמוך על התיקייה; או, באפליקציה שלו, פותחים את תיקיית הקמפיין. עבור האפליקציה, RPG Engine מוסיף את עצמו גם להגדרות של Antigravity עצמו, `.gemini/config/mcp_config.json` בתיקיית הבית שלך, שחלות על כל תיקייה שפותחים, לא רק על תיקיית הקמפיין: מחוץ לקמפיין הוא לא עושה דבר. לקמפיין יש שני הוקים קטנים: `rpg --approve` מאפשר למנחה להשתמש בכלים של RPG Engine בלי לשאול בכל פעם, ו-`rpg --listen` מודיע למנחה מיד כשפועלים מהדשבורד. המנחה יוצר את התמונות בצ'אט עצמו, בתוכנית בתשלום של Google; בתוכנית החינמית כלי התמונות שלו נכשל, והוא מצייר תמונות וקטוריות פשוטות, כמו Claude. ברגעים מרכזיים דמות מדברת דרך סוכן משלה, `.agents/agents/rpg-character.md`: המנחה כותב שורה מהסיפור, ותשובת הדמות מגיעה רגע אחר כך. ה-Antigravity שלך מתרגם גם את הדשבורד ואת חוקי המשחק וקורא את המסמכים שמייבאים, מחוץ לצ'אט, על חשבון המכסה של חשבון Google שלך: RPG Engine מפעיל אותו בנפרד מהצ'אטים שלך, כך שהוא לא משאיר דבר ביניהם. Antigravity שומר את הצ'אטים הקודמים שלך, ואי אפשר לכבות את הזיכרון שלו: המנחה מקבל הוראה לא לקרוא אותם לעולם. מה שכותבים נשלח ל-Google, שעשויה לתת לאנשים לקרוא אותו: לא לכלול במשחק מידע אישי. RPG Engine אינו מוצר של Google.
|
|
72
|
+
- **OpenCode**: בתיקיית הקמפיין כותבים `opencode`. לקמפיין יש תוסף קטן, `.opencode/plugins/rpg.js`, שמודיע למנחה מיד כשפועלים מהדשבורד. בקמפיין המנחה כותב קבצים רק דרך RPG Engine: הכתיבה והעריכה של קבצים ב-OpenCode עצמו כבויות שם, ו-OpenCode שואל לפני שהוא מריץ פקודה. המנחה מצייר את התמונות בעצמו, כתמונות וקטוריות פשוטות, כמו Claude. ברגעים מרכזיים דמות מדברת דרך סוכן משלה, `.opencode/agents/rpg-character.md`: המנחה כותב שורה מהסיפור, ותשובת הדמות מגיעה רגע אחר כך; ייתכן שמודל מקומי קטן לא יפעיל אותו. ה-OpenCode שלך, עם המודל שנבחר בו לאחרונה, מתרגם גם את הדשבורד ואת חוקי המשחק וקורא את המסמכים שמייבאים, מחוץ לצ'אט; אם אין מודל שהוא יכול להשתמש בו, Codex או Claude Code עושים זאת, אם הם מותקנים.
|
|
73
73
|
- **סוכן אחר**: מפעילים אותו בתיקיית הקמפיין ונותנים לו את שרת ה-MCP `rpg mcp`. RPG Engine הוא שרת MCP סטנדרטי: כל סוכן שתומך ב-MCP יכול להיות המנחה, כולל סוכנים מקומיים.
|
|
74
74
|
|
|
75
75
|
אם המנחה אומר שהוא לא מוצא את הכלים של RPG Engine, כותבים `rpg init` בתיקיית הקמפיין: בתיקייה שכבר היא קמפיין, הפקודה רק מעדכנת את הקבצים האלה. אחר כך פותחים צ'אט חדש.
|
|
76
76
|
|
|
77
|
-
אנחנו משחקים ובודקים עם **Claude Code**. **Codex** ו-**
|
|
77
|
+
אנחנו משחקים ובודקים עם **Claude Code**. **Codex**, **Antigravity** ו-**OpenCode** מחוברים ונבדקים, אבל עוד לא שוחק איתם קמפיין שלם. הקמפיין מכבה את הזיכרון של הסוכן עצמו: המשחק חי בקבצים שלו, כך שחזרה לשמירה באמת מחזירה אחורה.
|
|
78
78
|
|
|
79
79
|
### 2.5 הצ'אט הראשון
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ rpg init "The Salt Isles"
|
|
|
130
130
|
|
|
131
131
|
אתה אומר מה אתה מנסה לעשות, והמנחה אומר מה קורה. המנחה לעולם לא מחליט בשביל הדמות, ולעולם לא מדבר על המנוע. אפשר לשאול אותו איך משתמשים בלוח הבקרה.
|
|
132
132
|
|
|
133
|
-
**פעולה מתוך
|
|
133
|
+
**פעולה מתוך הדשבורד**: לוחצים על שם בדף הדמות, כמו נשק, לחש או משהו שהדמות נושאת: הכרטיס שלו אומר מה הוא. תיק נפתח בחץ שלו, וה-ⓘ שלו מציג את הכרטיס שלו. בוחרים מה לעשות עם הפריט. פעולה שלא מכוונת אל אף אחד, כמו **להצטייד**, מבקשת אישור על אותו כפתור, *אישור: אני מצטייד ב-Shield*: לוחצים עליו שוב, והפעולה נשלחת למנחה. פעולה שמכוונת אל מישהו, כמו **לתקוף**, שואלת אל מי, ברשימה או בלחיצה על המפה; אז הכפתור אומר את המשפט המלא, *אני תוקף את Hooded Bandit 1 עם Mace*, ולחיצה אחת שולחת אותו. כדי לומר זאת בדרך משלך, לוחצים על דמות כדי לדבר איתה, או כותבים בצ'אט. המנחה שומע זאת כאילו נאמר בצ'אט, פוסק לגביו כמו בכל פעולה אחרת, ושואל בכפתורים על מה שחסר. כשאין לאפליקציית ה-AI דרך להודיע למנחה מיד, המנחה קורא זאת ברגע שכותבים שוב בצ'אט; אם הצ'אט נסגר קודם, **לומר שוב** שולח זאת פעם נוספת.
|
|
134
134
|
|
|
135
135
|
### 3.2 הטלות
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ RPG Engine שומר את כל הקמפיין בסוף כל סצנה. הגדרת
|
|
|
198
198
|
|
|
199
199
|
### 3.11 תמונות
|
|
200
200
|
|
|
201
|
-
RPG Engine יכול ליצור תמונות של המקומות שמגיעים אליהם, של המשימות שלוקחים ושל מי שפוגשים, לפי הגדרת **תמונות**, ואת הדיוקן של הדמות כשמבקשים.
|
|
201
|
+
RPG Engine יכול ליצור תמונות של המקומות שמגיעים אליהם, של המשימות שלוקחים ושל מי שפוגשים, לפי הגדרת **תמונות**, ואת הדיוקן של הדמות כשמבקשים. אפליקציית ה-AI שלך יוצרת אותן בכלים משלה, עם ההתחברות שלך, בתוכנית שלך ובמגבלות שלה: **Claude** מצייר אותן כתמונות וקטוריות, **Codex** ו-**Antigravity** מציירים אותן בצבע, **OpenCode** מצייר בצ'אט תמונות וקטוריות פשוטות. ב-**הגדרות > קמפיין > תמונות** אפשר לבקש מ-Codex או מ-Antigravity ליצור אותן גם כשהמנחה הוא אפליקציה אחרת: במקום שבו האפליקציה שנבחרה לא יכולה, הצ'אט שלך יוצר אותן. ב**הגדרות** כתוב אם המחשב הזה יכול ליצור אותן, ואיך להגדיר אם לא. תמיד אפשר לתת תמונה משלך, לדמות או לכל דף שרואים: מעבירים את המצביע מעל אחת מהתמונות שלו, ובפינה מופיע כפתור תמונה קטן (גם במקלדת, ותמיד בטלפון). ב**עולם** בדף שנפתח יש גם **החלפת תמונה…**, או **הוספת תמונה…** כל עוד אין לו תמונה. התמונה שלך תופסת את מקום התמונה הקיימת. או שאפשר לשים את הקובץ בתיקיית **inbox** של הקמפיין ולומר למנחה לאיזה דף הוא מיועד.
|
|
202
202
|
|
|
203
203
|
### 3.12 בטיחות: קווים אדומים, וילונות ועצירה
|
|
204
204
|
|
|
@@ -219,7 +219,7 @@ RPG Engine יכול ליצור תמונות של המקומות שמגיעים
|
|
|
219
219
|
- **יומן**: משימות, הסיפור כספר, ציר הזמן שלו, היומנים של בני הלוויה והפתקים שלך.
|
|
220
220
|
- **עולם**: מפת העולם, מה שהדמות יודעת, המסמכים שנמצאו ולוח השנה.
|
|
221
221
|
- **מגש הקוביות**: בוחרים קוביות ומתאם, ומטילים. ×2 מכפיל את הקוביות ולא את המתאם, כמו בפגיעה קריטית.
|
|
222
|
-
- **שמירות**, **עזרה**, **הגדרות** ו**אודות**: סמלים בסוף השורה. ב**הגדרות** יש
|
|
222
|
+
- **שמירות**, **עזרה**, **הגדרות** ו**אודות**: סמלים בסוף השורה. ב**הגדרות** יש גם, תחת **הדף הזה**, את ההעדפות של הדף עצמו: ערכת נושא, צליל הקוביות, סוג הקוביות ו**סגנון המשחק**, כלומר הצבעים, הפנים והתמונות של הדף. אפשר לבחור את הסגנון של מערכת המשחק, ערכת נושא שנוספה ב-Packages › Add (מהקטלוג, מקישור GitHub, מקובץ .zip או מתיקייה), או את הסגנון של הדף עצמו. אם הסגנון של ערכת נושא מקשה על הקריאה בדף, אפשר לכבות שם את **הסגנון הייחודי של ערכת הנושא**. ההגדרות תמיד מופיעות בלעדיו, בכתובת של הדף עם `#/settings/page` בסופה.
|
|
223
223
|
|
|
224
224
|
כשהמנחה שואל משהו, הבאנר שלו נשאר בראש הדף, בכל חלק שבו נמצאים.
|
|
225
225
|
|
|
@@ -265,13 +265,13 @@ RPG Engine יכול ליצור תמונות של המקומות שמגיעים
|
|
|
265
265
|
|
|
266
266
|
- **נבנה תוך כדי משחק**: מהרעיון המוביל שלך, המנחה בונה כל מקום, דמות ועלילה רגע לפני שצריך אותם, ושומר אותם.
|
|
267
267
|
- **מוכן מההתחלה**: אותו דבר, כשהעולם נבנה לפני המשחק.
|
|
268
|
-
- **מהרפתקה או מספר משלך**: לתת למנחה את הקובץ שלו, *[ייבא את ההרפתקה הזאת כקמפיין שלנו: D:\Books\adventure.pdf. אל תגלה לי שום דבר ממה שכתוב בה.]* הכי טוב לקרוא אותה כטקסט, EPUB, מסמך Word או PDF שאפשר לסמן בו טקסט. PDF סרוק נקרא מתוך תמונות הדפים שלו, רק ב-Windows, לאט ועם כמה טעויות.
|
|
268
|
+
- **מהרפתקה או מספר משלך**: לתת למנחה את הקובץ שלו, *[ייבא את ההרפתקה הזאת כקמפיין שלנו: D:\Books\adventure.pdf. אל תגלה לי שום דבר ממה שכתוב בה.]* הכי טוב לקרוא אותה כטקסט, EPUB, מסמך Word או PDF שאפשר לסמן בו טקסט. PDF סרוק נקרא מתוך תמונות הדפים שלו, רק ב-Windows, לאט ועם כמה טעויות. אפליקציית ה-AI שלך קוראת אותו מחוץ לצ'אט, ואם לא, המנחה בצ'אט, בתוכנית שלך: ב-Claude Code או ב-Codex אחד משני אלה קורא אותו, ב-Antigravity ה-Antigravity שלך, וב-OpenCode המודל שנבחר בו לאחרונה. המסמך כולו נשלח ליצרן של זה שקורא אותו, לפי תנאי החשבון שלך והבחירה שלו לגבי אימון. הדשבורד מראה כמה כבר נקרא; מתוך רומן, המנחה מציע מאיפה להתחיל. המנחה כותב את המקומות, הדמויות והסודות.
|
|
269
269
|
|
|
270
270
|
קמפיין משחקים פעם אחת: כדי לשחק שוב באותה הרפתקה, יוצרים קמפיין חדש.
|
|
271
271
|
|
|
272
272
|
### 7.2 שפות
|
|
273
273
|
|
|
274
|
-
שפה אחת לכל קמפיין, זו של המנחה,
|
|
274
|
+
שפה אחת לכל קמפיין, זו של המנחה, והדשבורד עוקב אחריה. הדשבורד מגיע עם 26 שפות. כל שפה אחרת מתורגמת במחשב שלך בידי אפליקציית ה-AI שלך מחוץ לצ'אט (Codex או Claude Code; ב-Antigravity וב-OpenCode, האפליקציות עצמן), ואם אין כזו שיכולה, בידי המנחה בצ'אט. המונחים של המהדורה החמישית באיטלקית מגיעים מה-SRD האיטלקי הרשמי; טקסט החוקים נשאר באנגלית, והמנחה מספר אותו בשפה שלך.
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ RPG Engine נשאר בתיקייה הזאת: הוא קורא וכותב את ה
|
|
|
323
323
|
|
|
324
324
|
**המנחה זוכר משהו שביטלתי.** לפתוח צ'אט חדש וללחוץ על **נפתח צ'אט חדש** ב-שמירות.
|
|
325
325
|
|
|
326
|
-
**לא מופיעות תמונות.** הגדרות > תמונות אומר אם המחשב הזה יכול להכין אותן, ואיך.
|
|
326
|
+
**לא מופיעות תמונות.** הגדרות > קמפיין > תמונות אומר אם המחשב הזה יכול להכין אותן, ואיך.
|
|
327
327
|
|
|
328
328
|
**ההתקנה נכשלת, או ש-`rpg` לא עולה.** `node --version` חייב להראות 24 או חדש יותר. אם Windows משיבה שהרצת סקריפטים מושבתת, ראו [2.1](#21-what-you-need). ב-Windows, להרחיק את RPG Engine ואת הקמפיינים מנתיבים שמכילים `&`.
|
|
329
329
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,44018911,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: पूरी गाइड
|
|
3
3
|
|
|
4
4
|
**RPG Engine** आपको **AI को अपना गेम मास्टर** बनाकर टेबलटॉप रोल-प्लेइंग गेम खेलने देता है। आप गेम मास्टर से **चैट** में बात करते हैं। RPG Engine पर्दे के पीछे काम करता है: वह **दुनिया को याद रखता है**, **पासे रोल करता है** और **हिसाब-किताब रखता है**। चैट के साथ आप ब्राउज़र में एक पेज खुला रखते हैं, यानी **डैशबोर्ड**, जिसमें आपकी कैरेक्टर शीट, पासे, नक्शे और आपकी डायरी होती है।
|
|
@@ -67,14 +67,14 @@ rpg init "The Salt Isles"
|
|
|
67
67
|
गेम मास्टर एक **AI एजेंट** में चलता है: टर्मिनल या डेस्कटॉप पर चलने वाला ऐसा AI ऐप, जो आपके कंप्यूटर की फ़ाइलों के साथ काम कर सके, जैसे Claude Code, Codex, Antigravity या OpenCode। claude.ai या ChatGPT जैसी सादी चैट, या फ़ोन ऐप काफ़ी नहीं है: गेम मास्टर को आपके कंप्यूटर पर कैंपेन की फ़ाइलों तक पहुँचना होता है। हर एजेंट को अपना प्लान और लॉगिन चाहिए: Claude Code के लिए Claude का पेड प्लान, Codex के लिए ChatGPT लॉगिन, Antigravity के लिए Google अकाउंट, जिसके फ़्री प्लान में हफ़्ते का कोटा कम है; OpenCode उन मॉडलों के साथ चलता है जो आप उसे देते हैं, लोकल मॉडल भी। इसे आप एक बार इंस्टॉल करते हैं, उसके अपने पेज से: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai)।
|
|
68
68
|
|
|
69
69
|
- **Claude Code**: कैंपेन फ़ोल्डर में `claude` लिखें। जब वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो **Yes, I trust this folder** चुनें; ध्यान रहे, पहले से चुना हुआ जवाब *No, exit* होता है। कैंपेन में एक छोटा हुक भी है, `rpg --listen`, जिसे यह सवाल नहीं दिखाता: जब आप डैशबोर्ड से कुछ करते हैं, तो वह गेम मास्टर को तुरंत बता देता है।
|
|
70
|
-
- **Codex**: कैंपेन फ़ोल्डर में `codex` लिखें, और जब वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें। उसके डेस्कटॉप ऐप में सेटिंग्स में देखें कि गेम की चैट के लिए मेमोरी बंद हो।
|
|
71
|
-
- **Antigravity**: कैंपेन फ़ोल्डर में `agy` लिखें, और अगर वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें; या उसके ऐप में कैंपेन फ़ोल्डर खोलें। ऐप के लिए RPG Engine खुद को Antigravity की अपनी सेटिंग्स में भी जोड़ देता है, आपके होम फ़ोल्डर की `.gemini/config/mcp_config.json` में, जो आपके खोले हर फ़ोल्डर पर लागू होती हैं, सिर्फ़ कैंपेन पर नहीं: कैंपेन के बाहर वह कुछ नहीं करता। कैंपेन में दो छोटे हुक हैं: `rpg --approve` गेम मास्टर को RPG Engine के टूल इस्तेमाल करने देता है, हर बार आपसे पूछे बिना, और `rpg --listen` जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। चित्र गेम मास्टर चैट में खुद बनाता
|
|
72
|
-
- **OpenCode**: कैंपेन फ़ोल्डर में `opencode` लिखें। कैंपेन में एक छोटा प्लगइन है, `.opencode/plugins/rpg.js`, जो जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। कैंपेन में गेम मास्टर फ़ाइलें सिर्फ़ RPG Engine के ज़रिए लिखता है: OpenCode की अपनी फ़ाइल लिखने और बदलने की सुविधा वहाँ बंद रहती है, और कोई कमांड चलाने से पहले वह आपसे पूछता है। गेम मास्टर चित्र खुद बनाता है, सादे वेक्टर चित्रों के रूप में, जैसा Claude करता है। आपका OpenCode, उसमें आपके आख़िरी चुने मॉडल के साथ, डैशबोर्ड और खेल के नियमों का अनुवाद भी करता है और आप जो दस्तावेज़ इम्पोर्ट करते हैं उन्हें चैट के बाहर पढ़ता है; अगर उसके पास इस्तेमाल करने लायक कोई मॉडल न हो, तो Codex या Claude Code यह काम करते हैं, अगर वे आपके पास हों।
|
|
70
|
+
- **Codex**: कैंपेन फ़ोल्डर में `codex` लिखें, और जब वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें। अहम मौकों पर कोई किरदार अपने अलग एजेंट, `.codex/agents/rpg-character.toml`, के ज़रिए बोलता है, जो सिर्फ़ वही जानता है जो वह किरदार जानता है। उसके डेस्कटॉप ऐप में सेटिंग्स में देखें कि गेम की चैट के लिए मेमोरी बंद हो।
|
|
71
|
+
- **Antigravity**: कैंपेन फ़ोल्डर में `agy` लिखें, और अगर वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें; या उसके ऐप में कैंपेन फ़ोल्डर खोलें। ऐप के लिए RPG Engine खुद को Antigravity की अपनी सेटिंग्स में भी जोड़ देता है, आपके होम फ़ोल्डर की `.gemini/config/mcp_config.json` में, जो आपके खोले हर फ़ोल्डर पर लागू होती हैं, सिर्फ़ कैंपेन पर नहीं: कैंपेन के बाहर वह कुछ नहीं करता। कैंपेन में दो छोटे हुक हैं: `rpg --approve` गेम मास्टर को RPG Engine के टूल इस्तेमाल करने देता है, हर बार आपसे पूछे बिना, और `rpg --listen` जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। चित्र गेम मास्टर चैट में खुद बनाता है, Google के पेड प्लान के साथ; फ़्री प्लान में उसका इमेज टूल नहीं चलता, और तब वह सादे वेक्टर चित्र बनाता है, जैसा Claude करता है। अहम मौकों पर कोई किरदार अपने अलग एजेंट, `.agents/agents/rpg-character.md`, के ज़रिए बोलता है: गेम मास्टर कहानी की एक पंक्ति लिखता है, और किरदार का जवाब कुछ पल बाद आता है। आपका Antigravity डैशबोर्ड और खेल के नियमों का अनुवाद भी करता है और आप जो दस्तावेज़ इम्पोर्ट करते हैं उन्हें चैट के बाहर पढ़ता है, आपके Google अकाउंट के कोटे पर: RPG Engine उसे आपकी अपनी चैट से अलग शुरू करता है, इसलिए वह उनके बीच कुछ नहीं छोड़ता। Antigravity आपकी पुरानी चैट सहेजकर रखता है, और उसकी मेमोरी बंद नहीं की जा सकती: गेम मास्टर को कहा गया है कि वह उन्हें कभी न पढ़े। आप जो लिखते हैं वह Google के पास जाता है, जहाँ लोग उसे पढ़ सकते हैं: निजी जानकारी को खेल से बाहर रखें। RPG Engine Google का प्रोडक्ट नहीं है।
|
|
72
|
+
- **OpenCode**: कैंपेन फ़ोल्डर में `opencode` लिखें। कैंपेन में एक छोटा प्लगइन है, `.opencode/plugins/rpg.js`, जो जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। कैंपेन में गेम मास्टर फ़ाइलें सिर्फ़ RPG Engine के ज़रिए लिखता है: OpenCode की अपनी फ़ाइल लिखने और बदलने की सुविधा वहाँ बंद रहती है, और कोई कमांड चलाने से पहले वह आपसे पूछता है। गेम मास्टर चित्र खुद बनाता है, सादे वेक्टर चित्रों के रूप में, जैसा Claude करता है। अहम मौकों पर कोई किरदार अपने अलग एजेंट, `.opencode/agents/rpg-character.md`, के ज़रिए बोलता है: गेम मास्टर कहानी की एक पंक्ति लिखता है, और किरदार का जवाब कुछ पल बाद आता है; छोटा लोकल मॉडल शायद उसे न बुला पाए। आपका OpenCode, उसमें आपके आख़िरी चुने मॉडल के साथ, डैशबोर्ड और खेल के नियमों का अनुवाद भी करता है और आप जो दस्तावेज़ इम्पोर्ट करते हैं उन्हें चैट के बाहर पढ़ता है; अगर उसके पास इस्तेमाल करने लायक कोई मॉडल न हो, तो Codex या Claude Code यह काम करते हैं, अगर वे आपके पास हों।
|
|
73
73
|
- **कोई और एजेंट**: उसे कैंपेन फ़ोल्डर में शुरू करें और उसे MCP सर्वर `rpg mcp` दें। RPG Engine एक मानक MCP सर्वर है: MCP को सपोर्ट करने वाला कोई भी एजेंट गेम मास्टर बन सकता है, लोकल एजेंट भी।
|
|
74
74
|
|
|
75
75
|
अगर गेम मास्टर कहे कि उसे RPG Engine के टूल नहीं मिल रहे, तो कैंपेन फ़ोल्डर में `rpg init` लिखें: जो फ़ोल्डर पहले से कैंपेन है, उसमें यह सिर्फ़ इन फ़ाइलों को अपडेट करता है; फिर नई चैट खोलें।
|
|
76
76
|
|
|
77
|
-
हम इसे **Claude Code** के साथ खेलते और टेस्ट करते हैं; **Codex** और **
|
|
77
|
+
हम इसे **Claude Code** के साथ खेलते और टेस्ट करते हैं; **Codex**, **Antigravity** और **OpenCode** जुड़े हुए हैं और जाँचे गए हैं, पर उनके साथ अभी तक कोई पूरा कैंपेन नहीं खेला गया। कैंपेन एजेंट की अपनी मेमोरी बंद कर देता है: गेम उसकी फ़ाइलों में रहता है, ताकि किसी सेव पर लौटने का मतलब सचमुच वहीं लौटना हो।
|
|
78
78
|
|
|
79
79
|
### 2.5 पहली चैट
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ rpg init "The Salt Isles"
|
|
|
130
130
|
|
|
131
131
|
आप बताते हैं कि आप क्या करने की कोशिश करते हैं; गेम मास्टर बताता है कि क्या होता है। गेम मास्टर आपके किरदार के लिए कभी फ़ैसला नहीं करता, और इंजन के बारे में कभी बात नहीं करता। डैशबोर्ड कैसे इस्तेमाल करें, यह आप गेम मास्टर से पूछ सकते हैं।
|
|
132
132
|
|
|
133
|
-
**डैशबोर्ड से कुछ करना**: अपनी कैरेक्टर शीट पर किसी नाम पर क्लिक करें, जैसे कोई हथियार, कोई मंत्र या आपके पास रखी कोई चीज़: उसका कार्ड बताता है कि वह क्या है। चुनें कि आप उसके साथ क्या करते
|
|
133
|
+
**डैशबोर्ड से कुछ करना**: अपनी कैरेक्टर शीट पर किसी नाम पर क्लिक करें, जैसे कोई हथियार, कोई मंत्र या आपके पास रखी कोई चीज़: उसका कार्ड बताता है कि वह क्या है; थैला उसके तीर से खुलता है, और उसका ⓘ उसका कार्ड दिखाता है। चुनें कि आप उसके साथ क्या करते हैं। जिस काम में किसी और की ज़रूरत नहीं, जैसे **धारण करें**, उसमें उसी बटन पर पुष्टि माँगी जाती है, *पुष्टि करें: मैं ढाल धारण करूँ*: उसे फिर दबाएँ और वह गेम मास्टर तक पहुँच जाता है। जो काम किसी पर किया जाता है, जैसे **हमला करें**, उसमें पूछा जाता है कि किस पर, सूची में या नक्शे पर क्लिक करके; फिर बटन पूरा वाक्य दिखाता है, *मैं गदा से Hooded Bandit 1 पर हमला करूँ*, और एक क्लिक उसे भेज देता है। अपने ढंग से कहने के लिए, जिससे बात करनी हो उस व्यक्ति पर क्लिक करें, या चैट में लिखें। गेम मास्टर इसे ऐसे सुनता है जैसे आपने चैट में कहा हो, किसी भी दूसरी बात की तरह इस पर फ़ैसला देता है, और जो आपने नहीं बताया, वह बटनों से पूछता है। जहाँ आपके AI ऐप में तुरंत बताने की सुविधा नहीं है, वहाँ गेम मास्टर इसे तब पढ़ता है जब आप अगली बार चैट में लिखते हैं; अगर चैट पहले बंद हो चुकी थी, तो **दोबारा बोलें** इसे एक बार फिर भेज देता है।
|
|
134
134
|
|
|
135
135
|
### 3.2 रोल
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ RPG Engine हर दृश्य के अंत में पूरी कै
|
|
|
198
198
|
|
|
199
199
|
### 3.11 तस्वीरें
|
|
200
200
|
|
|
201
|
-
RPG Engine उन जगहों, उन मिशनों और उन लोगों के चित्र बनवा सकता है जिनसे आप मिलते हैं, जैसा **चित्र** की सेटिंग कहती है, और आपके कहने पर आपके किरदार का पोर्ट्रेट भी।
|
|
201
|
+
RPG Engine उन जगहों, उन मिशनों और उन लोगों के चित्र बनवा सकता है जिनसे आप मिलते हैं, जैसा **चित्र** की सेटिंग कहती है, और आपके कहने पर आपके किरदार का पोर्ट्रेट भी। आपका अपना AI ऐप उन्हें अपने साधनों से बनाता है, आपके लॉगिन से, आपके प्लान और उसकी सीमाओं में: **Claude** उन्हें वेक्टर चित्रों के रूप में बनाता है, **Codex** और **Antigravity** उन्हें पेंट करते हैं, **OpenCode** चैट में सादे वेक्टर चित्र बनाता है। **सेटिंग्स > कैंपेन > चित्र** में आप Codex या Antigravity से भी उन्हें पेंट करवा सकते हैं, तब भी जब आपका गेम मास्टर कोई और ऐप हो: जहाँ आपका चुना हुआ ऐप यह न कर सके, वहाँ आपकी चैट उन्हें बनाती है। **सेटिंग्स** बताती है कि यह कंप्यूटर उन्हें बना सकता है या नहीं, और नहीं बना सकता तो इसे कैसे सेट करें। आप अपना कोई चित्र हमेशा दे सकते हैं, अपने किरदार को या अपने देखे किसी भी पेज को: उसके किसी चित्र पर पॉइंटर ले जाएँ, तो उसके कोने में एक छोटा चित्र-बटन दिखता है (कीबोर्ड से भी, और फ़ोन पर हमेशा); **दुनिया** में आप जो पेज खोलते हैं, उस पर भी **तस्वीर बदलें…** होता है, या जब तक उसमें कोई चित्र न हो, **तस्वीर जोड़ें…**। आपका चित्र पहले वाले की जगह ले लेता है। या फ़ाइल को कैंपेन के **inbox** फ़ोल्डर में डाल दें और गेम मास्टर को बताएँ कि वह किस पेज के लिए है।
|
|
202
202
|
|
|
203
203
|
### 3.12 सुरक्षा: सीमा-रेखाएँ, पर्दे और स्टॉप
|
|
204
204
|
|
|
@@ -219,7 +219,7 @@ RPG Engine उन जगहों, उन मिशनों और उन ल
|
|
|
219
219
|
- **डायरी**: मिशन, किताब के रूप में कहानी, उसकी टाइमलाइन, आपके साथियों की डायरियाँ और आपके नोट।
|
|
220
220
|
- **दुनिया**: दुनिया का नक्शा, आपके किरदार को जो पता है, मिले हुए दस्तावेज़ और कैलेंडर।
|
|
221
221
|
- **पासा ट्रे**: पासे और मॉडिफ़ायर चुनें, फिर उन्हें फेंकें। ×2 पासों को दोगुना करता है, मॉडिफ़ायर को कभी नहीं। क्रिटिकल हिट में भी यही होता है।
|
|
222
|
-
- **सेव**, **सहायता**, **सेटिंग्स** और **जानकारी**: ये पंक्ति के आख़िर में आइकन के रूप में हैं। सेटिंग्स में पेज की अपनी पसंद भी मिलती हैं: थीम, पासों की आवाज़, पासों का सेट और **खेल की शैली**, यानी पेज के रंग, चेहरे और तस्वीरें। यह शैली खेल सिस्टम की अपनी हो सकती है, या Packages › Add से जोड़ी गई थीम, जो कैटलॉग, GitHub लिंक, .zip फ़ाइल या फ़ोल्डर से आती है, या फिर पेज की अपनी शैली। अगर किसी थीम की अपनी स्टाइल शीट से पेज पढ़ने में मुश्किल हो, तो वहाँ **थीम की अपनी शैली** बंद कर दें। सेटिंग्स हमेशा उसके बिना दिखती हैं, पेज के पते के आख़िर में `#/settings` जोड़कर।
|
|
222
|
+
- **सेव**, **सहायता**, **सेटिंग्स** और **जानकारी**: ये पंक्ति के आख़िर में आइकन के रूप में हैं। सेटिंग्स में **यह पेज** के अंदर पेज की अपनी पसंद भी मिलती हैं: थीम, पासों की आवाज़, पासों का सेट और **खेल की शैली**, यानी पेज के रंग, चेहरे और तस्वीरें। यह शैली खेल सिस्टम की अपनी हो सकती है, या Packages › Add से जोड़ी गई थीम, जो कैटलॉग, GitHub लिंक, .zip फ़ाइल या फ़ोल्डर से आती है, या फिर पेज की अपनी शैली। अगर किसी थीम की अपनी स्टाइल शीट से पेज पढ़ने में मुश्किल हो, तो वहाँ **थीम की अपनी शैली** बंद कर दें। सेटिंग्स हमेशा उसके बिना दिखती हैं, पेज के पते के आख़िर में `#/settings/page` जोड़कर।
|
|
223
223
|
|
|
224
224
|
जब गेम मास्टर आपसे कुछ पूछता है, तो उसका बैनर सबसे ऊपर बना रहता है, चाहे आप किसी भी सेक्शन में हों।
|
|
225
225
|
|
|
@@ -265,13 +265,13 @@ SRD में जो सामग्री नहीं है, उसे भी
|
|
|
265
265
|
|
|
266
266
|
- **खेलते-खेलते बनी**: आपके कथानक-आधार से, गेम मास्टर हर जगह, व्यक्ति और कथानक आपको उसकी ज़रूरत पड़ने से ठीक पहले बनाता है, और उसे सँभालकर रखता है।
|
|
267
267
|
- **शुरू में तैयार की गई**: वही, पर दुनिया खेल से पहले बनाई जाती है।
|
|
268
|
-
- **आपके अपने एडवेंचर या किताब से**: गेम मास्टर को उसकी फ़ाइल दें, *[इस एडवेंचर को हमारे कैंपेन के रूप में इम्पोर्ट करो: D:\Books\adventure.pdf. इसमें जो कुछ है, मुझे मत बताना।]* यह टेक्स्ट, EPUB, Word दस्तावेज़ या ऐसे PDF से सबसे अच्छा पढ़ा जाता है जिसका टेक्स्ट चुना जा सके; स्कैन किया हुआ PDF उसके पन्नों की तस्वीरों से पढ़ा जाता है, सिर्फ़ Windows पर, धीरे-धीरे और कुछ ग़लतियों के साथ। आपका अपना
|
|
268
|
+
- **आपके अपने एडवेंचर या किताब से**: गेम मास्टर को उसकी फ़ाइल दें, *[इस एडवेंचर को हमारे कैंपेन के रूप में इम्पोर्ट करो: D:\Books\adventure.pdf. इसमें जो कुछ है, मुझे मत बताना।]* यह टेक्स्ट, EPUB, Word दस्तावेज़ या ऐसे PDF से सबसे अच्छा पढ़ा जाता है जिसका टेक्स्ट चुना जा सके; स्कैन किया हुआ PDF उसके पन्नों की तस्वीरों से पढ़ा जाता है, सिर्फ़ Windows पर, धीरे-धीरे और कुछ ग़लतियों के साथ। आपका अपना AI ऐप इसे चैट के बाहर पढ़ता है, नहीं तो चैट में गेम मास्टर पढ़ता है, आपके प्लान पर: Claude Code या Codex में इन दोनों में से कोई एक पढ़ता है, Antigravity में आपका Antigravity, OpenCode में उसमें आपका आख़िरी चुना मॉडल। पूरा दस्तावेज़ उसे पढ़ने वाले ऐप के निर्माता को जाता है, आपके खाते की शर्तों और ट्रेनिंग के बारे में आपके चुनाव के अनुसार। डैशबोर्ड दिखाता है कि काम कितना आगे बढ़ा है; उपन्यास से, गेम मास्टर सुझाता है कि कहाँ से शुरू करें। वह जगहें, किरदार और राज़ लिखता है।
|
|
269
269
|
|
|
270
270
|
एक कैंपेन एक ही बार खेला जाता है: वही एडवेंचर फिर खेलना हो, तो नया कैंपेन बनाएँ।
|
|
271
271
|
|
|
272
272
|
### 7.2 भाषाएँ
|
|
273
273
|
|
|
274
|
-
हर कैंपेन की एक भाषा, गेम मास्टर की भाषा, जिसे डैशबोर्ड अपनाता है। डैशबोर्ड 26 भाषाओं के साथ आता है। कोई और भाषा आपके कंप्यूटर पर Codex या Claude Code
|
|
274
|
+
हर कैंपेन की एक भाषा, गेम मास्टर की भाषा, जिसे डैशबोर्ड अपनाता है। डैशबोर्ड 26 भाषाओं के साथ आता है। कोई और भाषा आपके कंप्यूटर पर आपका अपना AI ऐप चैट के बाहर अनुवाद करता है (Codex या Claude Code; Antigravity और OpenCode में उनका अपना), या जहाँ कोई न कर सके, वहाँ चैट में गेम मास्टर। पाँचवें संस्करण के शब्द इतालवी में आधिकारिक इतालवी SRD से आते हैं; नियमों का पाठ अंग्रेज़ी में रहता है, और गेम मास्टर उसे आपकी भाषा में सुनाता है।
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ RPG Engine इसी फ़ोल्डर में रहता है: वह
|
|
|
323
323
|
|
|
324
324
|
**गेम मास्टर को कुछ ऐसा याद है जो मैंने रद्द किया।** नई चैट खोलें और सेव में **मैंने नई चैट खोल ली है** दबाएँ।
|
|
325
325
|
|
|
326
|
-
**कोई चित्र नहीं दिखता।** सेटिंग्स > चित्र बताता है कि यह कंप्यूटर उन्हें बना सकता है या नहीं, और कैसे।
|
|
326
|
+
**कोई चित्र नहीं दिखता।** सेटिंग्स > कैंपेन > चित्र बताता है कि यह कंप्यूटर उन्हें बना सकता है या नहीं, और कैसे।
|
|
327
327
|
|
|
328
328
|
**इंस्टॉल नहीं होता, या `rpg` शुरू नहीं होता।** `node --version` को 24 या उससे नया बताना चाहिए। अगर Windows कहे कि स्क्रिप्ट चलाना बंद है, तो [2.1](#21-what-you-need) देखें। Windows पर RPG Engine और अपने कैंपेन को ऐसे पाथ से बाहर रखें जिनमें `&` हो।
|
|
329
329
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,8b6ac2d5,7b760ca8,086f7b8c,db332866,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,bd8adb1c,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,12a7bf4b,15e36217,4b57013e,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,9d7e522f,f4c26681,c6b050c9,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,6cb75000,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,ce5255cd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,44018911,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,3f155eae,b8e71497,32482cb4,d90a5d53,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,590b2eb2,df64a3bb,e9a3f2a9. 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.
|
|
@@ -67,14 +67,14 @@ A mesélő nem tud kampányt létrehozni neked: az `init` előtt semmi sem mondj
|
|
|
67
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, a Codex, az Antigravity vagy az OpenCode. 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, az Antigravityhez Google-fiók, amelynek ingyenes csomagjában kicsi a heti keret. Az OpenCode azokkal a modellekkel működik, amelyeket megadsz neki, a helyiekkel is. 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), [Antigravity](https://antigravity.google), [OpenCode](https://opencode.ai).
|
|
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
|
-
- **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.
|
|
71
|
-
- **Antigravity**: a kampány mappájában írd be: `agy`, és mondj igent, ha megkérdezi, megbízol-e a mappában; vagy az alkalmazásában nyisd meg a kampány mappáját. Az alkalmazáshoz az RPG Engine az Antigravity saját beállításaiba is beírja magát: a saját mappádban lévő `.gemini/config/mcp_config.json` fájlba. Ezek minden megnyitott mappára érvényesek, nem csak a kampányéra: kampányon kívül az RPG Engine nem csinál semmit. A kampányban két kis hook van: az `rpg --approve` lehetővé teszi, hogy a mesélő az RPG Engine eszközeit minden alkalommal kérdezés nélkül használja, az `rpg --listen` pedig azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel. A képeket a mesélő maga festi meg a chatben;
|
|
72
|
-
- **OpenCode**: a kampány mappájában írd be: `opencode`. A kampányban van egy kis bővítmény, a `.opencode/plugins/rpg.js`, amely azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel. A kampányban a mesélő csak az RPG Engine-en keresztül ír fájlokat: az OpenCode saját fájlírása és -szerkesztése ott ki van kapcsolva, és parancs futtatása előtt rákérdez nálad. A képeket a mesélő maga rajzolja, egyszerű vektorképekként, ahogy a Claude is. Az OpenCode a benne legutóbb választott modellel a chaten kívül a vezérlőpultot és a játék szabályait is lefordítja, és az importált dokumentumokat is beolvassa; ha nincs használható modellje, ezt a Codex vagy a Claude Code végzi el, ha megvannak neked.
|
|
70
|
+
- **Codex**: a kampány mappájában írd be: `codex`, és mondj igent, amikor megkérdezi, megbízol-e a mappában. Kulcspillanatokban a karakter egy saját ügynökön keresztül beszél, ez a `.codex/agents/rpg-character.toml`, amely csak azt tudja, amit a karakter. 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.
|
|
71
|
+
- **Antigravity**: a kampány mappájában írd be: `agy`, és mondj igent, ha megkérdezi, megbízol-e a mappában; vagy az alkalmazásában nyisd meg a kampány mappáját. Az alkalmazáshoz az RPG Engine az Antigravity saját beállításaiba is beírja magát: a saját mappádban lévő `.gemini/config/mcp_config.json` fájlba. Ezek minden megnyitott mappára érvényesek, nem csak a kampányéra: kampányon kívül az RPG Engine nem csinál semmit. A kampányban két kis hook van: az `rpg --approve` lehetővé teszi, hogy a mesélő az RPG Engine eszközeit minden alkalommal kérdezés nélkül használja, az `rpg --listen` pedig azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel. A képeket a mesélő maga festi meg a chatben, fizetős Google-csomaggal; az ingyenes csomagban a képkészítő eszköze nem működik, ilyenkor egyszerű vektorképeket rajzol, ahogy a Claude is. Kulcspillanatokban a karakter egy saját ügynökön keresztül beszél, ez a `.agents/agents/rpg-character.md`: a mesélő megír egy sort a történetből, a karakter válasza pedig egy pillanattal később érkezik. Az Antigravity a chaten kívül a vezérlőpultot és a játék szabályait is lefordítja, és az importált dokumentumokat is beolvassa, a Google-fiókod keretéből: az RPG Engine a saját chatjeidtől külön indítja, így nem hagy nyomot közöttük. Az Antigravity megőrzi a korábbi chatjeidet, és a memóriája nem kapcsolható ki: a mesélő azt az utasítást kapja, hogy soha ne olvassa el őket. Amit írsz, a Google-hoz kerül, ahol emberek is elolvashatják: ne vigyél személyes adatot a játékba. Az RPG Engine nem a Google terméke.
|
|
72
|
+
- **OpenCode**: a kampány mappájában írd be: `opencode`. A kampányban van egy kis bővítmény, a `.opencode/plugins/rpg.js`, amely azonnal szól a mesélőnek, ha a vezérlőpulton cselekszel. A kampányban a mesélő csak az RPG Engine-en keresztül ír fájlokat: az OpenCode saját fájlírása és -szerkesztése ott ki van kapcsolva, és parancs futtatása előtt rákérdez nálad. A képeket a mesélő maga rajzolja, egyszerű vektorképekként, ahogy a Claude is. Kulcspillanatokban a karakter egy saját ügynökön keresztül beszél, ez a `.opencode/agents/rpg-character.md`: a mesélő megír egy sort a történetből, a karakter válasza pedig egy pillanattal később érkezik; egy kis helyi modell lehet, hogy nem hívja meg. Az OpenCode a benne legutóbb választott modellel a chaten kívül a vezérlőpultot és a játék szabályait is lefordítja, és az importált dokumentumokat is beolvassa; ha nincs használható modellje, ezt a Codex vagy a Claude Code végzi el, ha megvannak neked.
|
|
73
73
|
- **Másik ügynök**: indítsd el a kampány mappájában, és add meg neki az `rpg mcp` MCP-szervert. Az RPG Engine szabványos MCP-szerver: bármelyik MCP-t támogató ügynök lehet a mesélő, a helyiek is.
|
|
74
74
|
|
|
75
75
|
Ha a mesélő azt mondja, hogy nem találja az RPG Engine eszközeit, írd be az `rpg init` parancsot a kampány mappájában: egy olyan mappában, amely már kampány, ez csak frissíti ezeket a fájlokat. Utána nyiss egy új chatet.
|
|
76
76
|
|
|
77
|
-
**Claude Code-dal** játszunk és tesztelünk. A **Codex** és az **
|
|
77
|
+
**Claude Code-dal** játszunk és tesztelünk. A **Codex**, az **Antigravity** és az **OpenCode** csatlakoztatva és ellenőrizve van, de még egyikükkel sem játszottunk végig egy kampányt. A kampány kikapcsolja az ügynök saját memóriáját: a játék a fájljaiban él, így egy mentéshez való visszatérés tényleg visszavisz.
|
|
78
78
|
|
|
79
79
|
### 2.5 Az első chat
|
|
80
80
|
|
|
@@ -130,7 +130,7 @@ A történeten kívül írd így: `[OOC: …]` (out of character): *[OOC: Hogyan
|
|
|
130
130
|
|
|
131
131
|
Te azt mondod meg, mit próbálsz tenni; a mesélő azt, mi történik. A mesélő sosem dönt a karaktered helyett, és sosem beszél a motorról. Megkérdezheted tőle, hogyan használd a vezérlőpultot.
|
|
132
132
|
|
|
133
|
-
**Cselekvés a vezérlőpultról**: kattints egy névre a karakterlapodon, például egy fegyverre, egy varázslatra vagy egy nálad lévő tárgyra: a kártyája megmondja, micsoda. Válaszd ki, mit teszel vele, például a **
|
|
133
|
+
**Cselekvés a vezérlőpultról**: kattints egy névre a karakterlapodon, például egy fegyverre, egy varázslatra vagy egy nálad lévő tárgyra: a kártyája megmondja, micsoda. A táska a nyilával nyílik ki, az ⓘ pedig a kártyáját mutatja. Válaszd ki, mit teszel vele. Ami senkit sem érint, például a **Felszerelés**, ugyanazon a gombon kéri a megerősítést: *Megerősítés: felszerelem a Pajzsot*. Nyomd meg újra, és elmegy a mesélőnek. Ami valakin történik, például a **Támadás**, megkérdezi, kin: a listában vagy a térképre kattintva. Ekkor a gomb a teljes mondatot kiírja: *Megtámadom az 1. csuklyás banditát a buzogánnyal*, és egy kattintás elküldi. Ha a magad módján akarod mondani, kattints valakire, akivel beszélnél, vagy írj a chatbe. A mesélő úgy hallja, mintha a chatben mondtad volna, úgy bírálja el, mint bármi mást, és gombokkal megkérdezi, amit kihagytál. Ha az AI-appod nem tud azonnal szólni a mesélőnek, a mesélő akkor olvassa el, amikor legközelebb írsz a chatbe; ha a chatet közben bezárták, a **Mondd újra** még egyszer elküldi.
|
|
134
134
|
|
|
135
135
|
### 3.2 Dobások
|
|
136
136
|
|
|
@@ -198,7 +198,7 @@ A vezérlőpult tetején lévő robot a mesélő: az arca követi a történet h
|
|
|
198
198
|
|
|
199
199
|
### 3.11 Képek
|
|
200
200
|
|
|
201
|
-
Az RPG Engine képeket készíthet az általad elért helyszínekről, a vállalt küldetésekről és azokról, akikkel találkozol, ahogy a **Képek** beállítás előírja, és a karaktered portréját is, ha kéred. A saját
|
|
201
|
+
Az RPG Engine képeket készíthet az általad elért helyszínekről, a vállalt küldetésekről és azokról, akikkel találkozol, ahogy a **Képek** beállítás előírja, és a karaktered portréját is, ha kéred. A saját AI-appod készíti őket a saját eszközeivel, a te bejelentkezéseddel, a te csomagodon és annak korlátai szerint: a **Claude** vektorképként rajzolja őket, a **Codex** és az **Antigravity** festi őket, az **OpenCode** egyszerű vektorképeket rajzol a chatben. A **Beállítások > Kampány > Képek** helyen elérheted, hogy a Codex vagy az Antigravity akkor is megfesse őket, ha a mesélőd másik app: ahol a kiválasztott nem tudja, a chated készíti el őket. A **Beállítások** megmondja, hogy ez a számítógép tudja-e készíteni őket, és ha nem, hogyan állítsd be. Bármikor adhatsz saját képet a karakterednek vagy bármelyik oldalnak, amelyet látsz: húzd az egérmutatót az egyik képe fölé, és a sarkában megjelenik egy kis képgomb (billentyűzettel is, telefonon pedig mindig); a **Világban** a megnyitott oldalon is van **Kép cseréje…**, vagy **Kép hozzáadása…**, amíg még nincs képe. A tiéd a meglévő helyére kerül. Vagy tedd a fájlt a kampány **inbox** mappájába, és told meg a mesélőnek, melyik oldalhoz való.
|
|
202
202
|
|
|
203
203
|
### 3.12 Biztonság: határok, fátylak és leállítás
|
|
204
204
|
|
|
@@ -219,7 +219,7 @@ Egy oldal a saját számítógépeden, amely csak az adott gép böngészőjébe
|
|
|
219
219
|
- **Napló**: küldetések, a történet könyvként, az idővonala, a társaid naplói, a jegyzeteid.
|
|
220
220
|
- **Világ**: a világtérkép, amit a karaktered tud, a megtalált dokumentumok és a naptár.
|
|
221
221
|
- **A dobótálca**: válassz kockákat és módosítót, aztán dobj; a ×2 megduplázza a kockákat, a módosítót soha, mint kritikus találatnál.
|
|
222
|
-
- **Mentések**, **Súgó**, **Beállítások** és **Névjegy**: ikonok a sor végén. A **Beállítások** az oldal saját
|
|
222
|
+
- **Mentések**, **Súgó**, **Beállítások** és **Névjegy**: ikonok a sor végén. A **Beállítások** az **Ez az oldal** alatt az oldal saját beállításait is tartalmazza: téma, kockahang, kockakészlet és **A játék stílusa**, vagyis az oldal színei, arcai és képei: a játékrendszeré, egy téma, amelyet a Packages › Add alatt adtál hozzá a katalógusból, GitHub-linkkel, .zip fájlból vagy mappából, vagy az oldal saját stílusa. Ha egy téma saját stíluslapja nehezen olvashatóvá teszi az oldalt, kapcsold ki ott a következőt: **A téma saját stílusa**. A **Beállítások** mindig enélkül jelennek meg, az oldal címével, amelynek a végén `#/settings/page` áll.
|
|
223
223
|
|
|
224
224
|
Ha a mesélő kérdez tőled valamit, a kérdése szalagként a képernyő tetején marad, bármelyik részben jársz.
|
|
225
225
|
|
|
@@ -265,13 +265,13 @@ A bővítmény valami újat ad egy kampányhoz a játékrendszer mellé: példá
|
|
|
265
265
|
|
|
266
266
|
- **Menet közben készített**: az alapötletedből a mesélő minden helyszínt, szereplőt és cselekményszálat közvetlenül azelőtt épít fel, hogy szükséged lenne rá, és megőrzi.
|
|
267
267
|
- **Az elején előkészített**: ugyanez, de a világ a játék előtt készül el.
|
|
268
|
-
- **A saját kalandodból vagy könyvedből**: add át a mesélőnek a fájlját, *[Importáld ezt a kalandot kampányunknak: D:\Books\adventure.pdf. Ne áruld el nekem, mi van benne.]* A legjobban szövegként olvasható, EPUB-ként, Word-dokumentumként vagy olyan PDF-ként, amelynek a szövege kijelölhető. A
|
|
268
|
+
- **A saját kalandodból vagy könyvedből**: add át a mesélőnek a fájlját, *[Importáld ezt a kalandot kampányunknak: D:\Books\adventure.pdf. Ne áruld el nekem, mi van benne.]* A legjobban szövegként olvasható, EPUB-ként, Word-dokumentumként vagy olyan PDF-ként, amelynek a szövege kijelölhető. A beszkennelt PDF-et az oldalak képeiből olvassa, csak Windowson, lassan és néhány hibával. A saját AI-appod olvassa el a chaten kívül, vagy ha az nem tudja, a mesélő a chatben, az előfizetésed terhére: Claude Code-ban vagy Codexben a kettő közül az egyik, Antigravityben az Antigravity, OpenCode-ban a benne legutóbb választott modell. A teljes dokumentum annak készítőjéhez kerül, aki olvassa, a fiókod feltételei és a tanításra vonatkozó választásod szerint. A vezérlőpult mutatja, meddig jutott. Regényből a mesélő javaslatot tesz, hol kezdjétek. Megírja a helyszíneket, a szereplőket és a titkokat.
|
|
269
269
|
|
|
270
270
|
Egy kampányt egyszer játszol végig: ha ugyanazt a kalandot újra szeretnéd játszani, hozz létre új kampányt.
|
|
271
271
|
|
|
272
272
|
### 7.2 Nyelvek
|
|
273
273
|
|
|
274
|
-
Kampányonként egy nyelv van, a mesélőé, és
|
|
274
|
+
Kampányonként egy nyelv van, a mesélőé, és a vezérlőpult ezt követi. A vezérlőpult 26 nyelven érkezik. Bármelyik másikat a saját AI-appod fordítja le a számítógépeden a chaten kívül (a Codex vagy a Claude Code; Antigravityben és OpenCode-ban a sajátjuk), vagy ha egyik sem tudja, a mesélő a chatben. Az ötödik kiadás olasz kifejezései a hivatalos olasz SRD-ből származnak. A szabályszöveg angol marad, a mesélő pedig a te nyelveden meséli el.
|
|
275
275
|
|
|
276
276
|
---
|
|
277
277
|
|
|
@@ -323,7 +323,7 @@ A mesélő által használt minden parancs a kampánymappában is futtatható: a
|
|
|
323
323
|
|
|
324
324
|
**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.
|
|
325
325
|
|
|
326
|
-
**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.
|
|
326
|
+
**Nem jelennek meg képek.** A Beállítások > Kampány > Képek megmutatja, hogy ez a számítógép tudja-e készíteni őket, és hogyan.
|
|
327
327
|
|
|
328
328
|
**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.
|
|
329
329
|
|