ContentTagsSystem

Namespace: Vortex.Sdk.ContentTagsSystem.* Assembly: ru.vortex.sdk.contenttags Условная компиляция: defineConstraints: ["USING_VORTEX_CONTENT_TAGS"], тоггл в SdkSettings

---

Область применения

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

Типовой пример — главное меню. В сборке для Steam на нём есть кнопка «Оценить игру» и блок ссылок на соцсети; в сборке для паблишера их быть не должно — ни кнопки магазина, ни внешних ссылок. Раздел «Дополнения» нужен там, где DLC продаются, и бессмыслен в демо-версии. Содержимое меню при этом общее: те же префабы, те же сцены, тот же код.

Без пакета это делается правкой префабов под каждую сборку: собрал для Steam — вернул кнопку, собрал для паблишера — убрал. С пакетом кнопка один раз помечается тегом store_links, тег включается в бандле steam и не включается в бандле publisher_x, а перед сборкой меняется одно поле — активное издание.

Те же очертания у соседних задач:

Когда пакет не подходит:

• контент обязан физически отсутствовать в сборке — цензура, возрастные ограничения, региональные запреты: это AssetSwapSystem, подмена ассетов перед сборкой. Здесь выключенное остаётся в билде;
• показ зависит от того, что сделал игрок — открыл, посмотрел, купил: это RecordMarksSystem и прочие системы прогресса;
• показ зависит от права на платный контент: это проверка владения на стороне площадки, а не конфигурация сборки;
• переключение нужно игроку в настройках — тогда это обычная настройка игры, а не издание.

---

Назначение

Конфигурация состава интерфейсов и систем под издание сборки. Одна игра выходит в нескольких изданиях — витрина Steam, витрина GOG, сборка под паблишера, демо — и отличается набором показанного: кнопка магазина, блок соцсетей, раздел дополнений, пункт меню.

Механика состоит из трёх вещей:

• тег — строковый ключ, объявленный в ассете настроек;
• бандл — издание: белый список включённых в нём тегов;
• активный бандл — одно поле, определяющее конфигурацию текущей сборки.

Компоненты пакета читают активный набор и показывают либо прячут размеченный контент. Переключение издания — смена одного значения перед сборкой, без правки сцен и префабов.

Вне ответственности:

• Физическое отсутствие контента. Выключенное остаётся в билде. Для изданий, где контент обязан отсутствовать (цензура, возрастные ограничения), существует AssetSwapSystem — подмена ассетов перед сборкой. Этот пакет — мягкая конфигурация представлений.
• Чистка данных игрока. Прогресс по контенту, выключенному в этом издании, остаётся в сохранении и просто не показывается. Квесты, инвентарь, галерея не фильтруются.
• Выбор издания в пайплайне. Значение в ассете проставляет сборщик — вручную или скриптом перед билдом.

---

Зависимости

---

Использование

Настройка проекта

1. Включите тоггл пакета в Tools → Vortex → Configs → SDK Settings.
2. Create → Vortex → Settings → Content Tags, положите ассет в Resources. Быстрый доступ к нему потом — Tools → Vortex → Content Tags → Settings.
3. Объявите теги: ключ плюс описание, зачем тег заведён.
4. Заведите бандлы изданий и отметьте в каждом включённые теги.
5. Выберите activeBundle.

Разметка контента

// Любая система может спросить напрямую — не только UI.
if (ContentBus.IsActive("store_links"))
    BuildStoreSection();

На сцене: ContentTagGateHandler там, где состояние настраивается свитчером; ContentTagObjectHandler там, где раздела просто не должно быть.

Перед сборкой издания

1. Поставьте нужный activeBundle в ассете.
2. Откройте Tools → Vortex → Content Tags → Index, нажмите Обновить.
3. Проверьте состав издания и разделы «объявлены, но не используются» и «используются, но не объявлены» — второй означает опечатку в компоненте или удалённое объявление.
4. Find в строке носителя: открытая сцена — выделение объекта, префаб — открытие в режиме редактирования и выделение, закрытая сцена — подсветка ассета.

---

Архитектура

