Туториал · Игровые системы

Как сделать дверь в Roblox Studio

Рабочей двери в Roblox нужны три вещи: то, что нажимает игрок (ProximityPrompt с надписью "Open"), плавное движение (TweenService) и сервер, который вносит изменение, чтобы все игроки видели одну и ту же дверь. В этом гайде мы собираем один скрипт, который делает это для каждой двери с тегом, распашной или раздвижной, с необязательным замком на ключ: сервер проверяет ключ, прежде чем что-то открыть.

Обновлено 12 ноября 2026 г.19 мин чтенияАвтор:

Коротко

Соберите дверь как Part или Model, отметьте Anchored, перенесите её pivot на край с петлями (вкладка Model, Pivot) и добавьте тег Door в окне Properties. Один Script в ServerScriptService находит все двери с тегом через CollectionService, добавляет ProximityPrompt ("Open", удержание E) и по событию Triggered твинит NumberValue от 0 до 1, двигая дверь через door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Атрибуты на каждой двери задают распашной или раздвижной тип, угол, время, автозакрытие и ключ.

  • Позицию Model нельзя твинить напрямую: у Model нет свойства CFrame или Position, а её WorldPivot задаёт только место pivot. Твиньте NumberValue и двигайте дверь через PivotTo: Roblox называет его основным способом двигать модели из скрипта.
  • Открывайте двери на сервере. Дверь, открытая из LocalScript, двигается только на экране этого игрока.
  • Проверяйте ключ и расстояние на сервере. В гайде Roblox по безопасности сказано, что ProximityPrompt можно использовать во вред так же, как RemoteEvent, и там же приведён пример проверки, которую обязан делать сервер: есть ли у игрока ключ, нужный, чтобы открыть дверь.
На этой странице
  1. Как это работает
  2. 1. Собираем дверь
  3. 2. Скрипт двери
  4. Раздвижные двери
  5. Двери с ключом
  6. Старые туториалы
  7. Пределы защиты
  8. 3. Проверка
  9. Расширения
  10. Common errors
  11. С RoCode
  12. Частые вопросы
  13. Источники и что почитать

Как работает дверь на скрипте

ИллюстрацияУдержание E в течение 0.2 секунды открывает дверь за 0.6 секунды, а через 4 секунды после полного открытия она закрывается сама (здесь ускорено). VaultDoor остаётся закрытой для игрока без RedKey.

Дверь, которая работает в настоящей игре, должен двигать сервер. Если её двигает LocalScript, дверь открывается на экране одного игрока и остаётся закрытой для всех остальных, потому что изменение, сделанное клиентом, остаётся на этом устройстве (смотрите что реплицируется, а что нет). Поэтому в этом гайде устройство игрока только показывает подсказку и сообщает о нажатии клавиши, а всё остальное делает один серверный Script. Одно использование двери выглядит так:

  1. Игрок подходит к двери ближе чем на 8 стадов, и появляется подсказка с действием Open, названием объекта Door и клавишей E на клавиатуре. На геймпаде или сенсорном экране Roblox показывает подходящую кнопку.
  2. Игрок удерживает E 0.2 секунды. Событие Triggered подсказки срабатывает на сервере с этим игроком.
  3. DoorService проверяет игрока: жив, достаточно близко, не спамит подсказкой и носит ключ, если дверь его требует.
  4. Скрипт твинит число от 0 (закрыто) до 1 (открыто). При каждом изменении числа он через PivotTo сдвигает дверь на эту долю пути от закрытого положения к открытому.
  5. Через четыре секунды после полного открытия дверь закрывается тем же способом. Нажатие во время движения разворачивает дверь обратно с того места, где она находится.
Из чего состоит система дверей
ЭлементГде находитсяЧто делает
Script DoorServiceServerScriptServiceНаходит все двери, добавляет каждой подсказку, проверяет каждое использование и двигает дверь. Единственный скрипт в этом гайде.
Тег DoorНа каждом Part или Model двериПомечает, что является дверью. Теги добавляются в окне Properties и сохраняются вместе с плейсом.
Атрибуты, например Style и KeyNameНа каждой двери (необязательно)Настройки одной двери: распашная или раздвижная, угол, скорость, автозакрытие и ключ.
ProximityPrompt DoorPromptВнутри двери (его добавляет DoorService)Показывает "Open" или "Close" и запускает Triggered, когда игрок удерживает E.
NumberValue DoorProgressВнутри двери (его добавляет DoorService)Число, которое твин двигает между 0 и 1. Каждое изменение двигает дверь.
Tool RedKey (необязательно)StarterPack, для тестовКлюч для запертой двери. Подойдёт любой Tool, если его имя совпадает с KeyName двери.
Explorer, когда гайд пройден. У обеих дверей есть тег Door, а у VaultDoor ещё атрибуты Style = Slide и KeyName = RedKey. Когда игра запущена, DoorService добавляет DoorProgress в каждую дверь и DoorPrompt в парт, на котором висит подсказка.
Workspace
  FrontDoor Part new
  VaultDoor Model new
    Panel Part new
    Knob Part new
