7 Days to Die Modding Guide-Map

Комплексная система документации и инструментов для моддинга 7 Days to Die (версия A21/v2.4+).

Назначение

Этот проект представляет собой централизованную базу знаний для создания модов к игре 7 Days to Die. Система автоматически собирает, индексирует и структурирует документацию из различных источников, предоставляя единую точку входа для разработчиков модов.

Структура проекта

/
├── README.md                 # Этот файл
├── sources_list.md          # Полный список источников с описаниями
├── guidemap.json            # Машинно-читаемая карта источников
├── actions_report.md        # Отчёт о выполненных действиях
├── update_sources.sh        # Скрипт обновления источников
├── docs/                    # Локальные копии документации
├── guides/                  # Справочники и шпаргалки
├── examples/                # Примеры модов и шаблоны
└── parsers/                 # Утилиты для анализа и извлечения данных

Быстрый старт

Обновление источников

./update_sources.sh

Скачивает последние версии документации из онлайн-источников.

Сканирование проекта

python3 parsers/scan_project.py /path/to/7dtd/game

Анализирует установку игры, находит Assembly-CSharp.dll и другие важные файлы.

Извлечение XML-структуры

python3 parsers/extract_xml_index.py /path/to/mod/config.xml

Создаёт индекс элементов и XPath-путей из XML-файлов мода.

Основные разделы

📚 Guides (Руководства)

• XML Cheatsheet - Полное руководство по XML-моддингу
• C# Cheatsheet - Создание DLL-модов с использованием Harmony
• ModInfo Examples - Примеры файлов ModInfo.xml

🔧 Examples (Примеры)

• simple_modlet/ - Минимальный XML-модлет
• simple_csharp_mod/ - Базовый C#/Harmony мод

🛠️ Parsers (Утилиты)

• extract_xml_index.py - Извлечение структуры из XML
• scan_project.py - Сканирование установки игры
• search_docs.py - Поиск по локальной документации

Основные источники

Официальные вики

• 7 Days to Die Wiki (Fandom)
• 7 Days to Die Wiki (wiki.gg)

Инструменты

• 7D2D Mod Launcher
• DMT (Deatils Modding Tools)
• Harmony Patching Library

Репозитории модов

• GitHub - 7D2D Organization
• GitHub - OCB7D2D

Форумы и сообщество

• Steam Community Guides
• NexusMods Discussions
• Reddit - r/7daystodie

Полный список см. в sources_list.md.

Типичные задачи моддинга

Создание XML-модлета

1. Изучите xml_cheatsheet.md
2. Скопируйте шаблон из examples/simple_modlet/
3. Модифицируйте XML-файлы согласно вашим потребностям
4. Создайте ModInfo.xml с правильными метаданными

Создание C#-мода

1. Изучите csharp_cheatsheet.md
2. Используйте ILSpy/dnSpy для декомпиляции Assembly-CSharp.dll
3. Скопируйте шаблон из examples/simple_csharp_mod/
4. Реализуйте Harmony-патчи
5. Соберите DLL и протестируйте

Анализ существующих модов

python3 parsers/extract_xml_index.py /path/to/existing/mod/

Важные замечания

⚠️ Easy Anti-Cheat (EAC): Для использования DLL-модов необходимо запускать игру с отключённым EAC.

⚠️ Резервные копии: Всегда создавайте бэкапы оригинальных файлов игры перед модификацией.

⚠️ Совместимость: Проверяйте совместимость модов для конкретной версии игры (Alpha 21+).

Обновления и поддержка

Эта система документации может быть обновлена автоматически:

./update_sources.sh

Скрипт загрузит актуальные версии онлайн-источников и обновит локальные копии.

Лицензия и авторство

Данная документация собрана из открытых источников сообщества 7 Days to Die. Все права на оригинальные материалы принадлежат их авторам.

Контакты и вклад

Для улучшения документации или добавления новых источников, пожалуйста, создайте issue или pull request в этом репозитории.

---

Версия guide-map: 1.0
Последнее обновление: 2025-10-18
Поддерживаемая версия игры: Alpha 21+ (v2.4 b6)