rpg-engine 0.0.0-stage → 0.1.0

package/dist/dashboard/guide/pt.md

@@ -0,0 +1,306 @@
+<!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 2020efdb f4fdeebb 80a7cfb9 23c5f59b b8f80c05 8c9f41da 0b4a6ef8 4eb17899 728ca4a5 e2839149. Change the English, then run it again. -->
+# RPG Engine: o guia completo
+
+**RPG Engine** permite que você jogue um jogo de RPG de mesa com uma **IA como mestre**. Você conversa com o mestre em um **chat**; o RPG Engine trabalha nos bastidores: ele **lembra do mundo**, **rola os dados** e **faz as contas**. Ao lado do chat, você mantém aberta uma página no navegador, o **painel**, com sua ficha, os dados, os mapas e seu diário.
+
+Este guia é para quem joga: você não precisa saber programar.
+
+## Início rápido <!-- icon: send -->
+
+1. Instale o **Node.js** em [nodejs.org](https://nodejs.org) (a versão LTS).
+2. Instale um **agente de IA**, o programa em que o mestre roda, e entre na sua conta: por exemplo, Claude Code ou Codex ([2.4](#24-connect-your-ai)).
+3. Em um terminal, instale o RPG Engine: `npm install -g rpg-engine`.
+4. Crie uma campanha: `rpg init "The Salt Isles"`.
+5. Entre na nova pasta, `cd "The Salt Isles"`, e inicie seu agente nela: `claude` para o Claude Code, `codex` para o Codex. Diga sim quando ele perguntar se você confia na pasta ([2.4](#24-connect-your-ai)) e escreva *Oi! Vamos começar.* O mestre responde com o link do seu painel.
+
+## 1. O que é o RPG Engine <!-- icon: about -->
+
+| Quem | O que faz |
+|---|---|
+| **Você** | Joga com seu personagem: o que ele faz, diz e tenta. |
+| **O mestre** (a IA) | Conta a história, interpreta todos os outros, decide o que acontece e pede rolagens. |
+| **RPG Engine** | Guarda o mundo em arquivos, rola os dados, conta pontos de vida, dinheiro, tempo e distâncias, e mantém os segredos até você descobri-los. |
+
+O mundo continua o mesmo de uma noite para outra, até em um chat novo, até com outra IA:
+
+- **O que foi dito continua valendo.** Um vilão morto continua morto.
+- **Os dados são de verdade.** O mestre não pode alterá-los, exceto na dificuldade mais fácil, se você escolher.
+- **Segredos continuam secretos.** O mestre nunca conta o que seu personagem não sabe.
+- **O mundo se move.** As ameaças avançam enquanto você descansa ou viaja, e você vê os sinais delas.
+- **Uma campanha é uma pasta** no seu computador: pare quando quiser e retome depois.
+
+Hoje o RPG Engine joga um sistema de jogo, a **quinta edição**, a partir do System Reference Document 5.1, que é gratuito. Outros virão ([Em breve](#9-coming-later)).
+
+---
+
+## 2. Primeiros passos <!-- icon: path -->
+
+### 2.1 O que você precisa
+
+- Um computador com Windows, macOS ou Linux, e um navegador.
+- **Node.js 22** ou mais novo, em [nodejs.org](https://nodejs.org). Ele traz o `npm`, que instala o RPG Engine.
+- Um **terminal**: no Windows, Terminal ou PowerShell; no macOS, Terminal. Para abrir um terminal em uma pasta, clique nela com o botão direito e escolha **Abrir no Terminal** (Windows) ou **Serviços > Novo Terminal na Pasta** (macOS).
+- Um **agente de IA** para o mestre ([2.4](#24-connect-your-ai)), com o **maior modelo** que ele oferecer: um modelo pequeno é mais fácil de convencer a revelar segredos ou a burlar as regras.
+
+### 2.2 Instalar
+
+```text
+npm install -g rpg-engine
+```
+
+`rpg --version` confirma que deu certo. Você usa `rpg` uma vez por campanha, para criá-la; depois disso, seu agente inicia o RPG Engine sozinho.
+
+### 2.3 Criar uma campanha
+
+Abra um terminal na pasta onde você guarda seus jogos ([2.1](#21-what-you-need) explica como):
+
+```text
+rpg init "The Salt Isles"
+```
+
+Isso cria a pasta `The Salt Isles` com uma campanha nova dentro; entre nela com `cd "The Salt Isles"`. Lembre onde ela está: você volta a ela toda vez que jogar. O resto você escolhe depois, no chat ou no painel; `rpg init --help` lista as opções para escolher algumas agora, como `--language it` ou `--difficulty hard`.
+
+O mestre não pode criar uma campanha para você: antes do `init`, nada diz ao seu agente onde está o RPG Engine.
+
+### 2.4 Conectar sua IA
+
+O mestre roda em um **agente de IA**: um aplicativo de IA, no terminal ou no desktop, que consegue trabalhar com os arquivos do seu computador, como o Claude Code ou o Codex. Um chat comum, como o claude.ai ou o ChatGPT, ou um aplicativo de celular, não basta: o mestre precisa acessar os arquivos da campanha no seu computador. Cada agente exige seu próprio plano e login: o Claude Code, um plano pago do Claude; o Codex, um login do ChatGPT. Você o instala uma vez, pela página dele: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: na pasta da campanha, escreva `claude`. Quando ele perguntar se você confia na pasta, escolha **Yes, I trust this folder**; cuidado, a resposta já selecionada é *No, exit*.
+- **Codex**: na pasta da campanha, escreva `codex` e diga sim quando ele perguntar se você confia na pasta. No aplicativo desktop dele, confira nas configurações se as memórias estão desligadas para os chats do jogo.
+- **Outro agente**: inicie-o na pasta da campanha e dê a ele o servidor MCP `rpg mcp`. O RPG Engine é um servidor MCP padrão: qualquer agente que aceite MCP pode ser o mestre, inclusive os locais.
+
+Nós jogamos e testamos com o **Claude Code**; o **Codex** está conectado e verificado, mas ainda não se jogou uma campanha inteira com ele; o `init` também configura o **Gemini CLI**. A campanha desliga a memória própria do agente: o jogo vive nos arquivos, para que voltar a um jogo salvo realmente volte.
+
+### 2.5 O primeiro chat
+
+Escreva qualquer coisa, como *Oi! Vamos começar.* Na primeira resposta de cada chat, o mestre dá o **link do seu painel**, algo como `http://127.0.0.1:4750`: abra-o e deixe-o ao lado do chat.
+
+Entre as mensagens do mestre, seu agente mostra as ferramentas que usa: não abra os detalhes delas (no Claude Code, ctrl+o), pois podem revelar segredos.
+
+Uma campanha nova passa por três etapas, mostradas no topo do painel: **1 Configurações** (como você quer jogar), **2 Sessão zero** (você cria seu personagem, jogando), **3 Jogar**.
+
+### 2.6 Configurações: escolhendo como jogar
+
+O mestre pergunta só o que ainda falta, algumas perguntas por vez; a etapa **Configurações** do painel mostra as mesmas perguntas em cartões. Escreva "você decide" e o mestre escolhe. Tudo pode mudar depois, no chat ou em **Configurações**.
+
+| Configuração | O que decide | Valores |
+|---|---|---|
+| **Mentor** | Quanto o mestre ensina as regras a você | desligado, dicas, tutorial |
+| **Dificuldade** | Quão duro o mundo joga | história, fácil, normal, difícil, brutal |
+| **Letalidade** | O que significa cair em um combate | narrativa (nunca morre), épica (só quando importa), dados |
+| **Jogos salvos** | Quando você pode voltar | morte permanente, ponto de controle, livre ([3.8](#38-saves-and-going-back)) |
+| **Rigor** | Quão de perto comida, luz e viagem seguem as regras | fluido, regras, simulação |
+| **Dados** | Quem rola seus dados | digitais, físicos |
+| **Unidades** | Distâncias e pesos | métrico, imperial |
+| **Companheiros** | Quem viaja com você | nenhum, criados com você, criados pelo mestre, encontrados no jogo |
+| **Imagens** | Imagens de locais, missões e de quem você encontra | nenhuma, sob pedido, novos locais, missões e quem você encontra ([3.11](#311-pictures)) |
+| **Linhas** e **Véus** | O que nunca aparece e o que acontece só fora de cena | listas |
+| **Idioma** | O idioma do jogo e do painel | qualquer um |
+
+A quinta edição acrescenta o **avanço**: pontos de experiência ou marcos.
+
+Sem um mundo escrito, o mestre também pergunta uma **premissa** (gênero, tom, alguns elementos, com suas palavras) e a **preparação**: montar o mundo na hora, conforme você avança, ou tudo no início.
+
+**O estilo do mestre** nunca é perguntado, mas você pode mudá-lo no chat ou em **Configurações**: a **prosa** (simples, literária, pulp, irônica), as **histórias** que ele inventa (situações, arcos, episódios, mistério), um autor para **escrever como** ou qualquer outra coisa **com suas palavras**.
+
+### 2.7 Sessão zero: seu personagem
+
+Você cria seu personagem com o mestre, como em uma mesa. Toda escolha é sua, a menos que você peça ao mestre para fazê-la: venha com uma ideia completa, uma ideia vaga ou nada. O mestre explica como os valores de habilidade são feitos antes de qualquer dado ser rolado. A história do personagem nunca é obrigatória; se você der uma, o mestre a escreve com suas palavras. Depois, o mestre pede uma imagem do personagem ([3.7](#37-your-characters-story-and-picture)). O RPG Engine calcula a ficha: você nunca faz as contas.
+
+---
+
+## 3. Jogando <!-- icon: chat -->
+
+### 3.1 Conversando com o mestre
+
+Escreva o que seu personagem faz ou diz, com suas próprias palavras:
+
+> Pergunto ao estalajadeiro quem mais passou por aqui esta noite.
+
+Fora da história, escreva entre colchetes: *[Como funciona agarrar?]* O mestre também responde entre colchetes.
+
+Você diz o que tenta; o mestre diz o que acontece. O mestre nunca decide pelo seu personagem e nunca fala do motor do jogo. Você pode perguntar a ele como usar o painel.
+
+### 3.2 Rolagens
+
+O mestre pede uma rolagem só quando o resultado é incerto e importa, e diz antes o que está em jogo. Então:
+
+- **No painel**, um aviso mostra um botão para cada teste, como *Acrobacia +4 · com vantagem*. Clique nele: os dados caem na página e o mestre recebe o resultado. Você também pode clicar na linha da sua ficha que se acende, jogar os dados pela bandeja de dados ou escrever outra coisa no aviso.
+- **Manual**, no canto do aviso ou em **Configurações**: o aviso diz o que rolar, e você rola pela ficha ou pela bandeja de dados.
+- **Dados físicos**, com a configuração de dados em físicos: você escreve as faces que tirou, *[Tirei 14.]*, e o RPG Engine soma seus modificadores.
+
+**Rolagens livres**: clique em qualquer número da sua ficha, ou abra a bandeja de dados, para rolar por diversão. Elas nunca contam e o mestre nunca as vê.
+
+**As rolagens do mestre** aparecem na sua coluna de rolagens, exceto as secretas. Você sempre pode perguntar *[Essa rolagem foi de verdade?]*: para uma rolagem secreta, o mestre dá uma impressão digital que prova que ela foi feita antes de você perguntar.
+
+### 3.3 Cenas e combates
+
+A história corre em **cenas**: um combate, uma conversa, uma exploração, uma viagem, um descanso. No fim de cada cena o jogo é salvo sozinho, e a cena entra no seu diário.
+
+Em um combate, o mestre narra todo turno que não é seu e para onde você pode decidir. A seção **Combate** mostra a ordem dos turnos, os pontos de vida do seu grupo e o quanto os inimigos parecem feridos, em palavras. Se seu personagem cair, os testes de morte aparecem grandes na página.
+
+### 3.4 Tempo, viagem e o mundo que se move
+
+O RPG Engine guarda a data; nenhum tempo passa entre as sessões. Diga que você descansa, *Fazemos um descanso longo*, e o descanso devolve o que deve. Diga para onde vai, *Pegamos a estrada ao norte, rumo a Rocca*, e o RPG Engine calcula o caminho, a distância e os dias, parando quando algo acontece no trajeto. O dinheiro é contado nas moedas do jogo, troco incluído.
+
+Vilões têm planos com prazos. A cada novo dia, o mestre move as ameaças que o tempo fez avançar, e você vê os sinais delas, nunca o relógio em si.
+
+### 3.5 Mapas
+
+**Mundo** mostra os locais que seu personagem conhece, as estradas entre eles e o caminho que você percorreu, com névoa sobre o resto. **Cena** mostra o mapa do local onde você está, quando há um, com quem está em cada lugar; em um combate, na sua vez, os quadrados que você não alcança ficam velados. Quando o mestre perguntar para onde você se move, toque em um quadrado ou escreva-o, como *E4*.
+
+### 3.6 Missões, diário e notas
+
+Uma tarefa que seu personagem assume vira uma missão no **Diário**, com seus objetivos, seu prazo e o que ela mede; marque-a com uma estrela para mantê-la à vista no topo de Cena. O Diário também conta sua **história**, cena por cena, e guarda suas **notas**: privadas, a menos que você **Compartilhar** uma, que o mestre ouve como o que você pensa, nunca como um fato.
+
+### 3.7 A história e a imagem do seu personagem
+
+Na sua ficha, o cartão **Descrição** tem uma caixa para a história do seu personagem: o mestre a escreve ali, depois que você disser sim. Para uma imagem, dê ao mestre um arquivo (PNG, JPEG, WebP ou SVG, até 5 MB) com o local dele no seu computador, ou peça um retrato ([3.11](#311-pictures)): *[Faça um retrato meu: cabelo grisalho em uma trança, uma cicatriz no queixo.]*
+
+### 3.8 Jogos salvos e voltar atrás
+
+O RPG Engine salva a campanha inteira no fim de cada cena. A configuração **Jogos salvos** decide o resto:
+
+| Jogos salvos | Salvar quando quiser | Voltar |
+|---|---|---|
+| **morte permanente** | não | nunca |
+| **ponto de controle** | não | ao último jogo salvo, só quando seu personagem morre |
+| **livre** | sim | a qualquer jogo salvo |
+
+Em todos os modos você pode **recomeçar**, desde o início do jogo ou desde a sessão zero. Faça isso no chat ou em **Jogos salvos**.
+
+Depois de voltar, **abra um chat novo**: o antigo lembra do que foi desfeito. Escreva *continuar* no chat novo e depois aperte **Abri um novo chat** em Jogos salvos.
+
+### 3.9 Sessões: parar e voltar
+
+Pare quando quiser: *[Vamos parar por aqui esta noite.]* Tudo já está salvo nos arquivos. Para voltar, inicie seu agente na pasta da campanha e escreva *continuar*: o mestre faz um resumo curto e segue em frente.
+
+### 3.10 O humor do mestre
+
+O robô no topo do painel é o mestre: o rosto dele acompanha o tom da história e nunca revela o que você ainda não sabe. Quando o chat está fechado, ele dorme.
+
+### 3.11 Imagens
+
+O RPG Engine pode gerar imagens dos locais a que você chega, das missões que você assume e de quem você encontra, conforme a configuração **Imagens**, e o retrato do seu personagem quando você pedir. Ele usa o que há no seu computador, com o seu próprio login: o **Codex** as pinta; se não, o **Claude Code** as desenha. **Configurações** diz se este computador consegue gerá-las e como configurá-lo, se não. Você sempre pode dar ao mestre uma imagem sua.
+
+### 3.12 Segurança: linhas, véus e parar
+
+As **Linhas** nunca aparecem no jogo; os **véus** acontecem só fora de cena. A qualquer momento, escreva *[parar]*: o mestre abandona esse conteúdo na hora e o acrescenta às suas linhas.
+
+### 3.13 Mudando de ideia
+
+Toda configuração pode mudar, no chat ou em **Configurações**. Uma decisão que o mestre toma sem o livro vira um **precedente**, para que a mesma pergunta tenha a mesma resposta da próxima vez.
+
+---
+
+## 4. O painel <!-- icon: party -->
+
+Uma página no seu próprio computador, aberta só no navegador dele, ativa enquanto o chat estiver aberto. Quando o chat fecha, ela mostra *Não conectado*; volta sozinha com o próximo chat.
+
+- **Grupo**: sua ficha e a dos seus companheiros. Clique em um número para rolá-lo; passe o mouse sobre ele para ver de onde vem. Ao lado, as rolagens.
+- **Cena**: onde você está, a imagem e o mapa dela, quem está lá, o que está acontecendo.
+- **Combate**: só em um combate: os turnos, quem luta, o que você tem à mão.
+- **Diário**: missões, a história, suas notas.
+- **Mundo**: o mapa do mundo como seu personagem o conhece.
+- **A bandeja de dados**: escolha os dados e um modificador, e jogue.
+- **Jogos salvos**, **Ajuda**, **Configurações** e **Sobre**, como ícones no fim da fileira. Configurações também guarda as preferências da própria página: tema, som dos dados, conjunto de dados.
+
+Quando o mestre pergunta algo a você, o aviso dele fica no topo, em qualquer seção em que você esteja.
+
+---
+
+## 5. Sistemas de jogo e regras da casa <!-- icon: dice -->
+
+### 5.1 O que é um sistema de jogo
+
+Os dados de um jogo: a ficha, os números, as criaturas, os itens, as magias e o texto das regras. Cada campanha joga um sistema. O RPG Engine calcula a ficha e o que é gasto e o que volta; como uma característica funciona, o mestre lê nas regras e decide, como em uma mesa.
+
+### 5.2 Quinta edição, incluída
+
+As raças, classes, subclasses, um antecedente e uma talento do SRD 5.1; as 319 magias, as armas, armaduras, itens mágicos e monstros; os capítulos de regras, que o mestre lê pelo texto exato; a ficha completa, calculada.
+
+Você também pode jogar conteúdo que o SRD não tem, de um livro que você possua: o mestre o escreve como páginas da sua campanha, e o RPG Engine as trata como suas. O RPG Engine traz só conteúdo aberto; o que seu mestre sabe não tem esse limite.
+
+### 5.3 Regras da casa e acréscimos seus
+
+Peça ao mestre: *[Regra da casa: um 1 natural em um ataque faz você largar a arma.]* Ele a guarda como um acordo da mesa ou escreve uma página ou um número da ficha quando for preciso. Regras da casa já escritas podem ir como arquivos de texto na pasta `rules` da campanha.
+
+### 5.4 Adicionar ou importar seu próprio sistema de jogo
+
+Ainda não: hoje o RPG Engine joga só a quinta edição ([Em breve](#9-coming-later)).
+
+---
+
+## 6. Extensões <!-- icon: plus -->
+
+Ainda não. Uma extensão vai acrescentar algo a uma campanha além do sistema de jogo: um mundo, uma aventura, um recurso como o clima, regras da casa para compartilhar.
+
+---
+
+## 7. De onde vem uma campanha, e seu idioma <!-- icon: world -->
+
+### 7.1 Três jeitos de ter um mundo
+
+- **Feito na hora**: a partir da sua premissa, o mestre monta cada local, pessoa e trama pouco antes de você precisar, e os guarda.
+- **Preparado no início**: o mesmo, com o mundo montado antes do jogo.
+- **De uma aventura sua**: dê ao mestre um texto ou um PDF e peça que ele prepare tudo, *[Prepare esta aventura como nossa campanha. Não me conte nada do que está nela.]* Ele escreve os locais, os personagens e os segredos. Ainda não há botão de importar.
+
+Uma campanha é jogada uma vez: para jogar a mesma aventura de novo, crie uma campanha nova.
+
+### 7.2 Idiomas
+
+Um idioma por campanha, o do mestre, que o painel acompanha. O painel vem com 26 idiomas. Qualquer outro é traduzido no seu computador pelo Codex ou pelo Claude Code ou, sem eles, pelo mestre no chat. Os termos da quinta edição em italiano vêm do SRD italiano oficial; o texto das regras fica em inglês, e o mestre o conta no seu idioma.
+
+---
+
+## 8. Para os curiosos: a pasta da campanha <!-- icon: list -->
+
+Você nunca precisa abri-la, e ela guarda os segredos da sua campanha. Nela estão `campaign.yaml` (suas configurações), `state.yaml` (em que pé está o jogo), `world/` (uma página markdown para cada personagem, local, missão e o resto), `rules/` (suas regras da casa), `images/`, `log.jsonl` (cada mudança), `.saves/`, `.player/` (suas notas) e os pequenos arquivos que dizem aos agentes de IA onde está o RPG Engine. As páginas usam o formato do Obsidian. Se você mudar uma página à mão, o mestre fica sabendo na resposta seguinte.
+
+Todo comando que o mestre usa também pode ser executado na pasta da campanha: `rpg --help` os lista. Muitos mostram os segredos da campanha.
+
+---
+
+## 9. Em breve <!-- icon: hourglass -->
+
+- **Você como mestre**, com a IA jogando o grupo.
+- **Modo autor**: escreva uma aventura com a IA, depois exporte e compartilhe.
+- **Vários jogadores no mesmo computador**, cada um com seu personagem, alternando a vez no mesmo chat.
+- **Extensões**: configurações, aventuras, recursos e regras da casa.
+- **Importar** seus manuais e aventuras.
+- **Outros jogos**: mais sistemas de jogo, e os seus.
+
+---
+
+## 10. Perguntas e problemas <!-- icon: info -->
+
+### Perguntas
+
+**Preciso saber as regras?** Não. Escolha o mentor tutorial e pergunte entre colchetes quando quiser.
+
+**O mestre pode trapacear?** Ele não pode mudar uma rolagem feita pelo RPG Engine, exceto na dificuldade história, nem fatos já estabelecidos.
+
+**Custa alguma coisa?** O RPG Engine é gratuito. O mestre roda no plano do seu agente, ou no seu próprio computador com um modelo local. Uma noite de jogo é um chat longo: nos planos menores você pode atingir o limite do plano antes de a noite acabar. Imagens e traduções usam o mesmo plano.
+
+**Posso jogar no celular?** Não: o mestre roda no seu computador, e o painel só abre lá.
+
+**Posso jogar com amigos?** Ainda não: hoje é um jogador, um personagem, mais companheiros ([Em breve](#9-coming-later)).
+
+**Posso usar outra IA da próxima vez?** Sim: abra a campanha em outro agente e escreva *continuar*.
+
+### Problemas
+
+**O painel não abre.** Pergunte ao mestre: `[Qual é o link do painel?]`. Ele só funciona enquanto há um chat aberto nessa campanha, depois da primeira resposta do mestre.
+
+**O mestre parece não conhecer o jogo.** Seu agente não carregou o RPG Engine. Confira se você o iniciou na pasta da campanha e confiou nela. No Claude Code, escreva `/mcp` e reconecte o `rpg`. No Codex, `codex mcp list` na pasta da campanha deve mostrar `rpg`. Se `rpg --version` não for encontrado, instale o RPG Engine de novo ([2.2](#22-install)).
+
+**Atualizar.** Execute `npm install -g rpg-engine` de novo e depois abra um chat novo: um mestre em execução mantém a versão com que começou.
+
+**O mestre lembra de algo que eu desfiz.** Abra um chat novo e aperte **Abri um novo chat** em Jogos salvos.
+
+**Nenhuma imagem aparece.** Configurações > Imagens diz se este computador consegue gerá-las e como.
+
+**A instalação falha, ou o `rpg` não inicia.** `node --version` deve mostrar 22 ou mais novo. No Windows, mantenha o RPG Engine e suas campanhas fora de caminhos que contenham `&`.
+
+**O link do painel mudou.** Outro programa ocupou o endereço de costume; o mestre dá a você o novo link.

package/dist/dashboard/guide/ro.md

@@ -0,0 +1,306 @@
+<!-- Translated from en.md, part by part, by npm run translate: c38df721 53ff5eaa 2020efdb f4fdeebb 80a7cfb9 23c5f59b b8f80c05 8c9f41da 0b4a6ef8 4eb17899 728ca4a5 e2839149. Change the English, then run it again. -->
+# RPG Engine: ghidul complet
+
+**RPG Engine** îți permite să joci un joc de rol de masă cu o **IA în rolul de maestru de joc**. Vorbești cu maestrul de joc într-un **chat**; RPG Engine lucrează în spate: **își amintește lumea**, **aruncă zarurile** și **ține socotelile**. Lângă chat ții deschisă în browser o pagină, **dashboardul**, cu fișa ta, zarurile, hărțile și jurnalul.
+
+Ghidul este pentru jucători: nu e nevoie să știi să programezi.
+
+## Pornire rapidă <!-- icon: send -->
+
+1. Instalează **Node.js** de pe [nodejs.org](https://nodejs.org) (versiunea LTS).
+2. Instalează un **agent IA**, programul în care rulează maestrul de joc, și autentifică-te: de exemplu Claude Code sau Codex ([2.4](#24-connect-your-ai)).
+3. Într-un terminal, instalează RPG Engine: `npm install -g rpg-engine`.
+4. Creează o campanie: `rpg init "The Salt Isles"`.
+5. Intră în folderul nou, `cd "The Salt Isles"`, și pornește agentul acolo: `claude` pentru Claude Code, `codex` pentru Codex. Spune da când te întreabă dacă ai încredere în folder ([2.4](#24-connect-your-ai)), apoi scrie *Salut! Hai să începem.* Maestrul de joc răspunde cu linkul către dashboard.
+
+## 1. Ce este RPG Engine <!-- icon: about -->
+
+| Cine | Ce face |
+|---|---|
+| **Tu** | Joci personajul tău: ce face, ce spune și ce încearcă. |
+| **Maestrul de joc** (IA) | Spune povestea, joacă pe toți ceilalți, hotărăște ce se întâmplă, cere aruncări. |
+| **RPG Engine** | Ține lumea în fișiere, aruncă zarurile, numără punctele de viață, banii, timpul și distanțele, păstrează secretele până le descoperi. |
+
+Lumea rămâne aceeași de la o seară la alta, chiar și într-un chat nou, chiar și cu altă IA:
+
+- **Ce s-a spus rămâne adevărat.** Un ticălos mort rămâne mort.
+- **Zarurile sunt reale.** Maestrul de joc nu le poate trunchia, în afară de dificultatea cea mai ușoară, dacă o alegi.
+- **Secretele rămân secrete.** Maestrul de joc nu-ți spune niciodată ce nu știe personajul tău.
+- **Lumea se mișcă.** Amenințările înaintează cât timp te odihnești sau călătorești, și le vezi semnele.
+- **O campanie este un folder** pe calculatorul tău: te oprești când vrei, o reiei mai târziu.
+
+Astăzi RPG Engine joacă un singur sistem de joc, **ediția a cincea**, din System Reference Document 5.1, gratuit. Vor veni și altele ([Mai târziu](#9-coming-later)).
+
+---
+
+## 2. Primii pași <!-- icon: path -->
+
+### 2.1 Ce îți trebuie
+
+- Un calculator cu Windows, macOS sau Linux și un browser web.
+- **Node.js 22** sau mai nou, de pe [nodejs.org](https://nodejs.org). Vine cu `npm`, care instalează RPG Engine.
+- Un **terminal**: pe Windows, Terminal sau PowerShell; pe macOS, Terminal. Ca să deschizi unul într-un folder, dă clic dreapta pe folder și alege **Open in Terminal** (Windows) sau **Services > New Terminal at Folder** (macOS).
+- Un **agent IA** pentru maestrul de joc ([2.4](#24-connect-your-ai)), cu **cel mai mare model** pe care îl oferă: un model mic poate fi convins mai ușor să dezvăluie secrete sau să încalce regulile.
+
+### 2.2 Instalare
+
+```text
+npm install -g rpg-engine
+```
+
+`rpg --version` verifică dacă a mers. Folosești `rpg` o dată pe campanie, ca s-o creezi; după aceea agentul pornește singur RPG Engine.
+
+### 2.3 Creează o campanie
+
+Deschide un terminal în folderul unde ții jocurile ([2.1](#21-what-you-need) spune cum):
+
+```text
+rpg init "The Salt Isles"
+```
+
+Aceasta creează folderul `The Salt Isles` cu o campanie nouă înăuntru; intră în el cu `cd "The Salt Isles"`. Ține minte unde se află: te întorci la el de fiecare dată când joci. Restul îl alegi mai târziu, în chat sau în dashboard; `rpg init --help` listează opțiunile pe care le poți alege chiar acum, cum ar fi `--language it` sau `--difficulty hard`.
+
+Maestrul de joc nu poate crea o campanie în locul tău: înainte de `init`, nimic nu-i spune agentului unde se află RPG Engine.
+
+### 2.4 Conectează-ți IA
+
+Maestrul de joc rulează într-un **agent IA**: o aplicație IA, în terminal sau pe desktop, care poate lucra cu fișierele de pe calculatorul tău, cum ar fi Claude Code sau Codex. Un chat simplu, precum claude.ai sau ChatGPT, sau o aplicație de telefon nu ajunge: maestrul de joc trebuie să ajungă la fișierele campaniei de pe calculatorul tău. Fiecare agent cere propriul abonament și propria autentificare: Claude Code un abonament Claude plătit, Codex o autentificare ChatGPT. Îl instalezi o singură dată, de pe pagina lui: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: în folderul campaniei scrie `claude`. Când te întreabă dacă ai încredere în folder, alege **Yes, I trust this folder**; atenție, răspunsul deja selectat este *No, exit*.
+- **Codex**: în folderul campaniei scrie `codex` și spune da când te întreabă dacă ai încredere în folder. În aplicația lui desktop, verifică în setări că memoriile sunt dezactivate pentru chaturile jocului.
+- **Alt agent**: pornește-l în folderul campaniei și dă-i serverul MCP `rpg mcp`. RPG Engine este un server MCP standard: orice agent care suportă MCP poate fi maestrul de joc, inclusiv cei locali.
+
+Jucăm și testăm cu **Claude Code**; **Codex** este conectat și verificat, dar încă nu s-a jucat o campanie întreagă cu el; `init` configurează și **Gemini CLI**. Campania dezactivează memoria proprie a agentului: jocul trăiește în fișierele lui, ca revenirea la o salvare să fie cu adevărat o revenire.
+
+### 2.5 Primul chat
+
+Scrie orice, de exemplu *Salut! Hai să începem.* În primul răspuns din fiecare chat, maestrul de joc îți dă **linkul către dashboard**, ceva de genul `http://127.0.0.1:4750`: deschide-l și ține-l lângă chat.
+
+Între mesajele maestrului de joc, agentul tău arată uneltele pe care le folosește: nu deschide detaliile lor (în Claude Code, ctrl+o), pentru că pot arăta secrete.
+
+O campanie nouă trece prin trei etape, afișate sus în dashboard: **1 Setări** (cum vrei să joci), **2 Sesiunea zero** (îți faci personajul, jucând), **3 Joc**.
+
+### 2.6 Setări: alegi cum joci
+
+Maestrul de joc întreabă doar ce mai lipsește, câteva întrebări odată; pasul **Setări** din dashboard arată aceleași întrebări sub formă de cartonașe. Scrie „alege tu” și maestrul de joc hotărăște. Totul se poate schimba mai târziu, în chat sau în **Setări**.
+
+| Setare | Ce hotărăște | Valori |
+|---|---|---|
+| **Mentor** | Cât de mult te învață maestrul de joc regulile | oprit, indicii, tutorial |
+| **Dificultate** | Cât de grea e lumea | poveste, ușor, normal, greu, brutal |
+| **Letalitate** | Ce înseamnă să cazi într-o luptă | narativ (nu mori niciodată), epic (doar când contează), zaruri |
+| **Salvări** | Când te poți întoarce | moarte definitivă, punct de control, liber ([3.8](#38-saves-and-going-back)) |
+| **Rigoare** | Cât de strict urmează regulile hrana, lumina și călătoria | fluid, reguli, simulare |
+| **Zaruri** | Cine aruncă zarurile tale | digitale, fizice |
+| **Unități de măsură** | Distanțe și greutăți | metrice, imperiale |
+| **Însoțitori** | Cine călătorește cu tine | niciunul, făcuți împreună cu tine, făcuți de maestrul de joc, întâlniți în joc |
+| **Imagini** | Imagini cu locuri, misiuni și cei pe care îi întâlnești | niciuna, la cerere, locuri noi, misiuni și cei pe care îi întâlnești ([3.11](#311-pictures)) |
+| **Linii** și **Văluri** | Ce nu apare niciodată și ce se petrece doar în afara scenei | liste |
+| **Limbă** | Limba jocului și a dashboardului | oricare |
+
+Ediția a cincea adaugă **progresia**: puncte de experiență sau borne.
+
+Dacă nu ai o lume scrisă, maestrul de joc îți cere și o **premisă** (gen, ton, câteva elemente, în cuvintele tale) și **pregătirea**: lumea se construiește din mers, pe parcurs, sau toată la început.
+
+**Stilul maestrului de joc** nu se întreabă niciodată, dar îl poți schimba în chat sau în **Setări**: **proza** (simplă, literară, pulp, ironică), **poveștile** pe care le inventează (situații, arcuri, episoade, mister), un autor după care să **scrie** sau orice altceva **în cuvintele tale**.
+
+### 2.7 Sesiunea zero: personajul tău
+
+Îți faci personajul împreună cu maestrul de joc, ca la o masă de joc. Fiecare alegere îți aparține, dacă nu-i ceri maestrului de joc s-o facă el: vino cu o idee completă, cu una vagă sau cu nimic. Maestrul de joc îți spune cum se obțin valorile abilităților înainte să se arunce vreun zar. Povestea ta nu este niciodată obligatorie; dacă dai una, maestrul de joc o scrie în cuvintele tale. Apoi maestrul de joc cere o imagine a personajului tău ([3.7](#37-your-characters-story-and-picture)). RPG Engine calculează fișa: nu faci tu niciodată socotelile.
+
+---
+
+## 3. Jocul <!-- icon: chat -->
+
+### 3.1 Vorbești cu maestrul de joc
+
+Scrie ce face sau ce spune personajul tău, în cuvintele tale:
+
+> Îl întreb pe hangiu cine a mai trecut pe aici în seara asta.
+
+Ca să ieși din poveste, scrie între paranteze drepte: *[Cum funcționează lupta corp la corp?]* Maestrul de joc răspunde tot între paranteze.
+
+Tu spui ce încerci; maestrul de joc spune ce se întâmplă. Maestrul de joc nu hotărăște niciodată pentru personajul tău și nu vorbește niciodată despre motor. Îl poți întreba cum se folosește dashboardul.
+
+### 3.2 Aruncări
+
+Maestrul de joc cere o aruncare doar când rezultatul este nesigur și contează, și spune mai întâi ce este în joc. Apoi:
+
+- **În dashboard**, un banner arată un buton pentru fiecare probă, de exemplu *Acrobatics +4 · with advantage*. Apasă-l: zarurile cad pe pagină și maestrul de joc află rezultatul. Poți și să apeși linia fișei tale care se luminează, să arunci zarurile din tavă sau să scrii altceva în banner.
+- **Manual**, în colțul bannerului sau în **Setări**: bannerul îți spune ce să arunci, iar tu arunci de pe fișă sau din tavă.
+- **Zaruri fizice**, cu setarea zarurilor pe fizice: scrii fețele pe care le-ai aruncat, *[Am aruncat 14.]*, iar RPG Engine adaugă modificatorii tăi.
+
+**Aruncări libere**: apasă orice număr de pe fișă sau deschide tava ca să arunci de plăcere. Nu contează niciodată, iar maestrul de joc nu le vede.
+
+**Aruncările maestrului de joc** apar în coloana ta de aruncări, în afară de cele secrete. Poți întreba oricând *[Aruncarea aceea a fost reală?]*: pentru o aruncare secretă, maestrul de joc dă o amprentă care dovedește că a fost făcută înainte să întrebi.
+
+### 3.3 Scene și lupte
+
+Povestea se desfășoară în **scene**: o luptă, o conversație, o explorare, o călătorie, o odihnă. La sfârșitul fiecărei scene jocul se salvează singur, iar scena intră în jurnalul tău.
+
+Într-o luptă, maestrul de joc povestește fiecare tură care nu e a ta și se oprește unde poți decide. Secțiunea **Luptă** arată ordinea turelor, punctele de viață ale grupului tău și cât de răniți par inamicii, în cuvinte. Dacă personajul tău cade, salvările împotriva morții apar mari pe pagină.
+
+### 3.4 Timp, călătorii și lumea care se mișcă
+
+RPG Engine ține data; între sesiuni nu trece timp. Spune că te odihnești, *Facem o odihnă lungă*, și odihna aduce înapoi ce trebuie. Spune încotro mergi, *Luăm drumul spre nord, către Rocca*, și RPG Engine calculează drumul, distanța și zilele, oprindu-se când se întâmplă ceva pe cale. Banii sunt numărați în monedele jocului, cu rest cu tot.
+
+Ticăloșii au planuri cu termene. În fiecare zi nouă, maestrul de joc mișcă amenințările pe care timpul le-a făcut să avanseze, iar tu le vezi semnele, niciodată ceasul însuși.
+
+### 3.5 Hărți
+
+**Lume** arată locurile pe care le cunoaște personajul tău, drumurile dintre ele și traseul parcurs, cu ceață peste rest. **Scenă** arată harta locului în care te afli, când are una, cu cine unde se află; într-o luptă, în rândul tău, căsuțele la care nu poți ajunge sunt acoperite. Când maestrul de joc întreabă unde te muți, atinge o căsuță sau scrie-o, de exemplu *E4*.
+
+### 3.6 Misiuni, jurnal și notițe
+
+O sarcină pe care o ia personajul tău devine o misiune în **Jurnal**, cu obiectivele ei, termenul și ce măsoară; pune-i o stea ca s-o ții la vedere în partea de sus a secțiunii Scenă. Jurnalul îți spune și **povestea**, scenă cu scenă, și păstrează **notițele** tale: private, dacă nu o **Partajează** pe una, pe care maestrul de joc o aude ca ceea ce crezi tu, niciodată ca fapt.
+
+### 3.7 Povestea și imaginea personajului tău
+
+Pe fișa ta, cartonașul **Descriere** are o casetă pentru povestea personajului: maestrul de joc o scrie acolo, după ce spui da. Pentru o imagine, dă-i maestrului de joc un fișier (PNG, JPEG, WebP sau SVG, până la 5 MB) cu locul unde se află pe calculatorul tău, sau cere un portret ([3.11](#311-pictures)): *[Fă-mi un portret: păr cenușiu împletit într-o coadă, o cicatrice pe bărbie.]*
+
+### 3.8 Salvări și întoarcerea în timp
+
+RPG Engine salvează toată campania la sfârșitul fiecărei scene. Setarea **salvări** hotărăște restul:
+
+| Salvări | Salvezi când vrei | Te întorci |
+|---|---|---|
+| **moarte definitivă** | nu | niciodată |
+| **punct de control** | nu | la ultima salvare, doar când personajul tău moare |
+| **liber** | da | la orice salvare |
+
+În orice mod poți **relua de la capăt**, de la începutul jocului sau de la sesiunea zero. Fă-o în chat sau în **Salvări**.
+
+După ce te-ai întors, **deschide un chat nou**: cel vechi își amintește ce s-a anulat. Scrie *continuă* în chatul nou, apoi apasă **Am deschis un chat nou** în Salvări.
+
+### 3.9 Sesiuni: oprirea și revenirea
+
+Oprește-te când vrei: *[Ne oprim aici pentru în seara asta.]* Totul este deja salvat în fișiere. Ca să revii, pornește agentul în folderul campaniei și scrie *continuă*: maestrul de joc îți face un scurt rezumat și merge mai departe.
+
+### 3.10 Dispoziția maestrului de joc
+
+Robotul din partea de sus a dashboardului este maestrul de joc: fața lui urmează tonul poveștii și nu dezvăluie niciodată ce nu știi încă. Când chatul este închis, doarme.
+
+### 3.11 Imagini
+
+RPG Engine poate genera imagini cu locurile la care ajungi, misiunile pe care le iei și cei pe care îi întâlnești, după cum spune setarea **imagini**, și portretul personajului tău când îl ceri. Folosește ce se află pe calculatorul tău, cu propria ta autentificare: **Codex** le pictează, altfel **Claude Code** le desenează. **Setări** spune dacă acest calculator le poate genera și cum îl configurezi dacă nu. Îi poți oricând da maestrului de joc o imagine a ta.
+
+### 3.12 Siguranță: linii, văluri și stop
+
+**Liniile** nu apar niciodată în joc; **vălurile** se petrec doar în afara scenei. În orice moment scrie *[stop]*: maestrul de joc renunță imediat la acel conținut și îl adaugă la liniile tale.
+
+### 3.13 Te răzgândești
+
+Orice setare se poate schimba, în chat sau în **Setări**. O decizie pe care maestrul de joc o ia fără carte devine un **precedent**, astfel că aceeași întrebare primește același răspuns data viitoare.
+
+---
+
+## 4. Dashboardul <!-- icon: party -->
+
+O pagină pe propriul tău calculator, deschisă doar în browserul acelui calculator, activă cât timp chatul este deschis. Când chatul se închide, arată *Not connected*; revine singură la următorul chat.
+
+- **Grup**: fișa ta și cele ale însoțitorilor tăi. Apasă un număr ca să-l arunci; ține cursorul deasupra ca să vezi de unde vine. Alături, aruncările.
+- **Scenă**: unde te afli, imaginea și harta ei, cine e acolo, ce se întâmplă.
+- **Luptă**: doar într-o luptă: turele, combatanții, ce ai la îndemână.
+- **Jurnal**: misiuni, povestea, notițele tale.
+- **Lume**: harta lumii așa cum o cunoaște personajul tău.
+- **Tava pentru zaruri**: alege zarurile și un modificator, apoi aruncă.
+- **Salvări**, **Ajutor**, **Setări** și **Despre**, ca pictograme la capătul rândului. Setări conține și preferințele paginii: tema, sunetul zarurilor, setul de zaruri.
+
+Când maestrul de joc te întreabă ceva, bannerul lui rămâne sus, indiferent în ce secțiune te afli.
+
+---
+
+## 5. Sisteme de joc și reguli de casă <!-- icon: dice -->
+
+### 5.1 Ce este un sistem de joc
+
+Datele unui joc: fișa, numerele, creaturile, obiectele, vrăjile și textul regulilor. Fiecare campanie joacă un singur sistem. RPG Engine calculează fișa și ce se consumă și ce se reface; cum funcționează o trăsătură, maestrul de joc citește în reguli și hotărăște, ca la o masă de joc.
+
+### 5.2 Ediția a cincea, inclusă
+
+Rasele, clasele, subclasele, un background și un feat din SRD 5.1; cele 319 vrăji, armele, armurile, obiectele magice și monștrii; capitolele de reguli, pe care maestrul de joc le citește după textul lor exact; fișa completă, calculată.
+
+Poți juca și conținut care lipsește din SRD, dintr-o carte pe care o deții: maestrul de joc îl scrie ca pagini ale campaniei tale, iar RPG Engine le tratează ca pe ale lui. RPG Engine livrează doar conținut deschis; ce știe maestrul tău de joc nu este limitat.
+
+### 5.3 Reguli de casă și adăugirile tale
+
+Cere-i maestrului de joc: *[Regulă de casă: un 1 natural la atac înseamnă că scapi arma.]* O păstrează ca pe o înțelegere a mesei de joc sau scrie o pagină ori un număr al fișei când e nevoie. Regulile de casă deja scrise pot merge ca fișiere text în folderul `rules` al campaniei.
+
+### 5.4 Adaugă sau importă propriul sistem de joc
+
+Încă nu: astăzi RPG Engine joacă doar ediția a cincea ([Mai târziu](#9-coming-later)).
+
+---
+
+## 6. Extensii <!-- icon: plus -->
+
+Încă nu. O extensie va adăuga ceva unei campanii, peste sistemul ei de joc: o lume, o aventură, o funcție precum vremea, reguli de casă de împărțit.
+
+---
+
+## 7. De unde vine o campanie și limba ei <!-- icon: world -->
+
+### 7.1 Trei moduri de a avea o lume
+
+- **Făcută din mers**: pornind de la premisa ta, maestrul de joc construiește fiecare loc, persoană și intrigă chiar înainte să ai nevoie de ele și le păstrează.
+- **Pregătită la început**: la fel, dar cu lumea construită înainte de joc.
+- **Din propria ta aventură**: dă-i maestrului de joc un text sau un PDF și cere-i să o pregătească, *[Pregătește această aventură ca pe campania noastră. Nu-mi spune nimic din ce se află în ea.]* Maestrul de joc scrie locurile, personajele și secretele. Încă nu există buton de import.
+
+O campanie se joacă o singură dată: ca să joci din nou aceeași aventură, creează o campanie nouă.
+
+### 7.2 Limbi
+
+O singură limbă pe campanie, cea a maestrului de joc, pe care o urmează dashboardul. Dashboardul vine în 26 de limbi. Orice altă limbă este tradusă pe calculatorul tău de Codex sau Claude Code sau, fără ele, de maestrul de joc în chat. Termenii ediției a cincea în italiană provin din SRD-ul italian oficial; textul regulilor rămâne în engleză, iar maestrul de joc îl povestește în limba ta.
+
+---
+
+## 8. Pentru curioși: folderul campaniei <!-- icon: list -->
+
+Nu trebuie să-l deschizi niciodată, iar el conține secretele campaniei tale. Are `campaign.yaml` (setările tale), `state.yaml` (unde a ajuns jocul), `world/` (o pagină markdown pentru fiecare personaj, loc, misiune și restul), `rules/` (regulile tale de casă), `images/`, `log.jsonl` (fiecare schimbare), `.saves/`, `.player/` (notițele tale) și fișierele mici care spun agenților IA unde se află RPG Engine. Paginile folosesc formatul Obsidian. Dacă schimbi o pagină de mână, maestrul de joc află la următorul răspuns.
+
+Fiecare comandă pe care o folosește maestrul de joc poate fi rulată și în folderul campaniei: `rpg --help` le listează. Multe afișează secretele campaniei.
+
+---
+
+## 9. Mai târziu <!-- icon: hourglass -->
+
+- **Tu ca maestru de joc**, cu IA jucând grupul.
+- **Mod autor**: scrie o aventură cu IA, apoi exportă-o și împărtășește-o.
+- **Mai mulți jucători pe același calculator**, fiecare cu propriul personaj, pe rând, în același chat.
+- **Extensii**: setări, aventuri, funcții și reguli de casă.
+- **Importul** manualelor și aventurilor tale.
+- **Alte jocuri**: mai multe sisteme de joc și ale tale.
+
+---
+
+## 10. Întrebări și probleme <!-- icon: info -->
+
+### Întrebări
+
+**Trebuie să cunosc regulile?** Nu. Alege mentorul în modul tutorial și întreabă între paranteze oricând vrei.
+
+**Poate maestrul de joc să trișeze?** Nu poate schimba o aruncare făcută de RPG Engine, în afară de dificultatea poveste, nici faptele deja stabilite.
+
+**Costă ceva?** RPG Engine este gratuit. Maestrul de joc rulează pe abonamentul agentului tău sau pe calculatorul tău, cu un model local. O seară de joc este un chat lung: pe cele mai mici abonamente poți atinge limita abonamentului înainte să se termine seara. Imaginile și traducerile folosesc același abonament.
+
+**Pot juca pe telefon?** Nu: maestrul de joc rulează pe calculatorul tău, iar dashboardul se deschide doar acolo.
+
+**Pot juca cu prieteni?** Încă nu: astăzi un jucător, un personaj, plus însoțitori ([Mai târziu](#9-coming-later)).
+
+**Pot folosi altă IA data viitoare?** Da: deschide campania în alt agent și scrie *continuă*.
+
+### Probleme
+
+**Dashboardul nu se deschide.** Întreabă maestrul de joc: `[Care e linkul către dashboard?]`. Funcționează doar cât timp un chat este deschis în acea campanie, după primul răspuns al maestrului de joc.
+
+**Maestrul de joc pare să nu cunoască jocul.** Agentul tău nu a încărcat RPG Engine. Verifică dacă l-ai pornit în folderul campaniei și dacă ai avut încredere în el. În Claude Code, scrie `/mcp` și reconectează `rpg`. În Codex, `codex mcp list` în folderul campaniei trebuie să arate `rpg`. Dacă `rpg --version` nu este găsit, instalează din nou RPG Engine ([2.2](#22-install)).
+
+**Actualizare.** Rulează din nou `npm install -g rpg-engine`, apoi deschide un chat nou: un maestru de joc deja pornit păstrează versiunea cu care a început.
+
+**Maestrul de joc își amintește ceva ce am anulat.** Deschide un chat nou și apasă **Am deschis un chat nou** în Salvări.
+
+**Nu apar imagini.** Setări > Imagini spune dacă acest calculator le poate genera și cum.
+
+**Instalarea eșuează sau `rpg` nu pornește.** `node --version` trebuie să arate 22 sau mai nou. Pe Windows, ține RPG Engine și campaniile tale în afara căilor care conțin `&`.
+
+**Linkul dashboardului s-a schimbat.** Alt program a luat adresa obișnuită; maestrul de joc îți dă noul link.