creator-mods-suite

# Creator Mods Suite **Creator Mods Suite** — это комплексный набор модов, разработанный специально для создателей контента Minecraft, YouTuber'ов и стримеров, играющих на версии 1.21.1. Он предоставляет набор из восьми независимо отключаемых функций, улучшающих геймплей для целей записи, с поддержкой как NeoForge, так и Fabric в рамках единой мультизагрузочной кодовой базы. ## Основное назначение Набор представляет собой «режиссёрский инструментарий» для Minecraft, позволяющий создателям запускать сложные события, управлять ракурсами камеры и изменять правила игры на лету с помощью команд или привязок клавиш. Это устраняет необходимость ставить игру на паузу, выходить в меню или перезапускать игру во время сессий записи, обеспечивая плавный и профессиональный вид отснятого материала. ## Ключевые функции Набор состоит из восьми отдельных модулей, каждый из которых выполняет определённую творческую функцию: 1. **Director's Toolkit (`/toolkit`)**: Средство для записи, включающее экранный хлопушку, маркеры дублей, переключатели заморозки мобов/игроков, спавнеры волн, снимки арены, закладки камеры и переключатели HUD для чистого кадра. Позволяет точно контролировать дубли записи. 2. **Ashen Colossus (`/colossus`)**: Анимированный трёхфазный бой с боссом на базе GeckoLib. Включает такие механики, как удары ударной волной, лавовый дождь, волны миньонов и фазу ярости с огненным кольцом. 3. **Power Kit (`/power`)**: Предоставляет шесть способностей, активируемых привязками клавиш: рывок, огненный взрыв, удар по земле, притяжение эндера, купол щита и заморозка мобов. Включает серверные перезарядки и визуальную обратную связь через строку хотбара. 4. **Rule Engine (`/rule`, `/shop`)**: Позволяет изменять правила игры в реальном времени с одиннадцатью суммируемыми опциями (например, случайные дропы, умноженный крафт, лавовые полы, гигантские мобы). Поддерживает пресеты датапаков для лёгкого переключения. 5. **Evolve (`/evolve`)**: Пятиэтапная система трансформации игрока, в которой игроки получают размер, бонусы к характеристикам и пассивные способности на каждой ступени, сопровождаемые эффектами частиц и сменой моделей. 6. **Event Director (`/event`)**: Запускает режиссированные мировые события, такие как кровавые луны, метеоры, осады, удачливые дожди и подъёмы пустоты. События основаны на фазах и могут быть перенастроены по времени, пропущены или остановлены с помощью команд. 7. **Arsenal (`/arsenal`)**: Вводит четыре уникальных оружия: Grapple Blade, Storm Bow, Gravity Hammer и Soul Scythe, каждое с отличными механическими взаимодействиями. 8. **Cursed Vault (`/vault`)**: Структура подземелья-пазла, содержащая Cursed Altar, который призывает мини-босса (Vault Keeper) и запечатанные сундуки, открывающиеся после его поражения. Включает функцию сброса одной командой. ## Дизайн, ориентированный на создателей * **Управление через командную строку**: Каждая функция управляется через чат-команды (например, `/colossus phase 3`, `/event skip`), что позволяет вносить изменения в реальном времени, не прерывая геймплей. * **Тихий режим**: Команды можно настроить так, чтобы обратная связь выводилась только в строку действий, а не в журнал чата, что предотвращает загромождение отснятого материала, сохраняя сообщения об ошибках видимыми для оператора. * **Независимое переключение**: Каждую из восьми функций можно включать или отключать индивидуально через конфигурацию или команды. Отключённые функции ничего не регистрируют в игровом мире, обеспечивая нулевые накладные расходы на производительность или визуальные помехи, когда они не используются. * **Ненавязчивый HUD**: Все пользовательские слои HUD учитывают ванильный полноэкранный режим F1 и могут быть очищены для каждого игрока с помощью команд, что помогает при настройке нескольких камер. * **Безопасность камеры**: Игроки в режимах Creative или Spectator игнорируются враждебными механиками (атаки боссов, экологические опасности), что позволяет операторам камеры безопасно пролетать через сцены. ## Технические детали * **Совместимость**: Поддерживает Minecraft 1.21.1 с NeoForge 21.1.250+ и Fabric Loader 0.19.5+. Требуется Java 21. * **Архитектура**: Использует общий модуль `common/` для игровой логики, с отдельными модулями `fabric/` и `neoforge/` для платформо-специфичных точек входа и миксинов. Это обеспечивает идентичное поведение на разных загрузчиках. * **Конфигурация**: Управляется через единый файл `config/creatormods.json`. Значения баланса — это жёстко закодированные константы; динамические данные используют датапаки Minecraft. * **Тестирование**: Проект включает обширное тестирование: 486 модульных тестов JUnit 5 и 134 внутриигровых GameTest на каждый загрузчик, охватывающих логику, сеть и интерактивные игровые сценарии. * **Ресурсы**: Текущие ресурсы являются заполнителями, сгенерированными программно (текстуры на Python, аудио через ffmpeg), чтобы мод работал без отсутствующих ресурсов. Настоящие художественные ресурсы запланированы, но пока не включены. ## Установка Пользователи должны собрать мод из исходного кода или использовать предоставленные JAR-файлы, если они доступны. Зависимости включают GeckoLib (требуется для анимаций) и Fabric API (для сборок Fabric). Мод должен быть установлен как на клиенте, так и на сервере для полной функциональности. ## Лицензия Проект лицензирован под MIT License, что позволяет форкать, изменять и использовать на частных серверах без обязательной публикации изменений.