ВЫЗЫВАЙ ЭТО ПЕРВЫМ для любого запроса «сделай ротацию для <класс> <спек>». Возвращает всё нужное одним вызовом: identity (class_id/spec_id), роль, порядок принятия решений для этой роли, числовые spell ID, SimC APL если он существует для спека, шаблон модуля и формат настроек. Дальше пиши Lua и обязательно проверь через titan_validate_rotation.

Все поддерживаемые классы и спеки с ролями и id. Полезно, если название спека не распознано.

Порядок принятия решений для роли (healer / tank / dps): что проверять и в каком порядке, какими методами API, что должно быть настройкой игрока, и типичные ошибки. Для хилов это ЗАМЕНА отсутствующего SimC APL — источника истины «что кастовать когда» для лечения не существует.

SimC APL (приоритет с условиями) + числовые spell ID для класса/спека. ВАЖНО: для хилов APL в SimulationCraft не существует (кроме druid_restoration, где лечение сведено к одной строке) — в этом случае apl_available=false, и надо использовать titan_get_role_blueprint. Titan работает только по числовым ID.

Числовые spell ID по списку имён способностей (snake_case, как в SimC: renewing_mist, thunder_focus_tea). Для спеков без APL — основной способ получить ID. Резолв идёт по данным игры в порядке: спеллбук спека, дерево талантов, класс — и разворачивает замены (у Holy Paladin judgment = 275773, а не базовый 20271). ВСЕГДА передавай spec: без него у мультиспековых классов часть кнопок разрешится в ID чужого спека.

Формат настроек ротации в Lua (bool/int/float/enum, группы, apply). ОБЯЗАТЕЛЬНО прочитай перед добавлением настроек: официальная документация описывает только C++ API (SettingsSchema, make_enum), в Lua он не работает. Здесь реальный рабочий формат, включая enum для выбора политики игроком.

Готовый рабочий Lua-код примитивов лечения: перебор союзников, эффективное HP с учётом heal absorb, выбор цели, поиск танка, резолвер enum-политики таргетинга (не использовать / себя / танка / себя и танка / на всех), диспел. Вставляй как есть и надстраивай спек-специфику — не переписывай заново.

Все методы Titan API с сигнатурами. Фильтр по подстроке. Проверяй здесь имена перед использованием — выдуманные методы валидатор отклонит.

Точная сигнатура одного метода API.

Список тем документации Titan SDK.

Полная документация по теме (aura, spell, player, group…).

Полнотекстовый поиск по всей документации SDK.

Канонический шаблон модуля ротации: структура, обязательные callback'и.

Полная рабочая ротация Holy Paladin (1205 строк) — эталон паттернов: настройки, enum-политики, очередь спендеров, диспел. Большой файл: запрашивай section, чтобы получить часть.

ВСЕГДА вызывай перед выдачей финального кода. Проверяет: синтаксис Lua, существование всех api./action. вызовов, и полноту по роли (хил без выборки цели лечения или танк без mitigation — ошибка, а не предупреждение). Передавай role, иначе ролевые проверки не выполнятся.