💡 Гайди Декомпіляція клієнтських скриптів MTA:SA (Luac 5.1): розпаковка захищених худів, спідометрів та інтерфейсів

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

Учасник
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🛠️ ❤️
Рейтинг
900 pts
💻 Практичний посібник: Декомпіляція та відновлення коду клієнтських Lua-скриптів у MTA

Багато розробників-початківців стикаються з тим, що завантаживши клієнтські ресурси або HUD з якогось сервера, вони відкривають файл .lua чи .luac у Notepad++, а там суцільні ієрогліфи та бінарний байткод.
У цьому гайді я поясню, як працює віртуальна машина Lua 5.1 у Multi Theft Auto, як зняти компіляцію та відновити читабельний чистий код.


1. Чим компілюються ресурси в MTA:SA

Офіційний серверний компілятор MTA перетворює текст Lua у бінарний байткод стандарту Lua 5.1.4.
Файл байткоду завжди починається з магічного 4-байтного заголовка:
Код:
1B 4C 75 61 (.Lua у шістнадцятковому виді)

Деякі автори змінюють ці байти на сміття або додають кастомний заголовок MTA!1 чи порожні байти, щоб збити з пантелику стандартні декомпілятори.


2. Інструменти для декомпіляції

  • unluac.jar — найпотужніший декомпілятор для Lua 5.1 на Java. Найкраще відновлює складні вкладені умови if / elseif / else та математичні цикли.
  • luadec 5.1 — швидка C++ консольна утиліта для масової розпаковки директорій.
  • HxD Hex Editor — для очищення пошкоджених сигнатур.

Команда для декомпіляції одного файлу:
Bash:
java -jar unluac.jar speedo_client.luac > speedo_decompiled.lua


3. Як боротися з обфускацією змінних

При декомпіляції ви побачите, що назви локальних змінних втрачені (це специфіка компіляції байткоду — вони перетворюються на номери регістрів):
Код:
-- Було отримано після декомпіляції:
local L0_1, L1_2, L2_3
L0_1 = getPedOccupiedVehicle(localPlayer)
if L0_1 then
    L1_2 = getElementSpeed(L0_1, "km/h")
    dxDrawText(tostring(math.floor(L1_2)), 500, 800, 600, 850, tocolor(255, 255, 255))
end

Швидке відновлення читабельності коду:
  1. Використовуйте VS Code або Sublime Text з пошуком та заміною Ctrl + H.
  2. Змінна L0_1 отримує результат getPedOccupiedVehicle — перейменовуємо її на veh.
  3. Змінна L1_2 рахує швидкість — перейменовуємо на speed.
  4. Код стає на 100% чистим, структурованим та готовим до впровадження у ваш власний модпак чи ресурс!

Пам'ятайте: не копіюйте код сліпо. Аналізуйте логіку, покращуйте оптимізацію рендеру через addEventHandler("onClientRender", root, ...), замінюйте статичні координати на адаптивні під будь-які роздільні здатності моніторів за допомогою guiGetScreenSize().
 

Кирило

Учасник
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈 🛠️
Рейтинг
300 pts
Дуже круто розписано! Я якраз розбирав так спідометр із цифровою панеллю передач: там автор засунув обчислення обертів RPM у 40 рядків заплутаних умов. Після декомпіляції через unluac вдалося прибрати зайві циклічні перевірки, і FPS на клієнті виріс з 45 до стабільних 60!
 

Богдан Буря

Новий учасник
🔰 НОВАЧОК
🌟 Знавець
🥉 🛠️
Рейтинг
445 pts
Максе, а якщо скрипт був упакований через LuaJIT (байткод v2)? unluac його бере?
 

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

Учасник
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🛠️ ❤️
Рейтинг
900 pts
Богдане, для LuaJIT байткоду стандартний unluac видасть помилку невідомого заголовка. Для таких випадків використовується утиліта ljd (LuaJIT Decompiler на Python) або Ghidra з плагіном luajit-loader. Але 95% серверів MTA працюють саме на класичному Lua 5.1!
 
Admin 🏆

Admin

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

Цікавий реліз! Нагадуємо автору та користувачам, що всі ресурси у розділі зливів проходять обов'язкову перевірку на відсутність бекдорів, прихованого коду та шкідливих функцій.

Запитання до автора:
Підкажіть, чи це оригінальний вихідний код ресурсу, і під яку версію MTA він оптимізований? Чи потрібні додаткові SQL-дампи для запуску?
 
Зверху
\n\n