Введение

CollectorBots — это стратегическая игра в реальном времени (RTS), разработанная на движке Unity. Игрок управляет базой с роботами-рабочими, которые собирают ресурсы, строят новые базы и расширяют свою территорию.

Цель игры

Основная цель — развить свою колонию роботов, собирая ресурсы (камень, дерево, железо) и строя дополнительные базы. Каждая база может производить новых рабочих, которые автоматически выполняют задачи по сбору и доставке ресурсов.

Жанр и целевая аудитория

• Жанр: RTS (Real-Time Strategy) с элементами автоматизации.
• Целевая аудитория: игроки, любящие стратегии, управление ресурсами и постепенное расширение без жёстких временных ограничений.

Геймплей

Игрок начинает с одной базовой структуры, которая уже имеет трёх рабочих. Рабочие автоматически сканируют окружающую территорию в поисках ресурсов, собирают их и доставляют на базу. Игрок может:

• Управлять базой: строить новых рабочих, устанавливать флаги для указания зон сбора.
• Наблюдать за ресурсами: отслеживать количество собранных ресурсов через UI.
• Строить новые базы: используя накопленные ресурсы, можно построить вторичную базу, которая также будет производить рабочих и расширять возможности сбора.

Игра не имеет явных противников или сценария победы — это бесконечный симулятор с акцентом на оптимизацию и расширение.

Технологический стек

• Unity 2021.3+ — основной движок.
• C# — язык программирования всех скриптов.
• DOTween — библиотека для плавных анимаций и твинов.
• TextMesh Pro — современная система отображения текста в UI.
• NavMesh — система навигации для перемещения рабочих по сцене.
• Unity Input System — новая система обработки ввода (вместо старого Input Manager).
• ScriptableObjects — для хранения конфигураций (стоимость построек, веса ресурсов и т.д.).

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

Проект организован в соответствии с чистой архитектурой, разделяющей код на слои:

• Infrastructure — базовые сервисы (события, пулы объектов, управление ресурсами).
• Gameplay — игровая логика (рабочие, базы, ресурсы, задачи).
• Common — утилиты и расширения, используемые во всех модулях.

Все скрипты находятся в папке Assets/Scripts/. Ресурсы (префабы, модели, текстуры) хранятся в Assets/Resources/.

Документация

Эта документация создана с использованием mdBook и расположена в папке src/. Конфигурация mdBook находится в файле book.toml в корне проекта.

Документация охватывает:

• Архитектуру проекта
• Описание скриптов и кода
• Игровые механики
• Системы и сервисы
• Пользовательский интерфейс
• Конфигурацию и настройки
• Ресурсы (Assets)
• Тестирование и отладку
• Производительность и оптимизацию
• Сборку и развёртывание

Как пользоваться документацией

Навигация осуществляется через оглавление (см. SUMMARY.md). Каждая глава содержит подробное описание соответствующей части проекта, включая диаграммы Mermaid, примеры кода на C# и ссылки на реальные файлы проекта.

Если вы впервые знакомитесь с проектом, рекомендуется начать с Архитектуры проекта, чтобы понять общую структуру, а затем перейти к Игровым механикам для понимания основного геймплея.