ServerScriptService
  DoorService Script new
StarterPack
  RedKey Tool new
    Handle Part new

Шаг 1: соберите дверь и задайте петлю

  1. В Explorer наведите курсор на Workspace, нажмите кнопку + и вставьте Part. Назовите его FrontDoor, задайте Size примерно 4, 7, 0.5 (4 стада в ширину, 7 в высоту, полстада в толщину) и поставьте в дверной проём. Дверь из нескольких партов тоже подойдёт: выделите их и нажмите Ctrl+G, чтобы сгруппировать в Model.
  2. Отметьте Anchored у каждого парта двери и оставьте CanCollide включённым. Анкерные парты никогда не двигаются от гравитации или столкновений, но скрипт всё равно может их двигать, и именно это делает DoorService.
  3. Задайте петлю. Выделите дверь, откройте вкладку Model и включите Pivot. Нажмите и удерживайте маленькую стрелку в углу кнопки Pivot и отметьте Snap, чтобы pivot прилипал к опорным точкам на углах, рёбрах и центрах. Перетащите pivot на тот край двери, где были бы петли. У раздвижной двери pivot может остаться в центре.
  4. Добавьте тег. Не снимая выделения с двери, прокрутите окно Properties до Tags, нажмите + и введите Door с заглавной D. Если дверь это Model, ставьте тег на саму Model, а не на парты внутри.
  5. Соберите вторую дверь, она понадобится в разделах про раздвижные двери и ключ. Вставьте в Workspace ещё два Part: Panel размером примерно 4, 7, 0.5 и Knob примерно 0.5, 0.5, 0.5, приставленный к одной из граней Panel. Выделите оба, нажмите Ctrl+G и переименуйте новую Model в VaultDoor. Заанкерьте оба парта, поставьте модель во второй проём и добавьте тег Door на Model. Её pivot может остаться в центре, потому что эта дверь будет раздвижной.

Pivot важен, потому что распашная дверь поворачивается вокруг него. Если оставить его в центре, дверь будет крутиться на месте, как вращающаяся дверь в магазине. У парта заданный вами pivot сохраняется как PivotOffset, и GetPivot его учитывает, поэтому скрипт поворачивает дверь ровно вокруг выбранной вами точки. Если у Model есть PrimaryPart, то pivot модели это pivot этого парта, и DoorService вешает подсказку тоже на него. Без PrimaryPart подсказка попадает на первый парт, найденный внутри модели. Если задаёте PrimaryPart, делайте это до того, как двигать pivot: назначение PrimaryPart переносит pivot модели в pivot этого парта, как отмечено на странице Roblox про Pivot tools.

Настройки двери (атрибуты)

Любая дверь работает со значениями по умолчанию из таблицы ниже. Чтобы изменить одну дверь, выделите её, прокрутите окно Properties до Attributes, нажмите +, введите имя, выберите тип и нажмите Save, затем задайте значение. DoorService читает атрибуты один раз, когда настраивает дверь, поэтому меняйте их, пока игра остановлена.

Необязательные атрибуты на каждой двери
АтрибутТипПо умолчаниюЧто делает
StylestringSwingSwing поворачивает дверь вокруг её pivot. Slide сдвигает её вбок вдоль ширины.
OpenAnglenumber90На сколько градусов поворачивается распашная дверь. Отрицательное число распахивает её в другую сторону. Держите значение между -179 и 179: дверь всегда идёт по короткой дуге, поэтому DoorService ограничивает угол этими пределами.
SlideDistancenumberеё ширинаНа сколько стадов раздвижная дверь едет вдоль своей ширины. Отрицательное число сдвигает её в другую сторону.
OpenSecondsnumber0.6Сколько длится полное открытие или закрытие, в пределах от 0.05 до 10.
AutoCloseSecondsnumber4Сколько дверь стоит полностью открытой, прежде чем закроется сама. 0 оставляет её открытой, пока кто-нибудь не закроет.
KeyNamestringнетИмя Tool, который должен быть у игрока, чтобы открыть дверь, например RedKey. Не задавайте его для двери, которую может открыть любой.

Шаг 2: добавьте скрипт двери

Наведите курсор на ServerScriptService, вставьте Script с именем DoorService и вставьте в него код ниже. Он управляет всеми дверями в плейсе, сколько бы вы их ни пометили тегом. Три настройки в начале действуют на все двери; атрибуты из шага 1 меняют одну дверь.

