dnd5-scripts/Readme.md

25 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Структура папки 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. -->