Neoxider — коллекция мощных инструментов для Unity

RU: Готовые решения для Unity, которые легко интегрируются в ваш проект. Более 150 модулей для быстрой разработки игр без лишних сложностей.

EN: Ready-to-use Unity tools that integrate easily into your project. 150+ modules for fast game development without unnecessary complexity.

Neoxider — это экосистема готовых инструментов для Unity, созданная разработчиками для разработчиков. Легко настраивается через Inspector, не требует глубокого погружения в код, но при этом остаётся полностью прозрачной и расширяемой. Идеально подходит для прототипирования и продакшн-проектов.

Neoxider is an ecosystem of ready-to-use Unity tools, built by developers for developers. Easy to configure through Inspector, no deep code diving required, yet fully transparent and extensible. Perfect for prototyping and production projects.

---

Чем примечателен Neoxider

• Production-ready: каждая подсистема поставляется с примерами, документацией и продуманными интеграциями.
• No-code там, где нужно: большинство компонентов настраиваются через инспектор и UnityEvent, но при этом остаются расширяемыми.
• Документация внутри: у каждого модуля есть собственный README в Assets/Neoxider/Docs/....
• Автоматическое сохранение: много скриптов имеют автоматическое сохранение, а также мощный модуль атрибутов сохранения.
• Модульность: изоляция через Assembly Definition Files, возможность импорта только нужных модулей.
• Расширяемость: легко расширять через наследование и интерфейсы.
• Гибридный подход: No-Code + Code для максимальной гибкости.

(Обратите особое внимание модулю Extensions если любите писать код) Также множество скриптов поддерживают работу через код или только с ним, к примеру Singleton, ChanceSystem и множество других

---

📑 Содержание

Навигация

• Быстрый старт
• Документация
• Топовые модули
• Зависимости
• Установка

Основные модули

• Tools — Инструменты и утилиты (150+ компонентов)
• UI — Пользовательский интерфейс
• Bonus — Бонусные системы
• Shop — Магазин и экономика
• Save — Система сохранений
• Cards — Карточные игры
• StateMachine — Машина состояний
• Animations — Анимации
• Audio — Звук
• Extensions — Расширения C#
• Editor — Инструменты редактора
• Level — Уровни
• Parallax — Параллакс
• GridSystem — Сетка
• PropertyAttribute — Атрибуты свойств

---

Demo Scenes

Demo Games

---

Как ориентироваться

Полный список — в соответствующих подпапках Docs. Каждый markdown содержит быстрый старт и примеры.

📖 Полная документация →

📌 PROJECT_SUMMARY → — краткий обзор структуры и модулей

Основные модули (краткий обзор)

Tools — Инструменты и утилиты

Самая большая категория, содержащая базовые "кирпичики" для построения игр:

• Components: DialogueManager, Loot, ScoreManager, TypewriterEffect, AttackSystem
• Input: SwipeController, MouseInputManager, MouseEffect, MultiKeyEventTrigger
• Movement: MovementToolkit, Follow, CameraConstraint, DistanceChecker, AiNavigation
• Physics: ExplosiveForce, ImpulseZone, MagneticField
  • 📖 Документация Physics →
• Spawner: ObjectPool, Spawner, SimpleSpawner
• Managers: Singleton, GM, EM, Bootstrap
• Random: ChanceManager, ChanceSystemBehaviour
• Time: Timer, TimerObject
• Debug: ErrorLogger, FPS
• Draw: Drawer
• FakeLeaderboard: Leaderboard, LeaderboardItem
• InteractableObject: InteractiveObject, PhysicsEvents2D/3D
• И многое другое...

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

UI — Пользовательский интерфейс

• UI — менеджер UI-панелей (страниц)
• ButtonScale/ButtonShake — анимации кнопок
• AnimationFly — анимация "летящих" элементов
• VisualToggle — универсальный переключатель визуальных состояний
• VariantView — управление визуальными состояниями

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

Bonus — Бонусные системы

• Slot — слот-машина
• WheelFortune — колесо фортуны
• Collection — система коллекций
• TimeReward — награды по времени
• LineRoulett — линейная рулетка

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

Shop — Магазин и экономика

• Shop — центральный контроллер магазина
• ShopItem — визуальное представление товара
• Money — система управления валютой
• ButtonPrice — кнопка с ценой
• TextMoney — UI для отображения денег

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

Save — Система сохранений

• SaveProvider — статический класс с API как PlayerPrefs
• ISaveProvider — интерфейс для провайдеров сохранения
• SaveManager — ядро системы сохранения
• GlobalSave — глобальное хранилище
• SaveableBehaviour — базовый класс для сохраняемых компонентов

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

Cards — Карточные игры

• MVP архитектура: Model, View, Presenter
• CardComponent, DeckComponent, HandComponent, BoardComponent
• Poker подмодуль с комбинациями
• DrunkardGame — готовая игра "Пьяница"

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

StateMachine — Машина состояний

• Код-реализация через IState интерфейс
• No-Code конфигурация через ScriptableObject
• Система предикатов для сложных условий
• Визуальный редактор Inspector

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

Animations — Анимации

• FloatAnimator — анимация float значений
• ColorAnimator — анимация цветов
• Vector3Animator — анимация векторов

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

Audio — Звук

• AMSettings — настройки аудио менеджера
• RandomMusicController — контроллер случайной музыки (используется в AM)
• SettingMixer — управление микшером
• AudioSimple — упрощенная система воспроизведения

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

Extensions — Расширения C#

Огромная библиотека методов-расширений:

• TransformExtensions, ComponentExtensions, GameObjectArrayExtensions
• EnumerableExtensions, StringExtension, ColorExtension
• RandomExtensions, CoroutineExtensions, AudioExtensions
• И многие другие...

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