Script в ServerScriptService с именем DoorService
-- Script в ServerScriptService с именем DoorService.
-- Открывает и закрывает каждый Part или Model с тегом "Door" по подсказке с удержанием E.
-- Дверь двигает сервер, поэтому все игроки видят одну и ту же дверь, и сервер же
-- проверяет расстояние и ключ, поэтому никто не откроет запертую дверь издалека.
--
-- Необязательные атрибуты на каждой двери (задаются в окне Properties):
--   Style            string  "Swing" (по умолчанию) или "Slide"
--   OpenAngle        number  на сколько градусов распашная дверь поворачивается вокруг pivot (по умолчанию 90, от -179 до 179)
--   SlideDistance    number  на сколько стадов раздвижная дверь едет вдоль своей ширины (по умолчанию: её ширина)
--   OpenSeconds      number  сколько длится открытие (по умолчанию 0.6)
--   AutoCloseSeconds number  закрыть снова через столько секунд; 0 оставляет открытой (по умолчанию 4)
--   KeyName          string  имя Tool, который должен быть у игрока, например "RedKey"

local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")

local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- стады
local MIN_SECONDS_BETWEEN_USES = 0.3 -- на каждую дверь, против спама подсказкой

local doorsSetUp: { [Instance]: boolean } = {}

local function attribute(door: Instance, name: string, default: any): any
	local value = door:GetAttribute(name)
	if value == nil or typeof(value) ~= typeof(default) then
		return default
	end
	if typeof(value) == "number" and (value ~= value or math.abs(value) == math.huge) then
		return default -- NaN или бесконечность, введённые в окне Properties
	end
	return value
end

local function hasKey(player: Player, keyName: string): boolean
	local backpack = player:FindFirstChildOfClass("Backpack")
	local character = player.Character
	local inBackpack = backpack and backpack:FindFirstChild(keyName)
	local held = character and character:FindFirstChild(keyName)
	return (inBackpack ~= nil and inBackpack:IsA("Tool")) or (held ~= nil and held:IsA("Tool"))
end

local function setUpDoor(door: Instance)
	if doorsSetUp[door] or not (door:IsA("BasePart") or door:IsA("Model")) then
		return -- уже рабочая дверь, либо это не парт и не модель
	end
	local promptPart = if door:IsA("Model") then (door.PrimaryPart or door:FindFirstChildWhichIsA("BasePart", true)) else door
	if not (promptPart and promptPart:IsA("BasePart")) then
		warn(`DoorService: {door:GetFullName()} has no part to put the prompt on`)
		return
	end

	doorsSetUp[door] = true
	door.Destroying:Connect(function()
		doorsSetUp[door] = nil
	end)
	-- Копия рабочей двери приносит с собой старые подсказку и значение: удаляем их
	for _, leftover in door:GetDescendants() do
		if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
			leftover:Destroy()
		end
	end

	-- Закрытое и открытое положения считаем один раз, от того места, где дверь стоит сейчас
	local closedPivot = door:GetPivot()
	local openPivot: CFrame
	if attribute(door, "Style", "Swing") == "Slide" then
		-- Едем вдоль более длинной горизонтальной стороны двери, её ширины. Model измеряется вдоль
		-- сторон своего pivot, Part по собственному Size, поэтому не поворачивайте pivot раздвижного парта
		local size = if door:IsA("Model") then door:GetExtentsSize() else (door :: BasePart).Size
		local alongX = size.X >= size.Z
		local width = if alongX then size.X else size.Z
		local direction = if alongX then Vector3.xAxis else Vector3.zAxis
		openPivot = closedPivot * CFrame.new(direction * attribute(door, "SlideDistance", width))
	else
		-- Lerp всегда поворачивает по короткой дуге, поэтому больший угол распахнул бы дверь не туда
		local angle = math.clamp(attribute(door, "OpenAngle", 90), -179, 179)
		openPivot = closedPivot * CFrame.Angles(0, math.rad(angle), 0)
	end
	local openSeconds = math.clamp(attribute(door, "OpenSeconds", 0.6), 0.05, 10)
	local autoClose = math.max(attribute(door, "AutoCloseSeconds", 4), 0)
	local keyName = attribute(door, "KeyName", "")

	-- Твиним число от 0 (закрыто) до 1 (открыто) и двигаем дверь вслед за ним.
	-- PivotTo двигает один парт или целую модель вокруг её pivot.
	local progress = Instance.new("NumberValue")
	progress.Name = "DoorProgress"
	progress.Parent = door
	progress.Changed:Connect(function(alpha: number)
		door:PivotTo(closedPivot:Lerp(openPivot, alpha))
	end)

	local prompt = Instance.new("ProximityPrompt")
	prompt.Name = "DoorPrompt"
	prompt.ActionText = "Open"
	prompt.ObjectText = if keyName ~= "" then `Needs {keyName}` else "Door"
	prompt.HoldDuration = 0.2
	prompt.MaxActivationDistance = PROMPT_DISTANCE
	prompt.RequiresLineOfSight = false
	prompt.Parent = promptPart

	local isOpen = false
	local lastUse = 0
	local moveCount = 0

	local function move(open: boolean)
		isOpen = open
		moveCount += 1
		door:SetAttribute("Open", open) -- это могут читать другие скрипты
		prompt.ActionText = if open then "Close" else "Open"
		-- Новый твин на том же значении отменяет старый, поэтому дверь может развернуться на полпути.
		-- Время масштабируем по тому, сколько ей ещё осталось пройти.
		local target = if open then 1 else 0
		local seconds = openSeconds * math.abs(target - progress.Value)
		TweenService:Create(progress, TweenInfo.new(seconds, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), { Value = target }):Play()

		if open and autoClose > 0 then
			local thisMove = moveCount
			task.delay(openSeconds + autoClose, function()
				if moveCount == thisMove and isOpen then
					move(false)
				end
			end)
		end
	end

	prompt.Triggered:Connect(function(player: Player)
		local now = os.clock()
		if now - lastUse < MIN_SECONDS_BETWEEN_USES then
			return
		end
		-- В гайде Roblox по безопасности сказано, что подсказками можно злоупотреблять как ремоутами, поэтому проверяем здесь ещё раз
		local character = player.Character
		local humanoid = character and character:FindFirstChildOfClass("Humanoid")
		local rootPart = humanoid and humanoid.RootPart
		if not (humanoid and rootPart) or humanoid.Health <= 0 then
			return
		end
		if (rootPart.Position - promptPart.Position).Magnitude > PROMPT_DISTANCE + 6 then
			return -- слишком далеко, чтобы честно воспользоваться подсказкой
		end
		if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
			return -- заперто, а у этого игрока нет ключа
		end
		lastUse = now
		move(not isOpen)
	end)
