Накратко
Направи вратата като 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, и там е даден пример за проверка, която сървърът е длъжен да прави: дали играчът има ключа, нужен за отваряне на вратата.
На тази страница
Как работи врата със скрипт
Врата, която работи в истинска игра, трябва да я движи сървърът. Ако я движи LocalScript, вратата се отваря на екрана на един играч и остава затворена за всички останали, защото промяна, направена от клиента, остава на това устройство (виж какво се репликира и какво не). Затова в това ръководство устройството на играча само показва подсказката и съобщава за натискането на клавиша, а всичко останало го прави един сървърен Script. Едно използване на вратата изглежда така:
- Играчът се приближава до вратата на по-малко от 8 стъда и се появява подсказка с действие Open, име на обекта Door и клавиш E на клавиатурата. На геймпад или сензорен екран Roblox показва подходящия бутон.
- Играчът задържа E за 0.2 секунди. Събитието
Triggeredна подсказката се задейства на сървъра с този играч. - DoorService проверява играча: жив е, достатъчно близо е, не спами подсказката и носи ключ, ако вратата изисква такъв.
- Скриптът туинва число от 0 (затворено) до 1 (отворено). При всяка промяна на числото той чрез
PivotToпремества вратата с тази част от пътя от затвореното до отвореното положение. - Четири секунди след пълното отваряне вратата се затваря по същия начин. Натискане по време на движение обръща вратата обратно от мястото, където е.
| Елемент | Къде е | Какво прави |
|---|---|---|
Script DoorService | ServerScriptService | Намира всички врати, добавя подсказка на всяка, проверява всяко използване и движи вратата. Единственият скрипт в това ръководство. |
Таг Door | На всеки Part или Model на врата | Отбелязва кое е врата. Таговете се добавят в прозореца Properties и се запазват заедно с плейса. |
Атрибути, например Style и KeyName | На всяка врата (незадължително) | Настройки на една врата: въртяща се или плъзгаща се, ъгъл, скорост, автоматично затваряне и ключ. |
ProximityPrompt DoorPrompt | Вътре във вратата (добавя го DoorService) | Показва "Open" или "Close" и задейства Triggered, когато играчът задържи E. |
NumberValue DoorProgress | Вътре във вратата (добавя го DoorService) | Числото, което туинът движи между 0 и 1. Всяка промяна движи вратата. |
Tool RedKey (незадължително) | StarterPack, за тестове | Ключ за заключената врата. Става всеки Tool, ако името му съвпада с KeyName на вратата. |
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: построй вратата и задай пантата
- В Explorer задръж курсора върху Workspace, натисни бутона + и вмъкни Part. Наречи го
FrontDoor, задайSizeоколо4, 7, 0.5(4 стъда ширина, 7 височина, половин стъд дебелина) и го постави в рамката на вратата. Врата от няколко парта също става: избери ги и натисни Ctrl+G, за да ги групираш в Model. - Отметни Anchored на всеки парт на вратата и остави CanCollide включено. Закотвените партове никога не се движат от гравитация или сблъсъци, но скриптът пак може да ги движи, и точно това прави DoorService.
- Задай пантата. Избери вратата, отвори раздела Model и включи Pivot. Натисни и задръж малката стрелка в ъгъла на бутона Pivot и отметни Snap, за да се залепя pivot за опорните точки в ъглите, ръбовете и центровете. Плъзни pivot до ръба на вратата, където биха били пантите. При плъзгаща се врата pivot може да остане в центъра.
- Добави тага. Без да махаш избора от вратата, превърти прозореца Properties до Tags, натисни + и въведи
Doorс главно D. Ако вратата е Model, слагай тага на самия Model, а не на партовете вътре. - Построй втора врата, тя ще ти трябва в разделите за плъзгащи се врати и ключ. Вмъкни в 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 чете атрибутите веднъж, когато настройва вратата, затова ги променяй, докато играта е спряна.
| Атрибут | Тип | По подразбиране | Какво прави |
|---|---|---|---|
Style | string | Swing | Swing завърта вратата около нейния pivot. Slide я плъзга встрани по ширината ѝ. |
OpenAngle | number | 90 | С колко градуса се завърта въртящата се врата. Отрицателно число я отваря в другата посока. Дръж стойността между -179 и 179: вратата винаги минава по късата дъга, затова DoorService ограничава ъгъла до тези граници. |
SlideDistance | number | ширината ѝ | С колко стъда плъзгащата се врата се движи по ширината си. Отрицателно число я плъзга в другата посока. |
OpenSeconds | number | 0.6 | Колко трае пълното отваряне или затваряне, в границите от 0.05 до 10. |
AutoCloseSeconds | number | 4 | Колко време вратата стои напълно отворена, преди да се затвори сама. 0 я оставя отворена, докато някой не я затвори. |
KeyName | string | няма | Име на Tool, който играчът трябва да има, за да отвори вратата, например RedKey. Не го задавай за врата, която всеки може да отвори. |
Стъпка 2: добави скрипта за вратата
Задръж курсора върху ServerScriptService, вмъкни Script с име DoorService и постави в него кода по-долу. Той управлява всички врати в плейса, колкото и да си отбелязал с таг. Трите настройки в началото важат за всички врати; атрибутите от стъпка 1 променят една врата.
-- 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 във всяка врата при пускане на играта, затова не трябва да вмъкваш нищо на ръка. Дръж едно копие на скрипта: той вече обслужва всички врати с таг.
| Част от скрипта | Какво прави | Защо |
|---|---|---|
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 с нужното име. Направи ключ, после кажи на вратата името му:
- Задръж курсора върху StarterPack, натисни + и вмъкни Tool с име
RedKey. Вмъкни в него един Part с имеHandle, това е партът, който персонажът държи в ръката си, и се увери, че не е закотвен: закотвен парт в инструмент приковава персонажа на място. Махни отметкатаCanBeDroppedна Tool, ако играчите не трябва да изхвърлят ключа за някой друг: докато е отметната, Backspace изхвърля екипирания инструмент в Workspace. - Избери VaultDoor, добави атрибут от тип string с име
KeyNameи задай стойностRedKey. Сега в името на обекта на подсказката пише Needs RedKey.
DoorService търси ключа на две места. Tool е в Backpack на играча, докато не го екипира, а екипирането го премества в персонажа, затова вратата се отваря, независимо дали ключът е в хотбара или в ръката. Проверката е на сървъра, защото ръководството на Roblox за сигурност посочва точно този случай, дали играчът има ключ за вратата, като право, което сървърът е длъжен да проверява. Ключът трябва само за отваряне: отворена врата може да затвори всеки, а тя и сама се затваря след AutoCloseSeconds.
StarterPack дава ключа на всички при всяко появяване и за тестове това е точно каквото трябва. В истинска игра го давай по друг начин:
- От магазин: ръководството за GUI на магазин дава Tool от ServerStorage в Backpack и StarterGear на купувача.
- От персонаж: ръководството за диалози с NPC дава Tool от
ServerStorage.DialogueItems, когато играчът избере вариант с действиеGiveItem. Сложи в тази папка Tool с име RedKey и задай на варианта в DialogueDataaction = "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 | Вратата се отваря само на екрана на този играч, а всички останали още я виждат затворена. | Вратата я движи сървърът, затова всички играчи виждат една и съща врата. |
Отваря вратата при Touched | Touched се задейства няколко пъти подред при едно докосване (страницата на Roblox за debounce), а устройството на играча може да управлява кога Touched се задейства за собствения му персонаж (документацията на Roblox за сигурност). | Подсказка, която сървърът проверява. |
Движи вратата на стъпки в цикъл с wait() | Roblox отбелязва wait() като заменен с task.wait(), а цикълът не може да се обърне по средата, когато някой натисне пак. | Един туин на движение. Нов туин на същата стойност отменя стария, затова вратата се обръща от мястото, където е. |
| Проверява ключа в LocalScript или изобщо не го проверява | Измамникът управлява всичко на своето устройство, затова проверка на клиента не спира никого. | Сървърът търси Tool в Backpack и в персонажа на играча. |
| Няма презареждане на подсказката | В ръководството на Roblox за сигурност пише, че подсказките са уязвими за злоупотреби също като ремоутите, затова нищо не пречи да се задейства отново и отново. | Едно използване на вратата на 0.3 секунди. |
Какво може и какво не може измамникът
Приеми, че измамникът управлява всичко на своето устройство, включително своя персонаж. Ето какво означава това за тези врати.
| Измамникът се опитва | Резултат | Защо |
|---|---|---|
| Да задейства подсказката от другия край на картата | Пренебрегва се, ако персонажът му не е до вратата | DoorService измерва разстоянието от основния парт на персонажа до парта с подсказката и пренебрегва всичко над 14 стъда. Измамникът може първо да телепортира персонажа до вратата (виж последния ред), затова проверката на разстоянието пази от използване отдалеч, а не от телепорт. |
| Да я задейства много пъти в секунда | Не повече от едно използване на вратата на 0.3 секунди | Сървърът пази времето на последното използване на всяка врата. |
| Да отвори врата с ключ без ключ | Отказ | Сървърът търси Tool в неговия Backpack и персонаж там, където ги вижда сам, а не на екрана на измамника. |
| Да използва вратата, докато персонажът е мъртъв | Пренебрегва се | DoorService проверява, че има Humanoid със здраве над 0 и основен парт. |
| Все пак да мине през затворената врата | Възможно | Документацията на Roblox за сигурност изброява заобикалянето на физически препятствия и промяната на собствените сблъсъци сред нещата, които клиентът може да прави със своя персонаж. |
| Да се телепортира зад вратата | Възможно | Същата документация споменава телепортирането на собствения персонаж до всяка точка. |
Стъпка 3: тествай
- Натисни Play (F5). Приближи се до FrontDoor: в рамките на 8 стъда се появява подсказка с действие Open и име на обекта Door. Задръж E. След 0.2 секунди вратата се завърта на 90 градуса около ръба с пантите за 0.6 секунди и на подсказката вече пише Close.
- Мини през вратата и изчакай. Четири секунди след пълното отваряне вратата се затваря сама. Задръж E, докато се затваря: тя се обръща и се отваря от мястото, където е била.
- Провери ключалката. Ако RedKey е в StarterPack, премести го засега в ServerStorage, натисни Play и задръж E до VaultDoor: на подсказката пише Needs RedKey и нищо не се движи. Спри играта, върни RedKey в StarterPack и пусни пак: VaultDoor се отваря, независимо дали ключът е в хотбара или в ръката.
- Провери плъзгащата се врата. VaultDoor, Model със
StyleSlide, при отваряне се плъзга встрани със своята ширина. Спри играта, избери VaultDoor, завърти я на 90 градуса с инструмента Rotate и пусни пак: тя пак трябва да се плъзга по ширината, а не по дебелината. Когато приключиш, завърти я обратно. - Избери Server & Clients в падащия списък с режими за тест, задай 2 клиента и натисни Play. Отвори вратата в прозореца на единия клиент: тя е отворена и в другия прозорец и се затваря и в двата.
- Спри играта, избери вратата и натисни 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. Всичко на сървъра, с проверка на разстоянието.
- Може да прегледа плейса ти, когато стъпката го изисква, чрез 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, за да стигне промяната до всички.
Източници и какво да прочетеш
- Roblox Creator Docs: PVInstance:PivotTo (на английски). местене на парт или цял модел чрез неговия pivot
- Roblox Creator Docs: Pivot tools (на английски). местене на pivot, Snap и опорни точки, pivot при наличие на PrimaryPart
- Roblox Creator Docs: Model (на английски). WorldPivot, GetExtentsSize следва pivot, SetPrimaryPartCFrame е остарял
- Roblox Creator Docs: CFrame:Lerp (на английски). завъртането се интерполира по най-късата дъга
- Roblox Creator Docs: TweenService (на английски). какво може да се туинва и как втори туин на същото свойство отменя първия
- Roblox Creator Docs: Proximity prompts (на английски). създаване и настройка на подсказки, вход на всяко устройство и пряка видимост
- Roblox Creator Docs: ProximityPrompt (на английски). клавиш и бутон по подразбиране, HoldDuration, MaxActivationDistance и Triggered
- Roblox Creator Docs: CollectionService (на английски). тагове, GetTagged и GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (на английски). добавяне на тагове и атрибути в Studio
- Roblox Creator Docs: Securing the client-server boundary (на английски). ProximityPrompt като повърхност за атака и проверка на правото „ключ и врата“
- Roblox Creator Docs: Network ownership, movement validation, and physics (на английски). какво може да прави клиентът със своя персонаж
- Roblox Creator Docs: Build a hinged door (на английски). врата с HingeConstraint без код
- Roblox Creator Docs: In-game tools (на английски). Handle, закотвяне и StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (на английски). какво прави Backspace с екипирания инструмент
Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.