Editor — Инструменты редактора

• NeoxiderSettingsWindow — окно глобальных настроек
• FindAndRemoveMissingScriptsWindow — поиск потерянных скриптов
• TextureMaxSizeChanger — массовое изменение размера текстур
• SaveProjectZip — создание резервных копий проекта
• AutoBuildName — автоматическое именование билдов

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

Level — Уровни

• LevelManager — менеджер уровней
• LevelButton — кнопка уровня
• Map — карта уровней

Parallax — Параллакс

• ParallaxLayer — слой параллакса с предпросмотром, зазорами, рандомизацией

GridSystem — Сетка

• FieldGenerator — генератор поля
• FieldCell — ячейка поля
• FieldSpawner — спавн объектов на поле

PropertyAttribute — Атрибуты свойств

• Различные атрибуты для валидации и отображения полей
• Кастомные редакторы для каждого атрибута

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

---

---

Зависимости и требования

• Unity: Рекомендуется версия 2022 и выше.
• DOTween: Для анимации (например, в «Колесе фортуны» и «Box») требуется установить DOTween.
• UniTask Ассинхронное программирование.

---

Интеграция ассетов Neoxider через Unity Package Manager

Добавьте зависимости:

• UniTask from Git URL https://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask
• DG Dotween from Assets Store DotWeen

Если вы хотите интегрировать ассеты NeoxiderTools в ваш Unity-проект, импортируя только содержимое папки /Assets/Neoxider, используйте следующий Git URL:

https://github.com/NeoXider/NeoxiderTools.git?path=Assets/Neoxider

Пример установки конкретной версии (закрепление на тег; актуальный на сейчас — v5.5.2):

https://github.com/NeoXider/NeoxiderTools.git?path=Assets/Neoxider#v5.5.2

Если хотите попробовать новые функции — установите библиотеку из ветки demo:

https://github.com/NeoXider/NeoxiderTools.git?path=Assets/Neoxider#demo

---

Установка модуля Pages (NeoxiderPages) через UPM

Модуль страниц находится в папке Assets/NeoxiderPages и поставляется как отдельный UPM-пакет.

• Важно: NeoxiderPages использует сборки Neo.* (Tools/Core), поэтому сначала установите базовый пакет NeoxiderTools (папка Assets/Neoxider), а затем Pages.
• Зависимости: TextMeshPro, uGUI и DOTween (для анимаций/DOTweenAnimation).

1) Установить базовый пакет NeoxiderTools

https://github.com/NeoXider/NeoxiderTools.git?path=Assets/Neoxider#v5.5.2

2) Установить Pages

https://github.com/NeoXider/NeoxiderTools.git?path=Assets/NeoxiderPages#v1.0.4

Быстрый вызов страниц по имени

Если удобнее переключать страницы по строке:

UIKit.ShowPage("PageEnd");
// или
PM.I.ChangePageByName("PageEnd");

Авто‑подписка на состояния игры

PageSubscriber может автоматически искать PageId по стандартным именам: PageGame, PageWin, PageLose, PageEnd.

• Включено по умолчанию (autoResolvePageIds = true).
• Можно переопределить имена в инспекторе.

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

1. Подготовьте зависимости: Unity 2021.3+, Spine Unity Runtime — для модулей Spine.
2. Импортируйте папку Assets/Neoxider в свой проект.
3. Добавьте системный префаб Assets/Neoxider/Prefabs/--System--.prefab в сцену — он подключает менеджеры событий и UI.
4. Подключите нужные подсистемы: компоненты находятся в папках Scripts/…, а примеры и готовые конфигурации — в Demo/ и Prefabs/.
5. Изучите документацию: откройте соответствующий README в Docs, чтобы настроить модуль за несколько минут.

---

Топовые модули

• SpineController — фасад для Spine с UnityEvent-обёртками, автозаполнением анимаций/скинов и отключением, если Spine Runtime отсутствует.
• ParallaxLayer — параллакс с предпросмотром, зазорами, рандомизацией и автоматической переработкой тайлов.
• Drawer — инструмент рисования линий с поддержкой LineRenderer/EdgeCollider, сглаживанием и UnityEvent для креативных механик.
• DialogueManager — диалоговая система с персонажами, портретами и событиями на каждой реплике.
• SwipeController — обработчик свайпов (мышь, тач, геймпад) с UnityEvent и фильтрами расстояния.
• ChanceManager — декларативная система вероятностей для лута, рулеток и других случайностей.
• ObjectPool / Spawner — расширяемый пул с волнами, задержками, случайным выбором префабов и инспекторной настройкой.
• FakeLeaderboard — динамический лидерборд с анимацией, сортировкой, автозаполнением и UI-примерами.
• MovementToolkit — набор контроллеров движения (клава/мышь, 2D/3D, follow-камеры, ограничители экрана).
• InteractiveObject — база для зон и триггеров, позволяет строить взаимодействия без кода.
• Timer / TimerObject — таймеры с паузой, повтором, сериализацией и событиями прогресса.
• Physics модуль — интересные физические компоненты: ExplosiveForce, ImpulseZone, MagneticField (с поддержкой притяжения к цели/точке, отталкивания и переключения режимов)

FAQ

Можно использовать выборочно? Да, импортируйте только нужные папки: зависимости указаны в документации.

Есть примеры сцен? Да, в папке Demo. Там набор минимальных сцен для проверки каждого крупного модуля.

Работает с 3D? Большинство систем — да. Исключение: чисто 2D-ориентированные решения вроде ParallaxLayer.

---

Поддержка и вклад

Neoxider развивается. Если нашли баг или хотите предложить модуль — открывайте issue/PR. В ответ мы стараемся документировать все изменения и предоставляем руководство по миграции.

see: Changelog

Удачи в разработке и приятного продакшена!