• 🎮 Игровой процесс: Классический шутер с разнообразными врагами, каждый из которых обладает уникальным поведением. Игрок может использовать различное оружие, перки и специальные способности для прохождения уровней.

• 🎯 Цель проекта: Разработать и организовать в единый, работоспособный механизм множество сложных и взаимосвязанных игровых систем: от продвинутого AI противников и обширного арсенала оружия до полной системы сохранений и кастомной физики. Основной задачей было создание стабильной и функциональной основы, способной поддерживать весь этот комплекс механик.

• 🏃‍♂️ Продвинутая система передвижения (Mobility Suite)

  • Ответственные классы: PlayerMovement.cs, PlayerDashsService.cs, PlayerHookService.cs.
  • Суть: Помимо стандартного передвижения (ходьба, приседание, прыжок), система включает две ключевые action-механики:
    • Крюк-кошка: Реализован на SpringJoint для создания физически корректного ощущения притягивания. Имеет ограниченный ресурс (Hook Strength), который тратится во время использования и регенерируется со временем.
    • Рывки (Dashes): Игрок имеет несколько зарядов рывка, которые позволяют мгновенно уклоняться от атак. Заряды восстанавливаются по одному с определенной задержкой.

• 🔫 Система оружия и способностей

  • Ответственные классы: PlayerWeaponsManager.cs, WeaponData.cs, PlayerWeaponRecoil.cs, PlayerImmediatelyProtectionService.cs.
  • Суть: Полностью data-driven система, где все оружие (более 10 видов) настраивается через ScriptableObject. Поддерживает различные режимы стрельбы (автоматический, зарядка, дробовик, лазер), имеет кастомную систему отдачи и интегрирована с системой боеприпасов. Также включает защитную способность — мощный направленный взрыв (Magnetic Shock), работающий по принципу "ультимейта" с долгой перезарядкой.

• 📈 Система здоровья и прокачки костюма

  • Ответственные классы: PlayerMainService.cs (как хаб), ImprovementItem.cs, DashImprovementItem.cs (примеры).
  • Суть: Комплексная система, управляющая здоровьем, броней и сопротивлением урону. Включает в себя механику перманентных улучшений: игрок находит на уровнях специальные предметы, дающие "очки прокачки", которые можно потратить в специальном меню на апгрейд способностей (увеличение числа рывков, усиление защитного взрыва и т.д.).

• 🤖 Тактический ИИ с командным взаимодействием

  • Ответственные классы: DefaultBot.cs (базовый класс), EnemysAiManager.cs, FlyingDroneBot.cs, TeleporterBot.cs и др.
  • Суть: Основа поведения врагов (более 15 типов). AI построен на базе конечного автомата (FSM), реализованного на корутинах. Каждый тип врага наследуется от DefaultBot и имеет уникальную логику атаки и передвижения.
  • Командная работа: EnemysAiManager отслеживает всех "умных" ботов на сцене. Если один из них замечает игрока, он может "поднять тревогу", и все боты в радиусе также станут агрессивными и получат последнее известное местоположение игрока.
  • Стрельба на упреждение: Некоторые враги используют метод CalculateSmartTargetPos, который рассчитывает будущую позицию игрока на основе его текущей скорости и скорости полета снаряда.

• 🎬 Система спавна врагов по сценариям

  • Ответственный класс: LevelSpawnScenario.cs.
  • Суть: Мощный инструмент для левел-дизайна, позволяющий создавать сложные сценарии появления врагов. Поддерживает волны, задержки между ними, повторения, движение врагов к указанным точкам (WayPoint) и активацию UnityEvent'ов после зачистки всех врагов в сценарии.

• 💾 Полная система сохранений

  • Ответственные классы: LevelSaveLoadSystem.cs, LevelSaveData.cs, FixedJsonUtilityFunc.cs.
  • Суть: Позволяет сериализовать и десериализовать состояние всей игровой сцены в любой момент времени. Сохраняет состояние игрока, каждого врага, летящего снаряда, предмета и триггера.
    🧠 Особенности реализации...

    
    Для сериализации несериализуемых по-умолчанию типов Unity (`Dictionary`, `Rigidbody`, `Transform`) был написан кастомный класс-хелпер `FixedJsonUtilityFunc`, который конвертирует их в "понятные" для `JsonUtility` форматы и обратно. Это демонстрирует способность обходить ограничения стандартных инструментов.

• 🎶 Аудио-система с пулом объектов

  • Ответственный класс: AudioPoolService.cs.
  • Суть: Для воспроизведения звуковых эффектов используется пул объектов AudioSource с поддержкой приоритетов. Это позволяет избежать постоянного создания/уничтожения объектов, что значительно снижает количество сборок мусора (GC) во время активного геймплея.

