rpg-engine 0.0.0-stage → 0.1.1

package/dist/dashboard/guide/sv.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: den kompletta guiden
+
+**RPG Engine** låter dig spela ett bordsrollspel med en **AI som spelledare**. Du pratar med spelledaren i en **chatt**. RPG Engine arbetar i bakgrunden: det **minns världen**, **slår tärningarna** och **för räkenskaperna**. Bredvid chatten har du en sida öppen i webbläsaren, **dashboarden**, med ditt rollformulär, tärningarna, kartorna och din dagbok.
+
+Den här guiden är till för spelare: du behöver inte kunna programmera.
+
+## Snabbstart <!-- icon: send -->
+
+1. Installera **Node.js** från [nodejs.org](https://nodejs.org) (LTS-versionen).
+2. Installera en **AI-agent**, programmet som spelledaren körs i, och logga in: till exempel Claude Code eller Codex ([2.4](#24-connect-your-ai)).
+3. Installera RPG Engine i en terminal: `npm install -g rpg-engine`.
+4. Skapa en kampanj: `rpg init "The Salt Isles"`.
+5. Gå in i den nya mappen med `cd "The Salt Isles"` och starta din agent där: `claude` för Claude Code, `codex` för Codex. Svara ja när den frågar om du litar på mappen ([2.4](#24-connect-your-ai)) och skriv sedan *Hej! Nu börjar vi.* Spelledaren svarar med länken till din dashboard.
+
+## 1. Vad RPG Engine är <!-- icon: about -->
+
+| Vem | Vad de gör |
+|---|---|
+| **Du** | Du spelar din rollperson: vad den gör, säger och försöker. |
+| **Spelledaren** (AI:n) | Berättar historien, spelar alla andra, avgör vad som händer och ber om slag. |
+| **RPG Engine** | Förvarar världen i filer, slår tärningarna, räknar livspoäng, pengar, tid och avstånd, och håller hemligheter dolda tills du upptäcker dem. |
+
+Världen förblir densamma från en kväll till nästa, även i en ny chatt, även med en annan AI:
+
+- **Det som har sagts förblir sant.** En död skurk förblir död.
+- **Tärningarna är äkta.** Spelledaren kan inte vrida på dem, utom på den lättaste svårighetsgraden, om du väljer den.
+- **Hemligheter förblir hemliga.** Spelledaren berättar aldrig det som din rollperson inte vet.
+- **Världen rör sig.** Hot närmar sig medan du vilar eller reser, och du ser tecknen.
+- **En kampanj är en mapp** på din dator: sluta när du vill och fortsätt senare.
+
+I dag spelar RPG Engine ett spelsystem, **femte utgåvan**, från det fria System Reference Document 5.1. Fler kommer ([Kommer senare](#9-coming-later)).
+
+---
+
+## 2. Komma igång <!-- icon: path -->
+
+### 2.1 Det här behöver du
+
+- En dator med Windows, macOS eller Linux, och en webbläsare.
+- **Node.js 22** eller nyare, från [nodejs.org](https://nodejs.org). Det följer med `npm`, som installerar RPG Engine.
+- En **terminal**: i Windows Terminal eller PowerShell, i macOS Terminal. För att öppna en i en mapp: högerklicka på mappen och välj **Öppna i Terminal** (Windows) eller **Tjänster > Ny terminal i mappen** (macOS).
+- En **AI-agent** för spelledaren ([2.4](#24-connect-your-ai)), med den **största modellen** den erbjuder: en liten modell är lättare att övertala att avslöja hemligheter eller böja reglerna.
+
+### 2.2 Installera
+
+```text
+npm install -g rpg-engine
+```
+
+Med `rpg --version` kontrollerar du att det gick bra. Du använder `rpg` en gång per kampanj, för att skapa den. Därefter startar din agent RPG Engine själv.
+
+### 2.3 Skapa en kampanj
+
+Öppna en terminal i mappen där du förvarar dina spel ([2.1](#21-what-you-need) visar hur):
+
+```text
+rpg init "The Salt Isles"
+```
+
+Då skapas mappen `The Salt Isles` med en ny kampanj i. Gå in i den med `cd "The Salt Isles"`. Kom ihåg var den ligger: du återvänder dit varje gång du spelar. Allt annat väljer du senare, i chatten eller på dashboarden. `rpg init --help` listar alternativen om du vill välja något redan nu, till exempel `--language it` eller `--difficulty hard`.
+
+Spelledaren kan inte skapa en kampanj åt dig: före `init` finns inget som talar om för din agent var RPG Engine finns.
+
+### 2.4 Koppla in din AI
+
+Spelledaren körs i en **AI-agent**: en AI-app, i terminalen eller på skrivbordet, som kan arbeta med filerna på din dator, till exempel Claude Code eller Codex. En vanlig chatt som claude.ai eller ChatGPT, eller en app i telefonen, räcker inte: spelledaren måste nå kampanjens filer på din dator. Varje agent kräver sin egen plan och sin egen inloggning: Claude Code en betald Claude-plan, Codex en ChatGPT-inloggning. Du installerar den en gång, från dess egen sida: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: skriv `claude` i kampanjmappen. När den frågar om du litar på mappen väljer du **Yes, I trust this folder**. Var försiktig: det förvalda svaret är *No, exit*.
+- **Codex**: skriv `codex` i kampanjmappen och svara ja när den frågar om du litar på mappen. I skrivbordsappen kontrollerar du i inställningarna att minnen är avstängda för spelets chattar.
+- **En annan agent**: starta den i kampanjmappen och ge den MCP-servern `rpg mcp`. RPG Engine är en vanlig MCP-server: alla agenter som stöder MCP kan vara spelledare, även lokala.
+
+Vi spelar och testar med **Claude Code**. **Codex** är kopplat och kontrollerat, men ingen hel kampanj har spelats med det ännu. `init` ställer också in **Gemini CLI**. Kampanjen stänger av agentens eget minne: spelet finns i dess filer, så att en återgång till ett sparat spel verkligen går tillbaka.
+
+### 2.5 Den första chatten
+
+Skriv vad du vill, till exempel *Hej! Nu börjar vi.* I sitt första svar i varje chatt ger spelledaren dig **länken till din dashboard**, något i stil med `http://127.0.0.1:4750`. Öppna den och ha den bredvid chatten.
+
+Mellan spelledarens meddelanden visar din agent de verktyg den använder. Öppna inte deras detaljer (i Claude Code, ctrl+o), eftersom de kan avslöja hemligheter.
+
+En ny kampanj går igenom tre steg, som visas högst upp på dashboarden: **1 Inställningar** (hur du vill spela), **2 Session noll** (du skapar din rollperson, under spel), **3 Spel**.
+
+### 2.6 Inställningar: välj hur du spelar
+
+Spelledaren frågar bara det som ännu saknas, några frågor i taget. Dashboardens steg **Inställningar** visar samma frågor som kort. Skriv "du bestämmer" så väljer spelledaren. Allt kan ändras senare, i chatten eller i **Inställningar**.
+
+| Inställning | Vad den avgör | Värden |
+|---|---|---|
+| **Mentor** | Hur mycket spelledaren lär ut reglerna | av, tips, handledning |
+| **Svårighetsgrad** | Hur hård världen är | berättelse, lätt, normal, svår, brutal |
+| **Dödlighet** | Vad det betyder att falla i strid | berättande (dör aldrig), episk (bara när det spelar roll), tärningar |
+| **Sparade spel** | När du får gå tillbaka | permadeath, checkpoint, fritt ([3.8](#38-saves-and-going-back)) |
+| **Stränghet** | Hur noga mat, ljus och resor följer reglerna | mjuk, regler, simulering |
+| **Tärningar** | Vem som slår dina tärningar | digitala, fysiska |
+| **Måttenheter** | Avstånd och vikter | metriska, imperiska |
+| **Följeslagare** | Vem som reser med dig | inga, skapade med dig, skapade av spelledaren, möts under spel |
+| **Bilder** | Bilder av platser, uppdrag och de du möter | inga, på begäran, nya platser, uppdrag och de du möter ([3.11](#311-pictures)) |
+| **Gränser** och **Slöjor** | Det som aldrig förekommer, och det som bara sker utanför scenen | listor |
+| **Språk** | Spelets och dashboardens språk | valfritt |
+
+Femte utgåvan lägger till **utveckling**: erfarenhetspoäng eller milstolpar.
+
+Om ingen värld är skriven frågar spelledaren också efter en **premiss** (genre, ton, några inslag, med dina ord) och efter **förberedelsen**: bygga världen allteftersom, under spelets gång, eller allt i början.
+
+**Spelledarens stil** frågas aldrig, men du kan ändra den i chatten eller i **Inställningar**: **prosan** (enkel, litterär, pulp, torr humor), **berättelserna** den hittar på (situationer, bågar, avsnitt, mysterium), en författare att **skriva som**, eller något annat **med dina ord**.
+
+### 2.7 Session noll: din rollperson
+
+Du skapar din rollperson tillsammans med spelledaren, som vid ett bord. Varje val är ditt, om du inte ber spelledaren göra det: kom med en färdig idé, en vag eller ingenting alls. Spelledaren berättar hur förmågepoängen bestäms innan någon tärning slås. Din bakgrundshistoria krävs aldrig. Om du ger en skriver spelledaren in den med dina ord. Sedan ber spelledaren om en bild av din rollperson ([3.7](#37-your-characters-story-and-picture)). RPG Engine räknar ut rollformuläret: du behöver aldrig räkna själv.
+
+---
+
+## 3. Spela <!-- icon: chat -->
+
+### 3.1 Prata med spelledaren
+
+Skriv vad din rollperson gör eller säger, med egna ord:
+
+> Jag frågar värdshusvärden vilka andra som kom förbi i kväll.
+
+Utanför berättelsen skriver du inom hakparenteser: *[Hur fungerar grappling?]* Spelledaren svarar också inom hakparenteser.
+
+Du säger vad du försöker, spelledaren säger vad som händer. Spelledaren bestämmer aldrig åt din rollperson och pratar aldrig om motorn. Du kan fråga hur dashboarden används.
+
+### 3.2 Slag
+
+Spelledaren ber om ett slag bara när utgången är osäker och spelar roll, och säger först vad som står på spel. Sedan:
+
+- **På dashboarden** visar en banderoll en knapp för varje slag, till exempel *Acrobatics +4 · with advantage*. Klicka på den: tärningarna faller på sidan och spelledaren får resultatet. Du kan också klicka på raden i ditt rollformulär som lyser, slänga tärningarna från tärningsbrickan eller skriva något annat i banderollen.
+- **För hand**, i banderollens hörn eller i **Inställningar**: banderollen säger vad du ska slå, och du slår det från ditt rollformulär eller tärningsbrickan.
+- **Fysiska tärningar**, när tärningsinställningen står på fysiska: du skriver vilka sidor du slog, *[Jag slog 14.]*, och RPG Engine lägger till dina modifikationer.
+
+**Fria slag**: klicka på valfritt tal i ditt rollformulär, eller öppna tärningsbrickan, för att slå på skoj. De räknas aldrig och spelledaren ser dem aldrig.
+
+**Spelledarens slag** visas i din slagkolumn, utom de hemliga. Du kan alltid fråga *[Var det slaget på riktigt?]*: för ett hemligt slag ger spelledaren ett fingeravtryck som bevisar att det gjordes innan du frågade.
+
+### 3.3 Scener och strider
+
+Berättelsen löper i **scener**: en strid, ett samtal, utforskande, resor, en vila. I slutet av varje scen sparas spelet av sig självt, och scenen hamnar i din dagbok.
+
+I en strid berättar spelledaren varje tur som inte är din och stannar där du kan bestämma. Sektionen **Strid** visar turordningen, din grupps livspoäng och hur skadade fienderna ser ut, i ord. Om din rollperson faller visas dödsslagen stort på sidan.
+
+### 3.4 Tid, resor och världen som rör sig
+
+RPG Engine håller reda på datumet. Ingen tid går mellan sessionerna. Säg att ni vilar, *Vi tar en lång vila*, så ger vilan tillbaka det den ska. Säg vart ni går, *Vi tar vägen norrut mot Rocca*, så räknar RPG Engine ut vägen, avståndet och dagarna, och stannar när något händer på vägen. Pengar räknas i spelets mynt, växel inräknad.
+
+Skurkar har planer med tidsgränser. Varje ny dag flyttar spelledaren fram de hot som tiden har fört närmare, och du ser deras tecken, aldrig själva klockan.
+
+### 3.5 Kartor
+
+**Värld** visar de platser din rollperson känner till, vägarna mellan dem och spåret du har gått, med dimma över resten. **Scen** visar kartan över platsen där du befinner dig, när den har en, med vem som står var. I en strid, på din tur, är de rutor du inte kan nå dolda av slöjor. När spelledaren frågar vart du går, tryck på en ruta eller skriv den, till exempel *E4*.
+
+### 3.6 Uppdrag, dagbok och anteckningar
+
+En uppgift som din rollperson tar sig an blir ett uppdrag i **Dagbok**, med sina mål, sin tidsgräns och det den mäter. Markera det med stjärna för att ha det i sikte överst i Scen. Dagboken berättar också din **historia**, scen för scen, och rymmer dina **anteckningar**: privata, om du inte **Delar** en. Spelledaren hör den som vad du tänker, aldrig som ett faktum.
+
+### 3.7 Din rollpersons historia och bild
+
+På ditt rollformulär har kortet **Beskrivning** en ruta för din rollpersons historia: spelledaren skriver in den, efter att du har sagt ja. För en bild ger du spelledaren en fil (PNG, JPEG, WebP eller SVG, upp till 5 MB) med var den finns på din dator, eller låter göra ett porträtt ([3.11](#311-pictures)): *[Gör ett porträtt åt mig: grått hår i fläta, ett ärr på hakan.]*
+
+### 3.8 Sparade spel och att gå tillbaka
+
+RPG Engine sparar hela kampanjen i slutet av varje scen. Inställningen **Sparade spel** avgör resten:
+
+| Sparade spel | Spara när du vill | Gå tillbaka |
+|---|---|---|
+| **permadeath** | nej | aldrig |
+| **checkpoint** | nej | till det senaste sparade spelet, bara när din rollperson dör |
+| **fritt** | ja | till vilket sparat spel som helst |
+
+I alla lägen kan du **börja om**, från spelets början eller från session noll. Gör det i chatten eller i **Sparade spel**.
+
+När du har gått tillbaka ska du **öppna en ny chatt**: den gamla minns det som ogjordes. Skriv *fortsätt* i den nya chatten och tryck sedan på **Jag har öppnat en ny chatt** i Sparade spel.
+
+### 3.9 Sessioner: sluta och komma tillbaka
+
+Sluta när du vill: *[Vi slutar här för i kväll.]* Allt är redan sparat i filerna. För att komma tillbaka startar du din agent i kampanjmappen och skriver *fortsätt*: spelledaren ger dig en kort sammanfattning och går vidare.
+
+### 3.10 Spelledarens sinnesstämning
+
+Roboten högst upp på dashboarden är spelledaren: dess ansikte följer berättelsens ton och avslöjar aldrig det du ännu inte vet. När chatten är stängd sover den.
+
+### 3.11 Bilder
+
+RPG Engine kan låta göra bilder av platserna du når, uppdragen du tar och de du möter, så som inställningen **Bilder** säger, och din rollpersons porträtt när du ber om det. Det använder det som finns på din dator, med din egen inloggning: **Codex** målar dem, annars ritar **Claude Code** dem. **Inställningar** visar om den här datorn kan göra dem, och hur du ställer in det om den inte kan. Du kan alltid ge spelledaren en egen bild.
+
+### 3.12 Trygghet: gränser, slöjor och stopp
+
+**Gränser** förekommer aldrig i spelet. **Slöjor** sker bara utanför scenen. När som helst kan du skriva *[stopp]*: spelledaren släpper det innehållet direkt och lägger till det bland dina gränser.
+
+### 3.13 Ångra dig
+
+Varje inställning kan ändras, i chatten eller i **Inställningar**. Ett avgörande som spelledaren gör utan regelboken blir ett **prejudikat**, så att samma fråga får samma svar nästa gång.
+
+---
+
+## 4. Dashboarden <!-- icon: party -->
+
+En sida på din egen dator, som bara öppnas i den datorns webbläsare och är levande medan chatten är öppen. När chatten stängs visar den *Not connected*. Den kommer tillbaka av sig själv med nästa chatt.
+
+- **Grupp**: ditt rollformulär och dina följeslagares. Klicka på ett tal för att slå det. Håll muspekaren över det för att se var det kommer ifrån. Bredvid finns slagen.
+- **Scen**: var du är, dess bild och karta, vem som är där, vad som händer.
+- **Strid**: bara i en strid: turerna, de som slåss, det du har till hands.
+- **Dagbok**: uppdrag, historien, dina anteckningar.
+- **Värld**: världskartan så som din rollperson känner den.
+- **Tärningsbrickan**: välj tärningar och en modifikation, och slå.
+- **Sparade spel**, **Hjälp**, **Inställningar** och **Om**, som ikoner i slutet av raden. Inställningar rymmer också sidans egna val: tema, tärningsljud, tärningsset.
+
+När spelledaren frågar dig något ligger dess banderoll kvar överst, oavsett vilken sektion du är i.
+
+---
+
+## 5. Spelsystem och husregler <!-- icon: dice -->
+
+### 5.1 Vad ett spelsystem är
+
+Data för ett spel: dess rollformulär, dess tal, dess varelser, föremål, besvärjelser och regeltexter. Varje kampanj spelar ett system. RPG Engine räknar ut rollformuläret och vad som förbrukas och kommer tillbaka. Hur en egenskap fungerar läser spelledaren i reglerna och avgör, som vid ett bord.
+
+### 5.2 Femte utgåvan, ingår
+
+Raserna, klasserna, subklasserna, en bakgrund och en färdighet (feat) i SRD 5.1, de 319 besvärjelserna, vapnen, rustningarna, magiska föremålen och monstren, regelkapitlen som spelledaren läser efter exakt text och det fullständiga rollformuläret, uträknat.
+
+Du kan också spela innehåll som saknas i SRD, från en bok du äger: spelledaren skriver det som sidor i din kampanj, och RPG Engine behandlar dem som sina egna. RPG Engine levereras bara med öppet innehåll. Det din spelledare kan är inte begränsat.
+
+### 5.3 Husregler och egna tillägg
+
+Fråga spelledaren: *[Husregel: en naturlig 1 på en attack betyder att du tappar ditt vapen.]* Den behåller det som en överenskommelse vid bordet, eller skriver en sida eller ett tal i rollformuläret när det behövs. Husregler som redan är utskrivna kan läggas som textfiler i kampanjens mapp `rules`.
+
+### 5.4 Lägga till eller importera ditt eget spelsystem
+
+Inte än: i dag spelar RPG Engine bara femte utgåvan ([Kommer senare](#9-coming-later)).
+
+---
+
+## 6. Tillägg <!-- icon: plus -->
+
+Inte än. Ett tillägg kommer att lägga till något i en kampanj ovanpå dess spelsystem: en värld, ett äventyr, en funktion som vädret, husregler att dela.
+
+---
+
+## 7. Var en kampanj kommer ifrån, och dess språk <!-- icon: world -->
+
+### 7.1 Tre sätt att få en värld
+
+- **Skapad allteftersom**: utifrån din premiss bygger spelledaren varje plats, person och intrig strax innan du behöver den, och behåller den.
+- **Förberedd i början**: samma sak, men med världen byggd före spelet.
+- **Från ditt eget äventyr**: ge spelledaren en text eller en PDF och be den ställa in det, *[Ställ in det här äventyret som vår kampanj. Berätta inget av det som står i det.]* Spelledaren skriver platserna, rollpersonerna och hemligheterna. Det finns ingen importknapp än.
+
+En kampanj spelas en gång: för att spela samma äventyr igen skapar du en ny kampanj.
+
+### 7.2 Språk
+
+Ett språk per kampanj, spelledarens, som dashboarden följer. Dashboarden levereras på 26 språk. Alla andra översätts på din dator av Codex eller Claude Code, eller, utan dem, av spelledaren i chatten. Femte utgåvans termer på italienska kommer från den officiella italienska SRD:n. Regeltexten förblir på engelska, och spelledaren berättar den på ditt språk.
+
+---
+
+## 8. För den nyfikne: kampanjmappen <!-- icon: list -->
+
+Du behöver aldrig öppna den, och den innehåller din kampanjs hemligheter. I den finns `campaign.yaml` (dina inställningar), `state.yaml` (hur långt spelet har kommit), `world/` (en markdownsida för varje rollperson, plats, uppdrag och allt annat), `rules/` (dina egna regler), `images/`, `log.jsonl` (varje ändring), `.saves/`, `.player/` (dina anteckningar) och de små filer som talar om för AI-agenter var RPG Engine finns. Sidorna använder Obsidians format. Om du ändrar en sida för hand får spelledaren veta det vid sitt nästa svar.
+
+RPG Engine håller sig i den här mappen: programmet läser och skriver spelet bara här och rör aldrig dina andra filer. Utanför mappen har det bara en egen datamapp (dashboardens översättningar, samt Codex eller Claude Code om du låter det installera dem) och tillfälliga mappar medan en bild ritas. Allt annat som din agent vill göra på din dator frågar den dig om först.
+
+Alla kommandon som spelledaren använder kan också köras i kampanjmappen: `rpg --help` listar dem. Många av dem skriver ut kampanjens hemligheter.
+
+---
+
+## 9. Kommer senare <!-- icon: hourglass -->
+
+- **Du som spelledare**, med AI:n som spelar gruppen.
+- **Författarläge**: skriv ett äventyr med AI:n, exportera det och dela det.
+- **Flera spelare på samma dator**, var och en med sin egen rollperson, som turas om i samma chatt.
+- **Tillägg**: inställningar, äventyr, funktioner och husregler.
+- **Import** av dina regelböcker och äventyr.
+- **Andra spel**: fler spelsystem, och dina egna.
+
+---
+
+## 10. Frågor och problem <!-- icon: info -->
+
+### Frågor
+
+**Måste jag kunna reglerna?** Nej. Välj mentorn handledning och fråga inom hakparenteser när du vill.
+
+**Kan spelledaren fuska?** Den kan inte ändra ett slag som RPG Engine har gjort, utom på svårighetsgraden berättelse, och inte heller fakta som redan är fastställda.
+
+**Kostar det något?** RPG Engine är gratis. Spelledaren körs på din agents plan, eller på din egen dator med en lokal modell. En spelkväll är en lång chatt: på de minsta planerna kan du nå planens gräns innan kvällen är slut. Bilder och översättningar använder samma plan.
+
+**Kan jag spela i telefonen?** Nej: spelledaren körs på din dator, och dashboarden öppnas bara där.
+
+**Kan jag spela med vänner?** Inte än: i dag en spelare, en rollperson, plus följeslagare ([Kommer senare](#9-coming-later)).
+
+**Kan jag använda en annan AI nästa gång?** Ja: öppna kampanjen i en annan agent och skriv *fortsätt*.
+
+### Problem
+
+**Dashboarden öppnas inte.** Fråga spelledaren: `[Vad är länken till dashboarden?]`. Den fungerar bara medan en chatt är öppen i den kampanjen, efter spelledarens första svar.
+
+**Spelledaren verkar inte kunna spelet.** Din agent har inte laddat RPG Engine. Kontrollera att du startade den i kampanjmappen och att du litade på den. I Claude Code skriver du `/mcp` och ansluter `rpg` igen. I Codex måste `codex mcp list` i kampanjmappen visa `rpg`. Om `rpg --version` inte hittas, installera RPG Engine igen ([2.2](#22-install)).
+
+**Uppdatera.** Kör `npm install -g rpg-engine` igen och öppna sedan en ny chatt: en spelledare som redan körs behåller den version den startade med.
+
+**Spelledaren minns något som jag ångrade.** Öppna en ny chatt och tryck på **Jag har öppnat en ny chatt** i Sparade spel.
+
+**Inga bilder visas.** Inställningar > Bilder visar om den här datorn kan göra dem, och hur.
+
+**Installationen misslyckas, eller `rpg` startar inte.** `node --version` måste visa 22 eller nyare. I Windows ska du hålla RPG Engine och dina kampanjer borta från sökvägar som innehåller `&`.
+
+**Dashboardlänken har ändrats.** Ett annat program tog den vanliga adressen. Spelledaren ger dig den nya länken.

package/dist/dashboard/guide/tr.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: eksiksiz kılavuz
+
+**RPG Engine**, masa başı rol yapma oyununu **yapay zekâ oyun yöneticisiyle** oynamanı sağlar. Oyun yöneticisiyle bir **sohbette** konuşursun; RPG Engine ise arka planda çalışır: **dünyayı hatırlar**, **zarları atar** ve **hesapları tutar**. Sohbetin yanında tarayıcında bir sayfa açık tutarsın: **gösterge paneli**. Orada karakter kağıdın, zarların, haritaların ve günlüğün durur.
+
+Bu kılavuz oyuncular için yazıldı: program yazmayı bilmen gerekmez.
+
+## Hızlı başlangıç <!-- icon: send -->
+
+1. [nodejs.org](https://nodejs.org) adresinden **Node.js** kur (LTS sürümü).
+2. Bir **yapay zekâ ajanı** kur ve giriş yap. Oyun yöneticisi bu programın içinde çalışır. Örneğin Claude Code ya da Codex ([2.4](#24-connect-your-ai)).
+3. Bir terminalde RPG Engine'i kur: `npm install -g rpg-engine`.
+4. Bir kampanya oluştur: `rpg init "The Salt Isles"`.
+5. Yeni klasöre gir, `cd "The Salt Isles"`, ve ajanını orada başlat: Claude Code için `claude`, Codex için `codex`. Klasöre güvenip güvenmediğini sorduğunda evet de ([2.4](#24-connect-your-ai)), sonra *Merhaba! Başlayalım.* yaz. Oyun yöneticisi gösterge panelinin bağlantısıyla yanıt verir.
+
+## 1. RPG Engine nedir <!-- icon: about -->
+
+| Kim | Ne yapar |
+|---|---|
+| **Sen** | Karakterini oynarsın: ne yaptığını, ne söylediğini ve neyi denediğini sen belirlersin. |
+| **Oyun yöneticisi** (yapay zekâ) | Hikâyeyi anlatır, diğer herkesi oynar, olacakları belirler, atış ister. |
+| **RPG Engine** | Dünyayı dosyalarda tutar, zarları atar, can puanını, parayı, zamanı ve mesafeleri sayar, sırları sen keşfedene kadar saklar. |
+
+Dünya bir akşamdan ötekine aynı kalır. Yeni bir sohbette de, başka bir yapay zekâyla da değişmez:
+
+- **Söylenen şey doğru kalır.** Ölen kötü karakter ölü kalır.
+- **Zarlar gerçektir.** Oyun yöneticisi onları eğip bükemez. Tek istisna, seçersen en kolay zorluk seviyesidir.
+- **Sırlar sır kalır.** Oyun yöneticisi, karakterinin bilmediği şeyi sana asla söylemez.
+- **Dünya hareket eder.** Sen dinlenirken ya da yolculuk ederken tehditler ilerler ve işaretlerini görürsün.
+- **Kampanya bir klasördür.** Bilgisayarında durur: istediğin zaman bırak, sonra devam et.
+
+RPG Engine bugün tek bir oyun sistemi oynatır: ücretsiz System Reference Document 5.1'den **beşinci edisyon**. Diğerleri gelecek ([Daha sonra gelecekler](#9-coming-later)).
+
+---
+
+## 2. Başlarken <!-- icon: path -->
+
+### 2.1 Neye ihtiyacın var
+
+- Windows, macOS ya da Linux çalıştıran bir bilgisayar ve bir web tarayıcısı.
+- **Node.js 22** veya daha yenisi, [nodejs.org](https://nodejs.org) adresinden. Yanında `npm` gelir, RPG Engine'i o kurar.
+- Bir **terminal**: Windows'ta Terminal ya da PowerShell, macOS'ta Terminal. Terminali bir klasörde açmak için klasöre sağ tıkla ve **Terminalde Aç** (Windows) ya da **Klasörde Yeni Terminal** (macOS) seçeneğini seç.
+- Oyun yöneticisi için bir **yapay zekâ ajanı** ([2.4](#24-connect-your-ai)). Sunduğu **en büyük modeli** kullan: küçük bir modeli sır söylemeye ya da kuralları esnetmeye ikna etmek daha kolaydır.
+
+### 2.2 Kurulum
+
+```text
+npm install -g rpg-engine
+```
+
+`rpg --version` komutu kurulumun işe yaradığını kontrol eder. `rpg` komutunu kampanya başına bir kez, kampanyayı oluşturmak için kullanırsın. Sonrasında ajanın RPG Engine'i kendisi başlatır.
+
+### 2.3 Kampanya oluşturma
+
+Oyunlarını tuttuğun klasörde bir terminal aç ([2.1](#21-what-you-need) nasıl yapılacağını anlatır):
+
+```text
+rpg init "The Salt Isles"
+```
+
+Bu komut `The Salt Isles` klasörünü ve içinde yeni bir kampanya oluşturur. `cd "The Salt Isles"` ile klasöre gir. Nerede olduğunu aklında tut: her oynayışında buraya dönersin. Geri kalan her şeyi sonra, sohbette ya da gösterge panelinde seçersin. Bazılarını şimdiden seçmek istersen `rpg init --help` seçenekleri listeler, örneğin `--language it` ya da `--difficulty hard`.
+
+Oyun yöneticisi senin için kampanya oluşturamaz: `init` çalışmadan önce ajanına RPG Engine'in nerede olduğunu söyleyen hiçbir şey yoktur.
+
+### 2.4 Yapay zekânı bağla
+
+Oyun yöneticisi bir **yapay zekâ ajanının** içinde çalışır. Bu, terminalde ya da masaüstünde çalışan ve bilgisayarındaki dosyalarla iş yapabilen bir yapay zekâ uygulamasıdır; örneğin Claude Code ya da Codex. claude.ai ya da ChatGPT gibi sade bir sohbet ya da telefon uygulaması yetmez: oyun yöneticisinin bilgisayarındaki kampanya dosyalarına erişmesi gerekir. Her ajanın kendi planı ve girişi vardır: Claude Code için ücretli bir Claude planı, Codex için bir ChatGPT girişi. Ajanı bir kez, kendi sayfasından kurarsın: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: kampanya klasöründe `claude` yaz. Klasöre güvenip güvenmediğini sorduğunda **Yes, I trust this folder** seçeneğini seç. Dikkat: önceden seçili gelen yanıt *No, exit* olur.
+- **Codex**: kampanya klasöründe `codex` yaz ve klasöre güvenip güvenmediğini sorduğunda evet de. Masaüstü uygulamasında, ayarlardan oyunun sohbetleri için belleklerin kapalı olduğunu kontrol et.
+- **Başka bir ajan**: kampanya klasöründe başlat ve ona `rpg mcp` MCP sunucusunu ver. RPG Engine standart bir MCP sunucusudur: MCP destekleyen her ajan oyun yöneticisi olabilir, yerel olanlar da.
+
+Biz **Claude Code** ile oynuyor ve test ediyoruz. **Codex** bağlı ve kontrol edildi, ama onunla henüz tam bir kampanya oynanmadı. `init` ayrıca **Gemini CLI**'ı da hazırlar. Kampanya ajanın kendi belleğini kapatır: oyun dosyalarında yaşar, böylece bir kaydın öncesine dönmek gerçekten geri dönmek olur.
+
+### 2.5 İlk sohbet
+
+*Merhaba! Başlayalım.* gibi herhangi bir şey yaz. Oyun yöneticisi her sohbetteki ilk yanıtında sana **gösterge panelinin bağlantısını** verir; `http://127.0.0.1:4750` gibi bir şeydir. Bağlantıyı aç ve sohbetin yanında açık tut.
+
+Oyun yöneticisinin mesajları arasında ajanın kullandığı araçları gösterir. Ayrıntılarını açma (Claude Code'da ctrl+o), çünkü sırları gösterebilirler.
+
+Yeni bir kampanya, gösterge panelinin üstünde görünen üç aşamadan geçer: **1 Ayarlar** (nasıl oynamak istediğin), **2 Sıfırıncı oturum** (karakterini oyun içinde yaparsın), **3 Oyun**.
+
+### 2.6 Ayarlar: nasıl oynayacağını seçmek
+
+Oyun yöneticisi yalnızca eksik kalan şeyleri sorar, her seferinde birkaç soru. Gösterge panelindeki **Ayarlar** adımı aynı soruları kartlar olarak gösterir. "Sen karar ver" yazarsan oyun yöneticisi seçer. Her şey sonradan, sohbette ya da **Ayarlar**'da değiştirilebilir.
+
+| Ayar | Neye karar verir | Değerler |
+|---|---|---|
+| **Akıl hocası** | Oyun yöneticisinin sana kuralları ne kadar öğrettiği | kapalı, ipuçları, öğretici |
+| **Zorluk** | Dünyanın ne kadar zor oynadığı | hikâye, kolay, normal, zor, acımasız |
+| **Ölümcüllük** | Bir çatışmada yere düşmenin ne anlama geldiği | anlatısal (asla ölmezsin), epik (yalnızca önemli olduğunda), zar |
+| **Kayıtlar** | Ne zaman geri dönebileceğin | kalıcı ölüm, kontrol noktası, serbest ([3.8](#38-saves-and-going-back)) |
+| **Kural sıkılığı** | Yiyecek, ışık ve yolculuğun kuralları ne kadar yakından izlediği | akıcı, kurallar, simülasyon |
+| **Zarlar** | Zarlarını kimin attığı | dijital, fiziksel |
+| **Birimler** | Mesafeler ve ağırlıklar | metrik, imparatorluk |
+| **Yoldaşlar** | Seninle kimin yolculuk ettiği | yok, seninle yapılan, oyun yöneticisinin yaptığı, oyunda tanışılan |
+| **Görseller** | Yerlerin, görevlerin ve tanışılanların görselleri | yok, istek üzerine, yeni yerler, görevler ve tanışılanlar ([3.11](#311-pictures)) |
+| **Sınırlar** ve **Perdeler** | Hiç görünmeyecekler ve yalnızca sahne dışında olacaklar | listeler |
+| **Dil** | Oyunun ve gösterge panelinin dili | herhangi biri |
+
+Beşinci edisyon bir de **ilerleme** ekler: deneyim puanları ya da kilometre taşları.
+
+Yazılı bir dünya yoksa oyun yöneticisi bir de **öncül** (tür, ton, birkaç öğe; kendi sözlerinle) ve **hazırlık** sorar: dünyayı oynarken anında mı kuracak, yoksa baştan hepsini mi.
+
+**Oyun yöneticisinin üslubu** hiç sorulmaz, ama sohbette ya da **Ayarlar**'da değiştirebilirsin: **anlatım** (sade, edebî, pulp, alaycı), oyun yöneticisinin uydurduğu **hikâyeler** (durumlar, yaylar, bölümler, gizem), **tarzını örnek alacağı** bir yazar ya da **kendi sözlerinle** başka herhangi bir şey.
+
+### 2.7 Sıfırıncı oturum: karakterin
+
+Karakterini bir masadaki gibi oyun yöneticisiyle birlikte yaparsın. Her seçim senindir, oyun yöneticisinden yapmasını istemediğin sürece. Dolu bir fikirle, belirsiz bir fikirle ya da hiçbir şeyle gelebilirsin. Oyun yöneticisi, daha hiçbir zar atılmadan önce yetenek puanlarının nasıl belirleneceğini söyler. Bir hikâye şart değildir. Verirsen oyun yöneticisi onu senin sözlerinle yazar. Sonra oyun yöneticisi karakterin için bir görsel ister ([3.7](#37-your-characters-story-and-picture)). Karakter kağıdını RPG Engine hesaplar: hiç toplama yapmazsın.
+
+---
+
+## 3. Oynamak <!-- icon: chat -->
+
+### 3.1 Oyun yöneticisiyle konuşmak
+
+Karakterinin ne yaptığını ya da söylediğini kendi sözlerinle yaz:
+
+> Hancıya bu gece başka kimin uğradığını soruyorum.
+
+Hikâyenin dışına çıkmak için köşeli parantez içinde yaz: *[Güreş tutuşu nasıl işliyor?]* Oyun yöneticisi de köşeli parantezle yanıt verir.
+
+Sen neyi denediğini söylersin, oyun yöneticisi ne olduğunu söyler. Oyun yöneticisi karakterin adına asla karar vermez ve motordan asla söz etmez. Gösterge panelini nasıl kullanacağını ona sorabilirsin.
+
+### 3.2 Atışlar
+
+Oyun yöneticisi atışı yalnızca sonuç belirsizse ve önemliyse ister, ve önce nelerin tehlikede olduğunu söyler. Sonra:
+
+- **Gösterge panelinde** bir bant her kontrol için bir düğme gösterir, örneğin *Akrobasi +4 · vantaggio ile*. Düğmeye tıkla: zarlar sayfaya düşer ve oyun yöneticisi sonucu duyar. Karakter kağıdında yanan satıra da tıklayabilir, zarları tepsiden atabilir ya da banta başka bir şey yazabilirsin.
+- **Elle**, bandın köşesinde ya da **Ayarlar**'da: bant neyi atman gerektiğini söyler, sen de onu karakter kağıdından ya da tepsiden atarsın.
+- **Fiziksel zarlar**, zar ayarı fiziksel olduğunda: attığın yüzleri yazarsın, *[14 attım.]*, RPG Engine değiştiricilerini ekler.
+
+**Serbest atışlar**: eğlenmek için atmak üzere karakter kağıdındaki herhangi bir sayıya tıkla ya da zar tepsisini aç. Hiçbir zaman sayılmazlar ve oyun yöneticisi onları görmez.
+
+**Oyun yöneticisinin atışları**, gizli olanlar dışında atış sütununda görünür. Her zaman sorabilirsin: *[Bu atış gerçek miydi?]* Gizli bir atış için oyun yöneticisi, sen sormadan önce yapıldığını kanıtlayan bir parmak izi verir.
+
+### 3.3 Sahneler ve çatışmalar
+
+Hikâye **sahneler** hâlinde ilerler: bir çatışma, bir konuşma, keşif, yolculuk, bir dinlenme. Her sahnenin sonunda oyun kendiliğinden kaydeder ve sahne günlüğüne girer.
+
+Bir çatışmada oyun yöneticisi senin olmayan her sırayı anlatır ve karar verebileceğin yerde durur. **Çatışma** bölümü sıraların düzenini, grubunun can puanlarını ve düşmanların ne kadar yaralı göründüğünü sözcüklerle gösterir. Karakterin yere düşerse ölüm kayıtları sayfada büyük görünür.
+
+### 3.4 Zaman, yolculuk ve hareket eden dünya
+
+RPG Engine tarihi tutar; oturumlar arasında zaman geçmez. Dinlendiğini söylersen, *Uzun bir dinlenmeye çekiliyoruz*, dinlenme geri gelmesi gerekeni geri getirir. Nereye gittiğini söylersen, *Kuzeye, Rocca'ya giden yola çıkıyoruz*, RPG Engine yolu, mesafeyi ve günleri hesaplar; yolda bir şey olursa durur. Para oyunun madeni paralarıyla sayılır, para üstü dahil.
+
+Kötü karakterlerin son tarihleri olan planları vardır. Her yeni günde oyun yöneticisi, zamanın ilerlettiği tehditleri hareket ettirir ve sen onların işaretlerini görürsün, saatin kendisini asla.
+
+### 3.5 Haritalar
+
+**Dünya**, karakterinin bildiği yerleri, aralarındaki yolları ve yürüdüğün izi gösterir; geri kalanın üstünde sis vardır. **Sahne**, bulunduğun yerin haritasını, varsa, kimin nerede durduğuyla birlikte gösterir. Çatışmada, sıran geldiğinde, ulaşamayacağın kareler perdelenir. Oyun yöneticisi nereye gideceğini sorduğunda bir kareye dokun ya da onu yaz, örneğin *E4*.
+
+### 3.6 Görevler, günlük ve notlar
+
+Karakterinin üstlendiği bir iş, **Günlük**'te hedefleri, son tarihi ve neyi ölçtüğüyle birlikte bir görev olur. Sahnenin üstünde gözünün önünde kalsın diye görevi yıldızla. Günlük ayrıca **hikâyeni** sahne sahne anlatır ve **notlarını** tutar: notlar özeldir, birini **Paylaş**mazsan. Paylaştığın notu oyun yöneticisi senin düşüncen olarak duyar, asla bir gerçek olarak değil.
+
+### 3.7 Karakterinin hikâyesi ve görseli
+
+Karakter kağıdında **Açıklama** kartında karakterinin hikâyesi için bir kutu vardır: sen evet dedikten sonra oyun yöneticisi onu oraya yazar. Görsel için oyun yöneticisine bir dosya ver (PNG, JPEG, WebP ya da SVG, en çok 5 MB) ve bilgisayarında nerede olduğunu söyle, ya da bir portre yaptır ([3.11](#311-pictures)): *[Bana bir portre yap: örgülü gri saç, çenede bir yara izi.]*
+
+### 3.8 Kayıtlar ve geri dönmek
+
+RPG Engine her sahnenin sonunda kampanyanın tamamını kaydeder. Gerisine **kayıtlar** ayarı karar verir:
+
+| Kayıtlar | İstediğinde kaydet | Geri dön |
+|---|---|---|
+| **kalıcı ölüm** | hayır | asla |
+| **kontrol noktası** | hayır | son kayda, yalnızca karakterin öldüğünde |
+| **serbest** | evet | herhangi bir kayda |
+
+Her kipte **baştan başlayabilirsin**: oyunun başından ya da sıfırıncı oturumdan. Bunu sohbette ya da **Kayıtlar**'da yap.
+
+Geri döndükten sonra **yeni bir sohbet aç**: eski sohbet geri alınanı hatırlar. Yeni sohbette *devam* yaz, sonra Kayıtlar'da **Yeni sohbet açtım** düğmesine bas.
+
+### 3.9 Oturumlar: durmak ve geri dönmek
+
+İstediğin zaman dur: *[Bu akşamlık burada duralım.]* Her şey zaten dosyalarda kayıtlı. Geri dönmek için ajanını kampanya klasöründe başlat ve *devam* yaz: oyun yöneticisi sana kısa bir özet geçer ve devam eder.
+
+### 3.10 Oyun yöneticisinin ruh hâli
+
+Gösterge panelinin üstündeki robot oyun yöneticisidir: yüzü hikâyenin tonunu izler ve henüz bilmediğin şeyi asla ele vermez. Sohbet kapalıyken uyur.
+
+### 3.11 Görseller
+
+RPG Engine, ulaştığın yerlerin, üstlendiğin görevlerin ve tanıştıklarının görsellerini, **görseller** ayarının dediği gibi, ve istediğinde karakterinin portresini yaptırabilir. Bilgisayarındakini ve kendi girişini kullanır: görselleri **Codex** çizer, o yoksa **Claude Code**. **Ayarlar** bu bilgisayarın görsel yapıp yapamadığını, yapamıyorsa nasıl kurulacağını söyler. Oyun yöneticisine her zaman kendi görselini verebilirsin.
+
+### 3.12 Güvenlik: sınırlar, perdeler ve dur
+
+**Sınırlar** oyunda asla görünmez; **perdeler** yalnızca sahne dışında olur. İstediğin an *[dur]* yaz: oyun yöneticisi o içeriği hemen bırakır ve sınırlarına ekler.
+
+### 3.13 Fikir değiştirmek
+
+Her ayar değiştirilebilir, sohbette ya da **Ayarlar**'da. Oyun yöneticisinin kitapsız verdiği bir karar **emsal** olur, böylece aynı soru bir dahaki sefere aynı yanıtı alır.
+
+---
+
+## 4. Gösterge paneli <!-- icon: party -->
+
+Kendi bilgisayarındaki bir sayfa; yalnızca o bilgisayarın tarayıcısında açılır ve sohbet açıkken canlıdır. Sohbet kapanınca *Not connected* gösterir; bir sonraki sohbetle kendiliğinden geri gelir.
+
+- **Grup**: senin karakter kağıdın ve yoldaşlarınınki. Bir sayıya tıklayarak at; nereden geldiğini görmek için üstüne gel. Yanında atışlar durur.
+- **Sahne**: bulunduğun yer, görseli ve haritası, orada kimlerin olduğu, neler olduğu.
+- **Çatışma**: yalnızca bir çatışmada: sıralar, savaşanlar, elinin altındakiler.
+- **Günlük**: görevler, hikâye, notların.
+- **Dünya**: karakterinin bildiği hâliyle dünya haritası.
+- **Zar tepsisi**: zarları ve bir değiştirici seç, at.
+- **Kayıtlar**, **Yardım**, **Ayarlar** ve **Hakkında**, satırın sonunda simgeler olarak. Ayarlar ayrıca sayfanın kendi tercihlerini de tutar: tema, zar sesi, zar takımı.
+
+Oyun yöneticisi sana bir şey sorduğunda, hangi bölümde olursan ol, bandı en üstte kalır.
+
+---
+
+## 5. Oyun sistemleri ve ev kuralları <!-- icon: dice -->
+
+### 5.1 Oyun sistemi nedir
+
+Bir oyunun verileri: karakter kağıdı, sayıları, yaratıkları, eşyaları, büyüleri ve kural metni. Her kampanya tek bir sistem oynar. RPG Engine karakter kağıdını, harcananı ve geri geleni hesaplar; bir özelliğin nasıl işlediğini ise oyun yöneticisi kurallardan okur ve bir masadaki gibi karar verir.
+
+### 5.2 Beşinci edisyon, dahil
+
+SRD 5.1'in ırkları, sınıfları, alt sınıfları, bir geçmişi ve bir yeteneği; 319 büyü, silahlar, zırhlar, sihirli eşyalar ve canavarlar; oyun yöneticisinin tam metniyle okuduğu kural bölümleri; hesaplanmış tam karakter kağıdı.
+
+SRD'de olmayan içerikleri de, sahip olduğun bir kitaptan oynayabilirsin: oyun yöneticisi onu kampanyanın sayfaları olarak yazar ve RPG Engine onlara kendi sayfaları gibi davranır. RPG Engine yalnızca açık içerik dağıtır; oyun yöneticinin bildikleri sınırlı değildir.
+
+### 5.3 Ev kuralları ve kendi eklemelerin
+
+Oyun yöneticisine sor: *[Ev kuralı: saldırıda doğal 1 gelirse silahını düşürürsün.]* Bunu masanın bir anlaşması olarak tutar; gerekirse bir sayfa ya da karakter kağıdında bir sayı yazar. Önceden yazılmış ev kuralları, kampanyanın `rules` klasörüne metin dosyaları olarak konabilir.
+
+### 5.4 Kendi oyun sistemini eklemek ya da içe aktarmak
+
+Henüz değil: bugün RPG Engine yalnızca beşinci edisyonu oynatır ([Daha sonra gelecekler](#9-coming-later)).
+
+---
+
+## 6. Eklentiler <!-- icon: plus -->
+
+Henüz değil. Bir eklenti, oyun sisteminin üstüne kampanyaya bir şey ekleyecek: bir dünya, bir macera, hava durumu gibi bir özellik, paylaşılacak ev kuralları.
+
+---
+
+## 7. Kampanya nereden gelir ve dili <!-- icon: world -->
+
+### 7.1 Dünyaya sahip olmanın üç yolu
+
+- **Oynarken yapılan**: öncülünden yola çıkarak oyun yöneticisi her yeri, kişiyi ve olay örgüsünü tam ihtiyacın olmadan önce kurar ve saklar.
+- **Baştan hazırlanan**: aynısı, ama dünya oyundan önce kurulur.
+- **Kendi maceranla**: oyun yöneticisine bir metin ya da PDF ver ve hazırlamasını iste: *[Bu macerayı kampanyamız olarak hazırla. İçindeki hiçbir şeyi bana söyleme.]* Yerleri, karakterleri ve sırları yazar. Henüz içe aktarma düğmesi yok.
+
+Bir kampanya bir kez oynanır: aynı macerayı yeniden oynamak için yeni bir kampanya oluştur.
+
+### 7.2 Diller
+
+Kampanya başına bir dil vardır: oyun yöneticisinin dili; gösterge paneli onu izler. Gösterge paneli 26 dille gelir. Başka her dil bilgisayarında Codex ya da Claude Code tarafından, onlar yoksa sohbette oyun yöneticisi tarafından çevrilir. Beşinci edisyonun İtalyanca terimleri resmî İtalyanca SRD'den gelir; kural metni İngilizce kalır ve oyun yöneticisi onu senin dilinde anlatır.
+
+---
+
+## 8. Merak edenler için: kampanya klasörü <!-- icon: list -->
+
+Klasörü açmana hiç gerek yok. Kampanyanın sırlarını da içerir. Klasörde şunlar var: `campaign.yaml` (ayarların), `state.yaml` (oyunun geldiği nokta), `world/` (her karakter, yer, görev ve diğer her şey için bir markdown sayfası), `rules/` (ev kuralların), `images/`, `log.jsonl` (her değişiklik), `.saves/`, `.player/` (notların) ve yapay zekâ ajanlarına RPG Engine'in nerede olduğunu söyleyen küçük dosyalar. Sayfalar Obsidian'ın biçimini kullanır. Bir sayfayı elle değiştirirsen oyun yöneticisi bunu bir sonraki cevabında öğrenir.
+
+RPG Engine bu klasörde kalır: oyunu yalnızca burada okur ve yazar, diğer dosyalarına hiç dokunmaz. Klasörün dışında yalnızca kendi veri klasörünü tutar (panelin çevirileri ve izin verirsen kurduğu Codex ya da Claude Code) ve bir resim çizilirken geçici klasörler kullanır. Ajanın bilgisayarında başka bir şey yapmak isterse önce sana sorar.
+
+Oyun yöneticisinin kullandığı her komutu kampanya klasöründe sen de çalıştırabilirsin: `rpg --help` hepsini listeler. Çoğu, kampanyanın sırlarını yazdırır.
+
+---
+
+## 9. Daha sonra gelecekler <!-- icon: hourglass -->
+
+- **Oyun yöneticisi olarak sen**, grubu yapay zekâ oynarken.
+- **Yazar kipi**: yapay zekâyla bir macera yaz, sonra dışa aktar ve paylaş.
+- **Aynı bilgisayarda birden çok oyuncu**: her biri kendi karakteriyle, aynı sohbette sırayla.
+- **Eklentiler**: ayarlar, maceralar, özellikler ve ev kuralları.
+- Kılavuzlarını ve maceralarını **içe aktarmak**.
+- **Başka oyunlar**: daha çok oyun sistemi ve kendi sistemin.
+
+---
+
+## 10. Sorular ve sorunlar <!-- icon: info -->
+
+### Sorular
+
+**Kuralları bilmem gerekiyor mu?** Hayır. Öğretici akıl hocasını seç ve istediğin zaman köşeli parantez içinde sor.
+
+**Oyun yöneticisi hile yapabilir mi?** RPG Engine'in yaptığı bir atışı değiştiremez; yalnızca hikâye zorluğunda bu mümkündür. Belirlenmiş gerçekleri de değiştiremez.
+
+**Bir maliyeti var mı?** RPG Engine ücretsizdir. Oyun yöneticisi ajanının planıyla ya da yerel bir modelle kendi bilgisayarında çalışır. Bir oyun akşamı uzun bir sohbettir: en küçük planlarda akşam bitmeden planın sınırına ulaşabilirsin. Görseller ve çeviriler aynı planı kullanır.
+
+**Telefonumda oynayabilir miyim?** Hayır: oyun yöneticisi bilgisayarında çalışır ve gösterge paneli yalnızca orada açılır.
+
+**Arkadaşlarımla oynayabilir miyim?** Henüz değil: bugün tek oyuncu, tek karakter ve yoldaşlar var ([Daha sonra gelecekler](#9-coming-later)).
+
+**Bir dahaki sefere başka bir yapay zekâ kullanabilir miyim?** Evet: kampanyayı başka bir ajanda aç ve *devam* yaz.
+
+### Sorunlar
+
+**Gösterge paneli açılmıyor.** Oyun yöneticisine sor: `[Gösterge panelinin bağlantısı ne?]`. Yalnızca o kampanyada bir sohbet açıkken, oyun yöneticisinin ilk yanıtından sonra çalışır.
+
+**Oyun yöneticisi oyunu bilmiyor gibi.** Ajanın RPG Engine'i yüklemedi. Onu kampanya klasöründe başlattığından ve ona güvendiğinden emin ol. Claude Code'da `/mcp` yaz ve `rpg`'yi yeniden bağla. Codex'te kampanya klasöründeki `codex mcp list` çıktısında `rpg` görünmelidir. `rpg --version` bulunamıyorsa RPG Engine'i yeniden kur ([2.2](#22-install)).
+
+**Güncelleme.** `npm install -g rpg-engine` komutunu yeniden çalıştır, sonra yeni bir sohbet aç: çalışan bir oyun yöneticisi başladığı sürümü korur.
+
+**Oyun yöneticisi geri aldığım bir şeyi hatırlıyor.** Yeni bir sohbet aç ve Kayıtlar'da **Yeni sohbet açtım** düğmesine bas.
+
+**Hiç görsel çıkmıyor.** Ayarlar > Görseller, bu bilgisayarın görsel yapıp yapamadığını ve nasıl yapacağını söyler.
+
+**Kurulum başarısız oluyor ya da `rpg` başlamıyor.** `node --version` 22 ya da daha yenisini göstermeli. Windows'ta RPG Engine'i ve kampanyalarını `&` içeren yollardan uzak tut.
+
+**Gösterge paneli bağlantısı değişti.** Başka bir program olağan adresi aldı; oyun yöneticisi sana yeni bağlantıyı verir.