# RPG Plus — лесная RPG, собранная из модов

RPG Plus — законченная небольшая RPG: пролог-новелла, где вы выбираете, кем был ваш герой, затем деревня и лес на тайловой карте, тайна пропавшего лесного света, побочные задания, верстак, торговец, пустыня на западе и пошаговые бои. Игра состоит только из файлов данных и сценариев; правила — характеристики, снаряжение, проверки, бои, крафт — приносят отдельные моды, которые может взять и любая другая игра.

Запуск — **Играть → RPG Plus → Новая игра**.

![Пролог на перекрёстке: указатель у лесной дороги и вопрос «Кем ты был до того, как пришёл сюда?» с тремя ответами: солдат, ученик мага, странник.](assets/prologue.jpg)

## История и как играть

1. **Перекрёсток.** Выберите своё прошлое: **солдат** (воин), **ученик мага** (маг) или **странник** (плут). Выбор задаёт характеристики и стартовое снаряжение. На старте у вас 25 монет.
2. **Деревня у Серого леса.** Ходите на WASD или стрелки, бегите на Shift, говорите и взаимодействуйте на E или F. **Журнал** всегда называет ваш конкретный следующий шаг.
3. **Староста** спрашивает о пропавшем свете или сразу отправляет вас за волком у восточной пещеры.
4. **Лес.** Собирайте хворост и грибы; слизни оставляют живую смолу и монеты. Волк всегда оставляет сердце янтаря и столько шерсти, что хватит на плащ.
5. **Верстак у колодца.** Сварите лесную мазь (гриб + смола), сшейте плащ лесного стража (2 шерсти + 2 смолы) или соберите сторожевой фонарь (янтарь + 2 смолы + 2 веток). Плащ надевается из сумки: он меняет ваши настоящие боевые числа.
6. **Травница** у западного забора просит мазь; помощь ей приводит к пропавшему курьеру в южном лесу.
7. **Святилище.** Пронесите фонарь через пещеру за волком к разрушенному святилищу. Верните лесу свет — или заключите сделку ради деревни. Обе концовки завершают приключение, а последние слова старосты зависят от вашего выбора.

Прочие жители деревни: **наставник** ведёт на тренировочную площадку (опыт один раз и проверка силы с бревном), **гадалка** читает вашу удачу. Очаг у колодца восстанавливает здоровье и ману. Награды нельзя собрать дважды.

![Верстак у колодца с тремя рецептами: Лесная мазь, Плащ лесного стража и Сторожевой фонарь, имеющиеся и нужные ингредиенты и кнопка изготовления.](assets/workbench.jpg)

![Разрушенное святилище в лесу, «Лес помнит», герой несёт фонарь.](assets/shrine.jpg)

### Пустыня

От деревни пройдите по главной дороге на запад, за край карты, — попадёте в **Сухой предел**: песок, глинобитный дом, навес каравана, разрушенная башня, пальмы и кактусы. Пять скорпионов и жуков ждут боя, а бочки припасов хранят небольшие разовые награды. Восточный край ведёт обратно к деревне.

![Сухой предел: песок, навес каравана, кактусы, пальмы, бочки, скорпионы и жуки; герой приезжает по дороге с востока.](assets/desert.jpg)

## Ваш герой

Откройте **лист персонажа** с панели инструментов: класс, уровень и опыт, характеристики (Сила, Ловкость, Интеллект, Выносливость, Харизма, Удача), боевые значения и снаряжение в слотах оружия, брони и аксессуара. Надевайте вещи из сумки.

![Лист персонажа плута второго уровня: характеристики, здоровье и мана, атака с бонусом +3 от снаряжения, пустые слоты экипировки.](assets/character-sheet.jpg)

Бои идут в командном стиле (FF), урон считается по формулам. Часть вариантов диалога проверяет характеристику броском d20 — например, **[Сила 12]** у наставника.

![Бой с волком: герой внизу слева, волк со здоровьем, атакой и защитой вверху, журнал боя справа.](assets/battle.jpg)

## Как игра собрана

RPG Plus — это коллекция **RPG Plus**. Её блоки:

