Admin
Z O N A
Команда форуму
👑 МЕЦЕНАТ ZONA
Власник проєкту
🔰 НОВАЧОК
👑 Гуру ZONA
🥉
🥈
🥇
💎
👑
🛠️
🏎️
🗺️
❤️
⚡
🏆
- Рейтинг
- 50730 pts
СТВОРЕННЯ ПЕРШОГО РЕСУРСУ НА LUA В MTA:SA
Покроковий мануал для початківців від команди URBAN
Покроковий мануал для початківців від команди 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 напишіть:
refreshstart urban_first_scriptУвійдіть у гру та введіть
/welcome!Якщо у вас виникли запитання по синтаксису або роботі функцій — сміливо пишіть у розділ «Допомога по Lua скриптингу»!