Скриптинг в Roblox для начинающих: изучаем программирование на Luau

Скриптинг в Roblox — это то, что превращает статичную сцену в играбельную игру. Каждая дверь, которая открывается, каждая монета, которая собирается, каждая таблица лидеров, которая обновляется — всё это работает на Luau, языке программирования, встроенном в Roblox Studio. Если вы никогда не писали ни строчки кода, это руководство проведёт вас от нуля до написания реальных рабочих игровых скриптов.

Luau основан на Lua, но включает современные возможности, такие как проверка типов и оптимизация производительности, разработанные специально для Roblox. Это один из самых дружелюбных к новичкам языков программирования, и всё необходимое для написания и запуска кода уже есть внутри Studio — не нужны дополнительные редакторы кода или установки.

Настройка среды для скриптинга

Откройте Roblox Studio и создайте новый проект Baseplate. Убедитесь, что вы видите панель Explorer справа и панель Output внизу — откройте их через вкладку View, если они отсутствуют. Explorer — это место, где вы создаёте и организуете скрипты. Output — это место, где вы читаете сообщения print и ошибки — ваши основные инструменты отладки как начинающего разработчика.

Чтобы создать свой первый скрипт, щёлкните правой кнопкой мыши по ServerScriptService в Explorer, выберите Insert Object и выберите Script. Откроется новый скрипт с `print("Hello world!")`. Нажмите Play и проверьте панель Output — вы должны увидеть там напечатанное сообщение. Это ваш первый успешный скрипт.

Переменные: хранение информации

Переменные — это именованные контейнеры для хранения данных. В Luau переменную создают с помощью ключевого слова `local`: `local playerName = "Steve"` создаёт текстовую переменную, `local coins = 100` — числовую, а `local isAlive = true` — логическую. Всегда используйте `local` — это ограничивает область видимости переменной её блоком и предотвращает конфликты. Используйте описательные имена вроде `playerHealth` вместо `x`, чтобы код оставался читаемым.

Основные типы данных в Luau: `string` для текста, `number` для целых чисел и десятичных дробей, `boolean` для true/false, `nil` для отсутствия значения и `table` для коллекций. Вам не нужно объявлять типы — Luau определяет их автоматически. Объединяйте строки с помощью `..`, например `"Hello, " .. playerName`, конвертируйте типы с помощью `tostring()` и `tonumber()`, а для интерполяции используйте строки с обратными кавычками и фигурными скобками.

Функции: многоразовые блоки кода

Функция — это именованный блок кода, который выполняется при вызове. Структура: `local function giveCoins(player, amount)`, далее тело функции и `end`. Слова в скобках — это параметры, входные данные, которые получает функция. Вызывайте её так: `giveCoins(somePlayer, 50)`. Функции также могут возвращать значения: `local damage = calculateDamage(50, 20)` сохраняет возвращённый результат.

Привыкайте писать небольшие функции с самого начала. Каждая игровая система — бой, инвентарь, магазины, таблицы лидеров — организована в функции. Если блок кода делает что-то конкретное, оберните его в функцию и дайте ей понятное имя.

If/Else: принятие решений

Оператор `if` проверяет условие и выполняет код только если оно истинно. Синтаксис: `if coins >= 100 then`, далее ваш код, опционально `elseif` для дополнительных условий, `else` для запасного варианта и `end` для закрытия. Операторы сравнения: `==` для равенства, `~=` для неравенства, `>`, `<`, `>=` и `<=`. Комбинируйте условия с помощью `and`, `or` и `not` — например, `if isAlive and coins > 0 then` выполнится только когда оба условия истинны.

Распространённая ошибка новичков — использование `=` вместо `==` для сравнения. Одинарный `=` присваивает значение. Двойной `==` сравнивает два значения. Если ваш скрипт ведёт себя неожиданно, проверьте это в первую очередь.

Циклы: повторение действий

Цикл `for` выполняется определённое количество раз. Напишите `for i = 1, 10 do`, далее код и `end` — это выполнится десять раз. Добавьте шаг — `for i = 10, 1, -1 do` считает в обратном порядке. Цикл `while` выполняется пока условие истинно, но внутри нужен `task.wait()` для предотвращения зависания.

Обобщённый цикл `for` перебирает коллекции. Используйте `for index, value in ipairs(myTable) do` для упорядоченных списков или `for key, value in pairs(myDictionary) do` для словарей с ключами и значениями. Именно так обрабатываются инвентари, списки игроков и данные таблиц лидеров.

Таблицы: организация данных

Таблицы — самая универсальная структура данных в Luau: массивы, словари или и то и другое. Создайте массив с помощью `local fruits = {"Apple", "Banana", "Cherry"}` и обращайтесь к элементам через `fruits[1]` (в Luau нумерация начинается с 1, а не с 0). Создайте словарь с помощью `local playerData = {coins = 100, level = 5}` и обращайтесь к значениям через `playerData.coins`. Практически каждая игровая система хранит данные в таблицах.

События: реакция на игровой мир

События — это основа скриптинга в Roblox. Вместо постоянной проверки, произошло ли что-то, вы подключаете функцию к событию, и Roblox автоматически вызывает её при срабатывании. Самое распространённое событие для начинающих — `Touched`: подключите через `part.Touched:Connect(function(hit) end)`, где `hit` — столкнувшаяся деталь. Другие важные события: `PlayerAdded` (срабатывает при подключении игрока), `PlayerRemoving` (срабатывает при выходе игрока), `CharacterAdded` (срабатывает при появлении персонажа) и `Changed` (срабатывает при обновлении свойства). Сохраняйте соединения в переменных и вызывайте `connection:Disconnect()`, когда они больше не нужны, чтобы предотвратить утечки памяти.

