💡 Гайди [Гайд] Створення першого серверного ресурсу на Lua в MTA:SA від А до Я

Admin 🏆

Admin

Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉 🥈 🥇 💎 👑 🛠️ 🏎️ 🗺️ ❤️ ⚡ 🏆
Рейтинг
50730 pts
СТВОРЕННЯ ПЕРШОГО РЕСУРСУ НА LUA В MTA:SA
Покроковий мануал для початківців від команди URBAN​



Вітаємо, майбутні девелопери! У цьому уроці ми розглянемо базову структуру ресурсу Multi Theft Auto та напишемо перший робочий скрипт з клієнтською та серверною частинами.

КРОК 1. СТРУКТУРА ПАПКИ РЕСУРСУ
Створіть папку з назвою ресурсу, наприклад urban_first_script у вашій директорії server/mods/deathmatch/resources/.
Усередині папки мають бути три файли:
  • meta.xml — головний маніфест ресурсу.
  • server.lua — серверна логіка.
  • client.lua — клієнтський інтерфейс та рендеринг.

КРОК 2. НАПОВНЕННЯ META.XML
Відкрийте meta.xml у будь-якому редакторі коду (VS Code, Sublime) та вставте наступний код:

XML:
<meta>
    <info author="URBAN Team" name="First Script" version="1.0.0" type="script" />
    
    <!-- Серверний скрипт -->
    <script src="server.lua" type="server" />
    
    <!-- Клієнтський скрипт -->
    <script src="client.lua" type="client" cache="false" />
</meta>

КРОК 3. СЕРВЕРНИЙ СКРИПТ (SERVER.LUA)
Напишемо команду /welcome, яка вітатиме гравця у чаті красивим помаранчевим кольором і відновлюватиме здоров'я:

Код:
-- Обробник команди /welcome
function onPlayerWelcomeCommand(playerSource, commandName)
    if not isElement(playerSource) or getElementType(playerSource) ~= "player" then
        return
    end

    local playerName = getPlayerName(playerSource)
    
    -- Виводимо красиве повідомлення в чат у кольорах URBAN
    outputChatBox("[URBAN] Ласкаво просимо на сервер, #ff7a00" .. playerName .. "#ffffff!", playerSource, 255, 255, 255, true)
    outputChatBox("[URBAN] Ваше здоров'я відновлено до 100%. Приємної гри!", playerSource, 150, 255, 150, true)
    
    -- Відновлення здоров'я
    setElementHealth(playerSource, 100)
    
    -- Тригеримо клієнтську подію для показу візуального ефекту
    triggerClientEvent(playerSource, "urban:showWelcomeNotification", playerSource, playerName)
end
addCommandHandler("welcome", onPlayerWelcomeCommand, false, false)

КРОК 4. КЛІЄНТСЬКИЙ СКРИПТ (CLIENT.LUA)
Створимо акуратне графічне повідомлення по центру екрану при виклику команди:

Код:
local screenW, screenH = guiGetScreenSize()
local isShowing = false
local showTimer = nil
local welcomeText = ""

function renderWelcomeBanner()
    if not isShowing then return end
    
    -- Малюємо стильний напівпрозорий блок у стилі URBAN
    local boxW, boxH = 420, 80
    local boxX = (screenW - boxW) / 2
    local boxY = screenH * 0.15
    
    -- Фон картки
    dxDrawRectangle(boxX, boxY, boxW, boxH, tocolor(20, 21, 27, 240), false)
    -- Помаранчева нижня смужка
    dxDrawRectangle(boxX, boxY + boxH - 4, boxW, 4, tocolor(255, 122, 0, 255), false)
    
    -- Текст
    dxDrawText("URBAN MTA NOTIFICATION", boxX, boxY + 12, boxX + boxW, boxY + 30, tocolor(255, 122, 0, 255), 1.2, "default-bold", "center", "top")
    dxDrawText(welcomeText, boxX, boxY + 38, boxX + boxW, boxY + 65, tocolor(240, 240, 240, 255), 1.0, "default", "center", "top")
end
addEventHandler("onClientRender", root, renderWelcomeBanner)

addEvent("urban:showWelcomeNotification", true)
addEventHandler("urban:showWelcomeNotification", root, function(name)
    welcomeText = "Вітаємо у грі, " .. name .. "!"
    isShowing = true
    
    if isTimer(showTimer) then killTimer(showTimer) end
    showTimer = setTimer(function()
        isShowing = false
    end, 5000, 1)
end)

КРОК 5. ЗАПУСК ТА ТЕСТ
В консолі сервера або F8 напишіть:
refresh
start urban_first_script
Увійдіть у гру та введіть /welcome!


Якщо у вас виникли запитання по синтаксису або роботі функцій — сміливо пишіть у розділ «Допомога по Lua скриптингу»!
 
Зверху
\n\n