end

-- Все двери с тегом сейчас и все, что получат тег позже (включая двери, клонированные скриптами)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
	setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)

DoorService сам добавляет DoorPrompt и DoorProgress в каждую дверь при запуске игры, поэтому вручную ничего вставлять не нужно. Держите одну копию скрипта: он уже обслуживает все двери с тегом.

Что делает каждая часть DoorService
Часть скриптаЧто делаетЗачем
attribute()Читает один атрибут и возвращает значение по умолчанию, если атрибута нет, у него не тот тип или это не настоящее число (NaN или бесконечность).Опечатка в окне Properties даёт дверь с настройками по умолчанию, а не сломанную дверь.
doorsSetUp и цикл по leftoverНастраивает каждую дверь один раз и сначала удаляет DoorPrompt или DoorProgress, скопированные с другой двери.Иначе у копии рабочей двери было бы две подсказки, и одна из них нерабочая.
closedPivot и openPivotВычисляются один раз, от того места, где дверь стоит в момент настройки. Распашная дверь поворачивает pivot вокруг его собственной вертикальной оси; раздвижная сдвигает его вдоль более длинной стороны двери.Lerp от закрытого pivot к открытому оставляет pivot на месте, пока дверь поворачивается, поэтому край с петлями не сдвигается на протяжении всего поворота.
DoorProgress и PivotToТвин меняет число; каждое изменение ставит дверь в closedPivot:Lerp(openPivot, alpha).TweenService умеет твинить NumberValue, а PivotTo двигает парт или модель со всеми её партами так, чтобы pivot оказался на этом CFrame.
ПодсказкаHoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight выключен. Запертая дверь показывает "Needs RedKey".С включённой прямой видимостью подсказка прячется, когда что-то загораживает её парт; без неё рама или остальные части двери-модели подсказку не скрывают.
move()Запускает твин к 1 или к 0, а время масштабирует по тому, сколько двери ещё осталось пройти.Новый твин на том же значении отменяет старый, поэтому дверь, развёрнутая на полпути, плавно идёт обратно и тратит на это половину времени.
АвтозакрытиеЖдёт время открытия плюс AutoCloseSeconds, затем закрывает дверь, только если moveCount не изменился.Старый таймер никогда не захлопнет дверь, которую за это время кто-то закрыл и открыл снова.
Проверки в TriggeredОдно использование двери раз в 0.3 секунды, живой персонаж, не дальше 14 стадов от парта с подсказкой и ключ, но только для открытия.Всем, что может запустить клиент, можно злоупотребить, поэтому сервер повторяет проверки. 14 стадов это 8 стадов подсказки плюс 6 запаса для игрока, который сдвинулся, пока удерживал E.
Атрибут OpenВыставляется на двери при каждом движении.Атрибуты, заданные на сервере, реплицируются всем игрокам, поэтому другие скрипты, включая LocalScript, могут слушать его через GetAttributeChangedSignal("Open").

