Блог школы Роблоппа — Роблокс Студио, обучение, познавательные статьи и новости школы

Что такое ModuleScript и зачем он нужен

2026-02-23 18:40 Документация
Когда проект в Роблокс Студио становится больше, обычных скриптов уже недостаточно. Код начинает повторяться, появляются одинаковые функции в разных местах, а поддерживать игру становится сложнее.
Именно здесь на помощь приходит ModuleScript.
Разберём простыми словами, что это такое и зачем он нужен начинающим разработчикам.

Что такое ModuleScript

ModuleScript — это специальный тип скрипта, который хранит функции и данные, чтобы их можно было использовать в других скриптах.
Проще говоря:
ModuleScript — это «контейнер с инструментами», который можно подключить в любом месте игры.
В отличие от обычного Script или LocalScript, ModuleScript сам по себе не запускается. Он начинает работать только тогда, когда его подключают через require().

Зачем нужен ModuleScript

1. Чтобы не дублировать код

Представьте, что у вас есть функция начисления очков.
Если вы вставите её в 5 разных скриптов — при изменении придётся редактировать всё вручную.
С ModuleScript функция хранится в одном месте.

2. Чтобы структурировать проект

Когда игра становится сложной (инвентарь, магазин, уровни, способности), код лучше разделять на модули:
  • модуль очков
  • модуль инвентаря
  • модуль оружия
  • модуль настроек
Это делает проект профессиональным.

3. Чтобы использовать функции повторно

Один модуль можно подключать:
  • в Server Script
  • в LocalScript
  • в нескольких системах игры

Как создать ModuleScript

  1. Откройте ServerScriptService (или ReplicatedStorage).
  2. Нажмите Insert Object → ModuleScript.
  3. Назовите его, например, ScoreModule.

Пример простого ModuleScript

Внутри ModuleScript:
local ScoreModule = {}
function ScoreModule.AddCoins(player, amount)
player.leaderstats.Coins.Value += amount
end
return ScoreModule
Обратите внимание на return ScoreModule — это обязательная часть.

Как подключить ModuleScript

В обычном Script:
local ScoreModule = require(game.ServerScriptService.ScoreModule)
game.Players.PlayerAdded:Connect(function(player)
ScoreModule.AddCoins(player, 10)
end)
Теперь функция вызывается из модуля.

Где лучше хранить ModuleScript

Обычно:
  • ServerScriptService — если модуль только для сервера
  • ReplicatedStorage — если нужен и серверу, и клиенту
Правильное размещение помогает избежать ошибок безопасности.

Частые ошибки новичков

  1. Забывают написать return в конце.
  2. Пытаются запускать ModuleScript напрямую.
  3. Неправильно указывают путь в require().
  4. Смешивают клиентскую и серверную логику.

Чем ModuleScript полезен детям

Работа с модулями учит:
  • структурировать код
  • мыслить как разработчик
  • создавать масштабные проекты
  • писать аккуратные и понятные программы
Это уже шаг к профессиональному программированию.

Итог

ModuleScript в Роблокс Студио — это способ организовать код, избежать повторений и сделать проект более удобным для развития.
Если ребёнок осваивает модули, значит он выходит на новый уровень понимания разработки.