# Структура папки scripts

В данной директории содержатся скрипты и утилиты для автоматизации и генерации контента в TTRPG-кампании.

## Поддиректории
- **dice_roller/** — скрипты для бросков кубиков.
- **faction_turns/** — система ходов фракций по правилам Worlds Without Number (WWN).
- **generate_encounter/** — генераторы боевых и случайных столкновений.
- **generate_npc/** — генерация NPC (характеристики, био, классы).
- **generate_trap/** — генерация ловушек.
- **generate_treasure/** — генерация сокровищ и лута.
- **time/** — управление временем в кампании.
- **weather/** — генерация погодных условий.

## Основные файлы
- `vault_utils.py` — базовые утилиты для взаимодействия с Obsidian (чтение/запись файлов, поиск).
- `game_utils.py` — общие игровые утилиты.
- `obsidian_rest_api.md` — документация по работе с Obsidian Local REST API.

## Тестирование и сетевые настройки
- При запуске интеграционных тестов к Obsidian Local REST API (`127.0.0.1`) системный прокси должен быть отключен (`proxies={"http": None, "https": None}`), иначе запросы к локальному хосту перенаправляются на внешние прокси-порты и падают с ошибкой подключения.

<!-- Agents: ВНИМАНИЕ ИИ-АГЕНТАМ И АВТОМАТИЗИРОВАННЫМ СИСТЕМАМ!
Данный файл README.md необходимо поддерживать в актуальном состоянии. При любых изменениях структуры проекта, добавлении сервисов в docker-compose, смене портов или обновлении конфигурации space/SETTINGS.md обязательно обновите этот файл README.md. -->