💡 Гайди Асинхронний Lua в MTA:SA: використання Coroutines для важких обчислень без просадки TPS

Максим Нірванський

Учасник
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🛠️ ❤️
Рейтинг
900 pts
⚡ Coroutines у Lua: як позбутися зависання сервера при масовій обробці даних

Типова проблема серверів MTA — коли при збереженні бази даних, обробці масивів з 10 000+ елементів або генерації мапи сервер зависає на 0.5–2 секунди, а гравці ловлять тайм-аут («Network Trouble»). У цьому гайді ми реалізуємо повноцінний асинхронний планувальник на корутинах (Lua Coroutines).


1. Як працює корутина

Корутина дозволяє зупинити виконання важкої функції в будь-якому місці за допомогою coroutine.yield() і повернути керування серверу, а в наступному тіку відновити роботу через coroutine.resume().

Код:
-- Менеджер розподілу навантаження (Async Task Dispatcher)
local asyncTasks = {}

function addAsyncTask(func, onComplete)
    local co = coroutine.create(func)
    table.insert(asyncTasks, { thread = co, callback = onComplete })
end

-- Обробка завдань у кожному серверному тіку
setTimer(function()
    local startTime = getTickCount()
    for i = #asyncTasks, 1, -1 do
        local task = asyncTasks[i]
        if coroutine.status(task.thread) == "suspended" then
            local ok, err = coroutine.resume(task.thread)
            if not ok then
                outputDebugString("[Async Error] " .. tostring(err), 1)
                table.remove(asyncTasks, i)
            end
        elseif coroutine.status(task.thread) == "dead" then
            if task.callback then task.callback() end
            table.remove(asyncTasks, i)
        end
        
        -- Якщо витратили більше 15 мс — віддаємо час рушію
        if getTickCount() - startTime > 15 then
            break
        end
    end
end, 50, 0)


2. Практичний приклад: обробка 100 000 гравців

Код:
addCommandHandler("reindex", function()
    addAsyncTask(function()
        outputServerLog("[Reindex] Початок індексації...")
        for i = 1, 100000 do
            -- Важка математична операція
            local result = math.sqrt(i) * math.sin(i)
            
            -- Кожні 1000 ітерацій робимо паузу
            if i % 1000 == 0 then
                coroutine.yield()
            end
        end
    end, function()
        outputServerLog("[Reindex] Успішно завершено без просадки TPS!")
    end)
end)
 

Кирило

Учасник
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈 🛠️
Рейтинг
300 pts
Це просто знахідка для систем парсингу логів та бекапу транспорту. До цього у нас кожні півгодини був секундний мікрофріз, тепер графік TPS рівний як струна — рівно 60 FPS!
 
Admin 🏆

Admin

Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 💎 👑 🛠️ 🏎️ 🗺️ ❤️ ⚡ 🏆
Рейтинг
50730 pts
Вітаю, Кирило! Дякую за активність на порталі URBAN MTA.

Адміністрація уважно ознайомилася з вашим запитанням. Для швидкої діагностики подібних проблем рекомендуємо:
1. Запустити /debugscript 3 безпосередньо у грі під правами розробника.
2. Вивести аргументи через iprint() перед місцем виникнення помилки.
3. Перевірити наявність та валідність елементів функцією isElement().

Уточнююче запитання до вас:
Підкажіть, на якій саме стороні виконується функція — Client чи Server? Також, якщо в консолі виводиться конкретна помилка або номер рядка (наприклад, attempt to perform arithmetic on a nil value), напишіть його тут, щоб ми могли підказати точне рішення!
 

Bogdan_Tuning

🔧 3D Modeler & Vehicle Physics
⚡ DOWNLOADER
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🥇 🛠️ 🏎️ ❤️ ⚡
Рейтинг
840 pts
Ще одна корисна штука для дебагу — `dxGetStatus()`, показує скільки пам'яті виділено під відеокарту та поточну кількість текстур.
 
Admin 🏆

Admin

Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 💎 👑 🛠️ 🏎️ 🗺️ ❤️ ⚡ 🏆
Рейтинг
50730 pts
Вітаю, Bogdan_Tuning! Дякую за активність на порталі URBAN MTA.

Адміністрація уважно ознайомилася з вашим запитанням. Для швидкої діагностики подібних проблем рекомендуємо:
1. Запустити /debugscript 3 безпосередньо у грі під правами розробника.
2. Вивести аргументи через iprint() перед місцем виникнення помилки.
3. Перевірити наявність та валідність елементів функцією isElement().

Уточнююче запитання до вас:
Підкажіть, на якій саме стороні виконується функція — Client чи Server? Також, якщо в консолі виводиться конкретна помилка або номер рядка (наприклад, attempt to perform arithmetic on a nil value), напишіть його тут, щоб ми могли підказати точне рішення!
 

Lviv_Customs

🛒 Custom Bodykits & Livery Studio
Релізер
⚡ DOWNLOADER
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈 🛠️ 🏎️ ⚡
Рейтинг
450 pts
Гарний приклад, до речі ще варто додати `assert` або валідацію типів аргументів через `type(var) == 'number'`, щоб у лог `debugscript 3` не сипалися попередження.
 
Admin 🏆

Admin

Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 💎 👑 🛠️ 🏎️ 🗺️ ❤️ ⚡ 🏆
Рейтинг
50730 pts
Вітаю, Lviv_Customs! Дякую за активність на порталі URBAN MTA.

Адміністрація уважно ознайомилася з вашим запитанням. Для швидкої діагностики подібних проблем рекомендуємо:
1. Запустити /debugscript 3 безпосередньо у грі під правами розробника.
2. Вивести аргументи через iprint() перед місцем виникнення помилки.
3. Перевірити наявність та валідність елементів функцією isElement().

Уточнююче запитання до вас:
Підкажіть, на якій саме стороні виконується функція — Client чи Server? Також, якщо в консолі виводиться конкретна помилка або номер рядка (наприклад, attempt to perform arithmetic on a nil value), напишіть його тут, щоб ми могли підказати точне рішення!
 
Зверху
\n\n