• 📦 Система предметов и подбираемых объектов (Pickups)

  • Ответственные классы: OrdinaryPlayerItem.cs (базовый класс), WeaponGetItem.cs, PlayerAmmoItem.cs, PlasmaGetItem.cs.
  • Суть: Полиморфная система, где базовый класс OrdinaryPlayerItem определяет общую логику подбора, а дочерние классы реализуют конкретное поведение: выдать оружие, пополнить боезапас, восполнить здоровье/броню или добавить плазму для крафта патронов.

• 💻 HUD и Индикаторы

  • Ответственные классы: MainCircleUI.cs, DashsIndicatorService.cs, HookCircle.cs, BulletsIndicators.cs.
  • Суть: Комплексный игровой интерфейс, который в реальном времени отображает всю важную информацию: здоровье, броню, выбранное оружие (в виде анимированного "колеса"), количество патронов, доступные рывки и энергию крюка-кошки.

• 🎯 Контекстные подсказки и информация

  • Ответственные классы: AdditionalInformationPanel.cs, KeyboardKeyTip.cs, LevelTaskService.cs.
  • Суть: Система предоставляет игроку обратную связь:
    • При наведении на интерактивный объект или врага появляется панель с информацией о нём (AdditionalInformationPanel).
    • Наэкранные подсказки по управлению (KeyboardKeyTip) автоматически обновляются при изменении раскладки в настройках.
    • Система задач (LevelTaskService) выводит на экран текущую цель миссии.

• ⚙️ Комплексное меню настроек

  • Ответственные классы: SettingsSaveLoadSystem.cs, SettingsSetSystem.cs.
  • Суть: Полнофункциональное меню настроек, позволяющее игроку кастомизировать практически все аспекты игры. Все настройки сохраняются и загружаются из файла.
  • Графика: Качество текстур, анизотропная фильтрация, разрешение и дистанция теней, SSAO, MSAA, качество растительности, дистанция прорисовки, VSync, FOV, разрешение и формат экрана.
  • Управление: Полная перенастройка всех клавиш (InputButtonField.cs), включая действия мыши и колеса прокрутки, а также настройка чувствительности.
  • Звук: Раздельная регулировка громкости (мастер, музыка, эффекты, окружение, UI), настройка максимального количества звуковых источников.

• 🌍 Система локализации

  • Ответственные классы: CurrentLanguageData.cs, StaticTextLanguageAdaptable.cs.
  • Суть: Реализована система, позволяющая переводить весь игровой текст. Текстовые данные хранятся в ScriptableObject (LanguageData), а специальные компоненты на UI-элементах (StaticTextLanguageAdaptable) автоматически подгружают нужный перевод при смене языка в настройках.

В большинстве игр сохранение происходит в строго определенных точках. Цель была амбициознее: дать игроку возможность сохраниться в разгаре боя, во время полета ракеты или диалога, а после загрузки — вернуться в абсолютно идентичное состояние мира.

Ключевые требования:

• Сохранять состояние всех динамических сущностей.
• Работать с несериализуемыми типами Unity.
• Корректно восстанавливать сцену, избегая дубликатов и потерянных объектов.

Система состоит из трех ключевых компонентов:

• LevelSaveData.cs: "Контейнер" для данных. Этот MonoBehaviour динамически собирает ссылки на все объекты, которые нужно сохранить: игрока, врагов, пули, предметы, триггеры. Перед сериализацией он "опрашивает" каждый объект и сохраняет его состояние в виде простого Serializable класса.

• FixedJsonUtilityFunc.cs: "Переводчик". Стандартный JsonUtility не умеет работать с Transform, Rigidbody, Dictionary и другими сложными типами. Этот статический класс содержит методы, которые "разбирают" эти объекты на базовые типы (например, Transform на Vector3 позиции, Quaternion вращения и Vector3 скейла) и "собирают" их обратно при загрузке.

• LevelSaveLoadSystem.cs: "Оркестратор". Этот класс управляет всем процессом:

  1. При сохранении: Вызывает метод SaveToJson() у LevelSaveData, который собирает все данные, конвертирует их в JSON и записывает в файл с помощью BinaryFormatter (для простоты).
  2. При загрузке:
     • Загружает сцену по ID, сохраненному в файле.
     • (Ключевой шаг) После загрузки сцены уничтожает всех динамических врагов, предметы и пули, которые были на сцене по умолчанию.
     • Читает JSON из файла.
     • Проходит по сохраненным данным и воссоздает каждый объект из префаба, а затем применяет к нему сохраненное состояние (позицию, здоровье, скорость и т.д.).

