rpg-engine 0.0.0-stage → 0.1.1

package/dist/dashboard/guide/fi.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: täydellinen opas
+
+**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.
+
+Tämä opas on pelaajille: ohjelmointitaitoja ei tarvita.
+
+## Pika-aloitus <!-- icon: send -->
+
+1. Asenna **Node.js** osoitteesta [nodejs.org](https://nodejs.org) (LTS-versio).
+2. Asenna **tekoälyagentti**, ohjelma, jossa pelinjohtaja toimii, ja kirjaudu sisään: esimerkiksi Claude Code tai Codex ([2.4](#24-connect-your-ai)).
+3. Asenna RPG Engine päätteessä: `npm install -g rpg-engine`.
+4. Luo kampanja: `rpg init "The Salt Isles"`.
+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.
+
+## 1. Mikä RPG Engine on <!-- icon: about -->
+
+| Kuka | Mitä tekee |
+|---|---|
+| **Sinä** | Pelaat hahmoasi: mitä hahmo tekee, sanoo ja yrittää. |
+| **Pelinjohtaja** (tekoäly) | Kertoo tarinaa, esittää kaikkia muita, päättää mitä tapahtuu ja pyytää heittoja. |
+| **RPG Engine** | Pitää maailman tiedostoissa, heittää nopat, laskee osumapisteet, rahat, ajan ja etäisyydet sekä pitää salaisuudet piilossa, kunnes ne paljastuvat. |
+
+Maailma pysyy samana illasta toiseen, vaikka keskustelu vaihtuisi tai tekoäly olisi toinen:
+
+- **Sanottu pysyy totena.** Kuollut konna pysyy kuolleena.
+- **Nopat ovat aitoja.** Pelinjohtaja ei voi vääntää niitä, paitsi helpoimmalla vaikeustasolla, jos valitset sen.
+- **Salaisuudet pysyvät salaisina.** Pelinjohtaja ei koskaan kerro, mitä hahmosi ei tiedä.
+- **Maailma liikkuu.** Uhat etenevät, kun lepäätte tai matkaatte, ja näet niiden merkit.
+- **Kampanja on kansio** tietokoneellasi: voit lopettaa milloin haluat ja jatkaa myöhemmin.
+
+Nykyisin RPG Engine pelaa yhtä pelijärjestelmää, **viidettä editiota**, ilmaisesta System Reference Document 5.1 -aineistosta. Muita on tulossa ([Tulossa myöhemmin](#9-coming-later)).
+
+---
+
+## 2. Alkuun pääseminen <!-- icon: path -->
+
+### 2.1 Mitä tarvitset
+
+- Tietokoneen, jossa on Windows, macOS tai Linux, sekä selaimen.
+- **Node.js 22:n** tai uudemman osoitteesta [nodejs.org](https://nodejs.org). Mukana tulee `npm`, joka asentaa RPG Enginen.
+- **Päätteen**: Windowsissa Terminal tai PowerShell, macOS:ssä Terminal. Voit avata päätteen kansiossa napsauttamalla kansiota hiiren kakkospainikkeella ja valitsemalla **Avaa Terminalissa** (Windows) tai **Palvelut > Uusi Terminal kansiossa** (macOS).
+- **Tekoälyagentin** pelinjohtajaksi ([2.4](#24-connect-your-ai)). Valitse sen tarjoama **suurin malli**: pienen mallin voi helpommin puhua paljastamaan salaisuuksia tai taivuttamaan sääntöjä.
+
+### 2.2 Asennus
+
+```text
+npm install -g rpg-engine
+```
+
+Komento `rpg --version` tarkistaa, että asennus onnistui. Käytät komentoa `rpg` vain kerran kampanjaa kohden, sen luomiseen. Sen jälkeen agenttisi käynnistää RPG Enginen itse.
+
+### 2.3 Kampanjan luominen
+
+Avaa pääte kansiossa, jossa pidät pelisi ([2.1](#21-what-you-need) kertoo miten):
+
+```text
+rpg init "The Salt Isles"
+```
+
+Tämä luo kansion `The Salt Isles`, jossa on uusi kampanja. Siirry siihen komennolla `cd "The Salt Isles"`. Muista, missä kansio on: palaat siihen joka pelikerralla. Kaiken muun valitset myöhemmin keskustelussa tai kojelaudalla. Komento `rpg init --help` listaa valinnat, joilla voit asettaa jotain jo nyt, kuten `--language it` tai `--difficulty hard`.
+
+Pelinjohtaja ei voi luoda kampanjaa puolestasi: ennen komentoa `init` mikään ei kerro agentillesi, missä RPG Engine on.
+
+### 2.4 Tekoälyn yhdistäminen
+
+Pelinjohtaja toimii **tekoälyagentissa**: tekoälysovelluksessa, päätteessä tai työpöydällä, joka voi käsitellä tietokoneesi tiedostoja, kuten Claude Code tai Codex. Pelkkä keskustelupalvelu, kuten claude.ai tai ChatGPT, tai puhelinsovellus ei riitä: pelinjohtajan on päästävä käsiksi kampanjan tiedostoihin tietokoneellasi. Jokainen agentti tarvitsee oman tilauksensa ja kirjautumisensa: Claude Code maksullisen Claude-tilauksen, Codex ChatGPT-kirjautumisen. Asennat sen kerran sen omalta sivulta: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: kirjoita kampanjakansiossa `claude`. Kun se kysyy, luotatko kansioon, valitse **Yes, I trust this folder**. Varo: valmiiksi valittuna on *No, exit*.
+- **Codex**: kirjoita kampanjakansiossa `codex` ja vastaa myöntävästi, kun se kysyy, luotatko kansioon. Tarkista sen työpöytäsovelluksen asetuksista, että muistit ovat pois päältä pelin keskusteluissa.
+- **Muu agentti**: käynnistä se kampanjakansiossa ja anna sille MCP-palvelin `rpg mcp`. RPG Engine on tavallinen MCP-palvelin: mikä tahansa MCP:tä tukeva agentti voi olla pelinjohtaja, myös paikalliset.
+
+Pelaamme ja testaamme **Claude Codella**. **Codex** on yhdistetty ja tarkistettu, mutta sillä ei ole vielä pelattu kokonaista kampanjaa. `init` valmistelee myös **Gemini CLI:n**. Kampanja sammuttaa agentin oman muistin: peli elää sen tiedostoissa, jotta tallennukseen palaaminen todella palauttaa pelin aiempaan tilaan.
+
+### 2.5 Ensimmäinen keskustelu
+
+Kirjoita mitä tahansa, vaikka *Hei! Aloitetaan.* Jokaisen keskustelun ensimmäisessä vastauksessa pelinjohtaja antaa **linkin kojelautaasi**, joka on esimerkiksi `http://127.0.0.1:4750`. Avaa se ja pidä keskustelun rinnalla.
+
+Pelinjohtajan viestien välissä agenttisi näyttää käyttämänsä työkalut. Älä avaa niiden tietoja (Claude Codessa ctrl+o), sillä ne voivat paljastaa salaisuuksia.
+
+Uusi kampanja käy läpi kolme vaihetta, jotka näkyvät kojelaudan yläreunassa: **1 Asetukset** (miten haluat pelata), **2 Nollasessio** (teet hahmosi pelaamalla), **3 Pelaaminen**.
+
+### 2.6 Asetukset: miten pelaat
+
+Pelinjohtaja kysyy vain sen, mikä vielä puuttuu, muutaman kysymyksen kerrallaan. Kojelaudan **Asetukset**-vaihe näyttää samat kysymykset korteilla. Kirjoita "päätä sinä", niin pelinjohtaja valitsee. Kaiken voi muuttaa myöhemmin, keskustelussa tai **Asetuksissa**.
+
+| Asetus | Mitä se ratkaisee | Arvot |
+|---|---|---|
+| **Mentori** | Kuinka paljon pelinjohtaja opettaa sinulle sääntöjä | pois, vihjeet, opastus |
+| **Vaikeustaso** | Kuinka vaikea maailma on | tarina, helppo, normaali, vaikea, häikäilemätön |
+| **Tappavuus** | Mitä kaatuminen taistelussa tarkoittaa | kerronnallinen (ei kuolemaa), eeppinen (vain kun sillä on merkitystä), nopat |
+| **Tallennukset** | Milloin voit palata taaksepäin | pysyvä kuolema, tarkistuspiste, vapaa ([3.8](#38-saves-and-going-back)) |
+| **Tarkkuus** | Kuinka tarkasti ruoka, valo ja matkustaminen noudattavat sääntöjä | sujuva, säännöt, simulaatio |
+| **Nopat** | Kuka heittää noppasi | digitaaliset, fyysiset |
+| **Mittayksiköt** | Etäisyydet ja painot | metrijärjestelmä, brittiläiset yksiköt |
+| **Seuralaiset** | Ketkä matkaavat kanssasi | ei ketään, tehty yhdessä kanssasi, pelinjohtajan tekemät, tavataan pelissä |
+| **Kuvat** | Kuvat paikoista, tehtävistä ja tapaamistasi hahmoista | ei mitään, pyydettäessä, uudet paikat, tehtävät ja tapaamasi hahmot ([3.11](#311-pictures)) |
+| **Rajat** ja **Verhot** | Mikä ei koskaan näy ja mikä tapahtuu vain kuvan ulkopuolella | listat |
+| **Kieli** | Pelin ja kojelaudan kieli | mikä tahansa |
+
+Viides edtio lisää **kehittymisen**: kokemuspisteet tai merkkipaalut.
+
+Jos maailmaa ei ole kirjoitettu valmiiksi, pelinjohtaja kysyy myös **lähtökohdan** (genre, tunnelma, muutama elementti omin sanoin) ja **valmistelun**: rakennetaanko maailma lennossa pelin edetessä vai kokonaan alussa.
+
+**Pelinjohtajan tyyliä** ei kysytä koskaan, mutta voit muuttaa sitä keskustelussa tai **Asetuksissa**: **proosa** (selkeä, kirjallinen, pulp, kuivan humoristinen), keksittävät **tarinat** (tilanteet, kaaret, jaksot, mysteeri), kirjailija, jonka tapaan **kirjoitetaan**, tai mikä tahansa muu **omin sanoin**.
+
+### 2.7 Nollasessio: hahmosi
+
+Teet hahmosi pelinjohtajan kanssa, kuten pelipöydässä. Jokainen valinta on sinun, ellet pyydä pelinjohtajaa tekemään sitä. Voit tulla valmiin idean, epämääräisen idean tai tyhjin käsin. Pelinjohtaja kertoo, miten kykypisteet määräytyvät, ennen kuin yhtään noppaa heitetään. Hahmon tarinaa ei vaadita koskaan. Jos annat sellaisen, pelinjohtaja kirjoittaa sen sinun sanoillasi. Sen jälkeen pelinjohtaja kysyy kuvaa hahmostasi ([3.7](#37-your-characters-story-and-picture)). RPG Engine laskee hahmolomakkeen: sinun ei tarvitse laskea itse mitään.
+
+---
+
+## 3. Pelaaminen <!-- icon: chat -->
+
+### 3.1 Puhuminen pelinjohtajan kanssa
+
+Kirjoita omin sanoin, mitä hahmosi tekee tai sanoo:
+
+> Kysyn majatalon isännältä, ketä muita on käynyt täällä tänä iltana.
+
+Tarinan ulkopuolella kirjoita hakasulkeiden väliin: *[Miten kamppailu toimii?]* Pelinjohtaja vastaa myös hakasulkeissa.
+
+Sinä kerrot, mitä yrität. Pelinjohtaja kertoo, mitä tapahtuu. Pelinjohtaja ei koskaan päätä hahmosi puolesta eikä puhu pelimoottorista. Voit kysyä siltä, miten kojelautaa käytetään.
+
+### 3.2 Heitot
+
+Pelinjohtaja pyytää heittoa vain, kun lopputulos on epävarma ja sillä on merkitystä, ja kertoo ensin, mikä on pelissä. Sitten:
+
+- **Kojelaudalla** banneri näyttää painikkeen jokaiselle heitolle, esimerkiksi *Acrobatics +4 · with advantage*. Napsauta sitä: nopat putoavat sivulle ja pelinjohtaja saa tuloksen. Voit myös napsauttaa hahmolomakkeen valaistua riviä, heittää noppia noppa-alustalta tai kirjoittaa bannerissa jotain muuta.
+- **Käsin**, bannerin kulmasta tai **Asetuksista**: banneri kertoo, mitä heittää, ja heität sen hahmolomakkeesta tai noppa-alustalta.
+- **Fyysiset nopat**, kun noppa-asetus on fyysinen: kirjoitat heittämäsi silmäluvut, *[Heitin 14.]*, ja RPG Engine lisää muuntimesi.
+
+**Vapaat heitot**: napsauta mitä tahansa hahmolomakkeen lukua tai avaa noppa-alusta heittääksesi huvikseen. Ne eivät koskaan lasku mihinkään, eikä pelinjohtaja näe niitä.
+
+**Pelinjohtajan heitot** näkyvät heittosarakkeessasi, salaisia lukuun ottamatta. Voit aina kysyä *[Oliko tuo heitto aito?]*: salaisesta heitosta pelinjohtaja antaa sormenjäljen, joka todistaa heiton tehdyn ennen kysymystäsi.
+
+### 3.3 Kohtaukset ja taistelut
+
+Tarina etenee **kohtauksissa**: taistelu, keskustelu, tutkiminen, matkustaminen, lepo. Jokaisen kohtauksen lopussa peli tallentaa itsestään, ja kohtaus siirtyy päiväkirjaasi.
+
+Taistelussa pelinjohtaja kertoo jokaisen vuoron, joka ei ole sinun, ja pysähtyy kohtaan, jossa voit päättää. **Taistelu**-osio näyttää vuorojärjestyksen, seurueesi osumapisteet ja sen, miltä viholliset näyttävät sanoin kuvattuna. Jos hahmosi kaatuu, kuolemanpelastusheitot näkyvät suurina sivulla.
+
+### 3.4 Aika, matkustaminen ja liikkuva maailma
+
+RPG Engine pitää kirjaa päivämäärästä. Pelikertojen välillä aikaa ei kulu. Sano, että lepäätte, *Pidämme pitkän levon*, ja lepo palauttaa sen, minkä pitääkin. Kerro, minne menette, *Lähdemme pohjoiseen johtavaa tietä Roccaan*, ja RPG Engine laskee reitin, matkan ja päivät, ja pysähtyy, kun matkalla tapahtuu jotain. Raha lasketaan pelin kolikoissa, vaihtorahat mukaan lukien.
+
+Konnilla on suunnitelmia, joilla on määräajat. Joka uusi päivä pelinjohtaja siirtää uhkia, joita aika on edistänyt, ja näet niiden merkit, mutta et koskaan itse kelloa.
+
+### 3.5 Kartat
+
+**Maailma** näyttää hahmosi tuntemat paikat, niiden väliset tiet ja kulkemasi reitin. Muu on sumun peitossa. **Kohtaus** näyttää sen paikan kartan, jossa olet, kun sellainen on, ja kuka missäkin seisoo. Taistelussa omalla vuorollasi ruudut, joihin et yllä, on verhottu. Kun pelinjohtaja kysyy, minne siirryt, kosketa ruutua tai kirjoita se, esimerkiksi *E4*.
+
+### 3.6 Tehtävät, päiväkirja ja muistiinpanot
+
+Tehtävä, jonka hahmosi ottaa vastaan, tulee **Päiväkirjaan** omine tavoitteineen, määräaikoineen ja mittareineen. Tähdellä merkitty tehtävä pysyy näkyvillä Kohtauksen yläosassa. Päiväkirja kertoo myös **tarinasi** kohtaus kohtaukselta ja säilyttää **muistiinpanosi**: ne ovat yksityisiä, ellet **Jaa** jotakin. Pelinjohtaja kuulee jaetun muistiinpanon sinun ajatuksenasi, ei koskaan tosiasiana.
+
+### 3.7 Hahmosi tarina ja kuva
+
+Hahmolomakkeen **Kuvaus**-kortissa on kenttä hahmosi tarinalle: pelinjohtaja kirjoittaa sen siihen, kun olet myöntänyt. Kuvaksi voit antaa pelinjohtajalle tiedoston (PNG, JPEG, WebP tai SVG, enintään 5 Mt) ja kertoa, missä se on tietokoneellasi, tai teettää muotokuvan ([3.11](#311-pictures)): *[Tee minulle muotokuva: harmaat hiukset letillä, arpi leuassa.]*
+
+### 3.8 Tallennukset ja taaksepäin palaaminen
+
+RPG Engine tallentaa koko kampanjan jokaisen kohtauksen lopussa. **Tallennukset**-asetus ratkaisee lopun:
+
+| Tallennukset | Tallenna kun haluat | Palaa taaksepäin |
+|---|---|---|
+| **pysyvä kuolema** | ei | ei koskaan |
+| **tarkistuspiste** | ei | viimeiseen tallennukseen, vain kun hahmosi kuolee |
+| **vapaa** | kyllä | mihin tahansa tallennukseen |
+
+Jokaisessa tilassa voit **aloittaa alusta**, pelin alusta tai nollasessiosta. Tee se keskustelussa tai kohdassa **Tallennukset**.
+
+Taaksepäin palaamisen jälkeen **avaa uusi keskustelu**: vanha muistaa, mikä peruttiin. Kirjoita uudessa keskustelussa *jatka* ja paina sitten Tallennuksissa **Avasin uuden keskustelun**.
+
+### 3.9 Pelikerrat: lopettaminen ja palaaminen
+
+Lopeta milloin haluat: *[Lopetetaan tältä illalta tähän.]* Kaikki on jo tallennettu tiedostoihin. Palataksesi käynnistä agenttisi kampanjakansiossa ja kirjoita *jatka*: pelinjohtaja antaa lyhyen kertauksen ja jatkaa.
+
+### 3.10 Pelinjohtajan mieliala
+
+Kojelaudan yläreunan robotti on pelinjohtaja: sen ilme seuraa tarinan tunnelmaa eikä koskaan paljasta sitä, mitä et vielä tiedä. Kun keskustelu on suljettu, se nukkuu.
+
+### 3.11 Kuvat
+
+RPG Engine voi teettää kuvia saavuttamistasi paikoista, ottamistasi tehtävistä ja tapaamistasi hahmoista **Kuvat**-asetuksen mukaan sekä hahmosi muotokuvan, kun pyydät. Se käyttää sitä, mitä tietokoneellasi on, omalla kirjautumisellasi: **Codex** maalaa ne, muuten **Claude Code** piirtää ne. **Asetukset** kertoo, voiko tämä tietokone tehdä niitä, ja miten sen saa toimimaan, jos ei voi. Voit aina antaa pelinjohtajalle oman kuvasi.
+
+### 3.12 Turvallisuus: rajat, verhot ja pysäytys
+
+**Rajat** eivät koskaan näy pelissä. **Verhot** tapahtuvat vain kuvan ulkopuolella. Kirjoita milloin tahansa *[stop]*: pelinjohtaja jättää sen sisällön heti pois ja lisää sen rajoihisi.
+
+### 3.13 Mielen muuttaminen
+
+Jokaista asetusta voi muuttaa, keskustelussa tai **Asetuksissa**. Pelinjohtajan ilman sääntökirjaa tekemä ratkaisu muuttuu **ennakkotapaukseksi**, jotta sama kysymys saa ensi kerralla saman vastauksen.
+
+---
+
+## 4. Kojelauta <!-- icon: party -->
+
+Sivu omalla tietokoneellasi, avattavissa vain sen koneen selaimessa ja elossa niin kauan kuin keskustelu on auki. Kun keskustelu sulkeutuu, sivulla lukee *Not connected*. Yhteys palaa itsestään seuraavan keskustelun mukana.
+
+- **Seurue**: sinun ja seuralaistesi hahmolomakkeet. Napsauta lukua heittääksesi sen, vie hiiri sen päälle nähdäksesi, mistä se tulee. Vieressä ovat heitot.
+- **Kohtaus**: missä olet, sen kuva ja kartta, ketkä ovat paikalla ja mitä tapahtuu.
+- **Taistelu**: vain taistelussa: vuorot, taistelijat ja se, mitä sinulla on käsillä.
+- **Päiväkirja**: tehtävät, tarina ja muistiinpanosi.
+- **Maailma**: maailmankartta sellaisena kuin hahmosi sen tuntee.
+- **Noppa-alusta**: valitse nopat ja muunnin ja heitä.
+- **Tallennukset**, **Ohje**, **Asetukset** ja **Tietoja** kuvakkeina rivin lopussa. Asetuksissa ovat myös sivun omat valinnat: teema, noppien ääni, noppasetti.
+
+Kun pelinjohtaja kysyy sinulta jotain, sen banneri pysyy ylhäällä missä osiossa tahansa olet.
+
+---
+
+## 5. Pelijärjestelmät ja kotisäännöt <!-- icon: dice -->
+
+### 5.1 Mikä pelijärjestelmä on
+
+Yhden pelin tiedot: sen hahmolomake, luvut, olennot, esineet, loitsut ja sääntötekstit. Jokainen kampanja pelaa yhtä järjestelmää. RPG Engine laskee hahmolomakkeen sekä sen, mitä kuluu ja mitä palautuu. Pelinjohtaja lukee säännöistä, miten ominaisuus toimii, ja päättää, kuten pelipöydässä.
+
+### 5.2 Viides edtio, mukana
+
+SRD 5.1:n rodut, hahmoluokat, alaluokat, tausta ja erikoistaito; 319 loitsua, aseet, panssarit, taikaesineet ja hirviöt; sääntöluvut, jotka pelinjohtaja lukee tarkalla sanamuodolla; täysi hahmolomake, laskettuna valmiiksi.
+
+Voit pelata myös sisältöä, jota SRD:stä puuttuu, omistamastasi kirjasta: pelinjohtaja kirjoittaa sen kampanjasi sivuiksi, ja RPG Engine käsittelee niitä ominaan. RPG Engine toimittaa vain avointa sisältöä. Pelinjohtajasi tietämys ei ole rajattua.
+
+### 5.3 Kotisäännöt ja omat lisäykset
+
+Pyydä pelinjohtajalta: *[Kotisääntö: luonnollinen 1 hyökkäyksessä tarkoittaa, että pudotat aseesi.]* Se pitää sen pöydän sopimuksena tai kirjoittaa sivun tai hahmolomakkeen luvun, kun sellainen tarvitaan. Valmiiksi kirjoitetut kotisäännöt voivat olla tekstitiedostoina kampanjan `rules`-kansiossa.
+
+### 5.4 Oman pelijärjestelmän lisääminen tai tuominen
+
+Ei vielä: nykyisin RPG Engine pelaa vain viidettä editiota ([Tulossa myöhemmin](#9-coming-later)).
+
+---
+
+## 6. Laajennukset <!-- icon: plus -->
+
+Ei vielä. Laajennus lisää kampanjaan jotakin pelijärjestelmän päälle: maailman, seikkailun, ominaisuuden kuten sään tai jaettavia kotisääntöjä.
+
+---
+
+## 7. Mistä kampanja tulee ja sen kieli <!-- icon: world -->
+
+### 7.1 Kolme tapaa saada maailma
+
+- **Tehty lennossa**: lähtökohdastasi pelinjohtaja rakentaa jokaisen paikan, henkilön ja juonen juuri ennen kuin tarvitset sen, ja säilyttää sen.
+- **Valmisteltu alussa**: sama, mutta maailma rakennetaan ennen pelin alkua.
+- **Omasta seikkailusta**: anna pelinjohtajalle teksti tai PDF ja pyydä sitä valmistelemaan se, *[Valmistele tämä seikkailu kampanjaksemme. Älä kerro minulle mitään siitä, mitä siinä on.]* Se kirjoittaa paikat, hahmot ja salaisuudet. Tuontipainiketta ei vielä ole.
+
+Kampanja pelataan kerran: pelataksesi saman seikkailun uudelleen luo uusi kampanja.
+
+### 7.2 Kielet
+
+Yksi kieli kampanjaa kohden, pelinjohtajan kieli, jota kojelauta seuraa. Kojelaudan mukana tulee 26 kieltä. Minkä tahansa muun kielen kääntää tietokoneellasi Codex tai Claude Code, tai ilman niitä pelinjohtaja keskustelussa. Viidennen editionin italiankieliset termit tulevat viralliselta italialaiselta SRD:ltä. Sääntöteksti pysyy englanniksi, ja pelinjohtaja kertoo sen sinun kielelläsi.
+
+---
+
+## 8. Uteliaille: kampanjakansio <!-- icon: list -->
+
+Sinun ei koskaan tarvitse avata sitä, ja siinä on kampanjasi salaisuudet. Kansiossa on `campaign.yaml` (asetuksesi), `state.yaml` (pelin tilanne), `world/` (yksi markdown-sivu jokaista hahmoa, paikkaa, tehtävää ja muuta kohden), `rules/` (talosääntösi), `images/`, `log.jsonl` (jokainen muutos), `.saves/`, `.player/` (muistiinpanosi) sekä pienet tiedostot, jotka kertovat tekoälyagenteille, missä RPG Engine on. Sivut käyttävät Obsidianin muotoa. Jos muokkaat sivua käsin, pelinjohtaja saa tiedon siitä seuraavassa vastauksessaan.
+
+RPG Engine pysyy tässä kansiossa: se lukee ja kirjoittaa peliä vain täällä eikä koske muihin tiedostoihisi. Sen ulkopuolelle se jättää vain oman datakansionsa (kojelaudan käännökset sekä Codexin tai Claude Coden, jos annat sen asentaa ne) ja väliaikaiset kansiot kuvan piirtämisen ajaksi. Jos tekoälyagenttisi haluaa tehdä tietokoneellasi jotain muuta, se kysyy sinulta ensin.
+
+Kaikki pelinjohtajan käyttämät komennot voi ajaa myös kampanjakansiossa: `rpg --help` listaa ne. Monet niistä tulostavat kampanjan salaisuuksia.
+
+---
+
+## 9. Tulossa myöhemmin <!-- icon: hourglass -->
+
+- **Sinä pelinjohtajana**, ja tekoäly pelaa seuruetta.
+- **Tekijätila**: kirjoita seikkailu tekoälyn kanssa, vie se ulos ja jaa se.
+- **Useita pelaajia samalla tietokoneella**, joilla kullakin on oma hahmo ja jotka vuorottelevat samassa keskustelussa.
+- **Laajennukset**: asetukset, seikkailut, ominaisuudet ja kotisäännöt.
+- **Oppaiden ja seikkailujen tuonti**.
+- **Muut pelit**: lisää pelijärjestelmiä ja omat järjestelmät.
+
+---
+
+## 10. Kysymykset ja ongelmat <!-- icon: info -->
+
+### Kysymykset
+
+**Tarvitseeko minun osata säännöt?** Ei. Valitse opastava mentori ja kysy hakasulkeissa milloin haluat.
+
+**Voiko pelinjohtaja huijata?** Se ei voi muuttaa RPG Enginen tekemää heittoa, paitsi vaikeustasolla tarina, eikä jo vahvistettuja tosiasioita.
+
+**Maksaako se mitään?** RPG Engine on ilmainen. Pelinjohtaja toimii agenttisi tilauksella tai omalla koneellasi paikallisella mallilla. Pelilta on pitkä keskustelu: pienimmillä tilauksilla voit saavuttaa tilauksen rajan ennen illan loppua. Kuvat ja käännökset käyttävät samaa tilausta.
+
+**Voinko pelata puhelimella?** Et: pelinjohtaja toimii tietokoneellasi, ja kojelauta aukeaa vain siellä.
+
+**Voinko pelata kavereiden kanssa?** Et vielä: nykyisin yksi pelaaja, yksi hahmo ja seuralaiset ([Tulossa myöhemmin](#9-coming-later)).
+
+**Voinko käyttää ensi kerralla toista tekoälyä?** Kyllä: avaa kampanja toisessa agentissa ja kirjoita *jatka*.
+
+### Ongelmat
+
+**Kojelauta ei aukea.** Kysy pelinjohtajalta: `[What's the dashboard link?]`. Se toimii vain, kun kyseisessä kampanjassa on keskustelu auki, pelinjohtajan ensimmäisen vastauksen jälkeen.
+
+**Pelinjohtaja ei tunnu tuntevan peliä.** Agenttisi ei ladannut RPG Engineä. Tarkista, että käynnistit sen kampanjakansiossa ja luotit kansioon. Kirjoita Claude Codessa `/mcp` ja yhdistä `rpg` uudelleen. Codexissa komennon `codex mcp list` kampanjakansiossa on näytettävä `rpg`. Jos `rpg --version` ei löydy, asenna RPG Engine uudelleen ([2.2](#22-install)).
+
+**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.
+
+**Pelinjohtaja muistaa jotain, minkä peruin.** Avaa uusi keskustelu ja paina Tallennuksissa **Avasin uuden keskustelun**.
+
+**Kuvia ei ilmesty.** Asetukset > Kuvat kertoo, voiko tämä tietokone tehdä niitä, ja miten.
+
+**Asennus epäonnistuu tai `rpg` ei käynnisty.** Komennon `node --version` on kerrottava 22 tai uudempi. Windowsissa pidä RPG Engine ja kampanjasi poissa poluista, joissa on `&`.
+
+**Kojelaudan linkki vaihtui.** Toinen ohjelma otti tavallisen osoitteen. Pelinjohtaja antaa sinulle uuden linkin.

package/dist/dashboard/guide/fr.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 : le guide complet
+
+**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.
+
+Ce guide s'adresse aux joueurs et joueuses : tu n'as pas besoin de savoir programmer.
+
+## Démarrage rapide <!-- icon: send -->
+
+1. Installe **Node.js** depuis [nodejs.org](https://nodejs.org) (la version LTS).
+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)).
+3. Dans un terminal, installe RPG Engine : `npm install -g rpg-engine`.
+4. Crée une campagne : `rpg init "The Salt Isles"`.
+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.
+
+## 1. Ce qu'est RPG Engine <!-- icon: about -->
+
+| Qui | Ce qu'il ou elle fait |
+|---|---|
+| **Toi** | Tu joues ton personnage : ce qu'il fait, dit et tente. |
+| **Le MJ** (l'IA) | Raconte l'histoire, joue tous les autres rôles, décide de ce qui arrive, demande des jets. |
+| **RPG Engine** | Garde le monde dans des fichiers, lance les dés, compte les points de vie, l'argent, le temps et les distances, garde les secrets jusqu'à ce que tu les découvres. |
+
+Le monde reste le même d'une soirée à l'autre, même dans un nouveau chat, même avec une autre IA :
+
+- **Ce qui a été dit reste vrai.** Un méchant mort reste mort.
+- **Les dés sont réels.** Le MJ ne peut pas les truquer, sauf à la difficulté la plus facile, si tu la choisis.
+- **Les secrets restent secrets.** Le MJ ne te dit jamais ce que ton personnage ne sait pas.
+- **Le monde bouge.** Les menaces avancent pendant que vous vous reposez ou voyagez, et tu en vois les signes.
+- **Une campagne est un dossier** sur ton ordinateur : arrête-toi quand tu veux, reprends plus tard.
+
+Aujourd'hui, RPG Engine joue un seul système de jeu, la **cinquième édition**, tirée du System Reference Document 5.1, libre de droits. D'autres suivront ([Plus tard](#9-coming-later)).
+
+---
+
+## 2. Pour commencer <!-- icon: path -->
+
+### 2.1 Ce qu'il te faut
+
+- Un ordinateur sous Windows, macOS ou Linux, et un navigateur web.
+- **Node.js 22** ou plus récent, depuis [nodejs.org](https://nodejs.org). Il apporte `npm`, qui installe RPG Engine.
+- Un **terminal** : sous Windows, Terminal ou PowerShell ; sous macOS, Terminal. Pour en ouvrir un dans un dossier, fais un clic droit sur le dossier et choisis **Ouvrir dans le Terminal** (Windows) ou **Services > Nouveau terminal au dossier** (macOS).
+- Un **agent IA** pour le MJ ([2.4](#24-connect-your-ai)), avec le **plus grand modèle** qu'il propose : un petit modèle se laisse plus facilement convaincre de révéler des secrets ou de contourner les règles.
+
+### 2.2 Installer
+
+```text
+npm install -g rpg-engine
+```
+
+`rpg --version` vérifie que tout a marché. Tu utilises `rpg` une seule fois par campagne, pour la créer. Ensuite, ton agent lance RPG Engine tout seul.
+
+### 2.3 Créer une campagne
+
+Ouvre un terminal dans le dossier où tu ranges tes parties ([2.1](#21-what-you-need) explique comment) :
+
+```text
+rpg init "The Salt Isles"
+```
+
+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 reviens à chaque partie. Tu choisis tout le reste plus tard, dans le chat ou sur le tableau de bord. `rpg init --help` liste les options pour en choisir dès maintenant, comme `--language it` ou `--difficulty hard`.
+
+Le MJ ne peut pas créer une campagne à ta place : avant `init`, rien n'indique à ton agent où se trouve RPG Engine.
+
+### 2.4 Connecter ton IA
+
+Le MJ fonctionne dans un **agent IA** : une appli d'IA, dans le terminal ou sur le bureau, qui peut travailler avec les fichiers de ton ordinateur, comme Claude Code ou Codex. Un simple chat comme claude.ai ou ChatGPT, ou une appli de téléphone, ne suffit pas : le MJ doit pouvoir accéder aux fichiers de la campagne sur ton ordinateur. Chaque agent demande son propre abonnement et sa propre connexion : Claude Code un abonnement Claude payant, Codex une connexion ChatGPT. Tu l'installes une fois, depuis sa propre page : [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code** : dans le dossier de la campagne, écris `claude`. Quand il demande si tu fais confiance au dossier, choisis **Yes, I trust this folder** ; attention, la réponse déjà sélectionnée est *No, exit*.
+- **Codex** : dans le dossier de la campagne, écris `codex`, et réponds oui quand il demande si tu fais confiance au dossier. Dans son appli de bureau, vérifie dans les paramètres que les mémoires sont désactivées pour les chats du jeu.
+- **Un autre agent** : lance-le dans le dossier de la campagne et donne-lui le serveur MCP `rpg mcp`. RPG Engine est un serveur MCP standard : tout agent qui gère MCP peut être le MJ, y compris les agents locaux.
+
+Nous jouons et testons avec **Claude Code**. **Codex** est connecté et vérifié, mais aucune campagne entière n'a encore été jouée avec lui. `init` prépare aussi **Gemini CLI**. La campagne désactive la mémoire propre de l'agent : la partie vit dans ses fichiers, pour qu'un retour à une sauvegarde revienne vraiment en arrière.
+
+### 2.5 Le premier chat
+
+Écris ce que tu veux, par exemple *Salut ! On commence.* Dans sa première réponse de chaque chat, le MJ te donne le **lien vers ton tableau de bord**, quelque chose comme `http://127.0.0.1:4750` : ouvre-le et garde-le à côté du chat.
+
+Entre les messages du MJ, ton agent montre les outils qu'il utilise. N'ouvre pas leurs détails (dans Claude Code, ctrl+o) : ils peuvent révéler des secrets.
+
+Une nouvelle campagne passe par trois étapes, affichées en haut du tableau de bord : **1 Paramètres** (comment tu veux jouer), **2 Session zéro** (tu crées ton personnage, en jouant), **3 Jeu**.
+
+### 2.6 Paramètres : choisir comment jouer
+
+Le MJ ne demande que ce qui manque encore, quelques questions à la fois. L'étape **Paramètres** du tableau de bord montre les mêmes questions sous forme de cartes. Écris « choisis toi-même » et le MJ décide. Tout peut changer plus tard, dans le chat ou dans **Paramètres**.
+
+| Réglage | Ce qu'il décide | Valeurs |
+|---|---|---|
+| **Mentor** | Combien le MJ t'enseigne les règles | désactivé, conseils, tutoriel |
+| **Difficulté** | Le niveau d'exigence du monde | histoire, facile, normal, difficile, brutal |
+| **Létalité** | Ce que signifie tomber en combat | narrative (jamais de mort), épique (seulement quand c'est important), dés |
+| **Sauvegardes** | Quand tu peux revenir en arrière | mort définitive, point de contrôle, libre ([3.8](#38-saves-and-going-back)) |
+| **Rigueur** | À quel point la nourriture, la lumière et les voyages suivent les règles | fluide, règles, simulation |
+| **Dés** | Qui lance tes dés | numériques, physiques |
+| **Unités** | Distances et poids | métriques, impériales |
+| **Compagnons** | Qui voyage avec toi | aucun, créés avec toi, créés par le MJ, rencontrés en jeu |
+| **Images** | Images des lieux, des quêtes et des personnes rencontrées | aucune, sur demande, nouveaux lieux, quêtes et personnes rencontrées ([3.11](#311-pictures)) |
+| **Lignes** et **Voiles** | Ce qui n'apparaît jamais, et ce qui se passe seulement hors champ | listes |
+| **Langue** | La langue du jeu et du tableau de bord | toutes |
+
+La cinquième édition ajoute la **progression** : points d'expérience ou paliers.
+
+Sans monde déjà écrit, le MJ demande aussi un **pitch** (genre, ton, quelques éléments, avec tes mots) et la **préparation** : construire le monde au fil du jeu, ou tout au début.
+
+**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 ou une autrice dont **imiter l'écriture**, ou tout autre souhait **avec tes mots**.
+
+### 2.7 Session zéro : ton personnage
+
+Tu crées ton personnage avec le MJ, comme à une table. Chaque choix est le tien, sauf si tu demandes au MJ de le faire : viens avec une idée précise, une idée floue, ou rien du tout. Le MJ t'explique comment sont déterminés 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 l'écrit avec tes mots. Ensuite, le MJ demande une image de ton personnage ([3.7](#37-your-characters-story-and-picture)). RPG Engine calcule la fiche : tu ne fais jamais les additions.
+
+---
+
+## 3. Jouer <!-- icon: chat -->
+
+### 3.1 Parler avec le MJ
+
+Écris ce que fait ou dit ton personnage, avec tes propres mots :
+
+> Je demande à l'aubergiste qui d'autre est passé ce soir.
+
+Pour sortir de l'histoire, écris entre crochets : *[Comment marche la lutte ?]* Le MJ répond aussi entre crochets.
+
+Tu dis ce que tu tentes ; le MJ dit ce qui arrive. Le MJ ne décide jamais à la place de ton personnage, et ne parle jamais du moteur de jeu. Tu peux lui demander comment utiliser le tableau de bord.
+
+### 3.2 Les jets
+
+Le MJ demande un jet seulement quand l'issue est incertaine et compte, et il dit d'abord ce qui est en jeu. Ensuite :
+
+- **Sur le tableau de bord**, une bannière affiche un bouton pour chaque test, par exemple *Acrobaties +4 · avec avantage*. Clique dessus : les dés tombent sur la page et le MJ en entend le résultat. Tu peux aussi cliquer sur la ligne de ta fiche qui s'allume, lancer les dés depuis la piste de dés, ou écrire autre chose dans la bannière.
+- **À la main**, dans le coin de la bannière ou dans **Paramètres** : la bannière t'indique quoi lancer, et tu le lances depuis ta fiche ou la piste de dés.
+- **Dés physiques**, avec le réglage des dés sur physiques : tu écris les faces obtenues, *[J'ai fait 14.]*, et RPG Engine ajoute tes modificateurs.
+
+**Jets libres** : clique sur n'importe quel nombre de ta fiche, ou ouvre la piste de dés, pour lancer juste pour le plaisir. Ils ne comptent jamais et le MJ ne les voit jamais.
+
+**Les jets du MJ** apparaissent dans ta colonne de jets, sauf les jets secrets. Tu peux toujours demander *[Ce jet était-il réel ?]* : pour un jet secret, le MJ donne une empreinte qui prouve qu'il a été fait avant ta question.
+
+### 3.3 Scènes et combats
+
+L'histoire se déroule en **scènes** : un combat, une conversation, une exploration, un voyage, un repos. À la fin de chaque scène, la partie est sauvegardée automatiquement, et la scène entre dans ton journal.
+
+Dans un combat, le MJ raconte tous les tours qui ne sont pas les tiens, et s'arrête là où tu peux décider. La section **Combat** montre l'ordre des tours, les points de vie de ton groupe et l'état des ennemis, en mots. Si ton personnage tombe, les jets de sauvegarde contre la mort s'affichent en grand sur la page.
+
+### 3.4 Le temps, les voyages et le monde qui bouge
+
+RPG Engine tient la date ; aucun temps ne passe entre les sessions. Dis que vous vous reposez, *On prend un long repos*, et le repos rend ce qu'il doit rendre. Dis où tu vas, *On prend la route du nord vers Rocca*, et RPG Engine calcule le chemin, la distance et les jours, en s'arrêtant quand quelque chose se passe en route. L'argent est compté dans les pièces du jeu, monnaie rendue comprise.
+
+Les méchants ont des plans avec des échéances. Chaque nouveau jour, le MJ fait avancer les menaces que le temps a fait progresser, et tu en vois les signes, jamais l'horloge elle-même.
+
+### 3.5 Cartes
+
+**Monde** montre les lieux que ton personnage connaît, les routes entre eux et le chemin que tu as parcouru, avec du brouillard sur le reste. **Scène** montre la carte du lieu où tu te trouves, quand il en a une, avec la position de chacun ; en combat, à ton tour, les cases que tu ne peux pas atteindre sont voilées. Quand le MJ demande où tu te déplaces, touche une case, ou écris-la, par exemple *E4*.
+
+### 3.6 Quêtes, journal et notes
+
+Une tâche que ton personnage prend en charge devient une quête dans le **Journal**, avec ses objectifs, son échéance et ce qu'elle mesure ; mets-la en favori pour la garder sous les yeux en haut de Scène. Le Journal raconte aussi ton **histoire**, scène par scène, et garde tes **notes** : privées, sauf si tu en **Partages** une, que le MJ entend comme ce que tu penses, jamais comme un fait.
+
+### 3.7 L'histoire et l'image de ton personnage
+
+Sur ta fiche, la carte **Description** a une zone pour l'histoire de ton personnage : le MJ y écrit, après ton accord. Pour une image, donne au MJ un fichier (PNG, JPEG, WebP ou SVG, jusqu'à 5 Mo) avec son emplacement sur ton ordinateur, ou fais créer un portrait ([3.11](#311-pictures)) : *[Fais-moi un portrait : cheveux gris en tresse, une cicatrice au menton.]*
+
+### 3.8 Sauvegardes et retour en arrière
+
+RPG Engine sauvegarde toute la campagne à la fin de chaque scène. Le réglage **Sauvegardes** décide du reste :
+
+| Sauvegardes | Sauvegarder quand tu veux | Revenir en arrière |
+|---|---|---|
+| **mort définitive** | non | jamais |
+| **point de contrôle** | non | à la dernière sauvegarde, seulement quand ton personnage meurt |
+| **libre** | oui | à n'importe quelle sauvegarde |
+
+Dans tous les modes, tu peux **recommencer**, depuis le début du jeu ou depuis la session zéro. Fais-le dans le chat ou dans **Sauvegardes**.
+
+Après un retour en arrière, **ouvre un nouveau chat** : l'ancien se souvient de ce qui a été annulé. Écris *continue* dans le nouveau chat, puis appuie sur **J'ai ouvert un nouveau chat** dans Sauvegardes.
+
+### 3.9 Sessions : s'arrêter et revenir
+
+Arrête-toi quand tu veux : *[On s'arrête là pour ce soir.]* Tout est déjà sauvegardé dans les fichiers. Pour revenir, lance ton agent dans le dossier de la campagne et écris *continue* : le MJ te fait un court résumé et reprend.
+
+### 3.10 L'humeur du MJ
+
+Le robot en haut du tableau de bord, c'est le MJ : son visage suit le ton de l'histoire, sans jamais révéler ce que tu ne sais pas encore. Quand le chat est fermé, il dort.
+
+### 3.11 Images
+
+RPG Engine peut faire créer des images des lieux que tu atteins, des quêtes que tu prends et des personnes que tu rencontres, selon le réglage **Images**, ainsi que le portrait de ton personnage quand tu le demandes. Il utilise ce qui se trouve sur ton ordinateur, avec ta propre connexion : **Codex** les peint, sinon **Claude Code** les dessine. **Paramètres** indique si cet ordinateur peut en créer, et comment le configurer sinon. Tu peux toujours donner au MJ une image à toi.
+
+### 3.12 Sécurité : lignes, voiles et stop
+
+Les **lignes** n'apparaissent jamais dans le jeu ; les **voiles** se passent seulement hors champ. À tout moment, écris *[stop]* : le MJ abandonne aussitôt ce contenu et l'ajoute à tes lignes.
+
+### 3.13 Changer d'avis
+
+Chaque réglage peut changer, dans le chat ou dans **Paramètres**. Une décision que le MJ prend sans le livre devient un **précédent**, pour que la même question reçoive la même réponse la prochaine fois.
+
+---
+
+## 4. Le tableau de bord <!-- icon: party -->
+
+Une page sur ton propre ordinateur, ouverte seulement dans le navigateur de cet ordinateur, active tant que le chat est ouvert. Quand le chat se ferme, elle affiche *Not connected* ; elle revient toute seule avec le chat suivant.
+
+- **Groupe** : ta fiche et celles de tes compagnons. Clique sur un nombre pour le lancer ; survole-le pour voir d'où il vient. À côté, les jets.
+- **Scène** : où tu es, son image et sa carte, qui est là, ce qui se passe.
+- **Combat** : seulement pendant un combat : les tours, les combattants, ce que tu as sous la main.
+- **Journal** : les quêtes, l'histoire, tes notes.
+- **Monde** : la carte du monde telle que ton personnage la connaît.
+- **La piste de dés** : choisis des dés et un modificateur, puis lance.
+- **Sauvegardes**, **Aide**, **Paramètres** et **À propos**, sous forme d'icônes au bout de la rangée. Paramètres contient aussi les préférences de la page elle-même : thème, son des dés, type de dés.
+
+Quand le MJ te pose une question, sa bannière reste en haut, quelle que soit la section où tu te trouves.
+
+---
+
+## 5. Systèmes de jeu et règles maison <!-- icon: dice -->
+
+### 5.1 Ce qu'est un système de jeu
+
+Les données d'un jeu : sa fiche, ses nombres, ses créatures, ses objets, ses sorts et le texte de ses règles. Chaque campagne joue un seul système. RPG Engine calcule la fiche, ce qui est dépensé et ce qui revient ; pour savoir comment fonctionne une capacité, le MJ lit les règles et décide, comme à une table.
+
+### 5.2 La cinquième édition, incluse
+
+Les races, les classes, les sous-classes, un historique et un don du SRD 5.1 ; les 319 sorts, les armes, les armures, les objets magiques et les monstres ; les chapitres de règles, que le MJ lit dans leur texte exact ; la fiche complète, calculée.
+
+Tu peux aussi jouer du contenu qui manque au SRD, tiré d'un livre que tu possèdes : le MJ l'écrit sous forme de pages de ta campagne, et RPG Engine les traite comme les siennes. RPG Engine ne fournit que du contenu libre ; ce que ton MJ connaît n'a pas cette limite.
+
+### 5.3 Règles maison et ajouts personnels
+
+Demande au MJ : *[Règle maison : un 1 naturel sur une attaque fait lâcher ton arme.]* Il la garde comme un accord de la table, ou écrit une page ou un nombre de la fiche quand il en faut un. Les règles maison déjà rédigées peuvent aller dans des fichiers texte, dans le dossier `rules` de la campagne.
+
+### 5.4 Ajouter ou importer ton propre système de jeu
+
+Pas encore : aujourd'hui, RPG Engine ne joue que la cinquième édition ([Plus tard](#9-coming-later)).
+
+---
+
+## 6. Extensions <!-- icon: plus -->
+
+Pas encore. Une extension ajoutera quelque chose à une campagne, en plus de son système de jeu : un monde, une aventure, une fonction comme la météo, des règles maison à partager.
+
+---
+
+## 7. D'où vient une campagne, et sa langue <!-- icon: world -->
+
+### 7.1 Trois façons d'avoir un monde
+
+- **Créé au fil du jeu** : à partir de ton pitch, le MJ construit chaque lieu, personnage et intrigue juste avant que tu en aies besoin, et le garde.
+- **Préparé au début** : pareil, mais avec le monde construit avant le jeu.
+- **À partir de ta propre aventure** : donne au MJ un texte ou un PDF et demande-lui de la mettre en place, *[Mets en place cette aventure comme notre campagne. Ne me dis rien de ce qu'elle contient.]* Il écrit les lieux, les personnages et les secrets. Il n'y a pas encore de bouton d'importation.
+
+Une campagne se joue une seule fois : pour rejouer la même aventure, crée une nouvelle campagne.
+
+### 7.2 Langues
+
+Une langue par campagne, celle du MJ, que le tableau de bord suit. Le tableau de bord est fourni en 26 langues. Toute autre est traduite sur ton ordinateur par Codex ou Claude Code, ou, sans eux, par le MJ dans le chat. Les termes de la cinquième édition en italien viennent du SRD italien officiel ; le texte des règles reste en anglais, et le MJ le raconte dans ta langue.
+
+---
+
+## 8. Pour les curieux : le dossier de la campagne <!-- icon: list -->
+
+Tu n'as jamais besoin de l'ouvrir, et il contient les secrets de ta campagne. Il comprend `campaign.yaml` (tes réglages), `state.yaml` (où en est la partie), `world/` (une page markdown pour chaque personnage, lieu, quête et le reste), `rules/` (tes règles maison), `images/`, `log.jsonl` (chaque modification), `.saves/`, `.player/` (tes notes), et les petits fichiers qui indiquent aux agents IA où se trouve RPG Engine. Les pages utilisent le format d'Obsidian. Si tu modifies une page à la main, le MJ l'apprend à sa prochaine réponse.
+
+RPG Engine reste dans ce dossier : il lit et écrit la partie uniquement ici, et ne touche jamais à tes autres fichiers. En dehors, il garde seulement son propre dossier de données (les traductions du tableau de bord, ainsi que Codex ou Claude Code si tu le laisses les installer) et des dossiers temporaires pendant qu'une image est dessinée. Pour tout le reste, ton agent te demande d'abord la permission avant d'agir sur ton ordinateur.
+
+Chaque commande que le MJ utilise peut aussi être lancée dans le dossier de la campagne : `rpg --help` les liste. Beaucoup affichent les secrets de la campagne.
+
+---
+
+## 9. Plus tard <!-- icon: hourglass -->
+
+- **Toi comme MJ**, avec l'IA qui joue le groupe.
+- **Mode auteur** : écrire une aventure avec l'IA, puis l'exporter et la partager.
+- **Plusieurs joueurs et joueuses sur le même ordinateur**, chacun avec son personnage, à tour de rôle dans le même chat.
+- **Extensions** : réglages, aventures, fonctions et règles maison.
+- **Importer** tes manuels et tes aventures.
+- **Autres jeux** : d'autres systèmes de jeu, et les tiens.
+
+---
+
+## 10. Questions et problèmes <!-- icon: info -->
+
+### Questions
+
+**Dois-je connaître les règles ?** Non. Choisis le mentor en mode tutoriel, et pose tes questions entre crochets quand tu veux.
+
+**Le MJ peut-il tricher ?** Il ne peut pas modifier un jet fait par RPG Engine, sauf à la difficulté histoire, ni les faits déjà établis.
+
+**Est-ce que ça coûte quelque chose ?** RPG Engine est gratuit. Le MJ fonctionne grâce à l'abonnement de ton agent, ou sur ton propre ordinateur avec un modèle local. Une soirée de jeu, c'est un long chat : avec les plus petits abonnements, tu peux atteindre la limite de l'abonnement avant la fin de la soirée. Les images et les traductions utilisent le même abonnement.
+
+**Puis-je jouer sur mon téléphone ?** Non : le MJ fonctionne sur ton ordinateur, et le tableau de bord ne s'ouvre que là.
+
+**Puis-je jouer avec des amis ?** Pas encore : aujourd'hui, un joueur ou une joueuse, un personnage, plus des compagnons ([Plus tard](#9-coming-later)).
+
+**Puis-je utiliser une autre IA la prochaine fois ?** Oui : ouvre la campagne dans un autre agent et écris *continue*.
+
+### Problèmes
+
+**Le tableau de bord ne s'ouvre pas.** Demande au MJ : `[Quel est le lien du tableau de bord ?]`. Il ne fonctionne que tant qu'un chat est ouvert dans cette campagne, après la première réponse du MJ.
+
+**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, installe de nouveau RPG Engine ([2.2](#22-install)).
+
+**Mise à jour.** Lance de nouveau `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é.
+
+**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.
+
+**Aucune image n'apparaît.** Paramètres > Images indique si cet ordinateur peut en créer, et comment.
+
+**L'installation échoue, ou `rpg` ne démarre pas.** `node --version` doit indiquer 22 ou plus. Sous Windows, garde RPG Engine et tes campagnes loin des chemins qui contiennent `&`.
+
+**Le lien du tableau de bord a changé.** Un autre programme a pris l'adresse habituelle ; le MJ te donne le nouveau lien.