rpg-engine 0.0.0-stage → 0.1.1

package/dist/dashboard/guide/en.md

@@ -0,0 +1,307 @@
+# RPG Engine: the complete guide
+
+**RPG Engine** lets you play a tabletop role-playing game with an **AI as your game master**. You talk with the master in a **chat**; RPG Engine works behind the scenes: it **remembers the world**, **rolls the dice** and **keeps the accounts**. Beside the chat you keep a page open in your browser, the **dashboard**, with your sheet, the dice, the maps and your journal.
+
+This guide is for players: you do not need to know how to program.
+
+## Quick start <!-- icon: send -->
+
+1. Install **Node.js** from [nodejs.org](https://nodejs.org) (the LTS version).
+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)).
+3. In a terminal, install RPG Engine: `npm install -g rpg-engine`.
+4. Create a campaign: `rpg init "The Salt Isles"`.
+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.
+
+## 1. What RPG Engine is <!-- icon: about -->
+
+| Who | What they do |
+|---|---|
+| **You** | You play your character: what they do, say and try. |
+| **The master** (the AI) | Tells the story, plays everyone else, decides what happens, asks for rolls. |
+| **RPG Engine** | Keeps the world in files, rolls the dice, counts hit points, money, time and distances, keeps secrets until you discover them. |
+
+The world stays the same from one evening to the next, even in a new chat, even with a different AI:
+
+- **What has been said stays true.** A dead villain stays dead.
+- **The dice are real.** The master cannot bend them, except at the easiest difficulty, if you choose it.
+- **Secrets stay secret.** The master never tells you what your character does not know.
+- **The world moves.** Threats advance while you rest or travel, and you see their signs.
+- **A campaign is a folder** on your computer: stop whenever you want, pick it up later.
+
+Today RPG Engine plays one game system, **fifth edition**, from the free System Reference Document 5.1. Others will come ([Coming later](#9-coming-later)).
+
+---
+
+## 2. Getting started <!-- icon: path -->
+
+### 2.1 What you need
+
+- A computer with Windows, macOS or Linux, and a web browser.
+- **Node.js 22** or newer, from [nodejs.org](https://nodejs.org). It brings `npm`, which installs RPG Engine.
+- A **terminal**: on Windows, Terminal or PowerShell; on macOS, Terminal. To open one in a folder, right-click the folder and choose **Open in Terminal** (Windows) or **Services > New Terminal at Folder** (macOS).
+- An **AI agent** for the master ([2.4](#24-connect-your-ai)), with the **largest model** it offers: a small model is easier to talk into revealing secrets or bending the rules.
+
+### 2.2 Install
+
+```text
+npm install -g rpg-engine
+```
+
+`rpg --version` checks that it worked. You use `rpg` once per campaign, to create it; after that your agent starts RPG Engine by itself.
+
+### 2.3 Create a campaign
+
+Open a terminal in the folder where you keep your games ([2.1](#21-what-you-need) says how):
+
+```text
+rpg init "The Salt Isles"
+```
+
+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; `rpg init --help` lists the options to choose some now, such as `--language it` or `--difficulty hard`.
+
+The master cannot create a campaign for you: before `init`, nothing tells your agent where RPG Engine is.
+
+### 2.4 Connect your AI
+
+The master runs in an **AI agent**: an AI app, in the terminal or on the desktop, that can work with the files on your computer, such as Claude Code or Codex. A plain chat such as claude.ai or ChatGPT, or a phone app, is not enough: the master needs to reach the campaign's files on your computer. Each agent needs its own plan and login: Claude Code a paid Claude plan, Codex a ChatGPT login. You install it once, from its own page: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: in the campaign folder write `claude`. When it asks whether you trust the folder, choose **Yes, I trust this folder**; careful, the answer already selected is *No, exit*.
+- **Codex**: in the campaign folder write `codex`, and say yes when it asks whether you trust the folder. In its desktop app, check in the settings that memories are off for the game's chats.
+- **Another agent**: start it in the campaign folder and give it the MCP server `rpg mcp`. RPG Engine is a standard MCP server: any agent that supports MCP can be the master, local ones included.
+
+We play and test it with **Claude Code**; **Codex** is connected and checked, but no whole campaign has been played with it yet; `init` also sets up **Gemini CLI**. The campaign turns off the agent's own memory: the game lives in its files, so that going back to a save really goes back.
+
+### 2.5 The first chat
+
+Write anything, such as *Hi! Let's start.* In its first answer of every chat the master gives you the **link to your dashboard**, something like `http://127.0.0.1:4750`: open it and keep it beside the chat.
+
+Between the master's messages your agent shows the tools it uses: do not open their details (in Claude Code, ctrl+o), they can show secrets.
+
+A new campaign goes through three stages, shown at the top of the dashboard: **1 Settings** (how you want to play), **2 Session zero** (you make your character, in play), **3 Play**.
+
+### 2.6 Settings: choosing how you play
+
+The master asks only what is still missing, a few questions at a time; the dashboard's **Settings** step shows the same questions as cards. Write "you decide" and the master chooses. Everything can change later, in the chat or in **Settings**.
+
+| Setting | What it decides | Values |
+|---|---|---|
+| **Mentor** | How much the master teaches you the rules | off, hints, tutorial |
+| **Difficulty** | How hard the world plays | story, easy, normal, hard, brutal |
+| **Lethality** | What falling in a fight means | narrative (never die), epic (only when it matters), dice |
+| **Saves** | When you may go back | permadeath, checkpoint, free ([3.8](#38-saves-and-going-back)) |
+| **Rigor** | How closely food, light and travel follow the rules | smooth, rules, simulation |
+| **Dice** | Who rolls your dice | digital, physical |
+| **Units** | Distances and weights | metric, imperial |
+| **Companions** | Who travels with you | none, made with you, made by the master, met in play |
+| **Pictures** | Pictures of places, quests and those you meet | none, on request, new places, quests and those you meet ([3.11](#311-pictures)) |
+| **Lines** and **Veils** | What never appears, and what happens only off screen | lists |
+| **Language** | The game's and the dashboard's language | any |
+
+Fifth edition adds **advancement**: experience points or milestones.
+
+Without a written world, the master also asks a **premise** (genre, tone, a few elements, in your words) and the **preparation**: build the world on the fly, as you go, or all at the start.
+
+**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**.
+
+### 2.7 Session zero: your character
+
+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.
+
+---
+
+## 3. Playing <!-- icon: chat -->
+
+### 3.1 Talking with the master
+
+Write what your character does or says, in your own words:
+
+> I ask the innkeeper who else came through tonight.
+
+Out of the story, write between square brackets: *[How does grappling work?]* The master answers in brackets too.
+
+You say what you try; the master says what happens. The master never decides for your character, and never talks about the engine. You can ask it how to use the dashboard.
+
+### 3.2 Rolls
+
+The master asks for a roll only when the outcome is uncertain and matters, and says first what is at stake. Then:
+
+- **On the dashboard**, a banner shows a button for each check, such as *Acrobatics +4 · with advantage*. Click it: the dice fall on the page and the master hears the result. You can also click the line of your sheet that lights up, throw the dice from the tray, or write something else in the banner.
+- **By hand**, in the banner's corner or in **Settings**: the banner tells you what to roll, and you roll it from your sheet or the tray.
+- **Physical dice**, with the dice setting on physical: you write the faces you rolled, *[I rolled a 14.]*, and RPG Engine adds your modifiers.
+
+**Free rolls**: click any number on your sheet, or open the tray, to roll for fun. They never count and the master never sees them.
+
+**The master's rolls** show in your roll column, except the secret ones. You can always ask *[Was that roll real?]*: for a secret roll the master gives a fingerprint that proves it was made before you asked.
+
+### 3.3 Scenes and fights
+
+The story runs in **scenes**: a fight, a conversation, exploring, travelling, a rest. At the end of each scene the game saves by itself, and the scene goes into your journal.
+
+In a fight the master tells every turn that is not yours, and stops where you can decide. The **Combat** section shows the order of the turns, your party's hit points and how hurt the enemies look, in words. If your character falls, the death saves appear large on the page.
+
+### 3.4 Time, travel and the world that moves
+
+RPG Engine keeps the date; no time passes between sessions. Say you rest, *We take a long rest*, and the rest brings back what it should. Say where you go, *We take the road north to Rocca*, and RPG Engine works out the way, the distance and the days, stopping when something happens on the way. Money is counted in the game's coins, change included.
+
+Villains have plans with deadlines. Each new day the master moves the threats that time has advanced, and you see their signs, never the clock itself.
+
+### 3.5 Maps
+
+**World** shows the places your character knows, the roads between them and the trail you walked, with fog over the rest. **Scene** shows the map of the place where you are, when it has one, with who stands where; in a fight, on your turn, the squares you cannot reach are veiled. When the master asks where you move, touch a square, or write it, such as *E4*.
+
+### 3.6 Quests, journal and notes
+
+A task your character takes becomes a quest in the **Journal**, with its goals, its deadline and what it measures; star it to keep it in view at the top of Scene. The Journal also tells your **story**, scene by scene, and keeps your **notes**: private, unless you **Share** one, which the master hears as what you think, never as a fact.
+
+### 3.7 Your character's story and picture
+
+On your sheet, the **Description** card has a box for your character's story: the master writes it in, after you say yes. For a picture, give the master a file (PNG, JPEG, WebP or SVG, up to 5 MB) with where it is on your computer, or have a portrait made ([3.11](#311-pictures)): *[Make me a portrait: grey hair in a braid, a scar on the chin.]*
+
+### 3.8 Saves and going back
+
+RPG Engine saves the whole campaign at the end of every scene. The **saves** setting decides the rest:
+
+| Saves | Save when you want | Go back |
+|---|---|---|
+| **permadeath** | no | never |
+| **checkpoint** | no | to the last save, only when your character dies |
+| **free** | yes | to any save |
+
+In every mode you can **start over**, from the start of play or from session zero. Do it in the chat or in **Saves**.
+
+After going back, **open a new chat**: the old one remembers what was undone. Write *continue* in the new chat, then press **I opened a new chat** in Saves.
+
+### 3.9 Sessions: stopping and coming back
+
+Stop whenever you want: *[Let's stop here for tonight.]* Everything is already saved in the files. To come back, start your agent in the campaign folder and write *continue*: the master gives you a short recap and goes on.
+
+### 3.10 The master's mood
+
+The robot at the top of the dashboard is the master: its face follows the tone of the story, and never gives away what you do not know yet. When the chat is closed, it sleeps.
+
+### 3.11 Pictures
+
+RPG Engine can have pictures made of the places you reach, the quests you take and those you meet, as the **pictures** setting says, and your character's portrait when you ask. It uses what is on your computer, with your own login: **Codex** paints them, otherwise **Claude Code** draws them. **Settings** says whether this computer can make them, and how to set it up if not. You can always give the master a picture of your own.
+
+### 3.12 Safety: lines, veils and stop
+
+**Lines** never appear in the game; **veils** happen only off screen. At any moment write *[stop]*: the master drops that content at once and adds it to your lines.
+
+### 3.13 Changing your mind
+
+Every setting can change, in the chat or in **Settings**. A ruling the master makes without the book becomes a **precedent**, so the same question gets the same answer next time.
+
+---
+
+## 4. The dashboard <!-- icon: party -->
+
+A page on your own computer, open only in that computer's browser, live while the chat is open. When the chat closes, it shows *Not connected*; it comes back by itself with the next chat.
+
+- **Party**: your sheet and your companions'. Click a number to roll it; hover over it to see where it comes from. Beside it, the rolls.
+- **Scene**: where you are, its picture and map, who is there, what is happening.
+- **Combat**: only in a fight: the turns, the fighters, what you have at hand.
+- **Journal**: quests, the story, your notes.
+- **World**: the world map as your character knows it.
+- **The dice tray**: choose dice and a modifier, and throw.
+- **Saves**, **Help**, **Settings** and **About**, as icons at the end of the row. Settings also holds the page's own preferences: theme, dice sound, dice set.
+
+When the master asks you something, its banner stays at the top, whatever section you are in.
+
+---
+
+## 5. Game systems and house rules <!-- icon: dice -->
+
+### 5.1 What a game system is
+
+The data of one game: its sheet, its numbers, its creatures, items, spells and rules text. Each campaign plays one system. RPG Engine works out the sheet and what is spent and comes back; how a feature works, the master reads in the rules and decides, as at a table.
+
+### 5.2 Fifth edition, included
+
+The races, classes, subclasses, a background and a feat of the SRD 5.1; the 319 spells, the weapons, armor, magic items and monsters; the rules chapters, which the master reads by their exact text; the full sheet, worked out.
+
+You can also play content the SRD lacks, from a book you own: the master writes it as pages of your campaign, and RPG Engine treats them as its own. RPG Engine ships only open content; what your master knows is not limited.
+
+### 5.3 House rules and your own additions
+
+Ask the master: *[House rule: a natural 1 on an attack means you drop your weapon.]* It keeps it as an agreement of the table, or writes a page or a number of the sheet when one is needed. House rules already written out can go as text files in the campaign's `rules` folder.
+
+### 5.4 Adding or importing your own game system
+
+Not yet: today RPG Engine plays only fifth edition ([Coming later](#9-coming-later)).
+
+---
+
+## 6. Extensions <!-- icon: plus -->
+
+Not yet. An extension will add something to a campaign on top of its game system: a world, an adventure, a feature such as the weather, house rules to share.
+
+---
+
+## 7. Where a campaign comes from, and its language <!-- icon: world -->
+
+### 7.1 Three ways to have a world
+
+- **Made on the fly**: from your premise, the master builds each place, person and plot just before you need it, and keeps it.
+- **Prepared at the start**: the same, with the world built before play.
+- **From your own adventure**: give the master a text or a PDF and ask it to set it up, *[Set up this adventure as our campaign. Don't tell me anything that's in it.]* It writes the places, the characters and the secrets. There is no import button yet.
+
+A campaign is played once: to play the same adventure again, create a new campaign.
+
+### 7.2 Languages
+
+One language per campaign, the master's, which the dashboard follows. The dashboard ships 26 languages. Any other is translated on your computer by Codex or Claude Code, or, without them, by the master in the chat. Fifth edition's terms in Italian come from the official Italian SRD; the rules text stays in English, and the master tells it in your language.
+
+---
+
+## 8. For the curious: the campaign folder <!-- icon: list -->
+
+You never need to open it, and it holds the secrets of your campaign. It has `campaign.yaml` (your settings), `state.yaml` (where the game stands), `world/` (one markdown page for each character, place, quest and the rest), `rules/` (your house rules), `images/`, `log.jsonl` (every change), `.saves/`, `.player/` (your notes), and the small files that tell AI agents where RPG Engine is. The pages use Obsidian's format. If you change a page by hand, the master hears of it at its next answer.
+
+RPG Engine stays in this folder: it reads and writes the game only here, and never touches your other files. Outside it, it keeps only a data folder of its own (the dashboard's translations, and Codex or Claude Code if you let it install them) and temporary folders while a picture is drawn. Anything else your agent wants to do on your computer, it asks you first.
+
+Every command the master uses can be run in the campaign folder too: `rpg --help` lists them. Many print the campaign's secrets.
+
+---
+
+## 9. Coming later <!-- icon: hourglass -->
+
+- **You as the game master**, with the AI playing the party.
+- **Author mode**: write an adventure with the AI, then export it and share it.
+- **Several players on the same computer**, each with their own character, taking turns in the same chat.
+- **Extensions**: settings, adventures, features and house rules.
+- **Importing** your manuals and adventures.
+- **Other games**: more game systems, and your own.
+
+---
+
+## 10. Questions and problems <!-- icon: info -->
+
+### Questions
+
+**Do I need to know the rules?** No. Choose the tutorial mentor, and ask between brackets whenever you want.
+
+**Can the master cheat?** It cannot change a roll RPG Engine made, except at difficulty story, nor facts already set.
+
+**Does it cost anything?** RPG Engine is free. The master runs on your agent's plan, or on your own computer with a local model. An evening of play is a long chat: on the smallest plans you may reach the plan's limit before the evening ends. Pictures and translations use the same plan.
+
+**Can I play on my phone?** No: the master runs on your computer, and the dashboard opens only there.
+
+**Can I play with friends?** Not yet: today one player, one character, plus companions ([Coming later](#9-coming-later)).
+
+**Can I use a different AI next time?** Yes: open the campaign in another agent and write *continue*.
+
+### Problems
+
+**The dashboard does not open.** Ask the master: `[What's the dashboard link?]`. It works only while a chat is open in that campaign, after the master's first answer.
+
+**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)).
+
+**Updating.** Run `npm install -g rpg-engine` again, then open a new chat: a running master keeps the version it started with.
+
+**The master remembers something I undid.** Open a new chat and press **I opened a new chat** in Saves.
+
+**No pictures appear.** Settings > Pictures says whether this computer can make them, and how.
+
+**Installing fails, or `rpg` will not start.** `node --version` must say 22 or newer. On Windows, keep RPG Engine and your campaigns out of paths that contain `&`.
+
+**The dashboard link changed.** Another program took the usual address; the master gives you the new link.

package/dist/dashboard/guide/es.md

@@ -0,0 +1,308 @@
+<!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 2020efdb f4fdeebb 80a7cfb9 23c5f59b b8f80c05 8c9f41da 0b4a6ef8 338535a6 728ca4a5 e2839149. Change the English, then run it again. -->
+# RPG Engine: la guía completa
+
+**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.
+
+Esta guía es para quienes juegan: no necesitas saber programar.
+
+## Inicio rápido <!-- icon: send -->
+
+1. Instala **Node.js** desde [nodejs.org](https://nodejs.org) (la versión LTS).
+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)).
+3. En una terminal, instala RPG Engine: `npm install -g rpg-engine`.
+4. Crea una campaña: `rpg init "The Salt Isles"`.
+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.
+
+## 1. Qué es RPG Engine <!-- icon: about -->
+
+| Quién | Qué hace |
+|---|---|
+| **Tú** | Juegas a tu personaje: lo que hace, dice e intenta. |
+| **El máster** (la IA) | Cuenta la historia, interpreta a todos los demás, decide qué ocurre y pide tiradas. |
+| **RPG Engine** | Guarda el mundo en archivos, tira los dados, cuenta los puntos de golpe, el dinero, el tiempo y las distancias, y mantiene los secretos hasta que los descubras. |
+
+El mundo es el mismo de una tarde a otra, incluso en un chat nuevo, incluso con otra IA:
+
+- **Lo que se ha dicho sigue siendo cierto.** Un villano muerto sigue muerto.
+- **Los dados son de verdad.** El máster no puede torcerlos, salvo en la dificultad más fácil, si la eliges.
+- **Los secretos siguen siendo secretos.** El máster nunca te cuenta lo que tu personaje no sabe.
+- **El mundo se mueve.** Las amenazas avanzan mientras descansas o viajas, y ves sus señales.
+- **Una campaña es una carpeta** en tu equipo: para cuando quieras y retómala más tarde.
+
+Hoy RPG Engine juega con un solo sistema de juego, la **quinta edición**, a partir del Documento de Referencia del Sistema 5.1, que es gratuito. Vendrán otros ([Próximamente](#9-coming-later)).
+
+---
+
+## 2. Primeros pasos <!-- icon: path -->
+
+### 2.1 Qué necesitas
+
+- Un equipo con Windows, macOS o Linux, y un navegador web.
+- **Node.js 22** o superior, desde [nodejs.org](https://nodejs.org). Incluye `npm`, que instala RPG Engine.
+- Una **terminal**: en Windows, Terminal o PowerShell; en macOS, Terminal. Para abrir una en una carpeta, haz clic derecho en la carpeta y elige **Abrir en Terminal** (Windows) o **Servicios > Nueva terminal en la carpeta** (macOS).
+- Un **agente de IA** para el máster ([2.4](#24-connect-your-ai)), con el **modelo más grande** que ofrezca: a un modelo pequeño le cuesta menos que lo convenzan de revelar secretos o de torcer las reglas.
+
+### 2.2 Instalar
+
+```text
+npm install -g rpg-engine
+```
+
+`rpg --version` comprueba que ha funcionado. Usas `rpg` una vez por campaña, para crearla; después tu agente inicia RPG Engine por sí solo.
+
+### 2.3 Crear una campaña
+
+Abre una terminal en la carpeta donde guardas tus juegos ([2.1](#21-what-you-need) explica cómo):
+
+```text
+rpg init "The Salt Isles"
+```
+
+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; `rpg init --help` muestra las opciones para elegir algunas ahora, como `--language it` o `--difficulty hard`.
+
+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.
+
+### 2.4 Conectar tu IA
+
+El máster se ejecuta 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 o Codex. Un chat sencillo como claude.ai o ChatGPT, o una aplicación del móvil, no basta: el máster necesita acceder a los archivos de la campaña en tu equipo. Cada agente necesita su propio plan e inicio de sesión: Claude Code, un plan de pago de Claude; Codex, una cuenta de ChatGPT. Se instala una sola vez, desde su propia página: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **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**; cuidado, la respuesta que aparece seleccionada es *No, exit*.
+- **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.
+- **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, incluidos los locales.
+
+Jugamos y probamos con **Claude Code**; **Codex** está conectado y comprobado, pero aún no se ha jugado con él una campaña entera; `init` también prepara **Gemini CLI**. 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.
+
+### 2.5 El primer chat
+
+Escribe lo que quieras, por ejemplo *Hola, ¡vamos a empezar!* En su primera respuesta de cada chat, el máster te da el **enlace a tu panel**, algo como `http://127.0.0.1:4750`: ábrelo y déjalo junto al chat.
+
+Entre los mensajes del máster, tu agente muestra las herramientas que usa: no abras sus detalles (en Claude Code, ctrl+o), pueden mostrar secretos.
+
+Una campaña nueva pasa por tres etapas, que se ven en la parte superior del panel: **1 Ajustes** (cómo quieres jugar), **2 Sesión cero** (creas tu personaje, jugando), **3 Juego**.
+
+### 2.6 Ajustes: elegir cómo juegas
+
+El máster pregunta solo lo que aún falta, unas pocas preguntas cada vez; el paso **Ajustes** del panel muestra las mismas preguntas como tarjetas. Escribe "decide tú" y el máster elige. Todo se puede cambiar después, en el chat o en **Ajustes**.
+
+| Ajuste | Qué decide | Valores |
+|---|---|---|
+| **Mentor** | Cuánto te enseña el máster las reglas | desactivado, pistas, tutorial |
+| **Dificultad** | Lo duro que es el mundo | historia, fácil, normal, difícil, brutal |
+| **Letalidad** | Qué significa caer en un combate | narrativa (nunca mueres), épica (solo cuando importa), dados |
+| **Partidas guardadas** | Cuándo puedes volver atrás | muerte permanente, punto de control, libre ([3.8](#38-saves-and-going-back)) |
+| **Rigor** | Con qué fidelidad siguen las reglas la comida, la luz y los viajes | fluido, reglas, simulación |
+| **Dados** | Quién tira tus dados | digitales, físicos |
+| **Unidades** | Distancias y pesos | métricas, imperiales |
+| **Compañeros** | Quién viaja contigo | ninguno, creados contigo, creados por el máster, encontrados en el juego |
+| **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)) |
+| **Líneas** y **Velos** | Lo que nunca aparece y lo que ocurre solo fuera de escena | listas |
+| **Idioma** | El idioma del juego y del panel | cualquiera |
+
+La quinta edición añade el **avance**: puntos de experiencia o hitos.
+
+Si no hay un mundo escrito, el máster también pregunta una **premisa** (género, tono, algunos elementos, con tus palabras) y la **preparación**: construir el mundo sobre la marcha, mientras juegas, o todo al principio.
+
+**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 quien **escribir al estilo**, o cualquier otra cosa **con tus palabras**.
+
+### 2.7 Sesión cero: tu personaje
+
+Creas tu personaje con el máster, como en una mesa. Todas las decisiones son tuyas, salvo que le pidas al máster que las tome: ven con una idea completa, con una vaga o con nada. El máster te explica cómo se generan las puntuaciones de característica antes de tirar ningún dado. Tu historia nunca es obligatoria; si das una, el máster la escribe con tus palabras. Después, el máster te pregunta por una imagen de tu personaje ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcula la ficha: nunca haces las cuentas.
+
+---
+
+## 3. Jugar <!-- icon: chat -->
+
+### 3.1 Hablar con el máster
+
+Escribe lo que hace o dice tu personaje, con tus propias palabras:
+
+> Le pregunto al posadero quién más ha pasado esta noche.
+
+Para hablar fuera de la historia, escribe entre corchetes: *[¿Cómo funciona el agarre?]* El máster también responde entre corchetes.
+
+Tú dices lo que intentas; el máster dice lo que ocurre. El máster nunca decide por tu personaje y nunca habla del motor. Puedes preguntarle cómo se usa el panel.
+
+### 3.2 Tiradas
+
+El máster pide una tirada solo cuando el resultado es incierto e importa, y dice primero qué está en juego. Entonces:
+
+- **En el panel**, un aviso muestra un botón para cada prueba, como *Acrobacias +4 · con ventaja*. Haz clic: los dados caen en la página y el máster oye el resultado. También puedes hacer clic en la línea de tu ficha que se ilumina, tirar los dados desde la bandeja de dados o escribir otra cosa en el aviso.
+- **Manual**, en la esquina del aviso o en **Ajustes**: el aviso te dice qué tirar, y lo tiras desde tu ficha o desde la bandeja de dados.
+- **Dados físicos**, con el ajuste de dados en físicos: escribes las caras que han salido, *[He sacado un 14.]*, y RPG Engine suma tus modificadores.
+
+**Tiradas libres**: haz clic en cualquier número de tu ficha, o abre la bandeja de dados, para tirar por diversión. Nunca cuentan y el máster no las ve.
+
+**Las tiradas del máster** aparecen en tu columna de tiradas, salvo las secretas. Siempre puedes preguntar *[¿Esa tirada fue real?]*: en una tirada secreta, el máster te da una huella que prueba que se hizo antes de que preguntaras.
+
+### 3.3 Escenas y combates
+
+La historia avanza en **escenas**: un combate, una conversación, una exploración, un viaje, un descanso. Al final de cada escena la partida se guarda sola, y la escena pasa a tu diario.
+
+En un combate, el máster cuenta todos los turnos que no son tuyos y se detiene donde puedes decidir. La sección **Combate** muestra el orden de los turnos, los puntos de golpe de tu grupo y, con palabras, lo malheridos que parecen los enemigos. Si tu personaje cae, las salvaciones de muerte aparecen en grande en la página.
+
+### 3.4 Tiempo, viajes y el mundo que se mueve
+
+RPG Engine lleva la fecha; no pasa tiempo entre sesiones. Di que descansas, *Hacemos un descanso largo*, y el descanso devuelve lo que debe. Di adónde vas, *Tomamos el camino del norte hacia Rocca*, y RPG Engine calcula el trayecto, la distancia y los días, y se detiene cuando ocurre algo por el camino. El dinero se cuenta en las monedas del juego, con el cambio incluido.
+
+Los villanos tienen planes con plazos. Cada día nuevo, el máster mueve las amenazas que el tiempo ha hecho avanzar, y ves sus señales, nunca el reloj en sí.
+
+### 3.5 Mapas
+
+**Mundo** muestra los lugares que tu personaje conoce, los caminos entre ellos y el rastro que has recorrido, con niebla sobre el resto. **Escena** muestra el mapa del lugar donde estás, cuando lo tiene, con quién está dónde; en un combate, en tu turno, las casillas a las que no puedes llegar aparecen veladas. Cuando el máster pregunte adónde te mueves, toca una casilla o escríbela, por ejemplo *E4*.
+
+### 3.6 Misiones, diario y notas
+
+Una tarea que asume tu personaje se convierte en una misión en el **Diario**, con sus objetivos, su plazo y lo que mide; márcala con una estrella para tenerla a la vista en la parte superior de Escena. El Diario también cuenta tu **historia**, escena a escena, y guarda tus **notas**: privadas, salvo que **Compartas** una, que el máster oye como lo que piensas, nunca como un hecho.
+
+### 3.7 La historia y la imagen de tu personaje
+
+En tu ficha, la tarjeta **Descripción** tiene un cuadro para la historia de tu personaje: el máster la escribe ahí, cuando tú le dices que sí. Para una imagen, dale al máster un archivo (PNG, JPEG, WebP o SVG, de hasta 5 MB) indicando dónde está en tu equipo, o pide que se haga un retrato ([3.11](#311-pictures)): *[Hazme un retrato: pelo gris trenzado, una cicatriz en la barbilla.]*
+
+### 3.8 Partidas guardadas y volver atrás
+
+RPG Engine guarda toda la campaña al final de cada escena. El ajuste de **partidas guardadas** decide el resto:
+
+| Partidas guardadas | Guardar cuando quieras | Volver atrás |
+|---|---|---|
+| **muerte permanente** | no | nunca |
+| **punto de control** | no | a la última partida guardada, solo cuando tu personaje muere |
+| **libre** | sí | a cualquier partida guardada |
+
+En todos los modos puedes **empezar de nuevo**, desde el inicio del juego o desde la sesión cero. Hazlo en el chat o en **Partidas guardadas**.
+
+Después de volver atrás, **abre un chat nuevo**: el anterior recuerda lo que se deshizo. Escribe *continuar* en el chat nuevo y pulsa **He abierto un chat nuevo** en Partidas guardadas.
+
+### 3.9 Sesiones: parar y volver
+
+Para cuando quieras: *[Lo dejamos aquí por hoy.]* Todo ya está guardado en los archivos. Para volver, inicia tu agente en la carpeta de la campaña y escribe *continuar*: el máster te da un breve resumen y sigue.
+
+### 3.10 El estado de ánimo del máster
+
+El robot de la parte superior del panel es el máster: su cara sigue el tono de la historia y nunca revela lo que aún no sabes. Cuando el chat está cerrado, duerme.
+
+### 3.11 Imágenes
+
+RPG Engine puede crear imágenes de los lugares a los que llegas, de las misiones que asumes y de quienes encuentras, según indique el ajuste de **imágenes**, y el retrato de tu personaje cuando lo pides. Usa lo que hay en tu equipo, con tu propio inicio de sesión: **Codex** las pinta; si no, las dibuja **Claude Code**. **Ajustes** indica si este equipo puede crearlas y cómo configurarlo si no. Siempre puedes darle al máster una imagen tuya.
+
+### 3.12 Seguridad: líneas, velos y stop
+
+Las **líneas** nunca aparecen en el juego; los **velos** ocurren solo fuera de escena. En cualquier momento escribe *[stop]*: el máster deja ese contenido al instante y lo añade a tus líneas.
+
+### 3.13 Cambiar de idea
+
+Cualquier ajuste se puede cambiar, en el chat o en **Ajustes**. Una decisión que el máster toma sin el libro se convierte en un **precedente**, de modo que la misma pregunta recibe la misma respuesta la próxima vez.
+
+---
+
+## 4. El panel <!-- icon: party -->
+
+Una página en tu propio equipo, que se abre solo en el navegador de ese equipo y está activa mientras el chat está abierto. Cuando el chat se cierra, muestra *Not connected*; vuelve sola con el siguiente chat.
+
+- **Grupo**: tu ficha y las de tus compañeros. Haz clic en un número para tirarlo; pasa el cursor por encima para ver de dónde sale. A su lado, las tiradas.
+- **Escena**: dónde estás, su imagen y su mapa, quién está allí, qué ocurre.
+- **Combate**: solo en un combate: los turnos, quienes combaten, lo que tienes a mano.
+- **Diario**: misiones, la historia, tus notas.
+- **Mundo**: el mapa del mundo tal como lo conoce tu personaje.
+- **La bandeja de dados**: elige dados y un modificador, y tira.
+- **Partidas guardadas**, **Ayuda**, **Ajustes** y **Acerca de**, como iconos al final de la fila. Ajustes también contiene las preferencias de la propia página: tema, sonido de los dados, juego de dados.
+
+Cuando el máster te pregunta algo, su aviso se queda en la parte superior, estés en la sección que estés.
+
+---
+
+## 5. Sistemas de juego y reglas de la casa <!-- icon: dice -->
+
+### 5.1 Qué es un sistema de juego
+
+Los datos de un juego: su ficha, sus números, sus criaturas, objetos, conjuros y el texto de sus reglas. Cada campaña juega con un sistema. RPG Engine calcula la ficha y lo que se gasta y lo que se recupera; cómo funciona un rasgo, lo lee el máster en las reglas y lo decide, como en una mesa.
+
+### 5.2 Quinta edición, incluida
+
+Las razas, las clases, las subclases, un trasfondo y una dote del SRD 5.1; los 319 conjuros, las armas, armaduras, objetos mágicos y monstruos; los capítulos de reglas, que el máster lee por su texto exacto; la ficha completa, calculada.
+
+También puedes jugar contenido que el SRD no tiene, de un libro que poseas: el máster lo escribe como páginas de tu campaña, y RPG Engine las trata como propias. RPG Engine incluye solo contenido abierto; lo que sabe tu máster no tiene ese límite.
+
+### 5.3 Reglas de la casa y tus propias añadiduras
+
+Pídeselo al máster: *[Regla de la casa: un 1 natural en un ataque significa que sueltas el arma.]* El máster la guarda como un acuerdo de la mesa, o escribe una página o un número de la ficha cuando hace falta. Las reglas de la casa que ya estén escritas pueden ir como archivos de texto en la carpeta `rules` de la campaña.
+
+### 5.4 Añadir o importar tu propio sistema de juego
+
+Todavía no: hoy RPG Engine juega solo con la quinta edición ([Próximamente](#9-coming-later)).
+
+---
+
+## 6. Extensiones <!-- icon: plus -->
+
+Todavía no. Una extensión añadirá algo a una campaña además de su sistema de juego: un mundo, una aventura, una función como el clima, reglas de la casa para compartir.
+
+---
+
+## 7. De dónde viene una campaña y su idioma <!-- icon: world -->
+
+### 7.1 Tres formas de tener un mundo
+
+- **Creado sobre la marcha**: a partir de tu premisa, el máster construye cada lugar, persona y trama justo antes de que lo necesites, y lo conserva.
+- **Preparado al principio**: lo mismo, con el mundo construido antes de jugar.
+- **A partir de tu propia aventura**: dale al máster un texto o un PDF y pídele que lo prepare, *[Prepara esta aventura como nuestra campaña. No me cuentes nada de lo que contiene.]* El máster escribe los lugares, los personajes y los secretos. Todavía no hay un botón de importación.
+
+Una campaña se juega una sola vez: para jugar otra vez la misma aventura, crea una campaña nueva.
+
+### 7.2 Idiomas
+
+Un idioma por campaña, el del máster, que el panel sigue. El panel incluye 26 idiomas. Cualquier otro lo traduce en tu equipo Codex o Claude Code o, sin ellos, el máster en el chat. Los términos de la quinta edición en italiano proceden del SRD oficial en italiano; el texto de las reglas sigue en inglés, y el máster lo cuenta en tu idioma.
+
+---
+
+## 8. Para curiosos: la carpeta de la campaña <!-- icon: list -->
+
+No necesitas abrirla nunca, y guarda los secretos de tu campaña. Contiene `campaign.yaml` (tus ajustes), `state.yaml` (cómo va el juego), `world/` (una página markdown por cada personaje, lugar, misión y el resto), `rules/` (tus reglas de la casa), `images/`, `log.jsonl` (cada cambio), `.saves/`, `.player/` (tus notas) y los archivos pequeños que indican a los agentes de IA dónde está RPG Engine. Las páginas usan el formato de Obsidian. Si cambias una página a mano, el máster lo sabrá en su siguiente respuesta.
+
+RPG Engine se queda en esta carpeta: solo lee y escribe la partida aquí, y nunca toca tus otros archivos. Fuera de ella, solo guarda una carpeta de datos propia (las traducciones del panel, y Codex o Claude Code si dejas que los instale) y carpetas temporales mientras se dibuja una imagen. Para cualquier otra cosa que tu agente quiera hacer en tu equipo, antes te lo pregunta.
+
+Todos los comandos que usa el máster se pueden ejecutar también en la carpeta de la campaña: `rpg --help` los enumera. Muchos muestran los secretos de la campaña.
+
+---
+
+## 9. Próximamente <!-- icon: hourglass -->
+
+- **Tú como máster**, con la IA interpretando al grupo.
+- **Modo autor**: escribe una aventura con la IA, luego expórtala y compártela.
+- **Varias personas en el mismo equipo**, cada una con su propio personaje, por turnos en el mismo chat.
+- **Extensiones**: ajustes, aventuras, funciones y reglas de la casa.
+- **Importar** tus manuales y aventuras.
+- **Otros juegos**: más sistemas de juego, y los tuyos.
+
+---
+
+## 10. Preguntas y problemas <!-- icon: info -->
+
+### Preguntas
+
+**¿Necesito conocer las reglas?** No. Elige el mentor en modo tutorial y pregunta entre corchetes cuando quieras.
+
+**¿Puede el máster hacer trampa?** No puede cambiar una tirada que haya hecho RPG Engine, salvo en la dificultad historia, ni hechos ya establecidos.
+
+**¿Cuesta algo?** RPG Engine es gratuito. El máster se ejecuta con el plan de tu agente, o en tu propio equipo con un modelo local. Una tarde de juego es un chat largo: en los planes más pequeños puedes alcanzar el límite del plan antes de que acabe la tarde. Las imágenes y las traducciones usan el mismo plan.
+
+**¿Puedo jugar en el móvil?** No: el máster se ejecuta en tu equipo, y el panel solo se abre allí.
+
+**¿Puedo jugar con amistades?** Todavía no: hoy hay una persona jugando, un personaje y sus compañeros ([Próximamente](#9-coming-later)).
+
+**¿Puedo usar otra IA la próxima vez?** Sí: abre la campaña en otro agente y escribe *continuar*.
+
+### Problemas
+
+**El panel no se abre.** Pregúntale al máster: `[¿Cuál es el enlace del panel?]`. Solo funciona mientras hay un chat abierto en esa campaña, después de la primera respuesta del máster.
+
+**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 no se encuentra `rpg --version`, instala RPG Engine de nuevo ([2.2](#22-install)).
+
+**Actualizar.** Ejecuta `npm install -g rpg-engine` otra vez y luego abre un chat nuevo: un máster que ya está en marcha conserva la versión con la que empezó.
+
+**El máster recuerda algo que deshice.** Abre un chat nuevo y pulsa **He abierto un chat nuevo** en Partidas guardadas.
+
+**No aparece ninguna imagen.** Ajustes > Imágenes indica si este equipo puede crearlas, y cómo.
+
+**La instalación falla, o `rpg` no se inicia.** `node --version` debe indicar 22 o superior. En Windows, mantén RPG Engine y tus campañas fuera de rutas que contengan `&`.
+
+**El enlace del panel ha cambiado.** Otro programa ha ocupado la dirección habitual; el máster te da el enlace nuevo.