Коротко
Зберіть двері як 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, це парт, який персонаж тримає в руці, і переконайтеся, що він не заанкерений: анкерний парт в інструменті прикує персонажа до місця. Зніміть у Tool позначкуCanBeDropped, якщо гравці не повинні викидати ключ для когось іншого: поки вона стоїть, 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 перед публікацією.