ContentBus (static)
  ├── IsActive(tag): bool                  ← включён ли тег в текущем издании
  ├── Matches(tags, mode): bool            ← сопоставление списка по режиму
  ├── ActiveBundle: string
  ├── ActiveTags: IReadOnlyCollection<string>
  └── Build()                              ← ленивое чтение ассета при первом обращении

ContentSettings (SO, Resources)
  ├── tags: List<ContentTag>               ← объявленные теги
  ├── bundles: List<ContentBundle>         ← издания
  ├── activeBundle: string                 ← издание текущей сборки
  └── Validate()                           ← пустые и дублирующиеся ключи, необъявленные теги

Handlers
  ├── ContentTagGateHandler                ← UIStateSwitcher: On / Off
  └── ContentTagObjectHandler              ← SetActive на списке целей

Editor
  ├── ContentTagsIndex                     ← индекс «тег → носители» одним проходом
  └── ContentTagsWindow                    ← Tools/Vortex/Content Tags/Index, только чтение

Порядок работы

1. При первом обращении к шине читается ассет из Resources.
2. Теги активного бандла становятся активным набором; набор живёт до конца сеанса.
3. Компонент в OnEnable сопоставляет свой список тегов с активным набором и переключает показ.

Отдельного шага загрузки нет и быть не должно: чтение синхронное, ждать нечего, подписываться не на что. В отличие от систем с внешней проверкой, здесь не существует промежуточного состояния «ещё не знаю».

Режимы сопоставления

Пустой список тегов на компоненте — ошибка конфигурации: Error и выключение. Трактовать незаполненную настройку как выполненное условие нельзя — забытая разметка показывала бы контент во всех изданиях.

Что значит «белый список»

Бандл перечисляет включённое, но контент без тегов виден всегда. Пакет управляет только тем, что промаркировано: большая часть игры общая для всех изданий, и обязательная разметка стоила бы дороже цены ошибки. Следствие: забытый тег означает, что объект уедет во все издания. Ревизия перед сборкой — задача окна Content Tags.

---

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

1. Ассет ContentSettings лежит в Resources. Без него активный набор пуст: всё размеченное выключено. Несколько ассетов — берётся первый, остальные игнорируются с Error.
2. Сломанная конфигурация гасит размеченное, а не открывает его. Пустое или неизвестное активное издание даёт пустой набор. Это сделано намеренно: поломка видна сразу, лишнее не уезжает в сборку издания.
3. Два управляющих компонента на одном UIStateSwitcher недопустимы. Победит отработавший последним. Проверкой это не закрывается — следите при вёрстке.
4. Собственный объект не кладётся в цели ContentTagObjectHandler. Выключив себя, компонент не получит OnEnable и обратно не включится. Такая цель пропускается с Error.
5. Пакет включается define-символом. Без тоггла USING_VORTEX_CONTENT_TAGS в SdkSettings сборка не компилируется.

---

Контракт

Вход

• ContentSettings в Resources: объявленные теги, бандлы, ключ активного издания.

Выход

• ContentBus.IsActive(tag) — включён ли тег;
• ContentBus.Matches(tags, mode) — результат сопоставления списка;
• ContentBus.ActiveBundle, ContentBus.ActiveTags — состав текущей конфигурации.

Гарантии

• API синхронное: первый вызов отвечает немедленно, промежуточных состояний нет.
• Активный набор строится один раз и за сеанс не меняется.
• Необъявленный тег считается выключенным.
• Сломанная конфигурация даёт пустой набор, а не произвольный.

Ограничения

---

API

ContentBus (static)

ContentSettings (SO, Create → Vortex → Settings → Content Tags)

ContentTagGateHandler

ContentTagObjectHandler

---

Граничные случаи

---

Файловая структура

ContentTagsSystem/
├── Bus/             # ContentBus — публичная точка входа
├── Model/           # ContentTag, ContentBundle, TagMatchMode, ContentTagsCatalog
├── Settings/        # ContentSettings
├── Handlers/        # ContentTagGateHandler, ContentTagObjectHandler
├── DefineSettings/  # тоггл пакета в SdkSettings
└── Editor/          # ContentTagsIndex, ContentTagsWindow