Помечать все двери тегом и управлять ими из одного скрипта это подход, который рекомендует сам Roblox: в справке по CollectionService сказано, что если вы добавляете один и тот же скрипт во множество объектов, скрипт на CollectionService может оказаться лучше. GetTagged возвращает двери, которые существуют при запуске скрипта, а GetInstanceAddedSignal ловит двери, помеченные или добавленные позже. Такой способ организации плейса разобран в гайде по клиентским и серверным скриптам.

Как сделать раздвижную дверь

Выделите VaultDoor, добавьте атрибут типа string с именем Style и задайте значение Slide. Теперь дверь не поворачивается, а едет вбок: на собственную ширину или на SlideDistance стадов, если вы его задали. Чтобы она ехала в другую сторону, задайте отрицательное расстояние, например -4 для двери шириной 4 стада. Любая другая дверь, включая FrontDoor, станет раздвижной так же, как только получит этот атрибут.

DoorService измеряет два горизонтальных размера двери, ширину и толщину, и двигает её вдоль большего. Model он измеряет через GetExtentsSize, чей бокс следует ориентации pivot модели, поэтому дверь, повёрнутая на 90 градусов после группировки, всё равно едет вдоль ширины, а не толщины. Part он измеряет по собственному Size парта, поэтому не поворачивайте pivot раздвижного парта. Сдвигать этот pivot можно.

  • Двойные двери: две половины с тегом рядом друг с другом, у обеих Style равен Slide, а у одной отрицательный SlideDistance, чтобы они расходились от середины. Для распашных двойных дверей поставьте pivot каждой половины на её внешний край и задайте одной половине отрицательный OpenAngle. У каждой половины своя подсказка, и открывается она отдельно. Если половины едут друг в друга, перенесите минус на другую половину.
  • Ворота, которые поднимаются вверх: этот скрипт двигает дверь только вдоль ширины. Чтобы двери поднимались, задайте direction в скрипте равным Vector3.yAxis (тогда все раздвижные двери поедут вверх) и дайте каждой SlideDistance, равный её высоте.
  • Дверь на физике: туториал Roblox про движущиеся объекты двигает парты вдоль одной оси через PrismaticConstraint. Как и дверь на петле, это физика, без подсказки и замка, пока вы не напишете их сами.

Как запереть дверь на ключ

Запертая дверь открывается только игроку, у которого есть Tool с нужным именем. Сделайте ключ, затем сообщите двери его имя:

  1. Наведите курсор на StarterPack, нажмите + и вставьте Tool с именем RedKey. Вставьте в него один Part с именем Handle, это парт, который персонаж держит в руке, и убедитесь, что он не заанкерен: анкерный парт в инструменте приковывает персонажа к месту. Снимите у Tool галочку CanBeDropped, если игроки не должны выбрасывать ключ для кого-то другого: пока она стоит, Backspace выбрасывает экипированный инструмент в Workspace.
  2. Выделите VaultDoor, добавьте атрибут типа string с именем KeyName и задайте значение RedKey. Теперь в названии объекта на подсказке написано Needs RedKey.

DoorService ищет ключ в двух местах. Tool лежит в Backpack игрока, пока его не экипируют, а экипировка переносит его в персонажа, поэтому дверь открывается, лежит ли ключ в хотбаре или в руке. Проверка идёт на сервере, потому что гайд Roblox по безопасности называет именно этот случай, есть ли у игрока ключ для двери, как право, которое обязан проверять сервер. Ключ нужен только для открытия: закрыть открытую дверь может кто угодно, и она сама закрывается через AutoCloseSeconds.

StarterPack выдаёт ключ всем при каждом спавне, и для тестов это то, что нужно. В настоящей игре выдавайте его иначе:

  • Из магазина: гайд по GUI магазина выдаёт Tool из ServerStorage в Backpack и StarterGear покупателя.
  • От персонажа: гайд по диалогам с NPC выдаёт Tool из ServerStorage.DialogueItems, когда игрок выбирает вариант с действием GiveItem. Положите в эту папку Tool с именем RedKey и задайте варианту в DialogueData action = "GiveItem" и item = "RedKey", и ключ будет выдаваться в разговоре.
  • Как предмет инвентаря: с системой инвентаря предмет-ключ работает, как только игрок его экипирует, потому что экипировка кладёт копию его Tool в Backpack и в руку.

Ключ в Backpack теряется, когда персонаж умирает, потому что Roblox при каждом спавне заново наполняет Backpack из StarterPack и StarterGear. Чтобы его сохранить, положите копию ещё и в StarterGear игрока, как это делает гайд по магазину. Чтобы ключ, наоборот, расходовался, найдите Tool ключа в Backpack или в персонаже игрока и уничтожьте его в обработчике Triggered, сразу после успешной проверки ключа.

