🖥️ [Мануал] Архітектура сучасного CEF-інтерфейсу в MTA:SA (HTML5/JS + Lua Bridge): Як влаштовані HUD та інвентарі в UKRAINE GTA

Admin 🏆

Admin

Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 💎 👑 🛠️ 🏎️ 🗺️ ❤️ ⚡ 🏆
Рейтинг
50730 pts
🖥️ Повний гайд: Створення швидких та адаптивних CEF-інтерфейсів для MTA:SA (HTML5 + Lua Bridge)

Більшість сучасних проектів, включаючи останні версії UKRAINE GTA, практично повністю відмовилися від громіздких стандартних GUI та малювання десятків dxDrawRectangle у нескінченних циклах onClientRender. Замість цього використовується CEF (Chromium Embedded Framework) — браузерний рушій, вбудований безпосередньо в MTA.

Це дозволяє використовувати сучасні технології веб-розробки (HTML5, CSS Flexbox/Grid, Vue, React, TailwindCSS), анімації transform та плавні градієнти, при цьому рендеринг повністю бере на себе відеокарта.​



1. Створення екземпляра CEF браузера в клієнтському Lua

Для того, щоб інтерфейс не розмивався на моніторах 2K/4K та не просідав FPS на слабких ноутбуках, важливо динамічно вираховувати роздільну здатність екрана гравця:​

Код:
-- client/cef_manager.lua
local screenW, screenH = guiGetScreenSize()
local myBrowser = nil
local isBrowserReady = false

addEventHandler("onClientResourceStart", resourceRoot, function()
    -- Створюємо браузер на весь екран з підтримкою прозорості (true)
    myBrowser = createBrowser(screenW, screenH, true, false)
    
    if myBrowser then
        addEventHandler("onClientBrowserCreated", myBrowser, function()
            -- Завантажуємо локальний HTML-файл
            loadBrowserURL(myBrowser, "http://mta/my_resource/html/index.html")
        end)
        
        addEventHandler("onClientBrowserDocumentReady", myBrowser, function()
            isBrowserReady = true
            outputChatBox("[ZONA MTA] Інтерфейс успішно завантажено!", 0, 255, 100)
        end)
    end
end)

-- Рендеринг текстури браузера на екрані
addEventHandler("onClientRender", root, function()
    if myBrowser and isBrowserReady then
        dxDrawImage(0, 0, screenW, screenH, myBrowser, 0, 0, 0, tocolor(255, 255, 255, 255), true)
    end
end)



2. Двосторонній міст даних (Lua <-> JavaScript Bridge)

Найголовніше завдання у розробці систем інвентарю, автосалонів чи спідометрів — миттєва передача даних без лагів.​

А. Передача даних з Lua в JavaScript (Оновлення балансу чи швидкості):
Код:
function updateSpeedometer(speed, fuel, engineState)
    if not isBrowserReady then return end
    
    local jsCode = string.format("window.updateVehicleInfo(%d, %d, %s);", 
        math.floor(speed), 
        math.floor(fuel), 
        tostring(engineState)
    )
    executeBrowserJavascript(myBrowser, jsCode)
end

Б. Виклик Lua функцій зсередини JavaScript (Клік на кнопку "Купити" або "Використати предмет"):
JavaScript:
// html/app.js
function onBuyItemClick(itemId, amount) {
    if (typeof mta !== 'undefined') {
        mta.triggerEvent('onClientBuyItemFromCEF', itemId, amount);
    }
}

В. Прийом події у Lua:
Код:
addEvent("onClientBuyItemFromCEF", true)
addEventHandler("onClientBuyItemFromCEF", root, function(itemId, amount)
    triggerServerEvent("onServerProcessPurchase", resourceRoot, localPlayer, itemId, amount)
end)



3. Фікс найпоширеніших проблем CEF у збірках
  • Блокування клавіатури (Неможливо рухатися після закриття вікна): Обов'язково використовуйте guiSetInputMode("no_binds_when_editing") при відкритті інпутів та guiSetInputMode("allow_binds") при закритті.
  • Витік пам'яті (Memory Leak): Якщо ховаєте інтерфейс, не перестворюйте createBrowser щоразу! Просто сховайте рендер або додайте клас .hidden у CSS.
  • Білий екран (White screen): Перевірте шлях у meta.xml — всі файли html, css, js, зображення та шрифти обов'язково повинні мати прапорець <file src="html/..." />.

💡 Маєте запитання по архітектурі CEF? Задавайте питання нижче в темі, розберемо будь-яку проблему чи фрагмент коду!
 

Roman_Coder

🎨 UI/DX Designer & Lua Specialist
⚡ DOWNLOADER
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈 🛠️ ⚡
Рейтинг
475 pts
Колеги, підкажіть щодо оптимізації передачі даних через CEF-міст: чи є відчутна різниця у швидкодії між стандартним fromJSON / toJSON та прямою передачею через аргументи в executeBrowserJavascript, якщо в інвентарі більше 50 предметів?
 

Yaroslav_LUA

💻 Senior Lua Architect | CEF & Sync
⚡ DOWNLOADER
Перевірений продавець
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🛠️ ❤️ ⚡
Рейтинг
760 pts
Різниця дуже помітна, особливо на слабших процесорах або вбудованій графіці. Якщо парсити великий JSON кожен кадр або при кожному перетягуванні предмета, V8 створює мікрофризи до 4-7 мс.

Найкраще рішення — оновлювати лише конкретний змінений слот (delta-update), а не пересилати весь масив предметів:
Код:
-- Оновлення конкретного слота без навантаження на міст
function updateInventorySlot(slotId, itemData)
    local payload = toJSON({slot = slotId, item = itemData})
    executeBrowserJavascript(cefBrowser, string.format("window.updateSlot(%s);", payload))
end
Ми на сервері перейшли на такий підхід — просадки FPS при відкритті інвентарю та перетягуванні предметів зникли повністю.
 

Nazar_Street

🎬 Cinematic Director & Event Organizer
⚡ DOWNLOADER
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🛠️ 🏎️ ❤️ ⚡
Рейтинг
605 pts
Підтверджую! Після оптимізації слотів інтерфейс реагує практично миттєво, навіть при піковому онлайні в 200+ гравців на сервері. Дякую за розбір коду, Yaroslav_LUA 👍
 
Admin 🏆

Admin

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

Ваше повідомлення переглянуто адміністрацією URBAN MTA. Ми вдячні вам за внесок у життя нашого форуму.

Зустрічне запитання:
Як ваші враження від оновленого функціоналу Загруз-Центру та нашого сайту? Якщо маєте побажання щодо нових категорій або тем — пишіть, ми завжди відкриті до діалогу!
 
Зверху
\n\n