```text
Сюжет                 rpg_plus_game (этот мод)
Деревня и лес         rpg_demo_game: карты, люди и предметы, которые игра расширяет
Ресурсы и правила     village_pack (арт), classic_rpg_pack (характеристики, классы, снаряжение)
Характеристики и проверки  stats_base, stat_checks
Тайловый мир          rpg
Предметы, снаряжение, торговля  items_base, equipment, trading, crafting
2D-движок             shell2d_base, dialog_base, characters_base, audio_base
Бой                   turn_battle_base, ff_battle, battle_formulas
Карточный бой         card_battle (опционально)
Интерфейс             ui_base, menu_base
Редактор тайловых карт  rpg_editor (опционально)
Редакторы данных      schema_tools, items_editor, characters_editor (опционально)
Тайловый рендер       tile_topdown_base, tile_isometric_base
```

Настройки коллекции: `battle.core` — `ff_battle`, проверки бросают `d20`, спрайт героя на карте — `village/hero`, карты рисуются сверху. Меняются в **Mods & Collections → Коллекции → RPG Plus → Изменить схему**.

## Авторам: меняйте без кода

```filestree
rpg_plus_game/
├── scenarios/rpg_plus/     пролог, training_yard, events/ (наставник, гадалка), woodland/, desert/
├── map_events/<map>/       новые люди, верстак, дверь пещеры, бочки; события с теми же id заменяют события rpg_demo_game
├── maps/                   rpg_woodland_shrine.json, rpg_desert.json
├── scenes/                 перекрёсток, тренировочная площадка, святилище, пустыня
├── quests/woodland.json    этапы журнала
├── items/, recipes/, stations/   материалы, изделия, меню верстака
├── patches/character.json  добыча, добавленная монстрам rpg_demo_game
├── patches/shop.json       товары сверх обычных у деревенского торговца
└── characters/, charsets/, backgrounds/, locale/
```

**Расширяйте чужой мод, а не копируйте его.** Деревня, дом и лес по-прежнему берутся из `rpg_demo_game`. Событие с тем же id, что там, заменяет его (староста получает новые диалоги); новые id добавляют людей. Патчи добавляют добычу его монстрам и товары его лавке.

**Проверки и условия в сценариях.** Гадалка испытывает Удачу, а потом смотрит на ваше снаряжение:

```scenario
text "— Хочешь знать, что тебя ждёт? Дай руку. Не эту — ту, которой не воруешь." key=rpg_plus/seer/hello
check luk 14 who=rpg_hero else=fail -> :ok

:ok
text "— Волк у пещеры боится огня больше, чем стали. И бей туда, где у него нет щита. Это бесплатно. Остальное — нет." key=rpg_plus/seer/fortune
when "!equipped(rpg_hero, 'classic/clover_charm')" -> :charm
end
```

`when "item('rpg_plus/salve') >= 1"` заглядывает в сумку, `level(rpg_hero) >= 3` — в уровень героя; флаги делают разовые награды безопасными. Строки написаны по-русски, у каждой есть `key=`; переводы лежат в `locale/scenarios_<lang>.properties`.

**Рецепт** — это данные в `recipes/woodland.json`:

```json
{
  "Id": "rpg_plus/salve",
  "Name": "rpg_plus/recipe/salve/name",
  "Type": "Cooking",
  "Input": [
    { "Id": "rpg_demo/mushroom", "Count": 1 },
    { "Id": "rpg_plus/resin", "Count": 1 }
  ],
  "Output": [{ "Id": "rpg_plus/salve", "Count": 1 }]
}
```

Опциональный **редактор тайловых карт** рисует землю, коллизии и события, а **редактор данных** правит предметы, рецепты и персонажей. Включите их в схеме игры.

## Если что-то пошло не так

1. **В старом сохранении нет янтаря волка.** Подойдите к месту волка у пещеры и нажмите E/F: янтарь можно подобрать там один раз, если у вас нет ни его, ни фонаря.
2. **Неясно, что делать дальше.** Откройте журнал.
3. **Пропал вариант диалога.** Некоторые варианты появляются только после определённого этапа задания или при нужном предмете.