rpg-engine 0.14.0 → 0.15.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 -0
- package/dist/campaign/index.d.ts +1 -1
- package/dist/campaign/index.js +1 -1
- package/dist/campaign/last-choices.js +1 -1
- package/dist/campaign/settings.d.ts +19 -5
- package/dist/campaign/settings.js +16 -8
- package/dist/commands/config.d.ts +2 -2
- package/dist/commands/config.js +42 -11
- package/dist/commands/find.d.ts +4 -4
- package/dist/commands/instructions.js +12 -1
- package/dist/commands/mode.js +10 -2
- package/dist/commands/shared/mode.js +6 -2
- package/dist/commands/shared/parts.d.ts +7 -0
- package/dist/commands/shared/parts.js +23 -0
- package/dist/commands/show.d.ts +1 -1
- package/dist/commands/status.js +6 -1
- package/dist/commands/write/write.d.ts +1 -1
- package/dist/commands/write/write.js +2 -2
- package/dist/dashboard/choices.js +22 -17
- package/dist/dashboard/guide/ar.md +12 -7
- package/dist/dashboard/guide/cs.md +12 -7
- package/dist/dashboard/guide/da.md +12 -7
- package/dist/dashboard/guide/de.md +12 -7
- package/dist/dashboard/guide/el.md +12 -7
- package/dist/dashboard/guide/en.md +11 -6
- package/dist/dashboard/guide/es.md +12 -7
- package/dist/dashboard/guide/fi.md +12 -7
- package/dist/dashboard/guide/fr.md +12 -7
- package/dist/dashboard/guide/he.md +12 -7
- package/dist/dashboard/guide/hi.md +12 -7
- package/dist/dashboard/guide/hu.md +13 -8
- package/dist/dashboard/guide/is.md +12 -7
- package/dist/dashboard/guide/it.md +13 -8
- package/dist/dashboard/guide/ja.md +12 -7
- package/dist/dashboard/guide/ko.md +14 -9
- package/dist/dashboard/guide/nb.md +12 -7
- package/dist/dashboard/guide/nl.md +12 -7
- package/dist/dashboard/guide/pl.md +12 -7
- package/dist/dashboard/guide/pt.md +12 -7
- package/dist/dashboard/guide/ro.md +12 -7
- package/dist/dashboard/guide/ru.md +12 -7
- package/dist/dashboard/guide/sv.md +12 -7
- package/dist/dashboard/guide/tr.md +12 -7
- package/dist/dashboard/guide/uk.md +13 -8
- package/dist/dashboard/guide/zh.md +12 -7
- package/dist/dashboard/i18n/ar.json +17 -0
- package/dist/dashboard/i18n/cs.json +17 -0
- package/dist/dashboard/i18n/da.json +17 -0
- package/dist/dashboard/i18n/de.json +17 -0
- package/dist/dashboard/i18n/el.json +17 -0
- package/dist/dashboard/i18n/es.json +17 -0
- package/dist/dashboard/i18n/fi.json +17 -0
- package/dist/dashboard/i18n/fr.json +17 -0
- package/dist/dashboard/i18n/he.json +17 -0
- package/dist/dashboard/i18n/hi.json +17 -0
- package/dist/dashboard/i18n/hu.json +17 -0
- package/dist/dashboard/i18n/is.json +17 -0
- package/dist/dashboard/i18n/it.json +17 -0
- package/dist/dashboard/i18n/ja.json +17 -0
- package/dist/dashboard/i18n/ko.json +17 -0
- package/dist/dashboard/i18n/nb.json +17 -0
- package/dist/dashboard/i18n/nl.json +17 -0
- package/dist/dashboard/i18n/pl.json +17 -0
- package/dist/dashboard/i18n/pt.json +17 -0
- package/dist/dashboard/i18n/ro.json +17 -0
- package/dist/dashboard/i18n/ru.json +17 -0
- package/dist/dashboard/i18n/sv.json +17 -0
- package/dist/dashboard/i18n/tr.json +17 -0
- package/dist/dashboard/i18n/uk.json +17 -0
- package/dist/dashboard/i18n/zh.json +17 -0
- package/dist/dashboard/labels.js +6 -0
- package/dist/dashboard/setup.js +1 -1
- package/dist/dashboard/style.css +31 -11
- package/dist/library/books.js +2 -0
- package/dist/server/dashboard/choices.d.ts +8 -5
- package/dist/server/dashboard/choices.js +6 -4
- package/dist/server/dashboard/writes.js +1 -1
- package/instructions/length-a-few-sessions.md +1 -0
- package/instructions/length-one-evening.md +1 -0
- package/instructions/session-zero.md +1 -1
- package/instructions/setup.md +1 -1
- package/package.json +1 -1
|
@@ -8,8 +8,8 @@ This guide is for players: you do not need to know how to program.
|
|
|
8
8
|
|
|
9
9
|
1. Install **Node.js** from [nodejs.org](https://nodejs.org) (the LTS version).
|
|
10
10
|
2. Install an **AI agent**, the program the master runs in, and sign in: for example Claude Code or Codex ([2.4](#24-connect-your-ai)).
|
|
11
|
-
3. In a new terminal, opened after Node.js is installed, install RPG Engine: `npm install -g rpg-engine`.
|
|
12
|
-
4.
|
|
11
|
+
3. In a new terminal, opened after Node.js is installed, install RPG Engine: `npm install -g rpg-engine`. If Windows answers that running scripts is disabled, write once `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, answer yes and try again.
|
|
12
|
+
4. Open the terminal in the folder where you keep your games (right-click it, **Open in Terminal**) and create a campaign, always with its name: `rpg init "The Salt Isles"`. RPG Engine answers with two lines in English: all is well.
|
|
13
13
|
5. Go into the new folder, `cd "The Salt Isles"`, and start your agent there: `claude` for Claude Code, `codex` for Codex. Say yes when it asks whether you trust the folder ([2.4](#24-connect-your-ai)), then write *Hi! Let's start.* The master answers with the link to your dashboard.
|
|
14
14
|
|
|
15
15
|
## 1. What RPG Engine is <!-- icon: about -->
|
|
@@ -47,7 +47,7 @@ A game comes as a game system, a package the master installs for your campaign:
|
|
|
47
47
|
npm install -g rpg-engine
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
`rpg --version` checks that it worked. You use `rpg` once per campaign, to create it; after that your agent starts RPG Engine by itself.
|
|
50
|
+
`rpg --version` checks that it worked. If npm offers to update itself, you can ignore it. You use `rpg` once per campaign, to create it; after that your agent starts RPG Engine by itself. `rpg` alone opens nothing: the master gives you the dashboard.
|
|
51
51
|
|
|
52
52
|
### 2.3 Create a campaign
|
|
53
53
|
|
|
@@ -57,7 +57,7 @@ Open a terminal in the folder where you keep your games ([2.1](#21-what-you-need
|
|
|
57
57
|
rpg init "The Salt Isles"
|
|
58
58
|
```
|
|
59
59
|
|
|
60
|
-
This makes the folder `The Salt Isles` with a new campaign in it; go into it with `cd "The Salt Isles"`. Remember where it is: you come back to it every time you play. You choose everything else later, in the chat or on the dashboard
|
|
60
|
+
This makes the folder `The Salt Isles` with a new campaign in it; go into it with `cd "The Salt Isles"`. Always write the name: without one, the folder you are in becomes the campaign, beside whatever it already holds. Remember where it is: you come back to it every time you play. You choose everything else later, in the chat or on the dashboard.
|
|
61
61
|
|
|
62
62
|
The master cannot create a campaign for you: before `init`, nothing tells your agent where RPG Engine is.
|
|
63
63
|
|
|
@@ -93,6 +93,7 @@ The master asks only what is still missing, a few questions at a time; the dashb
|
|
|
93
93
|
| **Dice** | Who rolls your dice | digital, physical |
|
|
94
94
|
| **Units** | Distances and weights | metric, imperial |
|
|
95
95
|
| **Character voices** | Who speaks for the characters you meet, from the master to the characters: the master always; at key moments the character themselves, knowing only what they know, as the master chooses; or always the character, for the main ones or for everyone, slower and costlier, where your AI app can | the master, sometimes, main characters, everyone |
|
|
96
|
+
| **Your character** | How your character is made in session zero | with the master, by the master, your own ([2.7](#27-session-zero-your-character)) |
|
|
96
97
|
| **Companions** | Who travels with you | none, made with you, made by the master, met in play |
|
|
97
98
|
| **Pictures** | Pictures of places, quests and those you meet | none, on request, new places, quests and those you meet ([3.11](#311-pictures)) |
|
|
98
99
|
| **Lines** and **Veils** | What never appears, and what happens only off screen | lists |
|
|
@@ -100,13 +101,15 @@ The master asks only what is still missing, a few questions at a time; the dashb
|
|
|
100
101
|
|
|
101
102
|
Fifth edition adds **advancement**: experience points or milestones.
|
|
102
103
|
|
|
103
|
-
Without a written world, the master also asks a **premise** (genre, tone, a few elements and what you enjoy most in a game, such as fights, mysteries, talk or exploring, in your words)
|
|
104
|
+
Without a written world, the master also asks a **premise** (genre, tone, a few elements and what you enjoy most in a game, such as fights, mysteries, talk or exploring, in your words) the **preparation**: build the world on the fly, as you go, or all at the start; and the **length**: one evening, a few sessions (three to five evenings), or open, one adventure after another. At the end of a story with a length you can always go on.
|
|
104
105
|
|
|
105
106
|
**The master's style** is never asked, but you can change it in the chat or in **Settings**: the **prose** (plain, literary, pulp, wry), the **stories** it invents (situations, arcs, episodes, mystery), an author to **write like**, or anything else **in your words**.
|
|
106
107
|
|
|
107
108
|
### 2.7 Session zero: your character
|
|
108
109
|
|
|
109
|
-
You make your character with the master, as at a table. Every choice is yours, unless you ask the master to make it: come with a full idea, a vague one, or nothing. The master tells you how ability scores are made before any die is rolled. Your story is never required; if you give one, the master writes it in your words. Then the master asks for a picture of your character ([3.7](#37-your-characters-story-and-picture)). RPG Engine works out the sheet: you never do the sums.
|
|
110
|
+
You make your character with the master, as at a table. Every choice is yours, unless you ask the master to make it: come with a full idea, a vague one, or nothing; or ask the master to make it all from a few words. In a game with levels the master asks from which level you start: the first, unless you want another. The master tells you how ability scores are made before any die is rolled. Your story is never required; if you give one, the master writes it in your words. Then the master asks for a picture of your character ([3.7](#37-your-characters-story-and-picture)). RPG Engine works out the sheet: you never do the sums.
|
|
111
|
+
|
|
112
|
+
Do you already have a character, from another game or another campaign? Choose **I already have one** in the setup and give it to the master: paste the sheet in the chat, or say where its file is on your computer (a PDF, a picture, a text). The master writes it as it is, at its level, checks it against the rules and the world, and agrees with you anything that does not fit.
|
|
110
113
|
|
|
111
114
|
---
|
|
112
115
|
|
|
@@ -303,6 +306,8 @@ Every command the master uses can be run in the campaign folder too: `rpg --help
|
|
|
303
306
|
|
|
304
307
|
**The master does not seem to know the game.** Your agent did not load RPG Engine. Check that you started it in the campaign folder and trusted it. In Claude Code, write `/mcp` and reconnect `rpg`. In Codex, `codex mcp list` in the campaign folder must show `rpg`. If `rpg --version` is not found, install RPG Engine again ([2.2](#22-install)).
|
|
305
308
|
|
|
309
|
+
**Windows does not find `claude`.** Its installer says so in a yellow note, with the folder it went into: add that folder to the PATH (System Properties > Environment Variables), then open a new terminal.
|
|
310
|
+
|
|
306
311
|
**Updating.** Run `npm install -g rpg-engine` again, then open a new chat: a running master keeps the version it started with.
|
|
307
312
|
|
|
308
313
|
**The master remembers something I undid.** Open a new chat and press **I opened a new chat** in Saves.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: 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.
|
|
@@ -9,8 +9,8 @@ Esta guía es para quienes juegan: no necesitas saber programar.
|
|
|
9
9
|
|
|
10
10
|
1. Instala **Node.js** desde [nodejs.org](https://nodejs.org) (la versión LTS).
|
|
11
11
|
2. Instala un **agente de IA**, el programa en el que se ejecuta el máster, e inicia sesión: por ejemplo Claude Code o Codex ([2.4](#24-connect-your-ai)).
|
|
12
|
-
3. En una terminal nueva, abierta después de instalar Node.js, instala RPG Engine: `npm install -g rpg-engine`.
|
|
13
|
-
4.
|
|
12
|
+
3. En una terminal nueva, abierta después de instalar Node.js, instala RPG Engine: `npm install -g rpg-engine`. Si Windows responde que la ejecución de scripts está deshabilitada, escribe una sola vez `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, responde que sí e inténtalo de nuevo.
|
|
13
|
+
4. Abre la terminal en la carpeta donde guardas tus juegos (haz clic derecho en ella y elige **Abrir en Terminal**) y crea una campaña, siempre con su nombre: `rpg init "The Salt Isles"`. RPG Engine responde con dos líneas en inglés: todo va bien.
|
|
14
14
|
5. Entra en la carpeta nueva, `cd "The Salt Isles"`, e inicia tu agente allí: `claude` para Claude Code, `codex` para Codex. Responde que sí cuando pregunte si confías en la carpeta ([2.4](#24-connect-your-ai)) y escribe *Hola, ¡vamos a empezar!* El máster responde con el enlace a tu panel.
|
|
15
15
|
|
|
16
16
|
## 1. Qué es RPG Engine <!-- icon: about -->
|
|
@@ -48,7 +48,7 @@ Un juego llega como un sistema de juego, un paquete que el máster instala para
|
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
`rpg --version` comprueba que todo ha salido bien. Usas `rpg` una vez por campaña, para crearla; después, tu agente inicia RPG Engine por sí solo.
|
|
51
|
+
`rpg --version` comprueba que todo ha salido bien. Si npm se ofrece a actualizarse, puedes ignorarlo. Usas `rpg` una vez por campaña, para crearla; después, tu agente inicia RPG Engine por sí solo. `rpg` solo no abre nada: el máster te da el panel.
|
|
52
52
|
|
|
53
53
|
### 2.3 Crear una campaña
|
|
54
54
|
|
|
@@ -58,7 +58,7 @@ Abre una terminal en la carpeta donde guardas tus juegos ([2.1](#21-what-you-nee
|
|
|
58
58
|
rpg init "The Salt Isles"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
Esto crea la carpeta `The Salt Isles` con una campaña nueva dentro; entra en ella con `cd "The Salt Isles"`. Recuerda dónde está: volverás a ella cada vez que juegues. Todo lo demás lo eliges después, en el chat o en el panel
|
|
61
|
+
Esto crea la carpeta `The Salt Isles` con una campaña nueva dentro; entra en ella con `cd "The Salt Isles"`. Escribe siempre el nombre: sin él, la carpeta en la que estás se convierte en la campaña, junto a lo que ya contenga. Recuerda dónde está: volverás a ella cada vez que juegues. Todo lo demás lo eliges después, en el chat o en el panel.
|
|
62
62
|
|
|
63
63
|
El máster no puede crear una campaña por ti: antes de `init`, nada le dice a tu agente dónde está RPG Engine.
|
|
64
64
|
|
|
@@ -94,6 +94,7 @@ El máster pregunta solo lo que aún falta, unas pocas preguntas cada vez; el pa
|
|
|
94
94
|
| **Dados** | Quién tira tus dados | digitales, físicos |
|
|
95
95
|
| **Unidades** | Distancias y pesos | métricas, imperiales |
|
|
96
96
|
| **Voces de los personajes** | Quién habla por los personajes que encuentras, del máster a los personajes: siempre el máster; en momentos clave el propio personaje, que sabe solo lo que sabe, según decida el máster; o siempre el personaje, en los principales o en todos, más lento y más costoso, donde tu aplicación de IA lo permita | el máster, a veces, personajes principales, todos |
|
|
97
|
+
| **Tu personaje** | Cómo se crea tu personaje en la sesión cero | con el máster, por el máster, el tuyo ([2.7](#27-session-zero-your-character)) |
|
|
97
98
|
| **Compañeros** | Quién viaja contigo | ninguno, creados contigo, creados por el máster, encontrados en el juego |
|
|
98
99
|
| **Imágenes** | Imágenes de lugares, misiones y de quienes encuentras | ninguna, a petición, lugares nuevos, misiones y quienes encuentras ([3.11](#311-pictures)) |
|
|
99
100
|
| **Líneas** y **Velos** | Lo que nunca aparece y lo que ocurre solo fuera de escena | listas |
|
|
@@ -101,13 +102,15 @@ El máster pregunta solo lo que aún falta, unas pocas preguntas cada vez; el pa
|
|
|
101
102
|
|
|
102
103
|
La quinta edición añade el **avance**: puntos de experiencia o hitos.
|
|
103
104
|
|
|
104
|
-
Si no hay un mundo escrito, el máster también pregunta una **premisa** (género, tono, algunos elementos y lo que más disfrutas en un juego, como combates, misterios, conversaciones o explorar, con tus palabras)
|
|
105
|
+
Si no hay un mundo escrito, el máster también pregunta una **premisa** (género, tono, algunos elementos y lo que más disfrutas en un juego, como combates, misterios, conversaciones o explorar, con tus palabras), la **preparación**: construir el mundo sobre la marcha, mientras juegas, o todo al principio; y la **duración**: una tarde, unas pocas sesiones (de tres a cinco tardes), o abierta, una aventura tras otra. Al final de una historia con duración siempre puedes continuar.
|
|
105
106
|
|
|
106
107
|
**El estilo del máster** nunca se pregunta, pero puedes cambiarlo en el chat o en **Ajustes**: la **prosa** (sencilla, literaria, pulp, irónica), las **historias** que inventa (situaciones, arcos, episodios, misterio), un autor con el que **escribir al estilo**, o cualquier otra cosa **con tus palabras**.
|
|
107
108
|
|
|
108
109
|
### 2.7 Sesión cero: tu personaje
|
|
109
110
|
|
|
110
|
-
Creas tu personaje con el máster, como en una mesa. Cada elección es tuya, a menos que le pidas al máster que la haga: puedes llegar con una idea completa, una vaga o con nada. El máster te explica cómo se obtienen las puntuaciones de característica antes de tirar ningún dado. Tu historia nunca es obligatoria; si aportas una, el máster la escribe con tus palabras. Después, el máster te pide una imagen de tu personaje ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcula la ficha: tú nunca haces las cuentas.
|
|
111
|
+
Creas tu personaje con el máster, como en una mesa. Cada elección es tuya, a menos que le pidas al máster que la haga: puedes llegar con una idea completa, una vaga o con nada; o pedirle al máster que lo haga todo a partir de unas pocas palabras. En un juego con niveles, el máster te pregunta desde qué nivel empiezas: el primero, a menos que quieras otro. El máster te explica cómo se obtienen las puntuaciones de característica antes de tirar ningún dado. Tu historia nunca es obligatoria; si aportas una, el máster la escribe con tus palabras. Después, el máster te pide una imagen de tu personaje ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcula la ficha: tú nunca haces las cuentas.
|
|
112
|
+
|
|
113
|
+
¿Ya tienes un personaje, de otro juego o de otra campaña? Elige **Ya tengo uno** en la configuración y entrégaselo al máster: pega la ficha en el chat o indica dónde está su archivo en tu equipo (un PDF, una imagen, un texto). El máster lo escribe tal cual, en su nivel, lo contrasta con las reglas y el mundo, y acuerda contigo lo que no encaje.
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -304,6 +307,8 @@ Cada comando que usa el máster también se puede ejecutar en la carpeta de la c
|
|
|
304
307
|
|
|
305
308
|
**El máster no parece conocer el juego.** Tu agente no cargó RPG Engine. Comprueba que lo iniciaste en la carpeta de la campaña y que confiaste en ella. En Claude Code, escribe `/mcp` y vuelve a conectar `rpg`. En Codex, `codex mcp list` en la carpeta de la campaña debe mostrar `rpg`. Si `rpg --version` no se encuentra, instala RPG Engine de nuevo ([2.2](#22-install)).
|
|
306
309
|
|
|
310
|
+
**Windows no encuentra `claude`.** Su instalador lo avisa en una nota amarilla, con la carpeta en la que se instaló: añade esa carpeta al PATH (Propiedades del sistema > Variables de entorno) y abre una terminal nueva.
|
|
311
|
+
|
|
307
312
|
**Actualizar.** Ejecuta `npm install -g rpg-engine` otra vez y abre un chat nuevo: un máster en marcha conserva la versión con la que empezó.
|
|
308
313
|
|
|
309
314
|
**El máster recuerda algo que deshice.** Abre un chat nuevo y pulsa **He abierto un chat nuevo** en Partidas guardadas.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: 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.
|
|
@@ -9,8 +9,8 @@ Tämä opas on pelaajille: ohjelmointitaitoja ei tarvita.
|
|
|
9
9
|
|
|
10
10
|
1. Asenna **Node.js** osoitteesta [nodejs.org](https://nodejs.org) (LTS-versio).
|
|
11
11
|
2. Asenna **tekoälyagentti**, ohjelma, jossa pelinjohtaja toimii, ja kirjaudu sisään: esimerkiksi Claude Code tai Codex ([2.4](#24-connect-your-ai)).
|
|
12
|
-
3. Asenna RPG Engine uudessa päätteessä, joka on avattu Node.js:n asennuksen jälkeen: `npm install -g rpg-engine`.
|
|
13
|
-
4.
|
|
12
|
+
3. Asenna RPG Engine uudessa päätteessä, joka on avattu Node.js:n asennuksen jälkeen: `npm install -g rpg-engine`. Jos Windows ilmoittaa, että komentosarjojen suorittaminen on estetty, kirjoita kerran `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, vastaa myöntävästi ja yritä uudelleen.
|
|
13
|
+
4. Avaa pääte kansioon, jossa säilytät pelisi (napsauta kansiota hiiren kakkospainikkeella ja valitse **Open in Terminal**), ja luo kampanja aina nimen kanssa: `rpg init "The Salt Isles"`. RPG Engine vastaa kahdella englanninkielisellä rivillä: kaikki on kunnossa.
|
|
14
14
|
5. Siirry uuteen kansioon komennolla `cd "The Salt Isles"` ja käynnistä agentti siellä: `claude` Claude Codelle, `codex` Codexille. Vastaa myöntävästi, kun se kysyy, luotatko kansioon ([2.4](#24-connect-your-ai)), ja kirjoita sitten *Hei! Aloitetaan.* Pelinjohtaja vastaa antamalla kojelaudan linkin.
|
|
15
15
|
|
|
16
16
|
## 1. Mikä RPG Engine on <!-- icon: about -->
|
|
@@ -48,7 +48,7 @@ Peli tulee pelijärjestelmänä. Se on paketti, jonka pelinjohtaja asentaa kampa
|
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
Komento `rpg --version` tarkistaa, että asennus onnistui. Käytät komentoa `rpg` kerran kampanjaa kohti, kampanjan luomiseen. Sen jälkeen agenttisi käynnistää RPG Enginen itse.
|
|
51
|
+
Komento `rpg --version` tarkistaa, että asennus onnistui. Jos npm tarjoutuu päivittämään itsensä, voit ohittaa tarjouksen. Käytät komentoa `rpg` kerran kampanjaa kohti, kampanjan luomiseen. Sen jälkeen agenttisi käynnistää RPG Enginen itse. Pelkkä `rpg` ei avaa mitään: kojelaudan antaa pelinjohtaja.
|
|
52
52
|
|
|
53
53
|
### 2.3 Kampanjan luominen
|
|
54
54
|
|
|
@@ -58,7 +58,7 @@ Avaa pääte kansioon, jossa säilytät pelisi ([2.1](#21-what-you-need) kertoo,
|
|
|
58
58
|
rpg init "The Salt Isles"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
Komento luo kansion `The Salt Isles`, jossa on uusi kampanja. Siirry siihen komennolla `cd "The Salt Isles"`. Muista, missä kansio on: palaat siihen aina, kun pelaat. Kaiken muun valitset myöhemmin, keskustelussa tai kojelaudalla.
|
|
61
|
+
Komento luo kansion `The Salt Isles`, jossa on uusi kampanja. Siirry siihen komennolla `cd "The Salt Isles"`. Kirjoita nimi aina: ilman nimeä kansiosta, jossa olet, tulee kampanja sen jo sisältämien tiedostojen viereen. Muista, missä kansio on: palaat siihen aina, kun pelaat. Kaiken muun valitset myöhemmin, keskustelussa tai kojelaudalla.
|
|
62
62
|
|
|
63
63
|
Pelinjohtaja ei voi luoda kampanjaa puolestasi: ennen komentoa `init` mikään ei kerro agentillesi, missä RPG Engine on.
|
|
64
64
|
|
|
@@ -94,6 +94,7 @@ Pelinjohtaja kysyy vain sen, mikä vielä puuttuu, muutaman kysymyksen kerrallaa
|
|
|
94
94
|
| **Nopat** | Kuka heittää noppasi | digitaaliset, fyysiset |
|
|
95
95
|
| **Mittayksiköt** | Etäisyydet ja painot | metrijärjestelmä, brittiläinen mittajärjestelmä |
|
|
96
96
|
| **Hahmojen äänet** | Kuka puhuu tapaamiesi hahmojen puolesta, pelinjohtajasta hahmoihin: aina pelinjohtaja; ratkaisevissa hetkissä hahmo itse, tietäen vain sen, minkä tietää, pelinjohtajan valinnan mukaan; tai aina hahmo itse, tärkeimmät tai kaikki, hitaammin ja kalliimmin, jos tekoälysovelluksesi sen sallii | pelinjohtaja, joskus, tärkeimmät hahmot, kaikki |
|
|
97
|
+
| **Hahmosi** | Miten hahmosi tehdään nollasessiossa | pelinjohtajan kanssa, pelinjohtajan tekemä, oma ([2.7](#27-session-zero-your-character)) |
|
|
97
98
|
| **Seuralaiset** | Kuka matkaa mukanasi | ei kukaan, luotu yhdessä kanssasi, pelinjohtajan luoma, tavattu pelissä |
|
|
98
99
|
| **Kuvat** | Kuvia paikoista, tehtävistä ja tapaamistasi hahmoista | ei mitään, pyynnöstä, uudet paikat, tehtävät ja tapaamasi hahmot ([3.11](#311-pictures)) |
|
|
99
100
|
| **Rajat** ja **Verhot** | Mikä ei koskaan esiinny pelissä ja mikä tapahtuu vain kuvaruudun ulkopuolella | luettelot |
|
|
@@ -101,13 +102,15 @@ Pelinjohtaja kysyy vain sen, mikä vielä puuttuu, muutaman kysymyksen kerrallaa
|
|
|
101
102
|
|
|
102
103
|
Viides editio lisää **kehittymisen**: kokemuspisteet tai merkkipaalut.
|
|
103
104
|
|
|
104
|
-
Jos maailmaa ei ole kirjoitettu valmiiksi, pelinjohtaja kysyy myös **lähtökohdan** (tyylilaji, sävy, muutama aines ja se, mistä pelissä nautit eniten, kuten taisteluista, arvoituksista, puheesta tai tutkimisesta, omin sanoin)
|
|
105
|
+
Jos maailmaa ei ole kirjoitettu valmiiksi, pelinjohtaja kysyy myös **lähtökohdan** (tyylilaji, sävy, muutama aines ja se, mistä pelissä nautit eniten, kuten taisteluista, arvoituksista, puheesta tai tutkimisesta, omin sanoin), **valmistelun**: rakennetaanko maailma lennossa pelin edetessä vai kokonaan alussa, sekä **keston**: yksi ilta, muutama pelikerta (kolmesta viiteen iltaa) tai avoin, seikkailu toisensa jälkeen. Kun kestoltaan rajattu tarina päättyy, voit aina jatkaa.
|
|
105
106
|
|
|
106
107
|
**Pelinjohtajan tyyliä** ei koskaan kysytä, mutta voit muuttaa sitä keskustelussa tai kohdassa **Asetukset**: **proosa** (selkeä, kirjallinen, pulp, kuiva), **tarinat**, joita pelinjohtaja keksii (tilanteet, juonikaaret, jaksot, mysteeri), kirjailija, jonka tyyliin **kirjoitetaan**, tai mikä tahansa muu **omin sanoin**.
|
|
107
108
|
|
|
108
109
|
### 2.7 Nollasessio: hahmosi
|
|
109
110
|
|
|
110
|
-
Teet hahmosi pelinjohtajan kanssa, kuten pelipöydän ääressä. Jokainen valinta on sinun, ellet pyydä pelinjohtajaa tekemään sitä: tule mukaan valmiin idean, epämääräisen idean tai
|
|
111
|
+
Teet hahmosi pelinjohtajan kanssa, kuten pelipöydän ääressä. Jokainen valinta on sinun, ellet pyydä pelinjohtajaa tekemään sitä: tule mukaan valmiin idean, epämääräisen idean tai ilman mitään ideaa, tai pyydä pelinjohtajaa tekemään koko hahmo muutaman sanan pohjalta. Tasoihin perustuvassa pelissä pelinjohtaja kysyy, miltä tasolta aloitat: ensimmäiseltä, ellet halua toista. Pelinjohtaja kertoo, miten ominaisuuspisteet määritetään, ennen kuin yhtään noppaa heitetään. Taustatarinaa ei koskaan vaadita. Jos kerrot sellaisen, pelinjohtaja kirjoittaa sen sinun sanoillasi. Sitten pelinjohtaja pyytää kuvaa hahmostasi ([3.7](#37-your-characters-story-and-picture)). RPG Engine laskee hahmolomakkeen: sinun ei koskaan tarvitse laskea itse.
|
|
112
|
+
|
|
113
|
+
Onko sinulla jo hahmo, toisesta pelistä tai toisesta kampanjasta? Valitse asetuksissa **Minulla on jo yksi** ja anna hahmo pelinjohtajalle: liitä hahmolomake keskusteluun tai kerro, missä sen tiedosto on tietokoneellasi (PDF, kuva, teksti). Pelinjohtaja kirjoittaa hahmon sellaisenaan, sen tasolla, tarkistaa sen sääntöjä ja maailmaa vasten ja sopii kanssasi kaikesta, mikä ei sovi.
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -304,6 +307,8 @@ Jokaisen komennon, jota pelinjohtaja käyttää, voi ajaa myös kampanjakansioss
|
|
|
304
307
|
|
|
305
308
|
**Pelinjohtaja ei tunnu tuntevan peliä.** Agenttisi ei ladannut RPG Engineä. Tarkista, että käynnistit sen kampanjakansiossa ja että luotit kansioon. Claude Codessa kirjoita `/mcp` ja yhdistä `rpg` uudelleen. Codexissa komennon `codex mcp list` kampanjakansiossa pitää näyttää `rpg`. Jos komentoa `rpg --version` ei löydy, asenna RPG Engine uudelleen ([2.2](#22-install)).
|
|
306
309
|
|
|
310
|
+
**Windows ei löydä komentoa `claude`.** Asennusohjelma kertoo siitä keltaisessa huomautuksessa ja mainitsee kansion, johon asennus meni: lisää kansio PATH-ympäristömuuttujaan (Järjestelmän ominaisuudet > Ympäristömuuttujat) ja avaa sitten uusi pääte.
|
|
311
|
+
|
|
307
312
|
**Päivittäminen.** Suorita `npm install -g rpg-engine` uudelleen ja avaa sitten uusi keskustelu: käynnissä oleva pelinjohtaja pitää sen version, jolla se käynnistyi.
|
|
308
313
|
|
|
309
314
|
**Pelinjohtaja muistaa jotain, minkä peruin.** Avaa uusi keskustelu ja paina Tallennuksissa **Avasin uuden keskustelun**.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine : le guide complet
|
|
3
3
|
|
|
4
4
|
**RPG Engine** te permet de jouer à un jeu de rôle sur table avec une **IA comme MJ**. Tu parles avec le MJ dans un **chat**. RPG Engine travaille en coulisses : il **garde en mémoire le monde**, **lance les dés** et **tient les comptes**. À côté du chat, tu gardes ouverte dans ton navigateur une page, le **tableau de bord**, avec ta fiche, les dés, les cartes et ton journal.
|
|
@@ -9,8 +9,8 @@ Ce guide s'adresse aux joueurs et joueuses : tu n'as pas besoin de savoir progra
|
|
|
9
9
|
|
|
10
10
|
1. Installe **Node.js** depuis [nodejs.org](https://nodejs.org) (la version LTS).
|
|
11
11
|
2. Installe un **agent IA**, le programme dans lequel le MJ fonctionne, et connecte-toi : par exemple Claude Code ou Codex ([2.4](#24-connect-your-ai)).
|
|
12
|
-
3. Dans un nouveau terminal, ouvert après l'installation de Node.js, installe RPG Engine : `npm install -g rpg-engine`.
|
|
13
|
-
4.
|
|
12
|
+
3. Dans un nouveau terminal, ouvert après l'installation de Node.js, installe RPG Engine : `npm install -g rpg-engine`. Si Windows répond que l'exécution de scripts est désactivée, écris une fois `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, réponds oui et réessaie.
|
|
13
|
+
4. Ouvre le terminal dans le dossier où tu ranges tes jeux (clic droit sur le dossier, **Ouvrir dans le Terminal**) et crée une campagne, toujours avec son nom : `rpg init "The Salt Isles"`. RPG Engine répond par deux lignes en anglais : tout va bien.
|
|
14
14
|
5. Entre dans le nouveau dossier, `cd "The Salt Isles"`, et lance ton agent à cet endroit : `claude` pour Claude Code, `codex` pour Codex. Réponds oui quand il demande si tu fais confiance au dossier ([2.4](#24-connect-your-ai)), puis écris *Salut ! On commence.* Le MJ répond avec le lien vers ton tableau de bord.
|
|
15
15
|
|
|
16
16
|
## 1. Qu'est-ce que RPG Engine <!-- icon: about -->
|
|
@@ -48,7 +48,7 @@ Un jeu prend la forme d'un système de jeu, un paquet que le MJ installe pour ta
|
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
`rpg --version` vérifie que tout a fonctionné. Tu utilises `rpg` une seule fois par campagne, pour la créer ; ensuite, ton agent lance RPG Engine tout seul.
|
|
51
|
+
`rpg --version` vérifie que tout a fonctionné. Si npm propose de se mettre à jour, tu peux l'ignorer. Tu utilises `rpg` une seule fois par campagne, pour la créer ; ensuite, ton agent lance RPG Engine tout seul. `rpg` seul n'ouvre rien : c'est le MJ qui te donne le tableau de bord.
|
|
52
52
|
|
|
53
53
|
### 2.3 Créer une campagne
|
|
54
54
|
|
|
@@ -58,7 +58,7 @@ Ouvre un terminal dans le dossier où tu ranges tes jeux ([2.1](#21-what-you-nee
|
|
|
58
58
|
rpg init "The Salt Isles"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
Cela crée le dossier `The Salt Isles` avec une nouvelle campagne dedans ; entres-y avec `cd "The Salt Isles"`. Retiens où il se trouve : tu y reviendras à chaque partie. Tu choisiras tout le reste plus tard, dans le chat ou sur le
|
|
61
|
+
Cela crée le dossier `The Salt Isles` avec une nouvelle campagne dedans ; entres-y avec `cd "The Salt Isles"`. Écris toujours le nom : sans nom, le dossier où tu te trouves devient la campagne, à côté de tout ce qu'il contient déjà. Retiens où il se trouve : tu y reviendras à chaque partie. Tu choisiras tout le reste plus tard, dans le chat ou sur le tableau de bord.
|
|
62
62
|
|
|
63
63
|
Le MJ ne peut pas créer une campagne à ta place : avant `init`, rien n'indique à ton agent où se trouve RPG Engine.
|
|
64
64
|
|
|
@@ -94,6 +94,7 @@ Le MJ ne demande que ce qui manque encore, quelques questions à la fois ; l'ét
|
|
|
94
94
|
| **Dés** | Qui lance tes dés | numériques, physiques |
|
|
95
95
|
| **Unités** | Distances et poids | métriques, impériales |
|
|
96
96
|
| **Voix des personnages** | Qui parle pour les personnages que tu rencontres, du MJ aux personnages : toujours le MJ ; aux moments clés, le personnage lui-même, qui ne sait que ce qu'il sait, selon le choix du MJ ; ou toujours le personnage, pour les principaux ou pour tous, plus lent et plus coûteux, là où ton appli d'IA le permet | le MJ, parfois, personnages principaux, tous |
|
|
97
|
+
| **Ton personnage** | Comment ton personnage est créé en session zéro | avec le MJ, par le MJ, le tien ([2.7](#27-session-zero-your-character)) |
|
|
97
98
|
| **Compagnons** | Qui voyage avec toi | aucun, créés avec toi, créés par le MJ, rencontrés en jeu |
|
|
98
99
|
| **Images** | Images des lieux, des quêtes et des personnages rencontrés | aucune, sur demande, nouveaux lieux, quêtes et personnages rencontrés ([3.11](#311-pictures)) |
|
|
99
100
|
| **Lignes** et **Voiles** | Ce qui n'apparaît jamais, et ce qui se passe seulement hors champ | listes |
|
|
@@ -101,13 +102,15 @@ Le MJ ne demande que ce qui manque encore, quelques questions à la fois ; l'ét
|
|
|
101
102
|
|
|
102
103
|
La cinquième édition ajoute la **progression** : points d'expérience ou paliers.
|
|
103
104
|
|
|
104
|
-
Si tu n'as pas de monde écrit, le MJ demande aussi une **prémisse** (le genre, le ton, quelques éléments, et ce que tu préfères dans un jeu, comme les combats, les mystères, les dialogues ou l'exploration, avec tes propres mots)
|
|
105
|
+
Si tu n'as pas de monde écrit, le MJ demande aussi une **prémisse** (le genre, le ton, quelques éléments, et ce que tu préfères dans un jeu, comme les combats, les mystères, les dialogues ou l'exploration, avec tes propres mots), la **préparation** : construire le monde au fil du jeu, ou tout au début ; et la **durée** : une soirée, quelques sessions (de trois à cinq soirées), ou ouverte, une aventure après l'autre. À la fin d'une histoire d'une durée donnée, tu peux toujours continuer.
|
|
105
106
|
|
|
106
107
|
**Le style du MJ** n'est jamais demandé, mais tu peux le changer dans le chat ou dans **Paramètres** : la **prose** (simple, littéraire, pulp, pince-sans-rire), les **histoires** qu'il invente (situations, arcs, épisodes, mystère), un auteur dont **imiter la plume**, ou toute autre chose **avec tes mots**.
|
|
107
108
|
|
|
108
109
|
### 2.7 Session zéro : ton personnage
|
|
109
110
|
|
|
110
|
-
Tu crées ton personnage avec le MJ, comme à une table. Chaque choix t'appartient, sauf si tu demandes au MJ de le faire : viens avec une idée complète, une idée vague, ou rien du tout. Le MJ t'explique comment sont obtenus les scores de caractéristiques avant qu'un seul dé soit lancé. Ton histoire n'est jamais obligatoire ; si tu en donnes une, le MJ la rédige avec tes mots. Ensuite, le MJ te propose une image de ton personnage ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcule la fiche : tu n'as jamais à faire les additions.
|
|
111
|
+
Tu crées ton personnage avec le MJ, comme à une table. Chaque choix t'appartient, sauf si tu demandes au MJ de le faire : viens avec une idée complète, une idée vague, ou rien du tout ; ou demande au MJ de tout créer à partir de quelques mots. Dans un jeu à niveaux, le MJ demande à partir de quel niveau tu commences : le premier, sauf si tu en veux un autre. Le MJ t'explique comment sont obtenus les scores de caractéristiques avant qu'un seul dé soit lancé. Ton histoire n'est jamais obligatoire ; si tu en donnes une, le MJ la rédige avec tes mots. Ensuite, le MJ te propose une image de ton personnage ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcule la fiche : tu n'as jamais à faire les additions.
|
|
112
|
+
|
|
113
|
+
Tu as déjà un personnage, d'un autre jeu ou d'une autre campagne ? Choisis **J'en ai déjà un** dans la configuration et donne-le au MJ : colle la fiche dans le chat, ou indique où se trouve son fichier sur ton ordinateur (un PDF, une image, un texte). Le MJ le reprend tel quel, à son niveau, le vérifie au regard des règles et du monde, et s'accorde avec toi sur tout ce qui ne colle pas.
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -304,6 +307,8 @@ Toutes les commandes que le MJ utilise peuvent aussi être lancées dans le doss
|
|
|
304
307
|
|
|
305
308
|
**Le MJ ne semble pas connaître le jeu.** Ton agent n'a pas chargé RPG Engine. Vérifie que tu l'as lancé dans le dossier de la campagne et que tu lui as fait confiance. Dans Claude Code, écris `/mcp` et reconnecte `rpg`. Dans Codex, `codex mcp list` dans le dossier de la campagne doit afficher `rpg`. Si `rpg --version` est introuvable, réinstalle RPG Engine ([2.2](#22-install)).
|
|
306
309
|
|
|
310
|
+
**Windows ne trouve pas `claude`.** Son installateur le signale dans une note jaune, avec le dossier où il s'est installé : ajoute ce dossier au PATH (Propriétés système > Variables d'environnement), puis ouvre un nouveau terminal.
|
|
311
|
+
|
|
307
312
|
**Mise à jour.** Relance `npm install -g rpg-engine`, puis ouvre un nouveau chat : un MJ déjà en cours garde la version avec laquelle il a démarré.
|
|
308
313
|
|
|
309
314
|
**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.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: המדריך המלא
|
|
3
3
|
|
|
4
4
|
**RPG Engine** מאפשר לשחק משחק תפקידים שולחני עם **בינה מלאכותית בתפקיד המנחה**. מדברים עם המנחה ב**צ'אט**; RPG Engine עובד מאחורי הקלעים: הוא **זוכר את העולם**, **מטיל את הקוביות** ו**מנהל את החשבונות**. לצד הצ'אט משאירים בדפדפן דף פתוח, **הלוח** (dashboard), עם דף הדמות, הקוביות, המפות והיומן.
|
|
@@ -9,8 +9,8 @@
|
|
|
9
9
|
|
|
10
10
|
1. להתקין את **Node.js** מהאתר [nodejs.org](https://nodejs.org) (גרסת LTS).
|
|
11
11
|
2. להתקין **סוכן בינה מלאכותית**, התוכנה שבה המנחה פועל, ולהתחבר אליו: למשל Claude Code או Codex ([2.4](#24-connect-your-ai)).
|
|
12
|
-
3. בטרמינל חדש, שנפתח אחרי שהותקן Node.js, להתקין את RPG Engine: `npm install -g rpg-engine`.
|
|
13
|
-
4.
|
|
12
|
+
3. בטרמינל חדש, שנפתח אחרי שהותקן Node.js, להתקין את RPG Engine: `npm install -g rpg-engine`. אם Windows משיבה שהרצת סקריפטים מושבתת, לכתוב פעם אחת `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, לענות yes ולנסות שוב.
|
|
13
|
+
4. לפתוח את הטרמינל בתיקייה שבה שומרים את המשחקים (לחיצה ימנית עליה, **Open in Terminal**) וליצור קמפיין, תמיד עם שם: `rpg init "The Salt Isles"`. RPG Engine עונה בשתי שורות באנגלית: הכול תקין.
|
|
14
14
|
5. להיכנס לתיקייה החדשה, `cd "The Salt Isles"`, ולהפעיל בה את הסוכן: `claude` עבור Claude Code, `codex` עבור Codex. לאשר כשהוא שואל אם סומכים על התיקייה ([2.4](#24-connect-your-ai)), ואז לכתוב *שלום! בוא נתחיל.* המנחה עונה עם הקישור ללוח.
|
|
15
15
|
|
|
16
16
|
## 1. מהו RPG Engine <!-- icon: about -->
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
הפקודה `rpg --version` בודקת שההתקנה הצליחה. משתמשים ב-`rpg` פעם אחת בכל קמפיין, כדי ליצור אותו. אחר כך הסוכן מפעיל את RPG Engine בעצמו.
|
|
51
|
+
הפקודה `rpg --version` בודקת שההתקנה הצליחה. אם npm מציע להתעדכן, אפשר להתעלם מכך. משתמשים ב-`rpg` פעם אחת בכל קמפיין, כדי ליצור אותו. אחר כך הסוכן מפעיל את RPG Engine בעצמו. הפקודה `rpg` לבדה לא פותחת דבר: את הדשבורד נותן המנחה.
|
|
52
52
|
|
|
53
53
|
### 2.3 יצירת קמפיין
|
|
54
54
|
|
|
@@ -58,7 +58,7 @@ npm install -g rpg-engine
|
|
|
58
58
|
rpg init "The Salt Isles"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
הפקודה יוצרת את התיקייה `The Salt Isles` עם קמפיין חדש בתוכה. נכנסים אליה עם `cd "The Salt Isles"`. כדאי לזכור איפה היא נמצאת: חוזרים אליה בכל פעם שמשחקים. את כל השאר בוחרים אחר כך, בצ'אט או בדשבורד.
|
|
61
|
+
הפקודה יוצרת את התיקייה `The Salt Isles` עם קמפיין חדש בתוכה. נכנסים אליה עם `cd "The Salt Isles"`. תמיד לכתוב את השם: בלי שם, התיקייה שבה נמצאים הופכת לקמפיין, לצד כל מה שכבר יש בה. כדאי לזכור איפה היא נמצאת: חוזרים אליה בכל פעם שמשחקים. את כל השאר בוחרים אחר כך, בצ'אט או בדשבורד.
|
|
62
62
|
|
|
63
63
|
המנחה לא יכול ליצור קמפיין במקומך: לפני `init`, שום דבר לא מראה לסוכן איפה RPG Engine נמצא.
|
|
64
64
|
|
|
@@ -94,6 +94,7 @@ rpg init "The Salt Isles"
|
|
|
94
94
|
| **קוביות** | מי מטיל את הקוביות | digital, physical |
|
|
95
95
|
| **יחידות מידה** | מרחקים ומשקלים | metric, imperial |
|
|
96
96
|
| **קולות הדמויות** | מי מדבר בשם הדמויות שפוגשים, מהמנחה ועד הדמויות עצמן: המנחה תמיד; ברגעים מרכזיים הדמות עצמה, כשהיא יודעת רק את מה שהיא יודעת, לפי בחירת המנחה; או תמיד הדמות, לדמויות הראשיות או לכולן, לאט ויקר יותר, במקום שבו אפליקציית ה-AI מאפשרת | the master, sometimes, main characters, everyone |
|
|
97
|
+
| **הדמות שלך** | איך הדמות נוצרת בסשן אפס | with the master, by the master, your own ([2.7](#27-session-zero-your-character)) |
|
|
97
98
|
| **בני לוויה** | מי מטייל איתך | none, made with you, made by the master, met in play |
|
|
98
99
|
| **תמונות** | תמונות של מקומות, משימות ודמויות שפוגשים | none, on request, new places, quests and those you meet ([3.11](#311-pictures)) |
|
|
99
100
|
| **קווים אדומים** ו**וילונות** | מה אף פעם לא מופיע, ומה קורה רק מחוץ למסך | רשימות |
|
|
@@ -101,13 +102,15 @@ rpg init "The Salt Isles"
|
|
|
101
102
|
|
|
102
103
|
המהדורה החמישית מוסיפה **התקדמות**: נקודות ניסיון או אבני דרך.
|
|
103
104
|
|
|
104
|
-
כשאין עולם כתוב, המנחה שואל גם **הנחת יסוד** (ז'אנר, אווירה, כמה אלמנטים, ומה הכי כיף לך במשחק, כמו קרבות, תעלומות, שיחות או חקירה, במילים שלך)
|
|
105
|
+
כשאין עולם כתוב, המנחה שואל גם **הנחת יסוד** (ז'אנר, אווירה, כמה אלמנטים, ומה הכי כיף לך במשחק, כמו קרבות, תעלומות, שיחות או חקירה, במילים שלך), את **ההכנה**: לבנות את העולם תוך כדי משחק, צעד אחר צעד, או הכול בהתחלה, ואת **האורך**: ערב אחד, כמה סשנים (שלושה עד חמישה ערבים), או פתוח, הרפתקה אחרי הרפתקה. בסוף סיפור שיש לו אורך תמיד אפשר להמשיך.
|
|
105
106
|
|
|
106
107
|
**הסגנון של המנחה** אף פעם לא נשאל, אבל אפשר לשנות אותו בצ'אט או ב**הגדרות**: **הפרוזה** (פשוטה, ספרותית, פאלפ, צינית), **הסיפורים** שהוא ממציא (סיטואציות, קשתות עלילה, פרקים, מסתורין), מחבר לכתוב **בסגנונו**, או כל דבר אחר **במילים שלך**.
|
|
107
108
|
|
|
108
109
|
### 2.7 סשן אפס: הדמות שלך
|
|
109
110
|
|
|
110
|
-
יוצרים את הדמות יחד עם המנחה, כמו סביב שולחן משחק. כל בחירה היא שלך, אלא אם מבקשים מהמנחה לבחור: אפשר להגיע עם רעיון מלא, עם רעיון מעורפל או בלי
|
|
111
|
+
יוצרים את הדמות יחד עם המנחה, כמו סביב שולחן משחק. כל בחירה היא שלך, אלא אם מבקשים מהמנחה לבחור: אפשר להגיע עם רעיון מלא, עם רעיון מעורפל או בלי כלום; או לבקש מהמנחה ליצור הכול מכמה מילים. במשחק עם רמות המנחה שואל מאיזו רמה מתחילים: הראשונה, אלא אם רוצים אחרת. המנחה מסביר איך נקבעים ערכי היכולות לפני שמוטלת קובייה כלשהי. סיפור רקע אף פעם לא נדרש; אם נותנים אחד, המנחה כותב אותו במילים שלך. אחר כך המנחה מבקש תמונה של הדמות ([3.7](#37-your-characters-story-and-picture)). RPG Engine מחשב את דף הדמות: אף פעם לא צריך לעשות חישובים.
|
|
112
|
+
|
|
113
|
+
כבר יש לך דמות, ממשחק אחר או מקמפיין אחר? בוחרים **כבר יש לי אחד** בהגדרה ונותנים אותה למנחה: מדביקים את דף הדמות בצ'אט, או אומרים איפה הקובץ שלה נמצא במחשב (PDF, תמונה, טקסט). המנחה רושם אותה כמות שהיא, ברמה שלה, בודק אותה מול החוקים והעולם, ומסכם איתך כל דבר שלא מתאים.
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -304,6 +307,8 @@ RPG Engine נשאר בתיקייה הזאת: הוא קורא וכותב את ה
|
|
|
304
307
|
|
|
305
308
|
**נראה שהמנחה לא מכיר את המשחק.** הסוכן לא טען את RPG Engine. לבדוק שהפעלת אותו בתיקיית הקמפיין ואישרת אמון. ב-Claude Code, לכתוב `/mcp` ולחבר מחדש את `rpg`. ב-Codex, הפקודה `codex mcp list` בתיקיית הקמפיין חייבת להציג את `rpg`. אם `rpg --version` לא נמצא, להתקין את RPG Engine שוב ([2.2](#22-install)).
|
|
306
309
|
|
|
310
|
+
**Windows לא מוצאת את `claude`.** תוכנית ההתקנה שלו אומרת זאת בהערה צהובה, עם התיקייה שאליה הותקן: להוסיף את התיקייה הזאת ל-PATH (System Properties > Environment Variables), ואז לפתוח טרמינל חדש.
|
|
311
|
+
|
|
307
312
|
**עדכון.** להריץ שוב `npm install -g rpg-engine`, ואז לפתוח צ'אט חדש: מנחה שכבר רץ נשאר עם הגרסה שבה התחיל.
|
|
308
313
|
|
|
309
314
|
**המנחה זוכר משהו שביטלתי.** לפתוח צ'אט חדש וללחוץ על **נפתח צ'אט חדש** ב-שמירות.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: पूरी गाइड
|
|
3
3
|
|
|
4
4
|
**RPG Engine** आपको **AI को अपना गेम मास्टर** बनाकर टेबलटॉप रोल-प्लेइंग गेम खेलने देता है। आप गेम मास्टर से **चैट** में बात करते हैं। RPG Engine पर्दे के पीछे काम करता है: वह **दुनिया को याद रखता है**, **पासे रोल करता है** और **हिसाब-किताब रखता है**। चैट के साथ आप ब्राउज़र में एक पेज खुला रखते हैं, यानी **डैशबोर्ड**, जिसमें आपकी कैरेक्टर शीट, पासे, नक्शे और आपकी डायरी होती है।
|
|
@@ -9,8 +9,8 @@
|
|
|
9
9
|
|
|
10
10
|
1. [nodejs.org](https://nodejs.org) से **Node.js** इंस्टॉल करें (LTS वर्शन)।
|
|
11
11
|
2. एक **AI एजेंट** इंस्टॉल करें, यानी वह प्रोग्राम जिसमें गेम मास्टर चलता है, और साइन इन करें: जैसे Claude Code या Codex ([2.4](#24-connect-your-ai))।
|
|
12
|
-
3. Node.js इंस्टॉल होने के बाद एक नया टर्मिनल खोलें और उसमें RPG Engine इंस्टॉल करें: `npm install -g rpg-engine`।
|
|
13
|
-
4.
|
|
12
|
+
3. Node.js इंस्टॉल होने के बाद एक नया टर्मिनल खोलें और उसमें RPG Engine इंस्टॉल करें: `npm install -g rpg-engine`। अगर Windows कहे कि स्क्रिप्ट चलाना बंद है, तो एक बार `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` लिखें, हाँ कहें और फिर कोशिश करें।
|
|
13
|
+
4. जिस फ़ोल्डर में आप अपने गेम रखते हैं, उसमें टर्मिनल खोलें (उस पर राइट-क्लिक करें, **Open in Terminal**) और कैंपेन बनाएँ, हमेशा उसके नाम के साथ: `rpg init "The Salt Isles"`। RPG Engine अंग्रेज़ी में दो पंक्तियों में जवाब देता है: सब ठीक है।
|
|
14
14
|
5. नए फ़ोल्डर में जाएँ, `cd "The Salt Isles"`, और वहीं अपना एजेंट शुरू करें: Claude Code के लिए `claude`, Codex के लिए `codex`। जब वह पूछे कि क्या आप फ़ोल्डर पर भरोसा करते हैं, तो हाँ कहें ([2.4](#24-connect-your-ai)), फिर लिखें *नमस्ते! चलिए शुरू करते हैं।* गेम मास्टर आपके डैशबोर्ड के लिंक के साथ जवाब देता है।
|
|
15
15
|
|
|
16
16
|
## 1. RPG Engine क्या है <!-- icon: about -->
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
`rpg --version` से जाँचें कि इंस्टॉल हुआ या नहीं। `rpg` आप हर कैंपेन में सिर्फ़ एक बार चलाते हैं, उसे बनाने के लिए; इसके बाद आपका एजेंट RPG Engine को खुद शुरू करता है।
|
|
51
|
+
`rpg --version` से जाँचें कि इंस्टॉल हुआ या नहीं। अगर npm खुद को अपडेट करने का सुझाव दे, तो आप उसे अनदेखा कर सकते हैं। `rpg` आप हर कैंपेन में सिर्फ़ एक बार चलाते हैं, उसे बनाने के लिए; इसके बाद आपका एजेंट RPG Engine को खुद शुरू करता है। अकेला `rpg` कुछ नहीं खोलता: डैशबोर्ड गेम मास्टर आपको देता है।
|
|
52
52
|
|
|
53
53
|
### 2.3 कैंपेन बनाएँ
|
|
54
54
|
|
|
@@ -58,7 +58,7 @@ npm install -g rpg-engine
|
|
|
58
58
|
rpg init "The Salt Isles"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
इससे `The Salt Isles` नाम का फ़ोल्डर बनता है, जिसमें नया कैंपेन होता है; `cd "The Salt Isles"` से उसके अंदर जाएँ। याद रखें कि वह कहाँ है: हर बार खेलने के लिए आप यहीं लौटेंगे। बाकी सब कुछ आप बाद में चुनते हैं, चैट में या डैशबोर्ड
|
|
61
|
+
इससे `The Salt Isles` नाम का फ़ोल्डर बनता है, जिसमें नया कैंपेन होता है; `cd "The Salt Isles"` से उसके अंदर जाएँ। नाम हमेशा लिखें: नाम के बिना, आप जिस फ़ोल्डर में हैं वही कैंपेन बन जाता है, उसमें पहले से रखी चीज़ों के साथ। याद रखें कि वह कहाँ है: हर बार खेलने के लिए आप यहीं लौटेंगे। बाकी सब कुछ आप बाद में चुनते हैं, चैट में या डैशबोर्ड पर।
|
|
62
62
|
|
|
63
63
|
गेम मास्टर आपके लिए कैंपेन नहीं बना सकता: `init` से पहले आपके एजेंट को कुछ पता नहीं होता कि RPG Engine कहाँ है।
|
|
64
64
|
|
|
@@ -94,6 +94,7 @@ rpg init "The Salt Isles"
|
|
|
94
94
|
| **पासे** | आपके पासे कौन रोल करता है | digital, physical |
|
|
95
95
|
| **इकाइयाँ** | दूरी और वज़न | metric, imperial |
|
|
96
96
|
| **किरदारों की आवाज़ें** | आपको मिलने वाले किरदारों की ओर से कौन बोलता है, गेम मास्टर से लेकर किरदारों तक: हमेशा गेम मास्टर; अहम मौकों पर खुद वह किरदार, जो सिर्फ़ वही जानता है जो उसे पता है, जैसा गेम मास्टर चुने; या हमेशा किरदार, मुख्य किरदारों के लिए या सबके लिए, जो धीमा और महँगा है, जहाँ आपका AI ऐप यह कर सके | the master, sometimes, main characters, everyone |
|
|
97
|
+
| **आपका किरदार** | सेशन ज़ीरो में आपका किरदार कैसे बनता है | with the master, by the master, your own ([2.7](#27-session-zero-your-character)) |
|
|
97
98
|
| **साथी** | आपके साथ कौन सफ़र करता है | none, made with you, made by the master, met in play |
|
|
98
99
|
| **चित्र** | जगहों, मिशनों और आपको मिलने वालों के चित्र | none, on request, new places, quests and those you meet ([3.11](#311-pictures)) |
|
|
99
100
|
| **सीमा-रेखाएँ** और **पर्दे** | क्या कभी नहीं दिखता, और क्या सिर्फ़ पर्दे के पीछे होता है | सूचियाँ |
|
|
@@ -101,13 +102,15 @@ rpg init "The Salt Isles"
|
|
|
101
102
|
|
|
102
103
|
पाँचवाँ संस्करण **उन्नति** जोड़ता है: अनुभव अंक या मील के पत्थर।
|
|
103
104
|
|
|
104
|
-
अगर कोई लिखी हुई दुनिया नहीं है, तो गेम मास्टर एक **कथानक** भी पूछता है (शैली, मिज़ाज, कुछ तत्व, और खेल में आपको सबसे ज़्यादा क्या पसंद है, जैसे लड़ाई, रहस्य, बातचीत या खोज, आपके अपने शब्दों में)
|
|
105
|
+
अगर कोई लिखी हुई दुनिया नहीं है, तो गेम मास्टर एक **कथानक** भी पूछता है (शैली, मिज़ाज, कुछ तत्व, और खेल में आपको सबसे ज़्यादा क्या पसंद है, जैसे लड़ाई, रहस्य, बातचीत या खोज, आपके अपने शब्दों में), **तैयारी**: दुनिया को खेलते-खेलते बनाना, या सब कुछ शुरू में; और **अवधि**: एक शाम, कुछ सेशन (तीन से पाँच शामें), या खुली, एक के बाद एक रोमांच। तय अवधि वाली कहानी के अंत में आप हमेशा आगे खेल सकते हैं।
|
|
105
106
|
|
|
106
107
|
**गेम मास्टर की शैली** कभी पूछी नहीं जाती, पर आप उसे चैट में या **सेटिंग्स** में बदल सकते हैं: **गद्य** (सादा, साहित्यिक, पल्प, चुटीला), उसकी गढ़ी **कहानियाँ** (हालात, कथा-चाप, कड़ियाँ, रहस्य), **किसकी तरह लिखें** यानी कोई लेखक, या **आपके शब्दों में** कुछ भी।
|
|
107
108
|
|
|
108
109
|
### 2.7 सेशन ज़ीरो: आपका किरदार
|
|
109
110
|
|
|
110
|
-
आप गेम मास्टर के साथ अपना किरदार बनाते हैं, जैसे टेबल पर बैठकर। हर चुनाव आपका है, जब तक आप गेम मास्टर से उसे करने को न कहें: पूरे विचार के साथ आएँ, अधूरे के साथ, या बिना किसी विचार
|
|
111
|
+
आप गेम मास्टर के साथ अपना किरदार बनाते हैं, जैसे टेबल पर बैठकर। हर चुनाव आपका है, जब तक आप गेम मास्टर से उसे करने को न कहें: पूरे विचार के साथ आएँ, अधूरे के साथ, या बिना किसी विचार के; या गेम मास्टर से कहें कि वह कुछ शब्दों से सब कुछ बना दे। लेवल वाले खेल में गेम मास्टर पूछता है कि आप किस लेवल से शुरू करना चाहते हैं: पहले से, जब तक आप कोई और न चाहें। कोई भी पासा रोल करने से पहले गेम मास्टर बताता है कि एबिलिटी स्कोर कैसे बनते हैं। आपकी कहानी ज़रूरी कभी नहीं होती; अगर आप देते हैं, तो गेम मास्टर उसे आपके शब्दों में लिखता है। फिर गेम मास्टर आपके किरदार की तस्वीर माँगता है ([3.7](#37-your-characters-story-and-picture))। कैरेक्टर शीट RPG Engine तैयार करता है: हिसाब-किताब आपको कभी नहीं करना पड़ता।
|
|
112
|
+
|
|
113
|
+
क्या आपके पास पहले से कोई किरदार है, किसी दूसरे खेल या दूसरे कैंपेन से? सेटअप में **मेरे पास पहले से है** चुनें और उसे गेम मास्टर को दें: कैरेक्टर शीट चैट में पेस्ट करें, या बताएँ कि उसकी फ़ाइल आपके कंप्यूटर में कहाँ है (PDF, तस्वीर, टेक्स्ट)। गेम मास्टर उसे जैसा है वैसा ही, उसके लेवल पर लिखता है, उसे नियमों और दुनिया से मिलाकर जाँचता है, और जो कुछ मेल नहीं खाता, उस पर आपके साथ सहमति बनाता है।
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -304,6 +307,8 @@ RPG Engine इसी फ़ोल्डर में रहता है: वह
|
|
|
304
307
|
|
|
305
308
|
**गेम मास्टर को खेल की जानकारी नहीं लगती।** आपके एजेंट ने RPG Engine लोड नहीं किया। जाँचें कि आपने उसे कैंपेन फ़ोल्डर में शुरू किया और उस पर भरोसा किया। Claude Code में `/mcp` लिखें और `rpg` को फिर से जोड़ें। Codex में, कैंपेन फ़ोल्डर में `codex mcp list` को `rpg` दिखाना चाहिए। अगर `rpg --version` नहीं मिलता, तो RPG Engine फिर से इंस्टॉल करें ([2.2](#22-install))।
|
|
306
309
|
|
|
310
|
+
**Windows को `claude` नहीं मिलता।** इसका इंस्टॉलर पीले नोट में यह बताता है, साथ में वह फ़ोल्डर भी जिसमें वह गया: उस फ़ोल्डर को PATH में जोड़ें (System Properties > Environment Variables), फिर नया टर्मिनल खोलें।
|
|
311
|
+
|
|
307
312
|
**अपडेट करना।** `npm install -g rpg-engine` फिर से चलाएँ, फिर नई चैट खोलें: चलता हुआ गेम मास्टर उसी संस्करण पर रहता है जिससे वह शुरू हुआ था।
|
|
308
313
|
|
|
309
314
|
**गेम मास्टर को कुछ ऐसा याद है जो मैंने रद्द किया।** नई चैट खोलें और सेव में **मैंने नई चैट खोल ली है** दबाएँ।
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,
|
|
1
|
+
<!-- Translated from en.md, paragraph by paragraph, by npm run translate: cdcc612c,e51b18d7,be38a186 f2f35057,51f49a5b 128c5761,5e6cbafc,48febcc7,f0f71376,b1381f21,cb3f91d5 5faea867,7780116a,afad321d,99406ef2,f831ecd8,b6a6bfff,b5544596,5c016bb1,3afa0abc,ef6b72c1,bc923cc3,07c079ea,30f9af2f,60051919,8619db5f,06d7d789,e6f82f9e,6def7d66,f27372ca,d904fdec,8da0dbd5,1c13fe15,de62cd09,1aa7894f,56b73d9b,d9fbeec2,74dc52f1,a2da9de6,cb3f91d5 09eaf555,63d0c1fb,27c765d2,46692547,e2d161a6,25f9bdf8,d8c01f15,b0846f60,602a5e46,6fee496f,71124663,4bed5644,c2bbeff9,3de0391e,15e36217,cb7d8189,b2a29c8a,056b4e29,2ef22287,d61653a8,e47ab79b,f4c26681,20018bab,6c58220c,5f7b18e6,6a64e757,ad3fa941,57283bd2,e9fa262a,44639926,86179abe,323d8fa3,f8d6b2fd,18bc17d2,3bbb14f4,2b2d7c37,65ff2775,623c2986,0fac97e5,d3afc486,cb3f91d5 ec2eeb06,92e343cc,aa0e26a1,da0fad21,cb3f91d5 5dafa85b,c5ec9f44,2e849e73,35a85f2e,607c7f74,95ffeabc,7687ded0,4ee5ae41,fd2934d1,177ddff0,025009be,c8315e19,cb3f91d5 40941750,f3b2d1f6,cb3f91d5 30c03e82,209b159b,6ea1911c,b8e71497,32482cb4,65c75baa,cb3f91d5 eac34391,4ee44b3b,487e04c0,c6ebe0c0,cb3f91d5 2f86bef9,9402592c,cb3f91d5 519ce5ee,de58bc03,b830ae6c,697b0622,180f77d8,e0f88bdb,1e0ccfed,05fde17f,5070d986,891d9bc7,5b0bb1d2,600db53a,6b115391,5db3836c,252805d8,df64a3bb,e214ff4a. Change the English, then run it again. -->
|
|
2
2
|
# RPG Engine: a teljes útmutató
|
|
3
3
|
|
|
4
4
|
Az **RPG Engine** lehetővé teszi, hogy asztali szerepjátékot játssz egy **MI mesélővel**. A mesélővel egy **csevegésben** beszélgetsz; az RPG Engine a háttérben dolgozik: **emlékszik a világra**, **dob a kockákkal** és **vezeti a számokat**. A csevegés mellett egy oldalt tartasz nyitva a böngészőben, ez a **vezérlőpult**, rajta a karakterlapoddal, a kockákkal, a térképekkel és a naplóddal.
|
|
@@ -9,8 +9,8 @@ Az útmutató játékosoknak szól: nem kell tudnod programozni.
|
|
|
9
9
|
|
|
10
10
|
1. Telepítsd a **Node.js**-t a [nodejs.org](https://nodejs.org) oldalról (az LTS verziót).
|
|
11
11
|
2. Telepíts egy **MI-ügynököt**, azt a programot, amelyben a mesélő fut, és jelentkezz be: például Claude Code vagy Codex ([2.4](#24-connect-your-ai)).
|
|
12
|
-
3. Egy új terminálban, amelyet a Node.js telepítése után nyitottál, telepítsd az RPG Engine-t: `npm install -g rpg-engine`.
|
|
13
|
-
4.
|
|
12
|
+
3. Egy új terminálban, amelyet a Node.js telepítése után nyitottál, telepítsd az RPG Engine-t: `npm install -g rpg-engine`. Ha a Windows azt válaszolja, hogy a szkriptek futtatása le van tiltva, írd be egyszer: `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`, válaszolj igennel, és próbáld újra.
|
|
13
|
+
4. Nyisd meg a terminált abban a mappában, ahol a játékaidat tartod (kattints rá jobb gombbal, **Megnyitás a Terminalban**), és hozz létre egy kampányt, mindig a nevével: `rpg init "The Salt Isles"`. Az RPG Engine két angol sorral válaszol: minden rendben.
|
|
14
14
|
5. Lépj be az új mappába: `cd "The Salt Isles"`, és indítsd el ott az ügynöködet: `claude` a Claude Code-hoz, `codex` a Codexhez. Mondj igent, amikor megkérdezi, megbízol-e a mappában ([2.4](#24-connect-your-ai)), aztán írd be: *Szia! Kezdjünk bele.* A mesélő válaszul megadja a vezérlőpulted linkjét.
|
|
15
15
|
|
|
16
16
|
## 1. Mi az az RPG Engine <!-- icon: about -->
|
|
@@ -48,7 +48,7 @@ A játék egy játékrendszerrel érkezik, egy csomaggal, amelyet a mesélő tel
|
|
|
48
48
|
npm install -g rpg-engine
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
Az `rpg --version` parancs megmutatja, hogy sikerült-e. Az `rpg` parancsot kampányonként egyszer használod, a létrehozáshoz. Ezután az ügynököd magától elindítja az RPG Enginet.
|
|
51
|
+
Az `rpg --version` parancs megmutatja, hogy sikerült-e. Ha az npm felajánlja, hogy frissíti magát, nyugodtan figyelmen kívül hagyhatod. Az `rpg` parancsot kampányonként egyszer használod, a létrehozáshoz. Ezután az ügynököd magától elindítja az RPG Enginet. Az `rpg` önmagában semmit sem nyit meg: a vezérlőpultot a mesélő adja meg.
|
|
52
52
|
|
|
53
53
|
### 2.3 Kampány létrehozása
|
|
54
54
|
|
|
@@ -58,7 +58,7 @@ Nyiss egy terminált abban a mappában, ahol a játékaidat tartod (a [2.1](#21-
|
|
|
58
58
|
rpg init "The Salt Isles"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
|
-
Ez létrehozza a `The Salt Isles` mappát egy új kampánnyal. Lépj be a `cd "The Salt Isles"` paranccsal. Jegyezd meg, hol van: minden játékalkalommal ide térsz vissza. Mindent másról később döntesz, a chaten vagy a vezérlőpulton.
|
|
61
|
+
Ez létrehozza a `The Salt Isles` mappát egy új kampánnyal. Lépj be a `cd "The Salt Isles"` paranccsal. Mindig írd be a nevet: név nélkül az a mappa lesz a kampány, amelyben éppen vagy, amellett, ami már benne van. Jegyezd meg, hol van: minden játékalkalommal ide térsz vissza. Mindent másról később döntesz, a chaten vagy a vezérlőpulton.
|
|
62
62
|
|
|
63
63
|
A mesélő nem tud kampányt létrehozni neked: az `init` előtt semmi sem mondja meg az ügynöködnek, hol van az RPG Engine.
|
|
64
64
|
|
|
@@ -93,7 +93,8 @@ A mesélő csak azt kérdezi, ami még hiányzik, egyszerre néhány kérdést.
|
|
|
93
93
|
| **Szigor** | Mennyire követik szigorúan a szabályokat az étel, a fény és az utazás | gördülékeny, szabályok, szimuláció |
|
|
94
94
|
| **Kockák** | Ki dobja a kockáidat | digitális, fizikai |
|
|
95
95
|
| **Mértékegységek** | Távolságok és súlyok | metrikus, birodalmi |
|
|
96
|
-
| **Karakterhangok** | Ki beszél a megismert karakterek helyett
|
|
96
|
+
| **Karakterhangok** | Ki beszél a megismert karakterek helyett, a mesélőtől a karakterekig: mindig a mesélő; kulcspillanatokban maga a karakter, csak azt tudva, amit ő tud, ahogy a mesélő választja; vagy mindig a karakter, a fontosaknál vagy mindenkinél, lassabban és drágábban, ahol az AI-alkalmazásod tudja | a mesélő, néha, fontos karakterek, mindenki |
|
|
97
|
+
| **A karaktered** | Hogyan készül a karaktered a nulladik alkalmon | a mesélővel, a mesélő által, saját ([2.7](#27-session-zero-your-character)) |
|
|
97
98
|
| **Társak** | Ki utazik veled | senki, veled közösen alkotott, a mesélő alkotta, játékban megismert |
|
|
98
99
|
| **Képek** | Képek a helyszínekről, küldetésekről és a megismert karakterekről | nincs, kérésre, új helyszínek, küldetések és megismert karakterek ([3.11](#311-pictures)) |
|
|
99
100
|
| **Határok** és **Fátylak** | Ami soha nem jelenik meg, és ami csak a színfalak mögött történik | listák |
|
|
@@ -101,13 +102,15 @@ A mesélő csak azt kérdezi, ami még hiányzik, egyszerre néhány kérdést.
|
|
|
101
102
|
|
|
102
103
|
Az ötödik kiadás hozzáadja a **fejlődést**: tapasztalati pontokat vagy mérföldköveket.
|
|
103
104
|
|
|
104
|
-
Ha nincs megírt világ, a mesélő egy **alaphelyzetet** is kérdez (műfaj, hangulat, néhány elem, és hogy mit élvezel a legjobban egy játékban, például a harcot, a rejtélyeket, a beszélgetést vagy a felfedezést, a saját szavaiddal),
|
|
105
|
+
Ha nincs megírt világ, a mesélő egy **alaphelyzetet** is kérdez (műfaj, hangulat, néhány elem, és hogy mit élvezel a legjobban egy játékban, például a harcot, a rejtélyeket, a beszélgetést vagy a felfedezést, a saját szavaiddal), az **előkészítést**: menet közben építse a világot, vagy az elején mindet; és a **hosszt**: egy este, néhány alkalom (három-öt este), vagy nyitott, egyik kaland a másik után. Egy meghatározott hosszúságú történet végén mindig folytathatod.
|
|
105
106
|
|
|
106
107
|
**A mesélő stílusát** sosem kérdezi, de megváltoztathatod a chaten vagy a **Beállítások** között: a **próza** (egyszerű, irodalmi, pulp, szárazon szellemes), az általa kitalált **történetek** (helyzetek, ívek, epizódok, rejtély), egy szerző, akihez hasonlóan **írjon**, vagy bármi más, **a te szavaiddal**.
|
|
107
108
|
|
|
108
109
|
### 2.7 Nulladik alkalom: a karaktered
|
|
109
110
|
|
|
110
|
-
A karaktered a mesélővel együtt alkotod meg, mint az asztalnál. Minden döntés a tiéd, hacsak nem kéred meg a mesélőt, hogy döntsön helyetted: jöhetsz kész ötlettel, homályossal vagy semmivel. A mesélő elmondja, hogyan készülnek a képességpontok,
|
|
111
|
+
A karaktered a mesélővel együtt alkotod meg, mint az asztalnál. Minden döntés a tiéd, hacsak nem kéred meg a mesélőt, hogy döntsön helyetted: jöhetsz kész ötlettel, homályossal vagy semmivel; vagy kérheted a mesélőt, hogy néhány szóból készítse el az egészet. Szintekkel játszott játékban a mesélő megkérdezi, melyik szinttől indulsz: az elsőtől, hacsak nem akarsz másikat. A mesélő még azelőtt elmondja, hogyan készülnek a képességpontok, hogy bármelyik kockát eldobnád. A történeted sosem kötelező; ha adsz egyet, a mesélő a te szavaiddal írja le. Ezután a mesélő képet kér a karakteredről ([3.7](#37-your-characters-story-and-picture)). Az RPG Engine kiszámolja a karakterlapot: te sosem számolsz.
|
|
112
|
+
|
|
113
|
+
Van már karaktered, egy másik játékból vagy egy másik kampányból? Válaszd a beállításnál a **Már van egy** lehetőséget, és add oda a mesélőnek: illeszd be a karakterlapot a chatbe, vagy mondd meg, hol van a fájlja a számítógépeden (PDF, kép, szöveg). A mesélő úgy írja le, ahogy van, a saját szintjén, összeveti a szabályokkal és a világgal, és megbeszéli veled, ami nem illik bele.
|
|
111
114
|
|
|
112
115
|
---
|
|
113
116
|
|
|
@@ -304,6 +307,8 @@ A mesélő által használt minden parancs a kampánymappában is futtatható: a
|
|
|
304
307
|
|
|
305
308
|
**A mesélő nem ismeri a játékot.** Az ügynököd nem töltötte be az RPG Engine-t. Ellenőrizd, hogy a kampány mappájában indítottad el, és megbíztál benne. Claude Code-ban írd be: `/mcp`, és csatlakoztasd újra az `rpg`-t. Codexben a `codex mcp list` parancsnak a kampány mappájában mutatnia kell az `rpg`-t. Ha az `rpg --version` nem található, telepítsd újra az RPG Engine-t ([2.2](#22-install)).
|
|
306
309
|
|
|
310
|
+
**A Windows nem találja a `claude`-ot.** A telepítője ezt egy sárga megjegyzésben jelzi, és megadja a mappát is, ahová települt: add hozzá ezt a mappát a PATH-hoz (Rendszertulajdonságok > Környezeti változók), aztán nyiss egy új terminált.
|
|
311
|
+
|
|
307
312
|
**Frissítés.** Futtasd újra az `npm install -g rpg-engine` parancsot, aztán nyiss új csevegést: a már futó mesélő azt a verziót tartja, amellyel elindult.
|
|
308
313
|
|
|
309
314
|
**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.
|