• Результат: Была создана полностью рабочая система, позволяющая сохранять и загружать игру в любой момент.
• Полученный опыт: Этот процесс научил меня глубокой работе с сериализацией, рефлексией (для доступа к типам объектов), управлению жизненным циклом объектов и важности строгого порядка операций при восстановлении сложной сцены. Этот опыт стал фундаментом для моих дальнейших, более сложных архитектурных решений.

• Производительность: Текущая реализация использует JsonUtility, который не является самым быстрым методом сериализации. В реальном ААА-проекте стоило бы использовать более производительные бинарные сериализаторы.
• "Хрупкость": Система сильно зависит от наличия префабов с нужными компонентами. Изменение префаба может "сломать" старые сохранения. В будущем можно было бы внедрить систему версионирования сохранений для обратной совместимости.

• 🎮 Gameplay: A classic shooter with a variety of enemies, each with unique behavior. The player can use different weapons, perks, and special abilities to complete levels.

• 🎯 Project Goal: To develop and organize a multitude of complex and interconnected game systems into a single, functional mechanism: from advanced enemy AI and an extensive arsenal of weapons to a comprehensive save system and custom physics. The main task was to create a stable and functional foundation capable of supporting this entire complex of mechanics.

• 🏃‍♂️ Advanced Movement System (Mobility Suite)

  • Responsible Classes: PlayerMovement.cs, PlayerDashsService.cs, PlayerHookService.cs.
  • Essence: In addition to standard movement (walking, crouching, jumping), the system includes two key action mechanics:
    • Grappling Hook: Implemented with a SpringJoint to create a physically accurate feeling of being pulled. It has a limited resource (Hook Strength) that is consumed during use and regenerates over time.
    • Dashes: The player has several dash charges that allow for instant evasion of attacks. Charges are restored one by one with a certain delay.

• 🔫 Weapon and Ability System

  • Responsible Classes: PlayerWeaponsManager.cs, WeaponData.cs, PlayerWeaponRecoil.cs, PlayerImmediatelyProtectionService.cs.
  • Essence: A completely data-driven system where all weapons (over 10 types) are configured via ScriptableObject. It supports various firing modes (automatic, charged, shotgun, laser), has a custom recoil system, and is integrated with an ammunition system. It also includes a defensive ability—a powerful directional blast (Magnetic Shock) that functions as an "ultimate" with a long cooldown.

• 📈 Health and Suit Upgrade System

  • Responsible Classes: PlayerMainService.cs (as a hub), ImprovementItem.cs, DashImprovementItem.cs (examples).
  • Essence: A comprehensive system that manages health, armor, and damage resistance. It includes a permanent upgrade mechanic: the player finds special items on levels that grant "upgrade points," which can be spent in a special menu to upgrade abilities (increasing the number of dashes, enhancing the protective blast, etc.).

• 🤖 Tactical AI with Team Interaction

  • Responsible Classes: DefaultBot.cs (base class), EnemysAiManager.cs, FlyingDroneBot.cs, TeleporterBot.cs, etc.
  • Essence: The foundation of enemy behavior (over 15 types). The AI is built on a finite-state machine (FSM) implemented with coroutines. Each enemy type inherits from DefaultBot and has unique attack and movement logic.
    • Teamwork: EnemysAiManager tracks all "smart" bots on the scene. If one of them spots the player, it can "raise an alarm," and all bots within a certain radius will also become aggressive and receive the player's last known location.
    • Predictive Shooting: Some enemies use the CalculateSmartTargetPos method, which calculates the player's future position based on their current velocity and the projectile's speed.

• 🎬 Enemy Spawning System via Scenarios

  • Responsible Class: LevelSpawnScenario.cs.
  • Essence: A powerful tool for level design that allows creating complex enemy appearance scenarios. It supports waves, delays between them, repetitions, moving enemies to specified points (WayPoint), and activating UnityEvents after clearing all enemies in a scenario.

• 💾 Comprehensive Save System

  • Responsible Classes: LevelSaveLoadSystem.cs, LevelSaveData.cs, FixedJsonUtilityFunc.cs.
  • Essence: Allows serializing and deserializing the state of the entire game scene at any moment. It saves the state of the player, every enemy, flying projectile, item, and trigger. To serialize non-serializable Unity types by default (Dictionary, Rigidbody, Transform), a custom helper class FixedJsonUtilityFunc was written to convert them into formats understandable by JsonUtility and back. This demonstrates the ability to work around the limitations of standard tools.

