Add mod documentation in seven languages

docs/ru.md

@@ -0,0 +1,47 @@
+# Cthangover: Murakami — сюжетная линия основной игры
+
+Этот мод добавляет в Cthangover одну сюжетную линию: по городу бродит зверь, и его след приводит к встрече с Мураками. Внутри — сценарии этой встречи, Мураками как персонаж с портретом и набором эмоций, задание в журнале и бои. Линия входит в игру Cthangover и требует базовый сюжет (`cthangover_game`).
+
+На этой странице — как линия встраивается в игру и как начинается; что будет дальше, игрок узнаёт сам.
+
+## Как всё начинается
+
+Когда Марао подходит к въезду в город, из темноты доносится рычание, и игрок решает: вернуться домой или проверить переулок:
+
+![Въезд в город ночью: текст «[Из темноты донёсся глухое рычание]» и варианты «Вернуться домой» и «Проверить переулок».](assets/growl.jpg)
+
+Проверка переулка запускает задание «Встреча с Мураками», и его первая запись появляется в журнале:
+
+![Журнал с активным заданием «Встреча с Мураками» и записью «Я встретил дикого волка в городе, он пытался попасть в закрытый дом».](assets/journal.jpg)
+
+## Как линия встроена в базовый сюжет
+
+Мод не меняет ни одного файла базовой игры. Он добавляет сценарии к существующим сценам, а игра выбирает нужный по приоритету и условию:
+
+```scenario
+scene: town_entry
+priority: 10
+condition: MeetingMurakamiQuest.notHasTag("wolf_battle")
+```
+
+- Стартовый сценарий принадлежит сцене `town_entry` и имеет приоритет 10, поэтому пока выполняется его условие, он выбирается вместо обычных сценариев города.
+- Каждый следующий шаг линии — ещё один сценарий `town_entry` с большим приоритетом (20, 30), а его условие смотрит на метки задания `MeetingMurakamiQuest`. Последний шаг играется в доме (`home_vestibule`).
+- Бои запускаются действием `battle.init` на боевой системе платформы, а исход записывается обратно меткой задания — следующий сценарий знает, чем всё кончилось.
+- Когда линия пройдена, её условия перестают выполняться, и город снова играет свои обычные сценарии.
+
+Что кладёт мод:
+
+- `scenarios/murakami/meeting/` — четыре сценария встречи;
+- `quests/quests.json` — задание с тремя записями в журнале;
+- `characters/player/murakami.json` — Мураками как персонаж, с картинкой;
+- `avatars/murakami/` — её эмоции для диалогов;
+- фоны встречи в `backgrounds/town/meetingmurakami/`;
+- тексты на семи языках в `locale/`.
+
+## Как отключить
+
+Линию можно не включать в коллекцию игры: тогда город играет только собственные сценарии, а задание так и не появится.
+
+## Известные проблемы
+
+- Двух эмоций Марао, которые используют эти сценарии, — `marao/what` и `marao/relax` — в игре нет, поэтому в этих строках портрет не показывается. Валидатор помечает их как `REF_NOT_FOUND`.