Method OnBegin

Source/Engine/Level/Level.cpp:1119–1187

}

SceneResult SceneLoader::OnBegin(Args& args)
{
    PROFILE_CPU_NAMED("Begin");
    LOG(Info, "Loading scene...");
    _lastSceneLoadTime = DateTime::Now();
    StartFrame = Engine::UpdateCount;

    // Validate arguments
    if (!args.Data.IsArray())
    {
        LOG(Error, "Invalid Data member.");
        CallSceneEvent(SceneEventType::OnSceneLoadError, nullptr, Guid::Empty);
        return SceneResult::Failed;
    }

    // Peek scene node value (it's the first actor serialized)
    SceneId = JsonTools::GetGuid(args.Data[0], "ID");
    if (!SceneId.IsValid())
    {
        LOG(Error, "Invalid scene id.");
        CallSceneEvent(SceneEventType::OnSceneLoadError, nullptr, SceneId);
        return SceneResult::Failed;
    }

    // Peek meta
    if (args.EngineBuild < 6000)
    {
        LOG(Error, "Invalid serialized engine build.");
        CallSceneEvent(SceneEventType::OnSceneLoadError, nullptr, SceneId);
        return SceneResult::Failed;
    }
    Modifier->EngineBuild = args.EngineBuild;

    // Scripting backend should be loaded for the current project before loading scene
    if (!Scripting::HasGameModulesLoaded())
    {
        LOG(Error, "Cannot load scene without game modules loaded.");
#if USE_EDITOR
        if (!CommandLine::Options.Headless.IsTrue())
        {
            if (ScriptsBuilder::LastCompilationFailed())
                MessageBox::Show(TEXT("Script compilation failed.\n\nCannot load scene without game script modules. Please fix any compilation issues.\n\nSee Output Log or logs for more info."), TEXT("Failed to compile scripts"), MessageBoxButtons::OK, MessageBoxIcon::Error);
            else
                MessageBox::Show(TEXT("Failed to load scripts.\n\nCannot load scene without game script modules.\n\nSee logs for more info."), TEXT("Missing game modules"), MessageBoxButtons::OK, MessageBoxIcon::Error);
        }
#endif
        CallSceneEvent(SceneEventType::OnSceneLoadError, nullptr, SceneId);
        return SceneResult::Failed;
    }

    // Skip is that scene is already loaded
    if (Level::FindScene(SceneId) != nullptr)
    {
        LOG(Info, "Scene {0} is already loaded.", SceneId);
        CallSceneEvent(SceneEventType::OnSceneLoadError, nullptr, SceneId);
        return SceneResult::Failed;
    }