Files
mod_rpg_plus_game/docs/ru.md
T

116 lines
11 KiB
Markdown

# 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. **Пропал вариант диалога.** Некоторые варианты появляются только после определённого этапа задания или при нужном предмете.