В чём ошибаются старые туториалы по дверям

Если вы сравниваете этот гайд с видео или постом на форуме, вот приёмы, из-за которых появляется большинство тем «у меня не работает дверь», и то, что этот гайд делает вместо них.

Частые приёмы в туториалах по дверям и что этот гайд делает вместо них
ТуториалПроблемаЭтот гайд
Твинит CFrame двери-ModelВ справке по Model нет свойства CFrame или Position. Её WorldPivot задаёт только место pivot модели, поэтому его твин двигает точку pivot, а парты остаются на месте.Твинит NumberValue и двигает всю модель через PivotTo.
Двигает модель через SetPrimaryPartCFrameУстарело: Roblox советует в новых проектах использовать PivotTo.Использует PivotTo, который Roblox называет основной функцией для перемещения Model из скриптов.
Приваривает все парты к одному парту-петле и твинит только петлюРаботает, когда все Weld на месте, но любой неприваренный парт остаётся позади, когда петля двигается.Держит все парты анкерными, без Weld. PivotTo двигает дверь и всё, что внутри неё.
Копирует один и тот же скрипт в каждую дверьКаждое исправление приходится повторять в каждой копии. Roblox предлагает помечать объекты тегами и обрабатывать их одним скриптом через CollectionService.Один DoorService и тег Door.
Открывает дверь в LocalScriptДверь открывается только на экране этого игрока, а все остальные по-прежнему видят её закрытой.Дверь двигает сервер, поэтому все игроки видят одну и ту же дверь.
Открывает дверь по TouchedTouched срабатывает несколько раз подряд за одно касание (страница Roblox про debounce), а устройство игрока может управлять тем, когда Touched срабатывает для его собственного персонажа (документация Roblox по безопасности).Подсказка, которую проверяет сервер.
Двигает дверь по шагам в цикле с wait()Roblox помечает wait() как заменённый на task.wait(), а цикл не может развернуться на полпути, когда кто-то нажимает снова.Один твин на движение. Новый твин на том же значении отменяет старый, поэтому дверь разворачивается с того места, где находится.
Проверяет ключ в LocalScript или не проверяет вовсеЧитер управляет всем на своём устройстве, поэтому проверка на клиенте никого не останавливает.Сервер ищет Tool в Backpack и в персонаже игрока.
Нет кулдауна на подсказкеВ гайде Roblox по безопасности сказано, что подсказки уязвимы для злоупотреблений так же, как ремоуты, поэтому ничто не мешает запускать её снова и снова.Одно использование двери раз в 0.3 секунды.

Что может и чего не может читер

Считайте, что читер управляет всем на своём устройстве, включая своего персонажа. Вот что это значит для этих дверей.

Что может попробовать читер и что с этим делает DoorService
Читер пытаетсяРезультатПочему
Запустить подсказку с другого конца картыИгнорируется, если его персонаж не у двериDoorService измеряет расстояние от корневого парта персонажа до парта с подсказкой и игнорирует всё, что дальше 14 стадов. Читер может сначала телепортировать персонажа к двери (смотрите последнюю строку), поэтому проверка расстояния защищает от использования издалека, а не от телепорта.
Запускать её много раз в секундуНе больше одного использования двери раз в 0.3 секундыСервер хранит время последнего использования каждой двери.
Открыть дверь с ключом без ключаОтказСервер ищет Tool в его Backpack и персонаже там, где видит их сам, а не на экране читера.
Использовать дверь, пока персонаж мёртвИгнорируетсяDoorService проверяет, что есть Humanoid со здоровьем больше 0 и корневой парт.
Всё равно пройти сквозь закрытую дверьВозможноДокументация Roblox по безопасности перечисляет обход физических препятствий и изменение собственных коллизий среди того, что клиент может делать со своим персонажем.
Телепортироваться за дверьВозможноТа же документация упоминает телепортацию своего персонажа в любую точку.

