rpg-engine 0.0.0-stage → 0.1.0

package/dist/dashboard/guide/ru.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: полное руководство
+
+**RPG Engine** позволяет играть в настольную ролевую игру с **ИИ в роли мастера**. Ты общаешься с мастером в **чате**, а RPG Engine работает за кулисами: он **помнит мир**, **бросает кубики** и **ведёт учёт**. Рядом с чатом в браузере открыта страница, **панель управления**: на ней лист персонажа, кубики, карты и журнал.
+
+Это руководство для игроков: программировать не нужно.
+
+## Быстрый старт <!-- icon: send -->
+
+1. Установи **Node.js** с сайта [nodejs.org](https://nodejs.org) (версию LTS).
+2. Установи **ИИ-агента**, программу, в которой работает мастер, и войди в аккаунт: например, Claude Code или Codex ([2.4](#24-connect-your-ai)).
+3. В терминале установи RPG Engine: `npm install -g rpg-engine`.
+4. Создай кампанию: `rpg init "The Salt Isles"`.
+5. Перейди в новую папку командой `cd "The Salt Isles"` и запусти там своего агента: `claude` для Claude Code, `codex` для Codex. Когда он спросит, доверяешь ли ты папке, ответь «да» ([2.4](#24-connect-your-ai)), а потом напиши *Привет! Давай начнём.* Мастер ответит ссылкой на твою панель управления.
+
+## 1. Что такое RPG Engine <!-- icon: about -->
+
+| Кто | Что делает |
+|---|---|
+| **Ты** | Играешь своим персонажем: что он делает, говорит и пробует. |
+| **Мастер** (ИИ) | Рассказывает историю, играет за всех остальных, решает, что происходит, просит сделать бросок. |
+| **RPG Engine** | Хранит мир в файлах, бросает кубики, считает очки здоровья, деньги, время и расстояния, хранит тайны, пока ты их не раскроешь. |
+
+Мир остаётся тем же от вечера к вечеру, даже в новом чате, даже с другим ИИ:
+
+- **Сказанное остаётся правдой.** Погибший злодей остаётся мёртвым.
+- **Кубики настоящие.** Мастер не может их подкрутить, кроме самой лёгкой сложности, если ты её выберешь.
+- **Тайны остаются тайнами.** Мастер никогда не расскажет того, чего не знает твой персонаж.
+- **Мир движется.** Угрозы растут, пока вы отдыхаете или путешествуете, и ты видишь их признаки.
+- **Кампания — это папка** на твоём компьютере: останавливайся когда хочешь и продолжай позже.
+
+Сейчас RPG Engine играет по одной игровой системе, **пятой редакции**, по свободному документу System Reference Document 5.1. Другие появятся ([Появится позже](#9-coming-later)).
+
+---
+
+## 2. Начало работы <!-- icon: path -->
+
+### 2.1 Что понадобится
+
+- Компьютер с Windows, macOS или Linux и веб-браузер.
+- **Node.js 22** или новее с сайта [nodejs.org](https://nodejs.org). Вместе с ним ставится `npm`, который устанавливает RPG Engine.
+- **Терминал**: в Windows это Терминал или PowerShell, в macOS это Терминал. Чтобы открыть его в нужной папке, щёлкни по папке правой кнопкой мыши и выбери **Открыть в Терминале** (Windows) или **Службы > Новое окно Терминала в папке** (macOS).
+- **ИИ-агент** для мастера ([2.4](#24-connect-your-ai)) с **самой крупной моделью**, которую он предлагает: маленькую модель проще уговорить выдать тайны или нарушить правила.
+
+### 2.2 Установка
+
+```text
+npm install -g rpg-engine
+```
+
+Команда `rpg --version` проверит, что всё получилось. Команду `rpg` ты используешь один раз на кампанию, чтобы создать её; дальше твой агент сам запускает RPG Engine.
+
+### 2.3 Создание кампании
+
+Открой терминал в папке, где ты хранишь свои игры ([2.1](#21-what-you-need) объясняет как):
+
+```text
+rpg init "The Salt Isles"
+```
+
+Команда создаёт папку `The Salt Isles` с новой кампанией внутри; перейди в неё командой `cd "The Salt Isles"`. Запомни, где она лежит: к ней ты будешь возвращаться при каждой игре. Всё остальное ты выберешь позже, в чате или на панели управления; `rpg init --help` покажет параметры, которые можно задать сразу, например `--language it` или `--difficulty hard`.
+
+Мастер не может создать кампанию за тебя: до `init` ничто не подсказывает твоему агенту, где находится RPG Engine.
+
+### 2.4 Подключение ИИ
+
+Мастер работает в **ИИ-агенте**: это ИИ-приложение, в терминале или на компьютере, которое умеет работать с файлами на твоём компьютере, например Claude Code или Codex. Обычного чата вроде claude.ai или ChatGPT, как и приложения для телефона, недостаточно: мастеру нужен доступ к файлам кампании на твоём компьютере. Каждому агенту нужны свой тариф и свой вход: Claude Code требует платный тариф Claude, Codex — вход через ChatGPT. Устанавливать агента нужно один раз, со своей страницы: [Claude Code](https://code.claude.com/docs/en/setup), [Codex](https://learn.chatgpt.com/docs/codex/cli).
+
+- **Claude Code**: в папке кампании напиши `claude`. Когда он спросит, доверяешь ли ты папке, выбери **Yes, I trust this folder**. Осторожно: по умолчанию выбран ответ *No, exit*.
+- **Codex**: в папке кампании напиши `codex` и ответь «да», когда он спросит, доверяешь ли ты папке. В его приложении для компьютера проверь в настройках, что память для чатов игры выключена.
+- **Другой агент**: запусти его в папке кампании и подключи к нему MCP-сервер `rpg mcp`. RPG Engine — стандартный MCP-сервер: мастером может стать любой агент с поддержкой MCP, в том числе локальный.
+
+Мы играем и проверяем на **Claude Code**. **Codex** подключён и проверен, но целиком кампанию на нём пока никто не проходил. `init` также настраивает **Gemini CLI**. Кампания отключает собственную память агента: игра живёт в её файлах, поэтому возврат к сохранению действительно возвращает назад.
+
+### 2.5 Первый чат
+
+Напиши что угодно, например *Привет! Давай начнём.* В первом ответе каждого чата мастер даёт **ссылку на твою панель управления**, примерно такую: `http://127.0.0.1:4750`. Открой её и держи рядом с чатом.
+
+Между сообщениями мастера твой агент показывает инструменты, которые он использует. Не открывай их подробности (в Claude Code это ctrl+o): там могут быть тайны.
+
+Новая кампания проходит три этапа, они показаны вверху панели: **1 Настройки** (как ты хочешь играть), **2 Нулевая сессия** (ты создаёшь персонажа прямо в игре), **3 Игра**.
+
+### 2.6 Настройки: как ты играешь
+
+Мастер спрашивает только о том, чего ещё не хватает, по несколько вопросов за раз; шаг **Настройки** на панели показывает те же вопросы карточками. Напиши «решай сам», и мастер выберет. Всё можно изменить позже, в чате или в **Настройках**.
+
+| Настройка | Что она определяет | Значения |
+|---|---|---|
+| **Наставник** | Насколько подробно мастер учит тебя правилам | выкл., подсказки, обучение |
+| **Сложность** | Насколько суров мир | сказка, лёгкая, обычная, трудная, жестокая |
+| **Смертельность** | Что значит упасть в бою | повествовательная (без смерти), эпическая (только когда это важно), кубики |
+| **Сохранения** | Когда можно вернуться назад | вечная смерть, контрольная точка, свободные ([3.8](#38-saves-and-going-back)) |
+| **Строгость** | Насколько точно еда, свет и путешествия следуют правилам | свободно, по правилам, симуляция |
+| **Кубики** | Кто бросает твои кубики | цифровые, настоящие |
+| **Единицы измерения** | Расстояния и вес | метрические, имперские |
+| **Спутники** | Кто путешествует с тобой | нет, созданные вместе с тобой, созданные мастером, встреченные в игре |
+| **Картинки** | Картинки мест, заданий и тех, кого ты встречаешь | нет, по запросу, новые места, задания и встречные ([3.11](#311-pictures)) |
+| **Границы** и **Завесы** | Что не появляется никогда и что происходит только за кадром | списки |
+| **Язык** | Язык игры и панели управления | любой |
+
+Пятая редакция добавляет **развитие**: очки опыта или вехи.
+
+Если мир не написан заранее, мастер также спросит **замысел** (жанр, тон, несколько элементов, твоими словами) и **подготовку**: строить мир на ходу, по мере игры, или целиком в начале.
+
+**Стиль мастера** мастер не спрашивает, но ты можешь изменить его в чате или в **Настройках**: **слог** (простой, литературный, пульп, ироничный), придумываемые **истории** (ситуации, арки, эпизоды, тайна), автора, **под которого писать**, или что-то другое **твоими словами**.
+
+### 2.7 Нулевая сессия: твой персонаж
+
+Ты создаёшь персонажа вместе с мастером, как за столом. Каждый выбор за тобой, если только ты не попросишь мастера выбрать за тебя: приходи с готовой идеей, с туманной или вообще без идей. Мастер объяснит, как определяются характеристики, до того как будет брошен хоть один кубик. История персонажа не обязательна; если ты её расскажешь, мастер запишет её твоими словами. Потом мастер спросит, нужна ли картинка персонажа ([3.7](#37-your-characters-story-and-picture)). Лист персонажа RPG Engine считает сам: тебе не придётся ничего подсчитывать.
+
+---
+
+## 3. Игра <!-- icon: chat -->
+
+### 3.1 Разговор с мастером
+
+Пиши, что делает или говорит твой персонаж, своими словами:
+
+> Я спрашиваю трактирщика, кто ещё заходил сегодня вечером.
+
+Если нужно выйти из истории, пиши в квадратных скобках: *[Как работает захват?]* Мастер тоже ответит в скобках.
+
+Ты говоришь, что пробуешь сделать, а мастер говорит, что происходит. Мастер никогда не решает за твоего персонажа и никогда не говорит о движке. Можешь спросить его, как пользоваться панелью управления.
+
+### 3.2 Броски
+
+Мастер просит бросок, только когда исход неясен и важен, и сначала говорит, что поставлено на карту. Дальше:
+
+- **На панели управления** в баннере появляется кнопка для каждой проверки, например *Акробатика +4 · с преимуществом*. Нажми её: кубики упадут на странице, и мастер узнает результат. Можно также нажать подсвеченную строку листа персонажа, бросить кубики из лотка или написать в баннере что-то другое.
+- **Вручную**, в углу баннера или в **Настройках**: баннер подскажет, что бросать, а бросаешь ты с листа персонажа или из лотка.
+- **Настоящие кубики**, если в настройке кубиков выбраны настоящие: ты пишешь выпавшие грани, *[Выпало 14.]*, а RPG Engine прибавляет твои модификаторы.
+
+**Свободные броски**: нажми на любое число на листе персонажа или открой лоток, чтобы бросить просто так. Они ничего не значат, и мастер их не видит.
+
+**Броски мастера** видны в твоей колонке бросков, кроме секретных. Ты всегда можешь спросить *[Это был настоящий бросок?]*: для секретного броска мастер даёт отпечаток, который доказывает, что бросок сделан до твоего вопроса.
+
+### 3.3 Сцены и бои
+
+История идёт **сценами**: бой, разговор, исследование, путешествие, отдых. В конце каждой сцены игра сохраняется сама, а сцена попадает в твой журнал.
+
+В бою мастер рассказывает о каждом ходе, который не твой, и останавливается там, где ты можешь принять решение. Раздел **Бой** показывает порядок ходов, очки здоровья твоего отряда и то, насколько изранены враги, словами. Если твой персонаж падает, спасброски от смерти крупно появляются на странице.
+
+### 3.4 Время, путешествия и движущийся мир
+
+RPG Engine ведёт календарь; между сессиями время не идёт. Скажи, что отдыхаешь, *Мы устраиваем долгий отдых*, и отдых вернёт то, что положено. Скажи, куда идёшь, *Мы идём по северной дороге в Рокку*, и RPG Engine посчитает путь, расстояние и дни и остановит вас, если что-то случится по дороге. Деньги считаются в монетах игры, вместе со сдачей.
+
+У злодеев есть планы со сроками. Каждый новый день мастер двигает угрозы, которым время подошло ближе, и ты видишь их признаки, но никогда не видишь сами часы.
+
+### 3.5 Карты
+
+Карта **Мир** показывает места, которые знает твой персонаж, дороги между ними и пройденный путь, а остальное скрыто туманом. **Сцена** показывает карту места, где ты находишься, если она есть, и кто где стоит; в бою, на твоём ходу, недоступные клетки затенены. Когда мастер спрашивает, куда ты идёшь, нажми на клетку или напиши её название, например *E4*.
+
+### 3.6 Задания, журнал и заметки
+
+Дело, за которое берётся твой персонаж, становится заданием в **Журнале**, с целями, сроком и тем, что его измеряет; отметь его звёздочкой, чтобы оно всегда было на виду вверху раздела «Сцена». В Журнале также рассказана твоя **история**, сцена за сценой, и хранятся твои **заметки**: они личные, пока ты не нажмёшь **Поделиться**; тогда мастер услышит заметку как твои мысли, а не как факт.
+
+### 3.7 История и картинка твоего персонажа
+
+На листе персонажа в карточке **Описание** есть поле для истории персонажа: мастер вписывает её туда после твоего согласия. Для картинки дай мастеру файл (PNG, JPEG, WebP или SVG, до 5 МБ) и скажи, где он лежит на компьютере, или закажи портрет ([3.11](#311-pictures)): *[Сделай мне портрет: седые волосы в косе, шрам на подбородке.]*
+
+### 3.8 Сохранения и возврат
+
+RPG Engine сохраняет всю кампанию в конце каждой сцены. Остальное определяет настройка **Сохранения**:
+
+| Сохранения | Сохраняться, когда хочешь | Вернуться |
+|---|---|---|
+| **вечная смерть** | нет | никогда |
+| **контрольная точка** | нет | к последнему сохранению, только когда персонаж погибает |
+| **свободные** | да | к любому сохранению |
+
+В любом режиме можно **начать заново**, с начала игры или с нулевой сессии. Сделай это в чате или в разделе **Сохранения**.
+
+После возврата **открой новый чат**: старый помнит то, что было отменено. Напиши в новом чате *продолжаем*, а потом нажми **Новый чат открыт** в разделе «Сохранения».
+
+### 3.9 Сессии: остановиться и вернуться
+
+Останавливайся когда хочешь: *[Давай на сегодня закончим.]* Всё уже сохранено в файлах. Чтобы вернуться, запусти агента в папке кампании и напиши *продолжаем*: мастер коротко напомнит, что было, и продолжит игру.
+
+### 3.10 Настроение мастера
+
+Робот вверху панели управления — это мастер: его лицо следует тону истории и никогда не выдаёт того, чего ты ещё не знаешь. Когда чат закрыт, он спит.
+
+### 3.11 Картинки
+
+RPG Engine может создавать картинки мест, до которых вы добрались, заданий, которые ты берёшь, и тех, кого встречаешь, как скажет настройка **Картинки**, а также портрет твоего персонажа по твоей просьбе. Он использует то, что есть на твоём компьютере, и твой собственный вход: **Codex** рисует их, а если его нет, то **Claude Code**. В **Настройках** написано, может ли этот компьютер их создавать, а если нет, то как это настроить. Ты всегда можешь дать мастеру собственную картинку.
+
+### 3.12 Безопасность: границы, завесы и стоп
+
+**Границы** никогда не появляются в игре; **завесы** остаются только за кадром. В любой момент напиши *[стоп]*: мастер сразу откажется от этого содержания и добавит его в твои границы.
+
+### 3.13 Передумать
+
+Любую настройку можно изменить, в чате или в **Настройках**. Решение, которое мастер принимает без книги, становится **прецедентом**, и на тот же вопрос в следующий раз будет тот же ответ.
+
+---
+
+## 4. Панель управления <!-- icon: party -->
+
+Страница на твоём компьютере, открывается только в браузере этого компьютера и работает, пока открыт чат. Когда чат закрывается, она показывает *Нет соединения*; со следующим чатом она возвращается сама.
+
+- **Отряд**: твой лист персонажа и листы спутников. Нажми на число, чтобы бросить его; наведи курсор, чтобы увидеть, откуда оно берётся. Рядом показаны броски.
+- **Сцена**: где ты находишься, её картинка и карта, кто рядом, что происходит.
+- **Бой**: только во время боя: ходы, бойцы, что у тебя под рукой.
+- **Журнал**: задания, история, твои заметки.
+- **Мир**: карта мира, как её знает твой персонаж.
+- **Лоток для кубиков**: выбери кубики и модификатор и бросай.
+- **Сохранения**, **Справка**, **Настройки** и **О программе**: значки в конце ряда. В «Настройках» есть и параметры самой страницы: тема, звук кубиков, набор кубиков.
+
+Когда мастер что-то у тебя спрашивает, его баннер остаётся вверху, в каком бы разделе ты ни был.
+
+---
+
+## 5. Игровые системы и домашние правила <!-- icon: dice -->
+
+### 5.1 Что такое игровая система
+
+Это данные одной игры: лист персонажа, числа, существа, предметы, заклинания и текст правил. Каждая кампания играет по одной системе. RPG Engine считает лист персонажа, а также что тратится и что возвращается; как работает особенность, мастер читает в правилах и решает, как за столом.
+
+### 5.2 Пятая редакция, входит в комплект
+
+Расы, классы, подклассы, предыстория и черта из SRD 5.1; 319 заклинаний, оружие, доспехи, магические предметы и монстры; главы правил, которые мастер читает по точному тексту; полный лист персонажа с расчётами.
+
+Можно также играть материалом, которого нет в SRD, из книги, которая есть у тебя: мастер запишет его страницами твоей кампании, и RPG Engine будет обращаться с ним как со своим. RPG Engine поставляется только с открытым содержанием; знания твоего мастера этим не ограничены.
+
+### 5.3 Домашние правила и твои дополнения
+
+Попроси мастера: *[Домашнее правило: натуральная 1 при атаке означает, что ты роняешь оружие.]* Он сохранит это как договорённость стола или запишет страницу либо число листа персонажа, если это нужно. Уже записанные домашние правила можно положить текстовыми файлами в папку `rules` кампании.
+
+### 5.4 Добавление или импорт своей игровой системы
+
+Пока нет: сейчас RPG Engine играет только по пятой редакции ([Появится позже](#9-coming-later)).
+
+---
+
+## 6. Расширения <!-- icon: plus -->
+
+Пока нет. Расширение будет добавлять что-то к кампании поверх её игровой системы: мир, приключение, особенность вроде погоды, домашние правила, которыми можно делиться.
+
+---
+
+## 7. Откуда берётся кампания и на каком она языке <!-- icon: world -->
+
+### 7.1 Три способа получить мир
+
+- **Создаётся на ходу**: по твоему замыслу мастер строит каждое место, персонажа и сюжет прямо перед тем, как они понадобятся, и запоминает их.
+- **Готовится в начале**: то же самое, но мир строится до игры.
+- **Из твоего приключения**: дай мастеру текст или PDF и попроси его подготовить игру, *[Подготовь это приключение как нашу кампанию. Ничего из него мне не рассказывай.]* Он запишет места, персонажей и тайны. Кнопки импорта пока нет.
+
+Кампания проходится один раз: чтобы сыграть то же приключение снова, создай новую кампанию.
+
+### 7.2 Языки
+
+У кампании один язык, язык мастера, и панель управления следует за ним. Панель управления поставляется на 26 языках. Любой другой переводится на твоём компьютере с помощью Codex или Claude Code, а без них — мастером в чате. Термины пятой редакции на итальянском берутся из официального итальянского SRD; текст правил остаётся на английском, а мастер пересказывает его на твоём языке.
+
+---
+
+## 8. Для любопытных: папка кампании <!-- icon: list -->
+
+Открывать её тебе никогда не нужно, и в ней хранятся тайны твоей кампании. В ней есть `campaign.yaml` (твои настройки), `state.yaml` (на чём остановилась игра), `world/` (по одной странице в формате markdown для каждого персонажа, места, задания и всего остального), `rules/` (твои домашние правила), `images/`, `log.jsonl` (каждое изменение), `.saves/`, `.player/` (твои заметки) и небольшие файлы, которые подсказывают ИИ-агентам, где находится RPG Engine. Страницы используют формат Obsidian. Если ты изменишь страницу вручную, мастер узнает об этом при следующем ответе.
+
+Каждую команду, которую использует мастер, можно запустить и самому в папке кампании: `rpg --help` покажет их список. Многие из них выводят тайны кампании.
+
+---
+
+## 9. Появится позже <!-- icon: hourglass -->
+
+- **Ты в роли мастера**, а ИИ играет за отряд.
+- **Режим автора**: пиши приключение вместе с ИИ, а потом экспортируй его и делись им.
+- **Несколько игроков на одном компьютере**, у каждого свой персонаж, по очереди в одном чате.
+- **Расширения**: настройки, приключения, особенности и домашние правила.
+- **Импорт** твоих руководств и приключений.
+- **Другие игры**: больше игровых систем и твои собственные.
+
+---
+
+## 10. Вопросы и проблемы <!-- icon: info -->
+
+### Вопросы
+
+**Нужно ли знать правила?** Нет. Выбери наставника в режиме обучения и спрашивай в скобках, когда захочешь.
+
+**Может ли мастер жульничать?** Он не может изменить бросок, сделанный RPG Engine, кроме сложности «сказка», и не может менять уже установленные факты.
+
+**Это стоит денег?** RPG Engine бесплатный. Мастер работает на тарифе твоего агента или на твоём компьютере с локальной моделью. Вечер игры — это длинный чат: на самых скромных тарифах можно упереться в лимит тарифа раньше, чем кончится вечер. Картинки и переводы расходуют тот же тариф.
+
+**Можно ли играть на телефоне?** Нет: мастер работает на твоём компьютере, и панель управления открывается только на нём.
+
+**Можно ли играть с друзьями?** Пока нет: сейчас один игрок, один персонаж и спутники ([Появится позже](#9-coming-later)).
+
+**Можно ли в следующий раз взять другой ИИ?** Да: открой кампанию в другом агенте и напиши *продолжаем*.
+
+### Проблемы
+
+**Панель управления не открывается.** Спроси мастера: `[Какая ссылка на панель управления?]`. Она работает только пока в этой кампании открыт чат, после первого ответа мастера.
+
+**Мастер, кажется, не знает игры.** Твой агент не загрузил RPG Engine. Проверь, что ты запустил его в папке кампании и подтвердил доверие к ней. В Claude Code напиши `/mcp` и переподключи `rpg`. В Codex команда `codex mcp list` в папке кампании должна показать `rpg`. Если `rpg --version` не находится, установи RPG Engine заново ([2.2](#22-install)).
+
+**Обновление.** Снова выполни `npm install -g rpg-engine`, а потом открой новый чат: работающий мастер остаётся на той версии, с которой запустился.
+
+**Мастер помнит то, что я отменил.** Открой новый чат и нажми **Новый чат открыт** в разделе «Сохранения».
+
+**Картинки не появляются.** В Настройки > Картинки написано, может ли этот компьютер их создавать и как это сделать.
+
+**Установка не удаётся или `rpg` не запускается.** `node --version` должна показывать 22 или новее. В Windows не держи RPG Engine и свои кампании в путях, где есть `&`.
+
+**Ссылка на панель управления изменилась.** Обычный адрес занял другой программа; мастер даст тебе новую ссылку.

package/dist/dashboard/guide/sv.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: 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 de nyfikna: kampanjmappen <!-- icon: list -->
+
+Du behöver aldrig öppna den, och den innehåller din kampanjs hemligheter. Den har `campaign.yaml` (dina inställningar), `state.yaml` (var spelet står), `world/` (en markdown-sida för varje rollperson, plats, uppdrag och resten), `rules/` (dina husregler), `images/`, `log.jsonl` (varje ändring), `.saves/`, `.player/` (dina anteckningar) och de små filerna 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.
+
+Varje kommando som spelledaren använder kan också köras i kampanjmappen: `rpg --help` listar dem. Många 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.