rpg-engine 0.0.0-stage → 0.1.1

package/dist/dashboard/guide/ru.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: полное руководство
+
+**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 Engine остаётся в этой папке: он читает и записывает игру только здесь и никогда не трогает другие твои файлы. За её пределами он хранит только собственную папку с данными (переводы дашборда, а также Codex или Claude Code, если ты разрешишь их установить) и временные папки, пока рисуется картинка. Обо всём остальном, что агент захочет сделать на твоём компьютере, он сначала спросит тебя.
+
+Любую команду, которую использует мастер, можно запустить и в папке кампании: `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 и свои кампании в путях, где есть `&`.
+
+**Ссылка на панель управления изменилась.** Обычный адрес занял другой программа; мастер даст тебе новую ссылку.