• 🎶 Audio System with Object Pooling

  • Responsible Class: AudioPoolService.cs.
  • Essence: An object pool of AudioSource components is used for playing sound effects, with support for priorities. This avoids constant instantiation and destruction of objects, significantly reducing garbage collection (GC) overhead during active gameplay.

• 📦 Item and Pickup System

  • Responsible Classes: OrdinaryPlayerItem.cs (base class), WeaponGetItem.cs, PlayerAmmoItem.cs, PlasmaGetItem.cs.
  • Essence: A polymorphic system where the base class OrdinaryPlayerItem defines the general pickup logic, and child classes implement specific behaviors: granting a weapon, replenishing ammo, restoring health/armor, or adding plasma for crafting ammo.

• HUD and Indicators

  • Responsible Classes: MainCircleUI.cs, DashsIndicatorService.cs, HookCircle.cs, BulletsIndicators.cs.
  • Essence: A comprehensive game interface that displays all vital information in real-time: health, armor, selected weapon (in an animated "wheel"), ammo count, available dashes, and grappling hook energy.

• 🎯 Contextual Hints and Information

  • Responsible Classes: AdditionalInformationPanel.cs, KeyboardKeyTip.cs, LevelTaskService.cs.
  • Essence: The system provides feedback to the player:
    • When aiming at an interactive object or enemy, a panel with information about it appears (AdditionalInformationPanel).
    • On-screen control hints (KeyboardKeyTip) automatically update when the key layout is changed in the settings.
    • The task system (LevelTaskService) displays the current mission objective on the screen.

• ⚙️ Comprehensive Settings Menu

  • Responsible Classes: SettingsSaveLoadSystem.cs, SettingsSetSystem.cs.
  • Essence: A fully functional settings menu that allows the player to customize almost every aspect of the game. All settings are saved to and loaded from a file.
    • Graphics: Texture quality, anisotropic filtering, shadow resolution and distance, SSAO, MSAA, vegetation quality, draw distance, VSync, FOV, screen resolution, and display mode.
    • Controls: Full rebinding of all keys (InputButtonField.cs), including mouse actions and scroll wheel, as well as sensitivity settings.
    • Sound: Separate volume controls (master, music, effects, ambient, UI), and configuration of the maximum number of sound sources.

• 🌍 Localization System

  • Responsible Classes: CurrentLanguageData.cs, StaticTextLanguageAdaptable.cs.
  • Essence: A system has been implemented to translate all in-game text. Text data is stored in a ScriptableObject (LanguageData), and special components on UI elements (StaticTextLanguageAdaptable) automatically load the correct translation when the language is changed in the settings.

In most games, saving occurs at strictly defined points. The goal was more ambitious: to give the player the ability to save in the middle of a battle, during a rocket's flight, or in a dialogue, and after loading, to return to an absolutely identical state of the world.

Key Requirements:

• Save the state of all dynamic entities.
• Work with non-serializable Unity types.
• Correctly restore the scene, avoiding duplicates and lost objects.

The system consists of three key components:

• LevelSaveData.cs: The data "container." This MonoBehaviour dynamically collects references to all objects that need to be saved: the player, enemies, projectiles, items, triggers. Before serialization, it "polls" each object and saves its state as a simple Serializable class.

• FixedJsonUtilityFunc.cs: The "translator." The standard JsonUtility cannot handle Transform, Rigidbody, Dictionary, and other complex types. This static class contains methods that "disassemble" these objects into basic types (e.g., a Transform into a Vector3 for position, a Quaternion for rotation, and a Vector3 for scale) and "reassemble" them upon loading.

• LevelSaveLoadSystem.cs: The "orchestrator." This class manages the entire process:

  1. On Save: Calls the SaveToJson() method on LevelSaveData, which gathers all data, converts it to JSON, and writes it to a file using BinaryFormatter (for simplicity).
  2. On Load:
     • Loads the scene by the ID saved in the file.
     • (Key Step) After the scene loads, it destroys all dynamic enemies, items, and projectiles that were in the scene by default.
     • Reads the JSON from the file.
     • Iterates through the saved data and recreates each object from a prefab, then applies its saved state (position, health, velocity, etc.).

• Result: A fully functional system was created that allows saving and loading the game at any moment.
• Experience Gained: This process taught me in-depth work with serialization, reflection (for accessing object types), object lifecycle management, and the importance of a strict order of operations when restoring a complex scene. This experience became the foundation for my subsequent, more complex architectural decisions.

• Performance: The current implementation uses JsonUtility, which is not the fastest serialization method. In a real AAA project, more performant binary serializers would be preferable.
• "Fragility": The system heavily relies on the existence of prefabs with the necessary components. Changing a prefab can "break" old saves. In the future, a save versioning system could be implemented for backward compatibility.