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

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

## Дерево основных файлов и папок

```text
scripts/
├── dice_roller/                 # Скрипты для бросков кубиков
├── faction_turns/               # Система ходов фракций (WWN)
├── generate_encounter/          # Генераторы столкновений и энкаунтеров
├── generate_npc/                # Генерация NPC (био, классы, характеристики)
├── generate_trap/               # Генерация ловушек
├── generate_treasure/           # Генерация лута и сокровищ
├── time/                        # Управление временем кампании
├── weather/                     # Генерация погодных условий
├── game_utils.py                # Общие игровые утилиты
├── obsidian_rest_api.md         # Документация по работе с Obsidian REST API
├── Readme.md                    # Описание структуры проекта (этот файл)
├── TASKS.md                     # План работ и задачи
└── vault_utils.py               # Утилиты для работы с Obsidian 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. -->