Створення власного C++ модуля для сервера MTA:SA за допомогою MTA Server SDK (ml_core)

Андрій Хімік

Учасник
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 🛠️ ❤️
Рейтинг
1220 pts
⚙️ Розробка високоефективних C++ модулів для сервера Multi Theft Auto

Серверний рушій MTA:SA підтримує підключення динамічних бібліотек (.dll на Windows та .so на Linux) через офіційний MTA Module SDK. Модулі дозволяють виконувати критичні за швидкістю завдання нативним машинним кодом C++, підключати сторонні драйвери (Redis, SQLite, Cryptography, OpenCV) та реєструвати власні глобальні функції в оточенні Lua.


1. Структура інтерфейсу ILuaModuleManager

Кожен модуль зобов'язаний реалізувати три експортовані функції з угодою виклику extern "C":
C++:
#include "ILuaModuleManager.h"
#include <string>

ILuaModuleManager* pModuleManager = nullptr;

// 1. Ініціалізація модуля при завантаженні сервером
extern "C" bool InitModule(ILuaModuleManager* pManager, char* szModuleName, char* szAuthor, float* fVersion)
{
    pModuleManager = pManager;
    strncpy(szModuleName, "UrbanCoreModule", 32);
    strncpy(szAuthor, "Andriy Khimik / URBAN MTA", 32);
    *fVersion = 1.0f;
    return true;
}

// 2. Викликається кожен серверний тік (DoPulse)
extern "C" void DoPulse()
{
    // Обробка черги повідомлень або асинхронних відповідей
}

// 3. Завершення роботи модуля
extern "C" bool ShutdownModule()
{
    return true;
}


2. Експорт C++ функції в Lua

Для додавання нової функції в Lua використовується стандартний Lua C API:
C++:
// C++ функція швидкого хешування рядка SHA-256
int lua_calculateFastHash(lua_State* luaVM)
{
    if (!lua_isstring(luaVM, 1)) {
        lua_pushnil(luaVM);
        return 1;
    }
    std::string input = lua_tostring(luaVM, 1);
    std::string hashResult = ComputeNativeSHA256(input);
    lua_pushstring(luaVM, hashResult.c_str());
    return 1; // повертаємо 1 значення на стек
}

extern "C" void RegisterScriptingFunctions(lua_State* luaVM)
{
    pModuleManager->RegisterFunction(luaVM, "calculateFastHash", lua_calculateFastHash);
}


3. Підключення в mtaserver.conf

Скомпільований файл розміщуємо в папці server/mods/deathmatch/modules/ і прописуємо:
XML:
<module src="UrbanCoreModule.so" />

Тепер у будь-якому ресурсі функція calculateFastHash("secret") доступна безпосередньо з Lua зі швидкістю нативного C++!
 

Тайлер Дерден

Учасник
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 ❤️
Рейтинг
795 pts
Шикарний мануал! Ми так для одного великого RP проекту винесли генерацію номерних знаків та прорахунок складних векторних формул траєкторій куль у C++ модуль. Серверний TPS зріс з 34 до стабільних 60!
 

Данік Хоффман

Учасник
🔰 НОВАЧОК
🔥 Майстер
🥉 🥈 🛠️
Рейтинг
750 pts
Андрію, а як краще організувати передачу результатів з фонового std::thread назад у Lua VM, щоб не зловити Segmentation Fault?
 

Андрій Хімік

Учасник
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 🛠️ ❤️
Рейтинг
1220 pts
Данік, найбезпечніший шлях — це потокобезпечна черга (std::queue з std::mutex). Фоновий потік кладе результат у чергу, а функція DoPulse(), яка гарантовано працює в головному потоці сервера, забирає дані та робить lua_pcall!
 
Admin 🏆

Admin

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

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

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

Roman_Coder

🎨 UI/DX Designer & Lua Specialist
⚡ DOWNLOADER
🔰 НОВАЧОК
🌟 Знавець
🥉 🥈 🛠️ ⚡
Рейтинг
475 pts
C++ модуль зібрався на Ubuntu 24.04 без єдиного ворнінгу через g++ 13. Тепер виклики сокетів літають миттєво!
 
Admin 🏆

Admin

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

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

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