rpg-engine 0.22.0 → 0.23.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.
- package/README.md +5 -5
- package/dist/campaign/create-campaign.d.ts +5 -0
- package/dist/campaign/create-campaign.js +40 -12
- package/dist/campaign/find-campaign.d.ts +5 -0
- package/dist/campaign/find-campaign.js +10 -5
- package/dist/campaign/host-files.d.ts +15 -4
- package/dist/campaign/host-files.js +130 -13
- package/dist/campaign/index.d.ts +2 -2
- package/dist/campaign/index.js +2 -2
- package/dist/cli/cli.js +18 -6
- package/dist/commands/config/dashboard.js +6 -1
- package/dist/commands/config/words.js +1 -1
- package/dist/commands/image.d.ts +3 -0
- package/dist/commands/image.js +31 -4
- package/dist/commands/import/import.d.ts +1 -1
- package/dist/commands/import/import.js +5 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +21 -3
- package/dist/commands/shared/campaign/git.js +1 -1
- package/dist/commands/shared/campaign/images.js +5 -3
- package/dist/commands/shared/characters/voices.d.ts +2 -2
- package/dist/commands/shared/characters/voices.js +8 -5
- package/dist/core/context.d.ts +15 -6
- package/dist/core/context.js +2 -1
- package/dist/dashboard/guide/ar.md +7 -4
- package/dist/dashboard/guide/cs.md +6 -3
- package/dist/dashboard/guide/da.md +6 -3
- package/dist/dashboard/guide/de.md +6 -3
- package/dist/dashboard/guide/el.md +6 -3
- package/dist/dashboard/guide/en.md +5 -2
- package/dist/dashboard/guide/es.md +6 -3
- package/dist/dashboard/guide/fi.md +6 -3
- package/dist/dashboard/guide/fr.md +7 -4
- package/dist/dashboard/guide/he.md +6 -3
- package/dist/dashboard/guide/hi.md +6 -3
- package/dist/dashboard/guide/hu.md +6 -3
- package/dist/dashboard/guide/is.md +6 -3
- package/dist/dashboard/guide/it.md +37 -34
- package/dist/dashboard/guide/ja.md +6 -3
- package/dist/dashboard/guide/ko.md +6 -3
- package/dist/dashboard/guide/nb.md +6 -3
- package/dist/dashboard/guide/nl.md +8 -5
- package/dist/dashboard/guide/pl.md +6 -3
- package/dist/dashboard/guide/pt.md +6 -3
- package/dist/dashboard/guide/ro.md +6 -3
- package/dist/dashboard/guide/ru.md +7 -4
- package/dist/dashboard/guide/sv.md +6 -3
- package/dist/dashboard/guide/tr.md +7 -4
- package/dist/dashboard/guide/uk.md +7 -4
- package/dist/dashboard/guide/zh.md +6 -3
- package/dist/dashboard/i18n/ar.json +5 -2
- package/dist/dashboard/i18n/cs.json +5 -2
- package/dist/dashboard/i18n/da.json +5 -2
- package/dist/dashboard/i18n/de.json +5 -2
- package/dist/dashboard/i18n/el.json +5 -2
- package/dist/dashboard/i18n/es.json +5 -2
- package/dist/dashboard/i18n/fi.json +5 -2
- package/dist/dashboard/i18n/fr.json +5 -2
- package/dist/dashboard/i18n/he.json +5 -2
- package/dist/dashboard/i18n/hi.json +5 -2
- package/dist/dashboard/i18n/hu.json +5 -2
- package/dist/dashboard/i18n/is.json +5 -2
- package/dist/dashboard/i18n/it.json +5 -2
- package/dist/dashboard/i18n/ja.json +5 -2
- package/dist/dashboard/i18n/ko.json +5 -2
- package/dist/dashboard/i18n/nb.json +5 -2
- package/dist/dashboard/i18n/nl.json +5 -2
- package/dist/dashboard/i18n/pl.json +5 -2
- package/dist/dashboard/i18n/pt.json +5 -2
- package/dist/dashboard/i18n/ro.json +5 -2
- package/dist/dashboard/i18n/ru.json +5 -2
- package/dist/dashboard/i18n/sv.json +5 -2
- package/dist/dashboard/i18n/tr.json +5 -2
- package/dist/dashboard/i18n/uk.json +5 -2
- package/dist/dashboard/i18n/zh.json +5 -2
- package/dist/dashboard/parts/labels.js +1 -1
- package/dist/dashboard/settings/settings.js +13 -4
- package/dist/dashboard/shell/notices.js +1 -1
- package/dist/dashboard/style.css +15 -7
- package/dist/helpers/briefs.d.ts +4 -0
- package/dist/helpers/briefs.js +13 -0
- package/dist/helpers/chosen.d.ts +8 -4
- package/dist/helpers/chosen.js +38 -14
- package/dist/helpers/index.d.ts +3 -2
- package/dist/helpers/index.js +5 -3
- package/dist/helpers/opencode.d.ts +13 -0
- package/dist/helpers/opencode.js +202 -0
- package/dist/instructions/index.d.ts +2 -2
- package/dist/instructions/index.js +3 -3
- package/dist/server/approver.d.ts +4 -2
- package/dist/server/approver.js +27 -7
- package/dist/server/bell/antigravity.d.ts +10 -0
- package/dist/server/bell/antigravity.js +95 -0
- package/dist/server/bell/index.d.ts +2 -0
- package/dist/server/bell/index.js +2 -0
- package/dist/server/bell/listener.d.ts +43 -0
- package/dist/server/bell/listener.js +149 -0
- package/dist/server/dashboard/index.d.ts +10 -1
- package/dist/server/dashboard/index.js +6 -1
- package/dist/server/dashboard/news.d.ts +3 -1
- package/dist/server/dashboard/news.js +64 -10
- package/dist/server/mcp.d.ts +3 -2
- package/dist/server/mcp.js +11 -7
- package/dist/server/player-acts.d.ts +21 -1
- package/dist/server/player-acts.js +38 -2
- package/dist/server/route/front.d.ts +3 -0
- package/dist/server/route/front.js +97 -0
- package/dist/server/route/index.d.ts +3 -0
- package/dist/server/route/index.js +3 -0
- package/dist/server/route/notes.d.ts +8 -0
- package/dist/server/route/notes.js +50 -0
- package/dist/server/route/router.d.ts +31 -0
- package/dist/server/route/router.js +215 -0
- package/instructions/start.md +1 -1
- package/instructions/voices-opencode.md +1 -0
- package/package.json +3 -2
- package/plugins/opencode.js +174 -0
- package/dist/server/bell-listener.d.ts +0 -10
- package/dist/server/bell-listener.js +0 -52
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: la guía completa
|
|
3
3
|
|
|
4
4
|
**RPG Engine** te permite jugar un juego de rol de mesa con una **IA como máster**. Hablas con el máster en un **chat**; RPG Engine trabaja entre bastidores: **recuerda el mundo**, **tira los dados** y **lleva las cuentas**. Junto al chat mantienes abierta una página en el navegador, el **panel**, con tu ficha, los dados, los mapas y tu diario.
|
|
@@ -64,13 +64,16 @@ El máster no puede crear una campaña por ti: antes de `init`, nada le dice a t
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Conectar tu IA
|
|
66
66
|
|
|
67
|
-
El máster funciona en un **agente de IA**: una aplicación de IA, en la terminal o en el escritorio, que puede trabajar con los archivos de tu equipo, como Claude Code, Codex
|
|
67
|
+
El máster funciona en un **agente de IA**: una aplicación de IA, en la terminal o en el escritorio, que puede trabajar con los archivos de tu equipo, como Claude Code, Codex, Antigravity u OpenCode. Un chat sencillo como claude.ai o ChatGPT, o una aplicación del teléfono, no basta: el máster necesita acceder a los archivos de la campaña en tu equipo. Cada agente necesita su propio plan y su propio inicio de sesión: Claude Code, un plan de pago de Claude; Codex, un inicio de sesión de ChatGPT; Antigravity, una cuenta de Google, cuyo plan gratuito tiene una cuota semanal pequeña; OpenCode funciona con los modelos que le des, incluidos los locales. Lo instalas una sola vez, desde su propia página: [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**: en la carpeta de la campaña escribe `claude`. Cuando pregunte si confías en la carpeta, elige **Yes, I trust this folder**; ojo, la respuesta que aparece marcada es *No, exit*. La campaña también tiene un pequeño hook, `rpg --listen`, que la pregunta no muestra: avisa al máster al instante cuando actúas desde el panel.
|
|
70
70
|
- **Codex**: en la carpeta de la campaña escribe `codex` y responde que sí cuando pregunte si confías en la carpeta. En su aplicación de escritorio, comprueba en los ajustes que las memorias estén desactivadas para los chats del juego.
|
|
71
|
-
- **Antigravity**: en la carpeta de la campaña escribe `agy` y responde que sí si pregunta si confías en la carpeta. La campaña tiene
|
|
71
|
+
- **Antigravity**: en la carpeta de la campaña escribe `agy` y responde que sí si pregunta si confías en la carpeta; o, en su aplicación, abre la carpeta de la campaña. Para la aplicación, RPG Engine también se añade a los ajustes propios de Antigravity, `.gemini/config/mcp_config.json` en tu carpeta personal, que valen para cualquier carpeta que abras, no solo la de la campaña: fuera de una campaña no hace nada. La campaña tiene dos pequeños hooks: `rpg --approve` permite al máster usar las herramientas de RPG Engine sin preguntarte cada vez, y `rpg --listen` avisa al máster al instante cuando actúas desde el panel. El máster pinta las imágenes en el propio chat; cuando falla su herramienta de imágenes, dibuja imágenes vectoriales sencillas, como hace Claude. Antigravity conserva tus chats anteriores y su memoria no se puede desactivar: al máster se le indica que nunca los lea. Lo que escribes va a Google, que puede hacer que personas lo lean: no incluyas datos personales en el juego. RPG Engine no es un producto de Google.
|
|
72
|
+
- **OpenCode**: en la carpeta de la campaña escribe `opencode`. La campaña tiene un pequeño plugin, `.opencode/plugins/rpg.js`, que avisa al máster al instante cuando actúas desde el panel. En la campaña, el máster escribe archivos solo a través de RPG Engine: la escritura y edición de archivos propia de OpenCode está desactivada allí, y OpenCode te pregunta antes de ejecutar un comando. El máster dibuja las imágenes por sí mismo, como imágenes vectoriales sencillas, como hace Claude. Tu OpenCode, con el modelo que elegiste por última vez en él, también traduce el panel y las reglas del juego y lee los documentos que importas, fuera del chat; si no tiene un modelo que pueda usar, lo hacen Codex o Claude Code, si los tienes.
|
|
72
73
|
- **Otro agente**: inícialo en la carpeta de la campaña y dale el servidor MCP `rpg mcp`. RPG Engine es un servidor MCP estándar: cualquier agente compatible con MCP puede ser el máster, incluso los locales.
|
|
73
74
|
|
|
75
|
+
Si el máster dice que no encuentra las herramientas de RPG Engine, escribe `rpg init` en la carpeta de la campaña: en una carpeta que ya es una campaña, solo actualiza estos archivos; después abre un chat nuevo.
|
|
76
|
+
|
|
74
77
|
Jugamos y probamos con **Claude Code**; **Codex** y **Antigravity** están conectados y comprobados, pero todavía no se ha jugado una campaña completa con ellos. La campaña desactiva la memoria propia del agente: el juego vive en sus archivos, para que volver a una partida guardada sea volver de verdad.
|
|
75
78
|
|
|
76
79
|
### 2.5 El primer chat
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: täydellinen opas
|
|
3
3
|
|
|
4
4
|
**RPG Engine** antaa sinun pelata pöytäroolipeliä, jossa **tekoäly toimii pelinjohtajana**. Keskustelet pelinjohtajan kanssa **keskustelussa**. RPG Engine työskentelee taustalla: se **muistaa maailman**, **heittää nopat** ja **pitää kirjaa**. Keskustelun rinnalla pidät selaimessa auki sivua, **kojelautaa**, jossa ovat hahmolomake, nopat, kartat ja päiväkirja.
|
|
@@ -64,13 +64,16 @@ Pelinjohtaja ei voi luoda kampanjaa puolestasi: ennen komentoa `init` mikään e
|
|
|
64
64
|
|
|
65
65
|
### 2.4 Tekoälyn yhdistäminen
|
|
66
66
|
|
|
67
|
-
Pelinjohtaja toimii **tekoälyagentissa**. Se on tekoälysovellus, päätteessä tai työpöydällä, joka voi käsitellä tietokoneesi tiedostoja, kuten Claude Code, Codex tai
|
|
67
|
+
Pelinjohtaja toimii **tekoälyagentissa**. Se on tekoälysovellus, päätteessä tai työpöydällä, joka voi käsitellä tietokoneesi tiedostoja, kuten Claude Code, Codex, Antigravity tai OpenCode. Pelkkä chat, kuten claude.ai tai ChatGPT, tai puhelinsovellus ei riitä: pelinjohtajan täytyy päästä käsiksi kampanjan tiedostoihin tietokoneellasi. Jokainen agentti tarvitsee oman tilauksensa ja kirjautumisensa: Claude Code maksullisen Claude-tilauksen, Codex ChatGPT-kirjautumisen, Antigravity Google-tilin, jonka ilmaisessa tilauksessa on pieni viikoittainen käyttökiintiö. OpenCode toimii niiden mallien kanssa, jotka sille annat, myös paikallisten. Asennat agentin kerran sen omalta sivulta: [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**: kirjoita kampanjakansiossa `claude`. Kun se kysyy, luotatko kansioon, valitse **Yes, I trust this folder**. Varo: valmiiksi valittuna on vastaus *No, exit*. Kampanjassa on myös pieni koukku, `rpg --listen`, jota kysymys ei näytä: se kertoo pelinjohtajalle heti, kun toimit kojelaudalla.
|
|
70
70
|
- **Codex**: kirjoita kampanjakansiossa `codex` ja vastaa myöntävästi, kun se kysyy, luotatko kansioon. Tarkista sen työpöytäsovelluksen asetuksista, että muistit on poistettu käytöstä pelin keskusteluissa.
|
|
71
|
-
- **Antigravity**: kirjoita kampanjakansiossa `agy` ja vastaa myöntävästi, jos se kysyy, luotatko kansioon. Kampanjassa on
|
|
71
|
+
- **Antigravity**: kirjoita kampanjakansiossa `agy` ja vastaa myöntävästi, jos se kysyy, luotatko kansioon, tai avaa sovelluksessa kampanjakansio. Sovellusta varten RPG Engine lisää itsensä myös Antigravityn omiin asetuksiin, kotikansiosi tiedostoon `.gemini/config/mcp_config.json`. Asetukset pätevät jokaiseen avaamaasi kansioon, eivät vain kampanjan: kampanjan ulkopuolella RPG Engine ei tee mitään. Kampanjassa on kaksi pientä koukkua: `rpg --approve` antaa pelinjohtajan käyttää RPG Enginen työkaluja kysymättä sinulta joka kerta, ja `rpg --listen` kertoo pelinjohtajalle heti, kun toimit kojelaudalla. Pelinjohtaja maalaa kuvat keskustelussa itse. Jos sen kuvatyökalu epäonnistuu, se piirtää yksinkertaisia vektorikuvia, kuten Claude. Antigravity säilyttää aiemmat keskustelusi, eikä sen muistia voi poistaa käytöstä: pelinjohtajaa on kielletty lukemasta niitä. Se, mitä kirjoitat, menee Googlelle, jonka työntekijät voivat lukea sen: pidä henkilötiedot poissa pelistä. RPG Engine ei ole Googlen tuote.
|
|
72
|
+
- **OpenCode**: kirjoita kampanjakansiossa `opencode`. Kampanjassa on pieni lisäosa, `.opencode/plugins/rpg.js`, joka kertoo pelinjohtajalle heti, kun toimit kojelaudalla. Kampanjassa pelinjohtaja kirjoittaa tiedostoja vain RPG Enginen kautta: OpenCoden oma tiedostojen kirjoittaminen ja muokkaaminen on siellä poistettu käytöstä, ja OpenCode kysyy sinulta ennen kuin suorittaa komennon. Pelinjohtaja piirtää kuvat itse yksinkertaisina vektorikuvina, kuten Claude. OpenCode käyttää mallia, jonka valitsit siinä viimeksi, ja kääntää sillä myös kojelaudan ja pelin säännöt sekä lukee tuomasi asiakirjat keskustelun ulkopuolella. Jos sillä ei ole käytettävää mallia, työn tekee Codex tai Claude Code, jos sinulla on jompikumpi.
|
|
72
73
|
- **Muu agentti**: käynnistä se kampanjakansiossa ja anna sille MCP-palvelin `rpg mcp`. RPG Engine on tavallinen MCP-palvelin: pelinjohtajaksi kelpaa mikä tahansa MCP:tä tukeva agentti, myös paikalliset.
|
|
73
74
|
|
|
75
|
+
Jos pelinjohtaja sanoo, ettei löydä RPG Enginen työkaluja, kirjoita kampanjakansiossa `rpg init`: kansiossa, joka on jo kampanja, komento vain päivittää nämä tiedostot. Avaa sen jälkeen uusi keskustelu.
|
|
76
|
+
|
|
74
77
|
Pelaamme ja testaamme **Claude Codella**. **Codex** ja **Antigravity** on yhdistetty ja tarkistettu, mutta niillä ei ole vielä pelattu kokonaista kampanjaa. Kampanja poistaa agentin oman muistin käytöstä: peli elää sen tiedostoissa, jotta tallennukseen palaaminen palauttaa pelin todella takaisin.
|
|
75
78
|
|
|
76
79
|
### 2.5 Ensimmäinen keskustelu
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,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.
|
|
@@ -64,13 +64,16 @@ Le MJ ne peut pas créer une campagne à ta place : avant `init`, rien n'indique
|
|
|
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, Codex ou
|
|
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
|
|
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.
|
|
71
|
-
- **Antigravity** : dans le dossier de la campagne, écris `agy`, et réponds oui s'il demande si tu fais confiance au dossier. La campagne contient
|
|
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 dashboard. Le MJ peint lui-même les images dans le chat ; quand son outil d'images échoue, il dessine de simples images vectorielles, comme le fait Claude. 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 dashboard. 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. Ton OpenCode, avec le modèle que tu y as choisi en dernier, traduit aussi le dashboard 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.
|
|
72
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.
|
|
73
74
|
|
|
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
|
+
|
|
74
77
|
Nous jouons et testons avec **Claude Code** ; **Codex** et **Antigravity** 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.
|
|
75
78
|
|
|
76
79
|
### 2.5 Le premier chat
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: המדריך המלא
|
|
3
3
|
|
|
4
4
|
**RPG Engine** מאפשר לשחק משחק תפקידים שולחני עם **בינה מלאכותית בתפקיד המנחה**. מדברים עם המנחה ב**צ'אט**; RPG Engine עובד מאחורי הקלעים: הוא **זוכר את העולם**, **מטיל את הקוביות** ו**מנהל את החשבונות**. לצד הצ'אט משאירים בדפדפן דף פתוח, **הלוח** (dashboard), עם דף הדמות, הקוביות, המפות והיומן.
|
|
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 חיבור ה-AI
|
|
66
66
|
|
|
67
|
-
המנחה פועל בתוך **סוכן AI**: אפליקציית AI, בטרמינל או בשולחן העבודה, שיכולה לעבוד עם הקבצים שבמחשב, כמו Claude Code, Codex או
|
|
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
70
|
- **Codex**: בתיקיית הקמפיין כותבים `codex`, ועונים yes כשהוא שואל אם לסמוך על התיקייה. באפליקציית שולחן העבודה שלו, כדאי לבדוק בהגדרות שהזיכרונות כבויים בצ'אטים של המשחק.
|
|
71
|
-
- **Antigravity**: בתיקיית הקמפיין כותבים `agy`, ועונים yes אם הוא שואל אם לסמוך על
|
|
71
|
+
- **Antigravity**: בתיקיית הקמפיין כותבים `agy`, ועונים yes אם הוא שואל אם לסמוך על התיקייה; או, באפליקציה שלו, פותחים את תיקיית הקמפיין. עבור האפליקציה, RPG Engine מוסיף את עצמו גם להגדרות של Antigravity עצמו, `.gemini/config/mcp_config.json` בתיקיית הבית שלך, שחלות על כל תיקייה שפותחים, לא רק על תיקיית הקמפיין: מחוץ לקמפיין הוא לא עושה דבר. לקמפיין יש שני הוקים קטנים: `rpg --approve` מאפשר למנחה להשתמש בכלים של RPG Engine בלי לשאול אותך בכל פעם, ו-`rpg --listen` מודיע למנחה מיד כשפועלים מהדשבורד. המנחה מצייר את התמונות בצ'אט עצמו; כשכלי התמונות שלו נכשל, הוא מצייר תמונות וקטוריות פשוטות, כמו Claude. Antigravity שומר את הצ'אטים הקודמים שלך, ואי אפשר לכבות את הזיכרון שלו: המנחה מקבל הוראה לא לקרוא אותם לעולם. מה שכותבים נשלח ל-Google, שעשויה לתת לאנשים לקרוא אותו: לא לכלול במשחק מידע אישי. RPG Engine אינו מוצר של Google.
|
|
72
|
+
- **OpenCode**: בתיקיית הקמפיין כותבים `opencode`. לקמפיין יש תוסף קטן, `.opencode/plugins/rpg.js`, שמודיע למנחה מיד כשפועלים מהדשבורד. בקמפיין המנחה כותב קבצים רק דרך RPG Engine: הכתיבה והעריכה של קבצים ב-OpenCode עצמו כבויות שם, ו-OpenCode שואל אותך לפני שהוא מריץ פקודה. המנחה מצייר את התמונות בעצמו, כתמונות וקטוריות פשוטות, כמו Claude. ה-OpenCode שלך, עם המודל שבחרת בו לאחרונה, מתרגם גם את הדשבורד ואת חוקי המשחק וקורא את המסמכים שמייבאים, מחוץ לצ'אט; אם אין מודל שהוא יכול להשתמש בו, Codex או Claude Code עושים זאת, אם הם מותקנים.
|
|
72
73
|
- **סוכן אחר**: מפעילים אותו בתיקיית הקמפיין ונותנים לו את שרת ה-MCP `rpg mcp`. RPG Engine הוא שרת MCP סטנדרטי: כל סוכן שתומך ב-MCP יכול להיות המנחה, כולל סוכנים מקומיים.
|
|
73
74
|
|
|
75
|
+
אם המנחה אומר שהוא לא מוצא את הכלים של RPG Engine, כותבים `rpg init` בתיקיית הקמפיין: בתיקייה שכבר היא קמפיין, הפקודה רק מעדכנת את הקבצים האלה. אחר כך פותחים צ'אט חדש.
|
|
76
|
+
|
|
74
77
|
אנחנו משחקים ובודקים עם **Claude Code**. **Codex** ו-**Antigravity** מחוברים ונבדקים, אבל עוד לא שוחק איתם קמפיין שלם. הקמפיין מכבה את הזיכרון של הסוכן עצמו: המשחק חי בקבצים שלו, כך שחזרה לשמירה באמת מחזירה אחורה.
|
|
75
78
|
|
|
76
79
|
### 2.5 הצ'אט הראשון
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: पूरी गाइड
|
|
3
3
|
|
|
4
4
|
**RPG Engine** आपको **AI को अपना गेम मास्टर** बनाकर टेबलटॉप रोल-प्लेइंग गेम खेलने देता है। आप गेम मास्टर से **चैट** में बात करते हैं। RPG Engine पर्दे के पीछे काम करता है: वह **दुनिया को याद रखता है**, **पासे रोल करता है** और **हिसाब-किताब रखता है**। चैट के साथ आप ब्राउज़र में एक पेज खुला रखते हैं, यानी **डैशबोर्ड**, जिसमें आपकी कैरेक्टर शीट, पासे, नक्शे और आपकी डायरी होती है।
|
|
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 अपना AI जोड़ें
|
|
66
66
|
|
|
67
|
-
गेम मास्टर एक **AI एजेंट** में चलता है: टर्मिनल या डेस्कटॉप पर चलने वाला ऐसा AI ऐप, जो आपके कंप्यूटर की फ़ाइलों के साथ काम कर सके, जैसे Claude Code, Codex या
|
|
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
70
|
- **Codex**: कैंपेन फ़ोल्डर में `codex` लिखें, और जब वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें। उसके डेस्कटॉप ऐप में सेटिंग्स में देखें कि गेम की चैट के लिए मेमोरी बंद हो।
|
|
71
|
-
- **Antigravity**: कैंपेन फ़ोल्डर में `agy` लिखें, और अगर वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ
|
|
71
|
+
- **Antigravity**: कैंपेन फ़ोल्डर में `agy` लिखें, और अगर वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें; या उसके ऐप में कैंपेन फ़ोल्डर खोलें। ऐप के लिए RPG Engine खुद को Antigravity की अपनी सेटिंग्स में भी जोड़ देता है, आपके होम फ़ोल्डर की `.gemini/config/mcp_config.json` में, जो आपके खोले हर फ़ोल्डर पर लागू होती हैं, सिर्फ़ कैंपेन पर नहीं: कैंपेन के बाहर वह कुछ नहीं करता। कैंपेन में दो छोटे हुक हैं: `rpg --approve` गेम मास्टर को RPG Engine के टूल इस्तेमाल करने देता है, हर बार आपसे पूछे बिना, और `rpg --listen` जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। चित्र गेम मास्टर चैट में खुद बनाता है; जब उसका इमेज टूल नहीं चलता, तो वह सादे वेक्टर चित्र बनाता है, जैसा Claude करता है। Antigravity आपकी पुरानी चैट सहेजकर रखता है, और उसकी मेमोरी बंद नहीं की जा सकती: गेम मास्टर को कहा गया है कि वह उन्हें कभी न पढ़े। आप जो लिखते हैं वह Google के पास जाता है, जहाँ लोग उसे पढ़ सकते हैं: निजी जानकारी को खेल से बाहर रखें। RPG Engine Google का प्रोडक्ट नहीं है।
|
|
72
|
+
- **OpenCode**: कैंपेन फ़ोल्डर में `opencode` लिखें। कैंपेन में एक छोटा प्लगइन है, `.opencode/plugins/rpg.js`, जो जब आप डैशबोर्ड से कुछ करते हैं, तो गेम मास्टर को तुरंत बता देता है। कैंपेन में गेम मास्टर फ़ाइलें सिर्फ़ RPG Engine के ज़रिए लिखता है: OpenCode की अपनी फ़ाइल लिखने और बदलने की सुविधा वहाँ बंद रहती है, और कोई कमांड चलाने से पहले वह आपसे पूछता है। गेम मास्टर चित्र खुद बनाता है, सादे वेक्टर चित्रों के रूप में, जैसा Claude करता है। आपका OpenCode, उसमें आपके आख़िरी चुने मॉडल के साथ, डैशबोर्ड और खेल के नियमों का अनुवाद भी करता है और आप जो दस्तावेज़ इम्पोर्ट करते हैं उन्हें चैट के बाहर पढ़ता है; अगर उसके पास इस्तेमाल करने लायक कोई मॉडल न हो, तो Codex या Claude Code यह काम करते हैं, अगर वे आपके पास हों।
|
|
72
73
|
- **कोई और एजेंट**: उसे कैंपेन फ़ोल्डर में शुरू करें और उसे MCP सर्वर `rpg mcp` दें। RPG Engine एक मानक MCP सर्वर है: MCP को सपोर्ट करने वाला कोई भी एजेंट गेम मास्टर बन सकता है, लोकल एजेंट भी।
|
|
73
74
|
|
|
75
|
+
अगर गेम मास्टर कहे कि उसे RPG Engine के टूल नहीं मिल रहे, तो कैंपेन फ़ोल्डर में `rpg init` लिखें: जो फ़ोल्डर पहले से कैंपेन है, उसमें यह सिर्फ़ इन फ़ाइलों को अपडेट करता है; फिर नई चैट खोलें।
|
|
76
|
+
|
|
74
77
|
हम इसे **Claude Code** के साथ खेलते और टेस्ट करते हैं; **Codex** और **Antigravity** जुड़े हुए हैं और जाँचे गए हैं, पर उनके साथ अभी तक कोई पूरा कैंपेन नहीं खेला गया। कैंपेन एजेंट की अपनी मेमोरी बंद कर देता है: गेम उसकी फ़ाइलों में रहता है, ताकि किसी सेव पर लौटने का मतलब सचमुच वहीं लौटना हो।
|
|
75
78
|
|
|
76
79
|
### 2.5 पहली चैट
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,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.
|
|
@@ -64,13 +64,16 @@ A mesélő nem tud kampányt létrehozni neked: az `init` előtt semmi sem mondj
|
|
|
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, a Codex vagy az
|
|
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
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. A kampányban
|
|
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; ha a képkészítő eszköze nem működik, egyszerű vektorképeket rajzol, ahogy a Claude is. 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. 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.
|
|
72
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.
|
|
73
74
|
|
|
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
|
+
|
|
74
77
|
**Claude Code-dal** játszunk és tesztelünk. A **Codex** és az **Antigravity** 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.
|
|
75
78
|
|
|
76
79
|
### 2.5 Az első chat
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. 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.
|
|
@@ -64,13 +64,16 @@ Sögumaðurinn getur ekki búið til herferð fyrir þig: fyrir `init` er ekkert
|
|
|
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, Codex eða
|
|
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, Codex, Antigravity eða OpenCode. 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, Antigravity þarf Google-reikning, en ókeypis áskrift hans hefur lítinn vikulegan kvóta. OpenCode virkar með þeim líkönum sem þú gefur því, líka staðbundnum. Þú setur það upp einu sinni, frá síðunni þess: [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**: 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.
|
|
71
|
-
- **Antigravity**: skrifaðu `agy` í herferðarmöppunni og svaraðu já ef það spyr hvort þú treystir möppunni. Herferðin hefur
|
|
71
|
+
- **Antigravity**: skrifaðu `agy` í herferðarmöppunni og svaraðu já ef það spyr hvort þú treystir möppunni, eða opnaðu herferðarmöppuna í appinu þess. Fyrir appið bætir RPG Engine sér líka við í stillingar Antigravity sjálfs, `.gemini/config/mcp_config.json` í heimamöppunni þinni, sem gilda fyrir hverja möppu sem þú opnar, ekki aðeins herferðarmöppuna: utan herferðar gerir það ekkert. Herferðin hefur tvo litla króka: `rpg --approve` leyfir sögumanninum að nota verkfæri RPG Engine án þess að spyrja þig í hvert sinn og `rpg --listen` lætur sögumanninn vita strax þegar þú gerir eitthvað á stjórnborðinu. Sögumaðurinn málar myndirnar sjálfur í spjallinu. Ef myndaverkfæri hans bregst teiknar sögumaðurinn einfaldar vigurmyndir, eins og Claude gerir. Antigravity geymir fyrri spjöll þín og ekki er hægt að slökkva á minni þess: sögumanninum er sagt að lesa þau aldrei. Það sem þú skrifar fer til Google, sem gæti látið fólk lesa það: haltu persónuupplýsingum utan leiksins. RPG Engine er ekki vara frá Google.
|
|
72
|
+
- **OpenCode**: skrifaðu `opencode` í herferðarmöppunni. Herferðin hefur litla viðbót (plugin), `.opencode/plugins/rpg.js`, sem lætur sögumanninn vita strax þegar þú gerir eitthvað á stjórnborðinu. Í herferðinni skrifar sögumaðurinn skrár aðeins í gegnum RPG Engine: eigin skráarritun og skráarbreytingar OpenCode eru óvirkar þar og það spyr þig áður en það keyrir skipun. Sögumaðurinn teiknar myndirnar sjálfur, sem einfaldar vigurmyndir, eins og Claude gerir. OpenCode hjá þér, með líkaninu sem þú valdir síðast í því, þýðir líka stjórnborðið og reglur leiksins og les skjölin sem þú flytur inn, utan spjallsins. Ef það hefur ekkert líkan til að nota gera Codex eða Claude Code það, ef þú ert með þau.
|
|
72
73
|
- **Annað forrit**: ræstu það í herferðarmöppunni og gefðu því MCP-þjóninn `rpg mcp`. RPG Engine er hefðbundinn MCP-þjónn: hvaða forrit sem styður MCP getur verið sögumaðurinn, líka staðbundin.
|
|
73
74
|
|
|
75
|
+
Ef sögumaðurinn segist ekki finna verkfæri RPG Engine skaltu skrifa `rpg init` í herferðarmöppunni: í möppu sem er nú þegar herferð færir það aðeins þessar skrár til nýjustu útgáfu. Opnaðu síðan nýtt spjall.
|
|
76
|
+
|
|
74
77
|
Við spilum og prófum með **Claude Code**. **Codex** og **Antigravity** eru tengd og athuguð, en engin heil herferð hefur enn verið spiluð með þeim. Herferðin slekkur á eigin minni forritsins: leikurinn býr í skrám þess, svo að það að fara aftur í vistun fari raunverulega aftur.
|
|
75
78
|
|
|
76
79
|
### 2.5 Fyrsta spjallið
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: la guida completa
|
|
3
3
|
|
|
4
4
|
**RPG Engine** ti permette di giocare a un gioco di ruolo da tavolo con una **IA come master**. Parli con il master in una **chat**; RPG Engine lavora dietro le quinte: **ricorda il mondo**, **tira i dadi** e **tiene i conti**. Accanto alla chat tieni aperta nel browser una pagina, la **dashboard**, con la tua scheda, i dadi, le mappe e il tuo diario.
|
|
@@ -33,85 +33,88 @@ Un gioco arriva come sistema di gioco, un pacchetto che il master installa per l
|
|
|
33
33
|
|
|
34
34
|
---
|
|
35
35
|
|
|
36
|
-
## 2. Per
|
|
36
|
+
## 2. Per iniziare <!-- icon: path -->
|
|
37
37
|
|
|
38
38
|
### 2.1 Cosa ti serve
|
|
39
39
|
|
|
40
40
|
- Un computer con Windows, macOS o Linux, e un browser.
|
|
41
|
-
- **Node.js 24** o più recente, da [nodejs.org](https://nodejs.org).
|
|
42
|
-
- Un **terminale**: su Windows, Terminale o PowerShell; su macOS, Terminale. Per aprirne uno in una cartella, clic destro sulla cartella e **Apri
|
|
43
|
-
- Un **agente
|
|
41
|
+
- **Node.js 24** o più recente, da [nodejs.org](https://nodejs.org). Include `npm`, che installa RPG Engine.
|
|
42
|
+
- Un **terminale**: su Windows, Terminale o PowerShell; su macOS, Terminale. Per aprirne uno in una cartella, fai clic con il tasto destro sulla cartella e scegli **Apri in Terminale** (Windows) o **Servizi > Nuovo Terminale nella cartella** (macOS). Se Windows risponde che l'esecuzione degli script è disattivata, scrivi una volta `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` e rispondi di sì.
|
|
43
|
+
- Un **agente AI** per il master ([2.4](#24-connect-your-ai)), con il **modello più grande** che offre: un modello piccolo si lascia convincere più facilmente a rivelare segreti o a piegare le regole.
|
|
44
44
|
|
|
45
|
-
### 2.2
|
|
45
|
+
### 2.2 Installazione
|
|
46
46
|
|
|
47
47
|
```text
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
`rpg --version`
|
|
51
|
+
Con `rpg --version` controlli che sia andato tutto bene. Se npm propone di aggiornarsi, puoi ignorarlo. Usi `rpg` una volta per campagna, per crearla; dopo, il tuo agente avvia RPG Engine da solo. `rpg` da solo non apre niente: la dashboard te la dà il master.
|
|
52
52
|
|
|
53
53
|
### 2.3 Creare una campagna
|
|
54
54
|
|
|
55
|
-
Apri un terminale nella cartella dove tieni i tuoi giochi (
|
|
55
|
+
Apri un terminale nella cartella dove tieni i tuoi giochi ([2.1](#21-what-you-need) spiega come):
|
|
56
56
|
|
|
57
57
|
```text
|
|
58
58
|
rpg init "The Salt Isles"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
Questo crea la cartella `The Salt Isles` con una nuova campagna dentro; entraci con `cd "The Salt Isles"`. Scrivi sempre il nome: senza, la cartella in cui ti trovi diventa la campagna, accanto a tutto quello che contiene già. Ricorda dove si trova: ci torni ogni volta che giochi. Tutto il resto lo scegli dopo, nella chat o nella dashboard.
|
|
62
62
|
|
|
63
|
-
Il master non può creare una campagna
|
|
63
|
+
Il master non può creare una campagna al posto tuo: prima di `init`, niente dice al tuo agente dove si trova RPG Engine.
|
|
64
64
|
|
|
65
|
-
### 2.4 Collegare la tua
|
|
65
|
+
### 2.4 Collegare la tua AI
|
|
66
66
|
|
|
67
|
-
Il master gira in un **agente
|
|
67
|
+
Il master gira in un **agente AI**: un'app AI, nel terminale o sul desktop, che può lavorare con i file del tuo computer, come Claude Code, Codex, Antigravity o OpenCode. Una chat semplice come claude.ai o ChatGPT, o un'app per telefono, non basta: il master deve poter raggiungere i file della campagna sul tuo computer. Ogni agente ha bisogno del suo piano e del suo accesso: Claude Code di un piano Claude a pagamento, Codex di un accesso ChatGPT, Antigravity di un account Google, il cui piano gratuito ha una piccola quota settimanale; OpenCode funziona con i modelli che gli dai, anche quelli locali. Lo installi una volta sola, dalla sua pagina: [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**: nella cartella della campagna scrivi `claude`. Quando chiede se ti fidi della cartella, scegli **Yes, I trust this folder**;
|
|
70
|
-
- **Codex**: nella cartella della campagna scrivi `codex
|
|
71
|
-
- **Antigravity**: nella cartella della campagna scrivi `agy
|
|
72
|
-
- **
|
|
69
|
+
- **Claude Code**: nella cartella della campagna scrivi `claude`. Quando chiede se ti fidi della cartella, scegli **Yes, I trust this folder**; attenzione, la risposta già selezionata è *No, exit*. La campagna ha anche un piccolo hook, `rpg --listen`, che la domanda non mostra: avvisa subito il master quando agisci dalla dashboard.
|
|
70
|
+
- **Codex**: nella cartella della campagna scrivi `codex` e rispondi di sì quando chiede se ti fidi della cartella. Nella sua app desktop, controlla nelle impostazioni che le memorie siano disattivate per le chat del gioco.
|
|
71
|
+
- **Antigravity**: nella cartella della campagna scrivi `agy` e rispondi di sì se chiede se ti fidi della cartella; oppure, nella sua app, apri la cartella della campagna. Per l'app, RPG Engine si aggiunge anche alle impostazioni di Antigravity, `.gemini/config/mcp_config.json` nella tua home, che valgono per ogni cartella che apri, non solo per quella della campagna: fuori da una campagna non fa nulla. La campagna ha due piccoli hook: `rpg --approve` lascia che il master usi gli strumenti di RPG Engine senza chiederti ogni volta il permesso, e `rpg --listen` avvisa subito il master quando agisci dalla dashboard. Il master dipinge le immagini direttamente nella chat; quando il suo strumento per le immagini non funziona, disegna semplici immagini vettoriali, come fa Claude. Antigravity conserva le tue chat passate e la sua memoria non si può disattivare: al master viene detto di non leggerle mai. Quello che scrivi va a Google, che potrebbe farlo leggere a delle persone: tieni i dati personali fuori dal gioco. RPG Engine non è un prodotto Google.
|
|
72
|
+
- **OpenCode**: nella cartella della campagna scrivi `opencode`. La campagna ha un piccolo plugin, `.opencode/plugins/rpg.js`, che avvisa subito il master quando agisci dalla dashboard. Nella campagna il master scrive i file solo attraverso RPG Engine: la scrittura e la modifica dei file di OpenCode stesso lì sono spente, e prima di lanciare un comando te lo chiede. Le immagini le disegna il master stesso, come semplici immagini vettoriali, come fa Claude. Il tuo OpenCode, con il modello che hai scelto per ultimo, traduce anche la dashboard e le regole del gioco e legge i documenti che importi, fuori dalla chat; senza un modello che possa usare, lo fanno Codex o Claude Code, se li hai.
|
|
73
|
+
- **Un altro agente**: avvialo nella cartella della campagna e dagli il server MCP `rpg mcp`. RPG Engine è un normale server MCP: qualsiasi agente che supporti MCP può fare da master, anche quelli locali.
|
|
73
74
|
|
|
74
|
-
|
|
75
|
+
Se il master dice di non trovare gli strumenti di RPG Engine, scrivi `rpg init` nella cartella della campagna: in una cartella che è già una campagna aggiorna soltanto questi file; poi apri una nuova chat.
|
|
76
|
+
|
|
77
|
+
Noi giochiamo e proviamo con **Claude Code**; **Codex** e **Antigravity** sono collegati e verificati, ma con loro non è ancora stata giocata una campagna intera. La campagna disattiva la memoria propria dell'agente: il gioco vive nei suoi file, così tornare a un salvataggio significa davvero tornare indietro.
|
|
75
78
|
|
|
76
79
|
### 2.5 La prima chat
|
|
77
80
|
|
|
78
|
-
Scrivi
|
|
81
|
+
Scrivi quello che vuoi, per esempio *Ciao! Iniziamo.* Nella sua prima risposta di ogni chat il master ti dà il **link alla tua dashboard**, qualcosa come `http://127.0.0.1:4750`: aprilo e tienilo accanto alla chat.
|
|
79
82
|
|
|
80
|
-
Tra
|
|
83
|
+
Tra un messaggio e l'altro del master, il tuo agente mostra gli strumenti che usa: non aprirne i dettagli (in Claude Code, ctrl+o), perché possono mostrare segreti.
|
|
81
84
|
|
|
82
|
-
Una campagna
|
|
85
|
+
Una nuova campagna passa per tre fasi, mostrate in cima alla dashboard: **1 Impostazioni** (come vuoi giocare), **2 Sessione zero** (crei il tuo personaggio, giocando), **3 Gioco**.
|
|
83
86
|
|
|
84
87
|
### 2.6 Impostazioni: scegliere come giocare
|
|
85
88
|
|
|
86
|
-
Il master chiede solo ciò che manca, poche domande alla volta; il passo **Impostazioni** della dashboard mostra le stesse domande come
|
|
89
|
+
Il master chiede solo ciò che manca ancora, poche domande alla volta; il passo **Impostazioni** della dashboard mostra le stesse domande come schede. Scrivi "decidi tu" e il master sceglie. Tutto si può cambiare dopo, nella chat o in **Impostazioni**.
|
|
87
90
|
|
|
88
91
|
| Impostazione | Cosa decide | Valori |
|
|
89
92
|
|---|---|---|
|
|
90
93
|
| **Mentore** | Quanto il master ti insegna le regole | spento, suggerimenti, tutorial |
|
|
91
94
|
| **Difficoltà** | Quanto è duro il mondo | storia, facile, normale, difficile, brutale |
|
|
92
|
-
| **Letalità** | Cosa
|
|
95
|
+
| **Letalità** | Cosa significa cadere in uno scontro | narrativa (non si muore mai), epica (solo quando conta), dadi |
|
|
93
96
|
| **Salvataggi** | Quando puoi tornare indietro | morte permanente, checkpoint, libero ([3.8](#38-saves-and-going-back)) |
|
|
94
|
-
| **Rigore** | Quanto cibo, luce e
|
|
97
|
+
| **Rigore** | Quanto cibo, luce e viaggio seguono da vicino le regole | fluido, regole, simulazione |
|
|
95
98
|
| **Dadi** | Chi tira i tuoi dadi | digitali, fisici |
|
|
96
|
-
| **Unità di misura** | Distanze e pesi |
|
|
97
|
-
| **Voci dei personaggi** | Chi
|
|
98
|
-
| **Il tuo personaggio** | Come
|
|
99
|
-
| **Compagni** | Chi viaggia con te | nessuno, creati con te,
|
|
100
|
-
| **Immagini** | Immagini di luoghi, missioni e di chi incontri |
|
|
101
|
-
| **Linee** e **Veli** |
|
|
99
|
+
| **Unità di misura** | Distanze e pesi | metriche, imperiali |
|
|
100
|
+
| **Voci dei personaggi** | Chi parla per i personaggi che incontri, dal master ai personaggi stessi: sempre il master; nei momenti chiave il personaggio in persona, che sa solo ciò che sa lui, a scelta del master; oppure sempre il personaggio, per quelli principali o per tutti, in modo più lento e più costoso, dove la tua app AI lo permette | il master, a volte, personaggi principali, tutti |
|
|
101
|
+
| **Il tuo personaggio** | Come viene creato il tuo personaggio nella sessione zero | con il master, dal master, il tuo ([2.7](#27-session-zero-your-character)) |
|
|
102
|
+
| **Compagni** | Chi viaggia con te | nessuno, creati con te, creati dal master, incontrati giocando |
|
|
103
|
+
| **Immagini** | Immagini di luoghi, missioni e di chi incontri | nessuna, su richiesta, nuovi luoghi, missioni e chi incontri ([3.11](#311-pictures)) |
|
|
104
|
+
| **Linee** e **Veli** | Ciò che non appare mai e ciò che accade solo fuori scena | elenchi |
|
|
102
105
|
| **Lingua** | La lingua del gioco e della dashboard | qualsiasi |
|
|
103
106
|
|
|
104
|
-
La quinta edizione aggiunge l'**avanzamento**: punti esperienza o
|
|
107
|
+
La quinta edizione aggiunge l'**avanzamento**: punti esperienza o tappe.
|
|
105
108
|
|
|
106
|
-
|
|
109
|
+
Se non c'è un mondo già scritto, il master chiede anche una **Premessa** (genere, tono, qualche elemento e ciò che ti piace di più in un gioco, come scontri, misteri, dialoghi o esplorazione, **A parole tue**), la **Preparazione**: costruire il mondo al volo, man mano, oppure tutto all'inizio; e la **Durata**: una sera, qualche sessione (da tre a cinque sere), oppure aperta, un'avventura dopo l'altra. Alla fine di una storia con una durata puoi sempre continuare.
|
|
107
110
|
|
|
108
|
-
**Lo stile del master** non viene chiesto, ma puoi cambiarlo
|
|
111
|
+
**Lo stile del master** non viene mai chiesto, ma puoi cambiarlo nella chat o in **Impostazioni**: la **Narrazione** (sobria, letteraria, pulp, ironica), le **Storie** che inventa (situazioni, archi, episodi, mistero), un autore da cui **Scrivi come**, o qualsiasi altra cosa **A parole tue**.
|
|
109
112
|
|
|
110
113
|
### 2.7 Sessione zero: il tuo personaggio
|
|
111
114
|
|
|
112
|
-
Crei il tuo personaggio
|
|
115
|
+
Crei il tuo personaggio insieme al master, come a un tavolo. Ogni scelta è tua, a meno che tu non chieda al master di farla: puoi arrivare con un'idea completa, con una vaga o con niente; oppure chiedere al master di creare tutto partendo da poche parole. In un gioco con i livelli il master ti chiede da quale livello vuoi partire: il primo, a meno che tu non ne voglia un altro. Il master ti spiega come si determinano i punteggi di caratteristica prima che venga tirato qualsiasi dado. La tua storia non è mai obbligatoria; se ne dai una, il master la scrive con le tue parole. Poi il master ti chiede un'immagine del tuo personaggio ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcola la scheda: i conti non li fai mai tu.
|
|
113
116
|
|
|
114
|
-
Hai già un personaggio, di un altro gioco o di un'altra campagna? Scegli **Ce l'ho già**
|
|
117
|
+
Hai già un personaggio, di un altro gioco o di un'altra campagna? Scegli **Ce l'ho già** nella configurazione e consegnalo al master: incolla la scheda nella chat, oppure di' dove si trova il suo file sul tuo computer (un PDF, un'immagine, un testo). Il master lo scrive così com'è, al suo livello, lo confronta con le regole e con il mondo, e concorda con te tutto ciò che non torna.
|
|
115
118
|
|
|
116
119
|
---
|
|
117
120
|
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine:完全ガイド
|
|
3
3
|
|
|
4
4
|
**RPG Engine**では、**AIをGM**にして、テーブルトークRPGを遊べます。GMとは**チャット**で会話します。RPG Engineは裏側で動き、**世界を記憶し**、**ダイスを振り**、**数値を管理**します。チャットの横にはブラウザーのページ、**ダッシュボード**を開いておきます。キャラクターシート、ダイス、マップ、ジャーナルが並びます。
|
|
@@ -64,13 +64,16 @@ rpg init "The Salt Isles"
|
|
|
64
64
|
|
|
65
65
|
### 2.4 AIをつなぐ
|
|
66
66
|
|
|
67
|
-
GMは **AIエージェント** の中で動きます。AIエージェントとは、パソコン上のファイルを扱えるAIアプリのことで、ターミナルでもデスクトップでも使えます。たとえば Claude Code、Codex、Antigravity です。claude.ai や ChatGPT のような普通のチャットや、スマートフォンのアプリでは足りません。GMは、パソコンにあるキャンペーンのファイルにアクセスする必要があるからです。エージェントごとに、プランとログインが必要です。Claude Code は有料のClaudeプラン、Codex は ChatGPT のログイン、Antigravity は Googleアカウントです。Antigravity
|
|
67
|
+
GMは **AIエージェント** の中で動きます。AIエージェントとは、パソコン上のファイルを扱えるAIアプリのことで、ターミナルでもデスクトップでも使えます。たとえば Claude Code、Codex、Antigravity、OpenCode です。claude.ai や ChatGPT のような普通のチャットや、スマートフォンのアプリでは足りません。GMは、パソコンにあるキャンペーンのファイルにアクセスする必要があるからです。エージェントごとに、プランとログインが必要です。Claude Code は有料のClaudeプラン、Codex は ChatGPT のログイン、Antigravity は Googleアカウントです。Antigravity の無料プランは、週ごとの利用枠が小さめです。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` もあります。この質問には表示されません。ダッシュボードで操作すると、すぐにGMへ伝えるしくみです。
|
|
70
70
|
- **Codex**:キャンペーンのフォルダで `codex` と入力します。フォルダを信頼するか聞かれたら、yes と答えます。デスクトップアプリでは、設定で、ゲームのチャットのメモリーがオフになっているか確認してください。
|
|
71
|
-
- **Antigravity**:キャンペーンのフォルダで `agy`
|
|
71
|
+
- **Antigravity**:キャンペーンのフォルダで `agy` と入力し、フォルダを信頼するか聞かれたら、yes と答えます。アプリを使う場合は、アプリでキャンペーンのフォルダを開きます。アプリ用に、RPG Engineは Antigravity 自身の設定ファイル(ホームフォルダの `.gemini/config/mcp_config.json`)にも自分を追加します。この設定は、キャンペーンのフォルダだけでなく、開くすべてのフォルダに適用されます。ただし、キャンペーンの外では何もしません。キャンペーンには小さなフックが2つあります。`rpg --approve` は、GMがRPG Engineのツールを、そのつど確認なしで使えるようにします。`rpg --listen` は、ダッシュボードで操作すると、すぐにGMへ伝えます。画像は、GMがチャットの中で自分で描きます。画像ツールが使えないときは、Claude と同じように、簡単なベクター画像を描きます。Antigravity は過去のチャットを保存し、そのメモリーはオフにできません。GMには、過去のチャットを決して読まないよう指示してあります。書いた内容はGoogleに送られ、人が読むことがあります。個人情報はゲームに書かないでください。RPG Engineは Google の製品ではありません。
|
|
72
|
+
- **OpenCode**:キャンペーンのフォルダで `opencode` と入力します。キャンペーンには小さなプラグイン `.opencode/plugins/rpg.js` があり、ダッシュボードで操作すると、すぐにGMへ伝えます。キャンペーンの中では、GMはRPG Engineを通してのみファイルを書き込みます。OpenCode自身のファイルの書き込みと編集はオフになっていて、コマンドを実行する前には確認が表示されます。画像は、GMが簡単なベクター画像として自分で描きます。Claude と同じ方法です。OpenCode で最後に選んだモデルが、チャットの外で、ダッシュボードとゲームのルールの翻訳や、取り込む文書の読み込みも行います。使えるモデルがない場合は、Codex か Claude Code があれば、そちらが行います。
|
|
72
73
|
- **ほかのエージェント**:キャンペーンのフォルダで起動し、MCPサーバー `rpg mcp` を渡します。RPG Engineは標準的なMCPサーバーです。MCPに対応したエージェントなら、ローカルで動くものも含めて、どれでもGMにできます。
|
|
73
74
|
|
|
75
|
+
GMが「RPG Engineのツールが見つからない」と言ったら、キャンペーンのフォルダで `rpg init` と入力します。すでにキャンペーンになっているフォルダでは、これらのファイルが最新の状態になるだけです。そのあと、新しいチャットを開きます。
|
|
76
|
+
|
|
74
77
|
プレイとテストは **Claude Code** で行っています。**Codex** と **Antigravity** は接続と動作の確認まで済んでいますが、キャンペーン全体をまだ遊び通してはいません。キャンペーンでは、エージェント自身のメモリーをオフにします。ゲームの内容はファイルに残るので、セーブに戻ると、本当にその時点に戻れます。
|
|
75
78
|
|
|
76
79
|
### 2.5 最初のチャット
|
|
@@ -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,
|
|
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,7b9a0a41,086f7b8c,da6d0862,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,1c335942,25f9bdf8,6bd01b74,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,774591fd,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,fa64227b,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,a78e1054,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4497f74b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,fd906c57,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,f83c9d82,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e9a3f2a9. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: 전체 가이드
|
|
3
3
|
|
|
4
4
|
**RPG Engine**은 **AI 게임 마스터**와 함께 테이블탑 롤플레잉 게임을 즐길 수 있게 해 줘요. **채팅**으로 GM과 대화해요. RPG Engine은 뒤에서 **세계를 기억하고**, **주사위를 굴리고**, **계산을 맡아요**. 채팅 옆에는 브라우저에 페이지를 하나 열어 두어요. 바로 **대시보드**예요. 캐릭터 시트, 주사위, 지도, 일지가 있어요.
|
|
@@ -64,13 +64,16 @@ GM은 캠페인을 대신 만들 수 없어요. `init`을 하기 전에는 에
|
|
|
64
64
|
|
|
65
65
|
### 2.4 AI 연결하기
|
|
66
66
|
|
|
67
|
-
GM은 **AI 에이전트** 안에서 움직여요. AI 에이전트는 터미널이나 데스크톱에서 쓰는 AI 앱으로, 컴퓨터의 파일을 다룰 수 있어요. Claude Code, Codex, Antigravity가 그 예예요. claude.ai나 ChatGPT 같은 일반 채팅이나 휴대폰 앱으로는 부족해요. GM이 컴퓨터에 있는 캠페인 파일에 접근할 수 있어야 하기 때문이에요. 에이전트마다 요금제와 로그인이 따로 필요해요. Claude Code는 유료 Claude 요금제, Codex는 ChatGPT 로그인, Antigravity는 Google 계정이 필요해요. Antigravity의 무료 요금제는 주간 사용량이 적어요. 설치는 각 에이전트의 페이지에서 한 번만 하면 돼요. [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://developers.openai.com/codex), [Antigravity](https://antigravity.google).
|
|
67
|
+
GM은 **AI 에이전트** 안에서 움직여요. AI 에이전트는 터미널이나 데스크톱에서 쓰는 AI 앱으로, 컴퓨터의 파일을 다룰 수 있어요. Claude Code, Codex, Antigravity, OpenCode가 그 예예요. claude.ai나 ChatGPT 같은 일반 채팅이나 휴대폰 앱으로는 부족해요. GM이 컴퓨터에 있는 캠페인 파일에 접근할 수 있어야 하기 때문이에요. 에이전트마다 요금제와 로그인이 따로 필요해요. Claude Code는 유료 Claude 요금제, Codex는 ChatGPT 로그인, Antigravity는 Google 계정이 필요해요. Antigravity의 무료 요금제는 주간 사용량이 적어요. 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`도 들어 있어요. 이 질문에는 나오지 않지만, 대시보드에서 행동하면 GM에게 바로 알려 주는 역할을 해요.
|
|
70
70
|
- **Codex**: 캠페인 폴더에서 `codex`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 데스크톱 앱에서는 설정에서 게임 채팅의 메모리가 꺼져 있는지 확인하세요.
|
|
71
|
-
- **Antigravity**: 캠페인 폴더에서 `agy`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 캠페인에는 작은
|
|
71
|
+
- **Antigravity**: 캠페인 폴더에서 `agy`를 입력하고, 폴더를 신뢰하는지 물으면 승인해요. 앱에서는 캠페인 폴더를 열어도 돼요. 앱을 쓰면 RPG Engine이 홈 폴더의 `.gemini/config/mcp_config.json`, 즉 Antigravity 자체 설정에도 스스로 추가돼요. 이 설정은 캠페인뿐 아니라 여는 모든 폴더에 적용되지만, 캠페인이 아닌 폴더에서는 아무 일도 하지 않아요. 캠페인에는 작은 훅이 두 개 있어요. `rpg --approve`는 GM이 RPG Engine의 도구를 쓸 때마다 매번 허락을 구하지 않게 해 주고, `rpg --listen`은 대시보드에서 행동하면 GM에게 바로 알려 줘요. GM이 이미지를 채팅에서 직접 그려요. 이미지 도구가 실패하면 Claude처럼 단순한 벡터 그림을 그려요. Antigravity는 지난 채팅을 보관하고 메모리도 끌 수 없어요. 그래서 GM은 지난 채팅을 절대 읽지 않도록 안내받아요. 입력한 내용은 Google로 전송되고, Google에서 사람이 읽을 수도 있어요. 개인 정보는 게임에 넣지 마세요. RPG Engine은 Google 제품이 아니에요.
|
|
72
|
+
- **OpenCode**: 캠페인 폴더에서 `opencode`를 입력해요. 캠페인에는 작은 플러그인 `.opencode/plugins/rpg.js`가 있어요. 대시보드에서 행동하면 GM에게 바로 알려 주는 역할을 해요. 캠페인에서 GM은 RPG Engine을 통해서만 파일을 써요. OpenCode 자체의 파일 쓰기와 편집 기능은 캠페인에서 꺼져 있고, 명령을 실행하기 전에는 먼저 물어봐요. GM은 이미지를 Claude처럼 단순한 벡터 그림으로 직접 그려요. OpenCode에서 마지막으로 고른 모델은 채팅 밖에서 대시보드와 게임 규칙을 번역하고, 가져온 문서를 읽는 일도 해요. 쓸 수 있는 모델이 없으면 Codex나 Claude Code가 있을 때 그쪽이 대신해요.
|
|
72
73
|
- **다른 에이전트**: 캠페인 폴더에서 에이전트를 시작하고 MCP 서버 `rpg mcp`를 연결해요. RPG Engine은 표준 MCP 서버예요. MCP를 지원하는 에이전트라면 로컬 에이전트를 포함해 어떤 것이든 GM이 될 수 있어요.
|
|
73
74
|
|
|
75
|
+
GM이 RPG Engine의 도구를 찾을 수 없다고 하면 캠페인 폴더에서 `rpg init`을 입력하세요. 이미 캠페인인 폴더에서는 이 파일들을 최신 상태로만 맞춰 줘요. 그다음 새 채팅을 열어요.
|
|
76
|
+
|
|
74
77
|
저희는 **Claude Code**로 플레이하고 테스트해요. **Codex**와 **Antigravity**는 연결과 확인을 마쳤지만, 아직 캠페인 하나를 끝까지 플레이해 보지는 못했어요. 캠페인은 에이전트 자체의 메모리를 꺼요. 게임은 파일에 저장되기 때문에, 세이브로 돌아가면 정말 그 시점으로 돌아가요.
|
|
75
78
|
|
|
76
79
|
### 2.5 첫 채팅
|