Skip to content

README_RU.md

Latest commit

 

History

History
122 lines (85 loc) · 7.78 KB

README_RU.md

File metadata and controls

122 lines (85 loc) · 7.78 KB

NeoxiderTools для Unity

Русский | English

Version Unity Namespace

NeoxiderTools — Unity-пакет для быстрой сборки игровых систем без скрытой магии. Внутри: no-code компоненты для Inspector, runtime-модули, editor-инструменты, samples и документация по точкам расширения.

Пакет подходит для прототипов, game jam проектов и production-игр: условия, сохранения, магазин, RPG-бой, инвентарь, квесты, state machine, UI, сетевые мосты и набор утилит, которые убирают повторяющийся glue-code.

Быстрые ссылки

Установка

Unity Package Manager

Git URL:

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

В Unity: Window > Package Manager > + > Add package from git URL.

Ручная установка

Скопируйте Assets/Neoxider в свой Unity-проект.

Требования

  • Unity 2022.1+.
  • Автоматически через UPM: com.unity.textmeshpro, com.unity.ai.navigation, com.unity.inputsystem.
  • Сторонние зависимости подключаются только по сценарию: UniTask, DOTween, Mirror, Spine Unity Runtime, Odin Inspector, MarkdownRenderer.
  • URP опционален. Пакет больше не зависит от com.unity.render-pipelines.universal; добавляйте URP отдельно только если проект использует URP-specific rendering features или 2D lights.

Что внутри

Область Что решает Документация
Condition Проверки через Inspector: поля, свойства, методы, GameObject state, AND/OR, события Condition
NoCode Привязка значений компонентов к UI и действиям без одноразовых view-скриптов NoCode
RPG Ресурсы, статы, баффы, статусы, прогрессия, бой, цели, multiplayer-ready API RPG
Shop Предметы, бандлы, owned/equipped, multi-currency, inventory bridge, save profile Shop
Inventory Aggregated и Slot Grid инвентарь, pickups, transfer rules, сохранение Inventory
Save PlayerPrefs/JSON provider flow, typed helpers, save attributes Save
Progression XP, уровни, perk tree, unlock tree, persistent progression Progression
Quest Конфиги квестов, цели, менеджер, no-code actions, runtime state Quest
StateMachine Runtime state machine и no-code transition predicates StateMachine
Network Опциональные Mirror wrappers и no-code network action/sync bridges Network guide
Tools Movement, свободный полет камеры, physics, timers, spawners, interaction, text, managers, view helpers Tools
Extensions 300+ extension-методов для C# и Unity API Extensions

No-code пример: NeoCondition

NeoCondition позволяет собирать игровую логику прямо в Inspector:

  • Проверять поля, свойства, состояние GameObject или методы с одним аргументом.
  • Сравнивать с константой или другим объектом.
  • Использовать AND, OR и инверсию.
  • Вызывать OnTrue, OnFalse, OnResult, OnInvertedResult через UnityEvent.

Пример: Money.CanSpend(100) == true включает кнопку покупки, а == false показывает сообщение о нехватке денег.

Подробнее: документация NeoCondition.

Чеклист первой сцены

  1. Импортируйте пакет.
  2. Добавьте Assets/Neoxider/Prefabs/--System--.prefab, если сцена использует встроенные менеджеры или UI bootstrap.
  3. Добавляйте компоненты через Add Component > Neoxider.
  4. Начните с нужного модуля: Shop, RPG, Condition, Tools.
  5. Для мультиплеера сначала установите Mirror и откройте Multiplayer guide.

Samples

Samples лежат в Assets/Neoxider/Samples~/ и импортируются через Package Manager при UPM-установке.

Sample Назначение
Demo Интеграционные сцены для основных систем и gameplay-модулей
NeoxiderPages Опциональный sample навигации страниц: PM, UIPage, BtnChangePage, UIKit helpers

Тесты

Тесты пакета находятся в Assets/Neoxider/Tests/:

  • Edit — edit-mode и pure logic проверки.
  • Play / PlayMode — runtime и scene behavior.
  • Editor — editor-specific проверки пакета.

Запуск через Unity Test Runner. Для тестов в проекте должен быть com.unity.test-framework.

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

Assets/Neoxider/
  Scripts/       Runtime-модули и asmdef-разделение
  Editor/        Custom inspectors, окна и editor-утилиты
  Tests/         EditMode и PlayMode тесты пакета
  Docs/          Русская документация
  DocsEn/        Английская документация
  Samples~/      UPM samples
  Prefabs/       Готовые префабы
  Resources/     Настройки и assets пакета

Игры на NeoxiderTools

Игра Жанр Платформа Ссылка Примечание
Внуки понарошку: пенсия прилагается Arcade, Survival Windows MyIndie UralGameJam 2026; inspector-driven Neoxider workflow

Поддержка

Открывайте issue или pull request в репозитории. При изменении публичного поведения обновляйте CHANGELOG.md и документацию соответствующего модуля.