Ръководство · Системи в играта

Как да направиш врата в Roblox Studio

На работеща врата в Roblox ѝ трябват три неща: нещо, което играчът натиска (ProximityPrompt с надпис "Open"), плавно движение (TweenService) и сървър, който прави промяната, за да виждат всички играчи една и съща врата. В това ръководство сглобяваме един скрипт, който прави това за всяка врата с таг, въртяща се или плъзгаща се, с незадължителна ключалка с ключ: сървърът проверява ключа, преди да отвори каквото и да е.

Обновено 20 ноември 2026 г.21 мин четенеАвтор:

Накратко

Направи вратата като 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, това е партът, който персонажът държи в ръката си, и се увери, че не е закотвен: закотвен парт в инструмент приковава персонажа на място. Махни отметката CanBeDropped на Tool, ако играчите не трябва да изхвърлят ключа за някой друг: докато е отметната, 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, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.