Шаг 3: проверьте

  1. Нажмите Play (F5). Подойдите к FrontDoor: в пределах 8 стадов появляется подсказка с действием Open и названием объекта Door. Удерживайте E. Через 0.2 секунды дверь распахивается на 90 градусов вокруг края с петлями за 0.6 секунды, и на подсказке теперь написано Close.
  2. Пройдите в дверь и подождите. Через четыре секунды после полного открытия дверь закрывается сама. Удерживайте E, пока она закрывается: она разворачивается и открывается с того места, где была.
  3. Проверьте замок. Если RedKey лежит в StarterPack, перенесите его пока в ServerStorage, нажмите Play и удерживайте E у VaultDoor: на подсказке написано Needs RedKey, и ничего не двигается. Остановите игру, верните RedKey в StarterPack и запустите снова: VaultDoor открывается, лежит ли ключ в хотбаре или в руке.
  4. Проверьте раздвижную дверь. VaultDoor, Model со Style Slide, при открытии едет вбок на свою ширину. Остановите игру, выделите VaultDoor, поверните её на 90 градусов инструментом Rotate и запустите снова: она по-прежнему должна ехать вдоль ширины, а не толщины. Когда закончите, поверните её обратно.
  5. Выберите Server & Clients в выпадающем списке режимов теста, задайте 2 клиента и нажмите Play. Откройте дверь в окне одного клиента: она открыта и в другом окне и закрывается в обоих.
  6. Остановите игру, выделите дверь и нажмите Ctrl+D, чтобы сделать дубликат, затем перенесите копию в другой проём. Проверьте, что у копии в Tags по-прежнему указан Door, и нажмите Play: копия работает без дополнительного скрипта.

Держите окно Output открытым (меню Window, затем Output). Когда всё работает, DoorService ничего не печатает. Предупреждение о том, что у двери "has no part to put the prompt on", означает, что внутри Model с тегом нет партов. Остальное смотрите в разделе Частые ошибки.

Как расширить

Автоматические двери

Чтобы дверь открывалась, когда кто-то подходит, вызывайте move(true) изнутри setUpDoor, не дожидаясь подсказки. В конце setUpDoor запустите цикл через task.spawn, потому что обычный цикл там никогда не закончится, и DoorService не продвинулся бы дальше первой двери. Пусть он работает, только пока дверь есть в игре: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Внутри цикла проверяйте через workspace:GetPartBoundsInBox, есть ли персонаж внутри бокса вокруг проёма, и вызывайте move(true), когда он там есть, а дверь закрыта. Дальше её, как и раньше, закроет автозакрытие. Задайте подсказке Enabled равным false, если дверь должна открываться только сама.

VIP-двери

Гайд по геймпассам уже собирает VIP-дверь, сквозь которую владельцы пасса проходят напрямую, на группах коллизий. Для VIP-двери, которая открывается на E, добавьте ещё одну проверку в обработчик Triggered рядом с проверкой ключа: делайте return, если не выполняется player:GetAttribute("OwnsPass_VIP") == true, это атрибут, который выставляет серверный скрипт из гайда по геймпассам. Читайте его только на сервере.

Кодовая панель

Для двери, которая открывается по введённому коду, храните код в серверном Script или в ServerStorage, которые игроки никогда не получают, и ни в коем случае не в LocalScript, где читер может его прочитать. LocalScript панели отправляет через RemoteEvent только введённые цифры. На сервере проверьте, что игрок рядом с дверью, ограничьте частоту попыток, сравните цифры и только потом вызывайте move(true). Гайд по RemoteEvent показывает, как проверять то, что получает ремоут.

Звуки

Положите Sound внутрь парта двери, чтобы он звучал из позиции этого парта, и вызывайте его метод Play в начале move. Или проигрывайте его из LocalScript, который слушает атрибут Open двери через GetAttributeChangedSignal("Open"), ведь сервер выставляет этот атрибут при каждом движении.

Двери, добавленные во время игры

Клонируйте новые двери из закрытого шаблона в ServerStorage. DoorService считывает закрытое положение двери в момент её появления, поэтому копия двери, которая в тот момент была открыта, считала бы своё открытое положение закрытым. Поставьте копию в проём через PivotTo до того, как задать ей Parent равным Workspace, чтобы DoorService запомнил это место как закрытое. Старые подсказки и значения, пришедшие с копией, удаляются автоматически. Про дверь, которая переносит игроков в другую зону или другой плейс, читайте в гайде по телепортам.

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

Откройте окно Output (меню Window, затем Output) до нажатия Play. Большинство проблем с дверями возникает из-за тега, pivot или атрибута, которые чуть-чуть не такие, как ждёт скрипт.

У двери не появляется подсказка

Проверьте по порядку: DoorService это Script, а не LocalScript, и лежит прямо в ServerScriptService; у двери есть тег Door с заглавной D, для двери-модели на самой Model; дверь это парт (Part, MeshPart или другой BasePart) или Model; и вы стоите не дальше 8 стадов от парта, на котором висит подсказка. Предупреждение в Output о том, что у двери "has no part to put the prompt on", означает, что внутри Model с тегом нет партов.

Дверь падает, уплывает или её толкают, когда игра запускается

Какой-то её парт не заанкерен. Выделите все парты двери и отметьте Anchored. Анкерные парты никогда не двигаются от физики, но DoorService всё равно может их двигать.

Я изменил атрибут, но дверь его игнорирует