Серверные скрипты и локальные скрипты

Серверные скрипты выполняются на сервере Roblox и управляют авторитетной игровой логикой — начислением валюты, сохранением данных, управлением раундами. Размещайте их в ServerScriptService. Локальные скрипты выполняются на устройстве каждого игрока для задач на стороне клиента — камера, ввод, интерфейс. Размещайте их в StarterPlayerScripts, StarterCharacterScripts или StarterGui.

Золотое правило: никогда не доверяйте клиенту. Вся логика, влияющая на геймплей, должна происходить на сервере. Клиент отправляет запросы через RemoteEvents в ReplicatedStorage — отправляйте с клиента через `remoteEvent:FireServer(data)`, слушайте на сервере через `remoteEvent.OnServerEvent:Connect(function(player, data) end)`. Сервер проверяет и выполняет.

Ваш первый игровой скрипт: смертельный блок

Вставьте Part в Workspace и покрасьте его в красный цвет. Щёлкните по нему правой кнопкой мыши в Explorer, вставьте Script и замените код по умолчанию. Напишите `local killPart = script.Parent` для ссылки на деталь. Определите `local function onTouched(hit)` и внутри напишите `local humanoid = hit.Parent:FindFirstChild("Humanoid")`, а затем `if humanoid then humanoid.Health = 0 end`. Подключите через `killPart.Touched:Connect(onTouched)`.

Нажмите Play и зайдите на красную деталь. Ваш персонаж погибнет и возродится. Это полноценный игровой скрипт в семь строк — каждый обби в Roblox использует именно этот паттерн для блоков-ловушек.

Ваш второй скрипт: система сбора монет

Создайте жёлтый цилиндрический Part и вставьте Script. Напишите `local coin = script.Parent` и `local debounce = false`. В функции `onTouched` проверьте `if debounce then return end`, установите `debounce = true`, убедитесь, что Humanoid существует, затем скройте монету через `coin.Transparency = 1` и `coin.CanCollide = false`. После `task.wait(5)` восстановите её и сбросьте debounce. Паттерн debounce используется почти в каждом скрипте с Touched — без него событие срабатывает десятки раз в секунду, пока детали пересекаются, вызывая повторные сборы. Освойте debounce как можно раньше.

Ваш третий скрипт: открывающаяся дверь

Создайте высокий тонкий Part для двери. Сохраните `local door = script.Parent` и `local originalPosition = door.Position`. При касании поднимите дверь через `door.Position = originalPosition + Vector3.new(0, 10, 0)`, подождите с помощью `task.wait(3)`, затем верните на место. Здесь вы познакомитесь с `Vector3` — типом данных для 3D-позиций, где y — это верх в Roblox. Для плавного движения используйте TweenService: получите его через `game:GetService("TweenService")`, создайте TweenInfo для длительности и вызовите `tweenService:Create(door, tweenInfo, {Position = targetPosition}):Play()`. Твины анимируют любое свойство во времени и делают взаимодействия более качественными.

Основные сервисы Roblox

Получайте любой сервис с помощью `game:GetService("ServiceName")` и сохраняйте ссылку в начале скрипта. Ознакомьтесь с руководством по инструментам для скриптинга для получения дополнительных ресурсов по работе с полным API Roblox.

Частые ошибки и сообщения об ошибках

Размещение LocalScript в ServerScriptService. Локальные скрипты работают только в клиентских контейнерах — StarterPlayerScripts, StarterCharacterScripts или внутри GUI в StarterGui. Если ваш клиентский код не работает, в первую очередь проверьте его расположение.

Забыли проверить на nil. Если `FindFirstChild` возвращает `nil` и вы обращаетесь к его свойству, скрипт падает с ошибкой «attempt to index nil». Всегда оборачивайте результаты поиска в проверку if перед использованием.

Использование wait() вместо task.wait(). Устаревший `wait()` неточен и объявлен deprecated. Используйте `task.wait(seconds)` для задержек, `task.spawn()` для потоков и `task.delay()` для отложенных вызовов.

Когда ошибки появляются в панели Output, читайте их внимательно — они включают имя скрипта, номер строки и описание. Ошибка «expected 'end'» означает незакрытый блок. Посчитайте пары `if/then/end` и `function/end` — каждому открывающему ключевому слову нужен соответствующий `end`.

Сохранение данных игроков

DataStoreService сохраняет прогресс игроков между сессиями. Получите хранилище через `game:GetService("DataStoreService"):GetDataStore("PlayerData")`. Загружайте при входе с помощью `pcall(function() return dataStore:GetAsync("Player_" .. player.UserId) end)` и сохраняйте при выходе с помощью `SetAsync`. Всегда оборачивайте вызовы к хранилищу данных в `pcall`, чтобы перехватывать сетевые ошибки, которые иначе обрушат ваш скрипт. Сохраняйте при `PlayerRemoving` и рассмотрите автосохранение по таймеру в качестве резервного варианта. Хранилища данных требуют опубликованной игры — включите доступ к API в Game Settings для тестирования в Studio. Потеря данных — самый быстрый способ навсегда потерять игроков.

Следующие шаги

Производительность важна с первого дня. По мере роста скриптов плохие привычки накапливаются. Прочитайте наше руководство по производительности игр, чтобы понять, как выбор в скриптинге влияет на частоту кадров, память и сетевой трафик.

Лучший способ учиться — это создавать. Выберите небольшой проект — сборщик монет, обби с таблицей лидеров, головоломку с дверями — и постройте его с нуля. Когда застрянете, читайте панель Output, ищите в документации Roblox и итерируйте. Скриптинг в Roblox — это одна из самых полезных точек входа в программирование, потому что обратная связь мгновенная: напишите код, нажмите Play, увидьте результат.