mod_town_pack/docs/ru.md

# Town Pack — фоны города, дома и бара со звуком бара

Town Pack — готовые декорации для истории в небольшом городке. Внутри три нарисованных фона — угловая улица у въезда в город, прихожая дома и вечерний бар — и зацикленный звук атмосферы бара. Сюжета, сцен и персонажей в моде нет: где показывать эти картинки, решает игра.

Две встроенные игры уже делят этот набор. **Cthangover** берёт въезд в город и прихожую, шаблон **My Novel** — все три фона и звук бара. Поскольку обе игры берут одни и те же файлы из этого мода, исправление или улучшенная картинка в Town Pack достаются им обеим.

## Что внутри

Въезд в город, `town/town_entry`: мощёный уличный угол с полосатыми навесами магазинов.

![Фон въезда в город: угловой дом с зелёными и белыми навесами на булыжной улице.](assets/town_entry.jpg)

Прихожая дома, `home/vestibule`: зал с лестницей, креслом и картиной.

![Фон прихожей: деревянная лестница, кресло, скамья и картина в раме в зале с тёплым светом.](assets/vestibule.jpg)

Бар, `bar/bar`: столики с фонарями, стойка и полки с бутылками.

![Фон бара: столики под фонарями, барная стойка и полки с бутылками под балочным потолком.](assets/bar.jpg)

Атмосфера бара, `bar/bar_ambient`: зацикленный Ogg Vorbis с гулом бара для звукового канала Ambience.

Все три картинки — размером 1920 × 1024. У каждой есть серый файл-спутник с тем же именем и суффиксом `_depth`:

![Файл глубины для въезда в город: чёрно-белая версия той же композиции.](assets/town_entry_depth.jpg)

Картинку глубины вы напрямую не видите. Показывая фон, игра подгружает `<name>_depth` и передаёт его системе освещения — та использует его для источников света, размещённых поверх сцены. Фон без файла глубины тоже показывается как обычно.

## Где вы это увидите

- **Cthangover:** сцена `town_entry` (въезд в город) и сцена `home_vestibule`.
- **Шаблон My Novel:** `my_novel_town`, `my_novel_home` и `my_novel_bar`. В сцене бара играет и `bar/bar_ambient`.

Тот же въезд в город в шаблоне My Novel: с него и строки рассказа начинается игра:

![Первая сцена My Novel: фон въезда в город за строкой «Вечерний город. Фонари уже горят, по мостовой тянет прохладой».](assets/reuse-my-novel.jpg)

А в Cthangover поверх той же картинки другой сюжет предлагает свои варианты:

![Въезд в город в Cthangover: тот же фон с вариантами «Вернуться к дому» и «Проверить переулок».](assets/reuse-cthangover.jpg)

Town Pack входит в коллекции обеих игр и загружается вместе с ними. Сама по себе установка не добавит эти места в чужую игру: фон должен использоваться в сценах самой игры.

## Используйте фоны в своей игре

1. Добавьте `town_pack>=1` в список `depends` своего контентного мода.
2. Включите `town_pack>=1` в коллекцию своей игры — так, как это делает шаблон My Novel в блоке **Assets**.
3. Обращайтесь к ресурсам по именам из списка ниже. Имена считаются относительно `backgrounds/` и `sounds/` и пишутся без расширения.

```jsonc
// mods/my_game/manifest.json — добавьте к существующему списку
"depends": ["town_pack>=1"]
```

Сцена, которая показывает бар и включает его атмосферу, — из шаблонной сцены `my_novel_bar`:

```json
{
  "name": "my_bar",
  "defaultBackground": "bar/bar",
  "defaultAmbient": "bar/bar_ambient"
}
```

Сценарий может сменить картинку и посреди диалога:

```scenario
background town/town_entry
text "В такой час улица пустует."
```

Доступные имена:

```text
town/town_entry     backgrounds/town/town_entry.png
home/vestibule      backgrounds/home/vestibule.png
bar/bar             backgrounds/bar/bar.png
bar/bar_ambient     sounds/bar/bar_ambient.ogg
```

## Как заменить картинку для своей игры

Чтобы заменить картинку, не трогая Town Pack, положите в свой мод файл с тем же относительным именем — например, `backgrounds/bar/bar.png` — и объявите в его `depends` зависимость `town_pack>=1`. Зависимый мод загружается позже и побеждает. Заменяя фон, положите рядом и одноимённый файл `_depth`: иначе игра найдёт исходную картинку глубины из Town Pack, и свет ляжет по композиции старой картинки.

Без зависимости порядок двух модов с одним и тем же именем не определён; карта ресурсов сообщает об этом как об ошибке.

## Если чего-то не хватает

1. Чёрный или пропавший фон обычно означает опечатку в имени. Имена чувствительны к регистру, разделитель — `/`.
2. Проверьте, что Town Pack включён в запущенную игру, а не просто установлен.
3. Нет звука бара: проверьте, что `defaultAmbient` сцены — `bar/bar_ambient`, а канал **Ambience** включён в **Settings → Sound**. Звук воспроизводит мод Audio Engine.