Проверьте три вещи. Тип: OpenAngle, SlideDistance, OpenSeconds и AutoCloseSeconds должны быть атрибутами типа number, а Style и KeyName типа string; при неверном типе DoorService берёт значение по умолчанию. Написание: имена сравниваются точно, поэтому openAngle это другой атрибут. Значения тоже сравниваются точно: Style должен быть Slide с заглавной S и без пробелов. Момент: DoorService читает атрибуты один раз, когда настраивает дверь, поэтому изменение во время плейтеста ничего не даёт, пока вы не запустите игру заново.

Дверь распахивается не в ту сторону или заваливается набок

Чтобы она открывалась в другую сторону, сделайте OpenAngle отрицательным, например -90. Если она поворачивается вокруг горизонтальной оси, а не вокруг вертикальной петли, значит, повёрнут сам pivot: включите Pivot на вкладке Model и поверните pivot обратно, чтобы он стоял вертикально.

Раздвижная дверь уезжает в стену или сдвигается совсем чуть-чуть

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

У меня есть ключ, но дверь не открывается

Ключ должен быть Tool, а не Part или Model, и его имя должно точно совпадать с KeyName, включая заглавные буквы. Он должен лежать в вашем Backpack или быть в руке. Проверьте также, что KeyName на двери это атрибут типа string.

Сделать с RoCode

Если не хочется настраивать всё это вручную, RoCode может собрать это в открытом у вас плейсе. RoCode это независимый ИИ-агент для Roblox Studio, не от Roblox: вы описываете изменение в веб-чате, а его плагин для Studio создаёт скрипты и объекты в вашем Explorer, так что вставлять код не нужно.

Вы пишете

Сделай так, чтобы двери с тегом Door открывались по подсказке с удержанием E: поворот на 90 градусов вокруг pivot за 0.6 секунды, закрытие через 4 секунды, сдвиг вместо поворота, когда атрибут Style равен Slide, и дверь остаётся закрытой, если у игрока нет Tool с именем из KeyName. Всё на сервере, с проверкой расстояния.

RoCode делает
  • Может просмотреть ваш плейс, когда шагу это нужно, через Search Game и Search Scripts, чтобы опереться на уже имеющиеся предметы, ремоуты или код сохранения, а не добавлять вторую систему
  • Пишет Script в ServerScriptService через Create Script, может создать парт двери через Create Instance и задать на нём атрибуты, такие как Style и KeyName
  • Ему велено проверять компиляцию каждого написанного скрипта через Check Script, который компилирует его в Studio без запуска
  • Ставит точку отмены до и после каждой пачки изменений, поэтому Ctrl+Z откатывает по одной пачке

Перед тестом проверьте pivot каждой двери инструментом Pivot в Studio: дверь поворачивается вокруг него. С плагином 3.9 или новее RoCode может запустить короткий плейтест и прочитать ошибки, а с плагином 3.9.15 или новее может управлять тестовым персонажем, который ходит и нажимает клавиши, но он проверяет только то, что сам решил протестировать, поэтому подойдите к каждой двери и удерживайте E сами. Как RoCode подключается к Studio.

Частые вопросы

Как сделать, чтобы дверь открывалась на E в Roblox Studio?

Положите ProximityPrompt в дверь и подключите его событие Triggered в серверном Script, который двигает дверь. DoorService делает и то и другое для каждой двери с тегом Door. E это клавиша подсказки по умолчанию, и Roblox показывает нужный ввод для клавиатур, геймпадов и сенсорных экранов.

Почему моя дверь крутится вокруг своей середины?

Её pivot всё ещё в центре. Включите Pivot на вкладке Model и перетащите pivot на край с петлями; скрипт поворачивает дверь вокруг pivot.

Как сделать раздвижную дверь?

Задайте атрибуту Style двери значение Slide. Она едет вбок на свою ширину или на SlideDistance стадов; отрицательное расстояние сдвигает её в другую сторону.

Можно ли сделать дверь без скриптов?

Да. Туториал Roblox про дверь на петле крепит незаанкеренную дверь к раме через HingeConstraint с ограничениями, и игроки открывают её, толкая телом. У такой двери нет подсказки, замка и автозакрытия.

Как сделать дверь, которую могут открыть только VIP?

Возьмите VIP-дверь из гайда по геймпассам, сквозь которую проходят владельцы пасса, или добавьте в обработчик Triggered в DoorService проверку, которая перед открытием читает на сервере, владеет ли игрок пассом, например атрибут OwnsPass_VIP, который выставляет тот гайд.

Почему дверь открывается у меня, но не у других игроков?

Её открывает LocalScript, а изменение, сделанное LocalScript, остаётся на устройстве этого игрока. Перенесите код открытия в серверный Script, как в DoorService, чтобы изменение дошло до всех.

Источники и что почитать

Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

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