Перейти к основному содержимому

README

Aspid.FastTools

Boilerplate Killer for Unity

Unity 6000.0.53f1+ Release 1.0.0 MIT

Aspid.FastTools — пакет для Unity, который убирает рутину из сериализации, профилирования и редакторского кода.

Установка​

Все версии
https://github.com/VPDPersonal/Aspid.FastTools.git#upm

Нужна Unity 6000.0.53f1 или новее. Если пакет у вас из Asset Store, git URL не нужен: установите его из My Assets в Package Manager.

Решение проблем

Сразу после установки появляются ошибки компиляции. Версия Unity старше 6000.0.53f1: в более ранних патчах 6000.0 нет API UI Toolkit, которые использует пакет. Проверьте версию в Help → About Unity (Unity → About Unity на macOS).

В Console появляется Assembly with name 'Aspid.FastTools' already exists. В проекте есть вторая копия пакета, например его папка в Assets. Удалите копию.

Переход между Asset Store и git URL. Оба источника ставят один и тот же пакет, tech.aspid.fasttools, поэтому сначала удалите его в Window → Package Manager (In Project), затем установите из другого источника.

Возможности​

Сериализация​

Выбор сериализуемого типа в инспектореВыбор сериализуемого типа в инспекторе

Serializable Types

Сохраняет System.Type в компоненте или ассете и даёт выбрать его в инспекторе из совместимых типов. TypeSelector сужает этот список.

Подробнее

Смена Pistol на Shotgun с сохранением Damage = 37Смена Pistol на Shotgun с сохранением Damage = 37

SerializeReference Selector

Даёт выбрать класс для поля [SerializeReference] в инспекторе и переносит совместимые данные при смене класса.

Подробнее

EnumValues

Сопоставляет ключам enum значения — множители, цвета, ассеты — и даёт редактировать их в инспекторе, включая флаги.

Подробнее

Редактор и инструменты​

public void Step(){    using var _ = this.Marker();    using (this.Marker().WithName("Steering"))        Steer(_agents);    using (this.Marker().WithName("Integrate"))        Integrate();}

ProfilerMarkers

Размечает участок одной строкой, а имя маркера генератор собирает из типа, метода и строки вызова.

Подробнее

var header = new VisualElement()    .SetPaddingX(12)    .SetPaddingY(10)    .AddChild(new Label("Ability Config")        .SetFontSize(14));

VisualElement Extensions

Задаёт свойства, стили и события элемента цепочкой, так что дерево UI Toolkit собирается одним выражением.

Подробнее

manaCost    .Update()    .SetIntAndApply(42);

SerializedProperty Extensions

Обновляет объект, записывает значение и применяет изменения одной цепочкой. Ещё находит C#-поле за свойством и объект, которому оно принадлежит.

Подробнее

caster.GetDisplayName();caster.GetDisplayNameWithIndex();
  • GetDisplayName()“Ability Caster”
  • GetDisplayNameWithIndex()“Ability Caster (2)”

Editor Helpers

Подписывает объекты и компоненты читаемыми именами, а одинаковые компоненты — с номером.

Подробнее

public void Simulate(){    using var _ = this.Marker();    using (this.Marker().WithName("Neighbors"))    FindNeighbors();    Integrate();}

Agent Skills

Учит coding-агента писать код с FastTools: маркеры профилировщика, выбор типов, EnumValues и VisualElement Extensions.

Подробнее

Ресурсы​

Обзор примеров

Сцены и редакторские инструменты для сериализации, enum-таблиц, профилирования и интерфейсов редактора.

Справочник API

Типы, методы и свойства пакета, на английском.

Журнал изменений

Изменения и исправления по версиям.

Помощь и поддержка​

Нашли ошибку или есть вопрос?

Укажите версию Unity, версию пакета и шаги воспроизведения.

Поддержать проект​