Какая mental model Unreal Engine важна для диагностики: lifecycle, graph, runtime, targets, protocol, threads или resources?

Почему именно Threads — ключевая mental model

Unreal Engine работает в многопоточной архитектуре, где три основных потока взаимодействуют через командные очереди и fence-механизмы. Непонимание этой модели ведёт к race condition, deadlock и необъяснимым frame hitch даже при корректной логике на уровне Blueprint или C++.

Три главных потока

• Game Thread (GT): выполняет UWorld::Tick, Blueprint, C++ GameplayAbilities, AI. Все обращения к UObject должны происходить здесь.
• Render Thread (RT): строит FRHICommandList, управляет SceneProxy, выполняет culling. Не имеет доступа к UObject.
• RHI Thread: переводит RHI-команды в нативные API вызовы (Vulkan/DX12/Metal). На некоторых платформах отдельный поток, на других — inline в RT.

Диаграмма взаимодействия

Frame N:
  Game Thread:   Tick() -> EnqueueRenderCommand() -> [CommandQueue] ->
  Render Thread:                                                      BuildScene() -> [RHICommandList] ->
  RHI Thread:                                                                                           Submit() -> GPU

# Синхронизация: FlushRenderingCommands() блокирует GT до завершения RT
# Диагностика deadlock: ищите вызов FlushRenderingCommands() внутри GT с лока

Как threads объясняют реальные проблемы

• Crash "not on game thread": доступ к UObject* из Background Task или Timer без AsyncTask(ENamedThreads::GameThread, ...).
• Frame hitch: GT ждёт RT через FlushRenderingCommands() — например, при смене материала в runtime.
• Deadlock при shutdown: Worker thread держит лок, GT ждёт его завершения, RT ждёт GT — классический circular dependency.

Практический код диагностики

// Проверка что мы на правильном потоке
void UMyComponent::SafeUObjectAccess()
{
    // Crash если вызвать не из game thread
    check(IsInGameThread());

    // Правильная передача данных в render thread
    FMyData DataCopy = MyData; // копируем, не передаём указатель
    ENQUEUE_RENDER_COMMAND(UpdateMyBuffer)(
        [DataCopy](FRHICommandListImmediate& RHICmdList)
        {
            // Здесь нет доступа к UObject!
            UpdateBufferWithData(RHICmdList, DataCopy);
        }
    );
}

// Вызов из background thread -> game thread
void UMySubsystem::OnAsyncCallbackFromWorker(FResult Result)
{
    AsyncTask(ENamedThreads::GameThread, [this, Result]()
    {
        check(IsInGameThread());
        ProcessResult(Result); // теперь безопасно
    });
}

Другие полезные mental models (вторичные)

• Lifecycle: важна для понимания когда BeginPlay/EndPlay/Destroyed вызываются относительно репликации.
• Graph (Blueprint graph): важна для отладки execution flow в BP, но вторична относительно threads.
• Resources: важна для понимания VRAM/RAM бюджетов, но проблемы с ресурсами обычно диагностируются через Unreal Insights, а не mental model.

Подводные камни

• Таймеры (FTimerManager) всегда выполняются на GT — но async tasks из TaskGraph могут быть на любом потоке.
• TWeakObjectPtr не thread-safe: разыменование вне GT может вернуть dangling pointer после GC.
• Unreal Insights показывает GT/RT bottleneck, но не всегда корректно атрибутирует RHI-time на мобильных платформах.
• ENQUEUE_RENDER_COMMAND захватывает лямбду по значению — случайный захват UObject* по указателю ведёт к use-after-free после GC.
• На консолях (PS5/Xbox) добавляется четвёртый поток — Audio Thread; его синхронизация с GT отдельная проблема.
• В Shipping-билде многие thread-safety проверки (check(IsInGameThread())) отключены — баги проявляются только в Debug/Development конфигурации.
• FlushRenderingCommands() в Loading Screen коде — распространённая причина фриза на загрузке уровня.

• Сразу обвинять Unreal Engine, не проверив соседние слои системы
• Чинить симптом без минимального воспроизведения и evidence
• Не учитывать версии, конфигурацию, окружение и recent changes

• Умеет локализовать проблему вокруг Unreal Engine
• Двигается от симптома к гипотезам и проверкам
• Отличает баг инструмента от ошибки использования или окружения