Ve zkratce
Postavte dveře jako Part nebo Model, zaškrtněte Anchored, přesuňte jejich pivot na okraj s panty (karta Model, Pivot) a v okně Properties přidejte tag Door. Jeden Script v ServerScriptService najde všechny dveře s tagem přes CollectionService, přidá ProximityPrompt ("Open", podržení E) a při události Triggered tweenuje NumberValue od 0 do 1 a posouvá dveře přes door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Atributy na každých dveřích určují otočný nebo posuvný typ, úhel, čas, automatické zavření a klíč.
- Pozici Modelu nejde tweenovat přímo: Model nemá vlastnost CFrame ani Position a jeho
WorldPivoturčuje jen místo pivotu. Tweenujte NumberValue a dveře posouvejte přesPivotTo: Roblox ho označuje za hlavní způsob, jak hýbat modely ze skriptu. - Dveře otevírejte na serveru. Dveře otevřené z LocalScriptu se pohnou jen na obrazovce tohoto hráče.
- Klíč a vzdálenost kontrolujte na serveru. Návod Robloxu k bezpečnosti říká, že ProximityPrompt lze zneužít stejně jako RemoteEvent, a uvádí tam i příklad kontroly, kterou musí server dělat: jestli má hráč klíč potřebný k otevření dveří.
Na této stránce
Jak fungují dveře na skriptu
Dveřmi, které fungují ve skutečné hře, musí hýbat server. Pokud jimi hýbe LocalScript, dveře se otevřou na obrazovce jednoho hráče a pro všechny ostatní zůstanou zavřené, protože změna provedená klientem zůstane na tomto zařízení (viz co se replikuje a co ne). Proto v tomto návodu zařízení hráče jen ukazuje výzvu a hlásí stisk klávesy a všechno ostatní dělá jeden serverový Script. Jedno použití dveří vypadá takto:
- Hráč přijde ke dveřím blíž než na 8 studů a objeví se výzva s akcí Open, názvem objektu Door a klávesou E na klávesnici. Na gamepadu nebo dotykové obrazovce Roblox ukáže odpovídající tlačítko.
- Hráč drží E 0.2 sekundy. Událost
Triggeredvýzvy se spustí na serveru s tímto hráčem. - DoorService hráče zkontroluje: je naživu, dost blízko, nespamuje výzvu a nese klíč, pokud ho dveře vyžadují.
- Skript tweenuje číslo od 0 (zavřeno) do 1 (otevřeno). Při každé změně čísla posune dveře přes
PivotToo tuto část cesty od zavřené polohy k otevřené. - Čtyři sekundy po úplném otevření se dveře stejným způsobem zavřou. Stisk během pohybu dveře otočí zpět od místa, kde právě jsou.
| Prvek | Kde je | Co dělá |
|---|---|---|
Script DoorService | ServerScriptService | Najde všechny dveře, každým přidá výzvu, kontroluje každé použití a hýbe dveřmi. Jediný skript v tomto návodu. |
Tag Door | Na každém Part nebo Model dveří | Označuje, co jsou dveře. Tagy se přidávají v okně Properties a ukládají se spolu s place. |
Atributy, například Style a KeyName | Na každých dveřích (volitelné) | Nastavení jedněch dveří: otočné nebo posuvné, úhel, rychlost, automatické zavření a klíč. |
ProximityPrompt DoorPrompt | Uvnitř dveří (přidává ho DoorService) | Ukazuje "Open" nebo "Close" a spustí Triggered, když hráč drží E. |
NumberValue DoorProgress | Uvnitř dveří (přidává ho DoorService) | Číslo, které tween posouvá mezi 0 a 1. Každá změna pohne dveřmi. |
Tool RedKey (volitelné) | StarterPack, pro testy | Klíč k zamčeným dveřím. Poslouží jakýkoli Tool, pokud jeho název odpovídá KeyName dveří. |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
Krok 1: postavte dveře a nastavte pant
- V Exploreru najeďte myší na Workspace, klikněte na tlačítko + a vložte Part. Pojmenujte ho
FrontDoor, nastavteSizezhruba na4, 7, 0.5(4 study na šířku, 7 na výšku, půl studu na tloušťku) a postavte ho do dveřního otvoru. Poslouží i dveře z několika partů: vyberte je a stiskněte Ctrl+G, aby se seskupily do Modelu. - U každého partu dveří zaškrtněte Anchored a CanCollide nechte zapnuté. Ukotvené party se nikdy nepohnou gravitací ani kolizemi, ale skript s nimi pohnout může, a právě to dělá DoorService.
- Nastavte pant. Vyberte dveře, otevřete kartu Model a zapněte Pivot. Klikněte a podržte malou šipku v rohu tlačítka Pivot a zaškrtněte Snap, aby se pivot přichytával k opěrným bodům v rozích, na hranách a ve středech. Přetáhněte pivot na ten okraj dveří, kde by byly panty. U posuvných dveří může pivot zůstat uprostřed.
- Přidejte tag. Dveře nechte vybrané, posuňte okno Properties na Tags, klikněte na + a zadejte
Doors velkým D. Pokud jsou dveře Model, dejte tag na samotný Model, ne na party uvnitř. - Postavte druhé dveře, budou potřeba v částech o posuvných dveřích a o klíči. Vložte do Workspace další dva Party:
Panelo velikosti zhruba4, 7, 0.5aKnobzhruba0.5, 0.5, 0.5, přiložený k jedné ze stěn Panel. Vyberte oba, stiskněte Ctrl+G a nový Model přejmenujte naVaultDoor. Oba party ukotvěte, model postavte do druhého otvoru a přidejte tagDoorna Model. Jeho pivot může zůstat uprostřed, protože tyto dveře budou posuvné.
Pivot je důležitý, protože otočné dveře se kolem něj otáčejí. Pokud ho necháte uprostřed, dveře se budou točit na místě jako otáčivé dveře v obchodě. U partu se vámi nastavený pivot uloží jako PivotOffset a GetPivot s ním počítá, takže skript otáčí dveře přesně kolem bodu, který jste vybrali. Pokud má Model PrimaryPart, je pivot modelu pivotem tohoto partu a DoorService na něj dá i výzvu. Bez PrimaryPart se výzva dostane na první part nalezený uvnitř modelu. Pokud PrimaryPart nastavujete, udělejte to dřív, než pivot posunete: přiřazení PrimaryPart přesune pivot modelu na pivot tohoto partu, jak uvádí stránka Robloxu o Pivot tools.
Nastavení dveří (atributy)
Jakékoli dveře fungují s výchozími hodnotami z tabulky níže. Chcete-li změnit jedny dveře, vyberte je, posuňte okno Properties na Attributes, klikněte na +, zadejte název, vyberte typ a klikněte na Save, pak nastavte hodnotu. DoorService čte atributy jednou, když dveře nastavuje, proto je měňte, když hra neběží.
| Atribut | Typ | Výchozí | Co dělá |
|---|---|---|---|
Style | string | Swing | Swing otáčí dveře kolem jejich pivotu. Slide je posouvá do strany podél šířky. |
OpenAngle | number | 90 | O kolik stupňů se otočné dveře otočí. Záporné číslo je otevře na druhou stranu. Hodnotu držte mezi -179 a 179: dveře jdou vždy po kratším oblouku, proto DoorService úhel omezuje na tyto meze. |
SlideDistance | number | jejich šířka | O kolik studů posuvné dveře popojedou podél své šířky. Záporné číslo je posune na druhou stranu. |
OpenSeconds | number | 0.6 | Jak dlouho trvá úplné otevření nebo zavření, v rozmezí od 0.05 do 10. |
AutoCloseSeconds | number | 4 | Jak dlouho dveře stojí úplně otevřené, než se samy zavřou. 0 je nechá otevřené, dokud je někdo nezavře. |
KeyName | string | žádný | Název Toolu, který hráč musí mít, aby dveře otevřel, například RedKey. Nenastavujte ho u dveří, které může otevřít kdokoli. |
Krok 2: přidejte skript dveří
Najeďte myší na ServerScriptService, vložte Script s názvem DoorService a vložte do něj kód níže. Řídí všechny dveře v place, ať jich tagem označíte kolik chcete. Tři nastavení na začátku platí pro všechny dveře; atributy z kroku 1 mění jedny dveře.
-- Script v ServerScriptService s názvem DoorService.
-- Otevírá a zavírá každý Part nebo Model s tagem "Door" výzvou s podržením E.
-- Dveřmi hýbe server, takže všichni hráči vidí stejné dveře, a server také
-- kontroluje vzdálenost a klíč, takže nikdo neotevře zamčené dveře z dálky.
--
-- Volitelné atributy na každých dveřích (nastavují se v okně Properties):
-- Style string "Swing" (výchozí) nebo "Slide"
-- OpenAngle number o kolik stupňů se otočné dveře otočí kolem pivotu (výchozí 90, od -179 do 179)
-- SlideDistance number o kolik studů posuvné dveře popojedou podél své šířky (výchozí: jejich šířka)
-- OpenSeconds number jak dlouho trvá otevření (výchozí 0.6)
-- AutoCloseSeconds number znovu zavřít po tolika sekundách; 0 je nechá otevřené (výchozí 4)
-- KeyName string název Toolu, který hráč musí mít, například "RedKey"
local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")
local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- study
local MIN_SECONDS_BETWEEN_USES = 0.3 -- na každé dveře, proti spamování výzvy
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 nebo nekonečno zadané v okně 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 -- už funkční dveře, nebo to není part ani model
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)
-- Kopie funkčních dveří s sebou přinese starou výzvu a hodnotu: smažeme je
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- Zavřenou a otevřenou polohu spočítáme jednou, od místa, kde dveře stojí teď
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- Jedeme podél delší vodorovné strany dveří, jejich šířky. Model se měří podél
-- stran svého pivotu, Part podle vlastního Size, proto neotáčejte pivot posuvného partu
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 vždy otáčí po kratším oblouku, takže větší úhel by dveře otevřel špatným směrem
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", "")
-- Tweenujeme číslo od 0 (zavřeno) do 1 (otevřeno) a dveře posouváme za ním.
-- PivotTo posune jeden part nebo celý model kolem jeho pivotu.
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) -- tohle mohou číst jiné skripty
prompt.ActionText = if open then "Close" else "Open"
-- Nový tween na stejné hodnotě zruší ten starý, takže dveře se mohou v půli otočit zpět.
-- Čas škálujeme podle toho, kolik jim ještě zbývá ujet.
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
-- Návod Robloxu k bezpečnosti říká, že výzvy lze zneužít stejně jako remoty, proto tu kontrolujeme znovu
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 -- příliš daleko na to, aby výzvu použil poctivě
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- zamčeno a tento hráč nemá klíč
end
lastUse = now
move(not isOpen)
end)
end
-- Všechny dveře s tagem teď a všechny, které tag dostanou později (včetně dveří naklonovaných skripty)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
DoorService při spuštění hry sám přidá DoorPrompt a DoorProgress do každých dveří, takže ručně nic vkládat nemusíte. Mějte jednu kopii skriptu: už obsluhuje všechny dveře s tagem.
| Část skriptu | Co dělá | Proč |
|---|---|---|
attribute() | Přečte jeden atribut a vrátí výchozí hodnotu, pokud atribut chybí, má špatný typ nebo to není skutečné číslo (NaN nebo nekonečno). | Překlep v okně Properties dá dveře s výchozím nastavením, ne rozbité dveře. |
doorsSetUp a smyčka přes leftover | Nastaví každé dveře jednou a nejdřív smaže DoorPrompt nebo DoorProgress zkopírované z jiných dveří. | Jinak by kopie funkčních dveří měla dvě výzvy a jedna z nich by nefungovala. |
closedPivot a openPivot | Spočítají se jednou, od místa, kde dveře stojí v okamžiku nastavení. Otočné dveře otáčejí pivot kolem jeho vlastní svislé osy; posuvné ho posouvají podél delší strany dveří. | Lerp od zavřeného pivotu k otevřenému nechá pivot na místě, zatímco se dveře otáčejí, takže okraj s panty se po celé otočení nepohne. |
DoorProgress a PivotTo | Tween mění číslo; každá změna postaví dveře do closedPivot:Lerp(openPivot, alpha). | TweenService umí tweenovat NumberValue a PivotTo posune part nebo model se všemi jeho party tak, aby pivot skončil na tomto CFrame. |
| Výzva | HoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight vypnuté. Zamčené dveře ukazují "Needs RedKey". | Se zapnutou přímou viditelností se výzva schová, když něco zakryje její part; bez ní výzvu nezakryje rám ani ostatní části dveří typu model. |
move() | Spustí tween k 1 nebo k 0 a čas škáluje podle toho, kolik dveřím ještě zbývá ujet. | Nový tween na stejné hodnotě zruší ten starý, takže dveře otočené v půli plynule jedou zpět a stráví tím polovinu času. |
| Automatické zavření | Počká dobu otevření plus AutoCloseSeconds a pak dveře zavře, jen pokud se moveCount nezměnil. | Starý časovač nikdy nezabouchne dveře, které mezitím někdo zavřel a znovu otevřel. |
Kontroly v Triggered | Jedno použití dveří jednou za 0.3 sekundy, živá postava, nejvýš 14 studů od partu s výzvou a klíč, ale jen pro otevření. | Všechno, co může spustit klient, se dá zneužít, proto server kontroly opakuje. 14 studů je 8 studů výzvy plus 6 rezervy pro hráče, který se pohnul, zatímco držel E. |
Atribut Open | Nastavuje se na dveřích při každém pohybu. | Atributy nastavené na serveru se replikují všem hráčům, takže jiné skripty, včetně LocalScriptu, ho mohou poslouchat přes GetAttributeChangedSignal("Open"). |
Označovat všechny dveře tagem a řídit je z jednoho skriptu je přístup, který doporučuje sám Roblox: referenční příručka k CollectionService uvádí, že pokud přidáváte stejný skript do mnoha objektů, skript na CollectionService může být lepší. GetTagged vrací dveře, které existují při spuštění skriptu, a GetInstanceAddedSignal zachytí dveře označené nebo přidané později. Tento způsob organizace place rozebírá návod ke klientským a serverovým skriptům.
Jak udělat posuvné dveře
Vyberte VaultDoor, přidejte atribut typu string s názvem Style a nastavte hodnotu Slide. Teď se dveře neotáčejí, ale jedou do strany: o vlastní šířku nebo o SlideDistance studů, pokud jste ho nastavili. Aby jely na druhou stranu, nastavte zápornou vzdálenost, například -4 u dveří širokých 4 study. Jakékoli jiné dveře, včetně FrontDoor, se stanou posuvnými stejně, jakmile dostanou tento atribut.
DoorService změří dva vodorovné rozměry dveří, šířku a tloušťku, a posouvá je podél většího. Model měří přes GetExtentsSize, jehož kvádr sleduje orientaci pivotu modelu, takže dveře otočené po seskupení o 90 stupňů stejně jedou podél šířky, ne tloušťky. Part měří podle vlastního Size partu, proto neotáčejte pivot posuvného partu. Posouvat tento pivot můžete.
- Dvojité dveře: dvě poloviny s tagem vedle sebe, obě mají
StyleSlide a jedna zápornýSlideDistance, aby se rozjížděly od středu. U otočných dvojitých dveří dejte pivot každé poloviny na její vnější okraj a jedné polovině nastavte zápornýOpenAngle. Každá polovina má vlastní výzvu a otevírá se zvlášť. Pokud poloviny jedou proti sobě, přesuňte minus na druhou polovinu. - Vrata, která jedou nahoru: tento skript posouvá dveře jen podél šířky. Aby dveře stoupaly, nastavte ve skriptu
directionnaVector3.yAxis(pak pojedou nahoru všechny posuvné dveře) a dejte každýmSlideDistancerovný jejich výšce. - Dveře na fyzice: tutoriál Robloxu o pohyblivých objektech posouvá party podél jedné osy přes PrismaticConstraint. Stejně jako dveře na pantu je to fyzika, bez výzvy a zámku, dokud je sami nenapíšete.
Jak zamknout dveře na klíč
Zamčené dveře se otevřou jen hráči, který má Tool se správným názvem. Udělejte klíč a pak dveřím řekněte jeho název:
- Najeďte myší na StarterPack, klikněte na + a vložte Tool s názvem
RedKey. Vložte do něj jeden Part s názvemHandle, to je part, který postava drží v ruce, a ověřte, že není ukotvený: ukotvený part v nástroji přikove postavu na místo. U Toolu odškrtněteCanBeDropped, pokud hráči nemají klíč zahazovat pro někoho jiného: dokud je zaškrtnuté, Backspace vyhodí vybavený nástroj do Workspace. - Vyberte VaultDoor, přidejte atribut typu string s názvem
KeyNamea nastavte hodnotuRedKey. Teď je v názvu objektu na výzvě Needs RedKey.
DoorService hledá klíč na dvou místech. Tool leží v Backpacku hráče, dokud ho nevybaví, a vybavení ho přesune do postavy, takže dveře se otevřou, ať je klíč v hotbaru, nebo v ruce. Kontrola probíhá na serveru, protože návod Robloxu k bezpečnosti uvádí právě tento případ, jestli má hráč klíč ke dveřím, jako oprávnění, které musí kontrolovat server. Klíč je potřeba jen k otevření: otevřené dveře může zavřít kdokoli a samy se zavřou po AutoCloseSeconds.
StarterPack dává klíč všem při každém spawnu, a pro testy je to přesně to pravé. Ve skutečné hře ho vydávejte jinak:
- Z obchodu: návod ke GUI obchodu vydá Tool ze ServerStorage do Backpacku a StarterGear kupujícího.
- Od postavy: návod k dialogům s NPC vydá Tool ze
ServerStorage.DialogueItems, když hráč vybere možnost s akcíGiveItem. Dejte do této složky Tool s názvem RedKey a nastavte možnosti v DialogueDataaction = "GiveItem"aitem = "RedKey"a klíč se bude vydávat v rozhovoru. - Jako předmět inventáře: se systémem inventáře předmět klíče funguje, jakmile ho hráč vybaví, protože vybavení dá kopii jeho Toolu do Backpacku a do ruky.
Klíč v Backpacku se ztratí, když postava zemře, protože Roblox při každém spawnu znovu naplní Backpack ze StarterPack a StarterGear. Chcete-li ho zachovat, dejte kopii i do StarterGear hráče, jak to dělá návod k obchodu. Pokud se má klíč naopak spotřebovat, najděte Tool klíče v Backpacku nebo v postavě hráče a zničte ho v handleru Triggered, hned po úspěšné kontrole klíče.
V čem se starší tutoriály ke dveřím mýlí
Pokud tento návod porovnáváte s videem nebo příspěvkem na fóru, tady jsou postupy, kvůli kterým vzniká většina vláken „nefungují mi dveře“, a co tento návod dělá místo nich.
| Tutoriál | Problém | Tento návod |
|---|---|---|
Tweenuje CFrame dveří typu Model | Referenční příručka k Modelu nemá vlastnost CFrame ani Position. Jeho WorldPivot určuje jen místo pivotu modelu, takže jeho tween posune bod pivotu a party zůstanou na místě. | Tweenuje NumberValue a celý model posouvá přes PivotTo. |
Posouvá model přes SetPrimaryPartCFrame | Zastaralé: Roblox radí v nových projektech používat PivotTo. | Používá PivotTo, který Roblox označuje za hlavní funkci pro přesun Modelu ze skriptů. |
| Přivaří všechny party k jednomu partu pantu a tweenuje jen pant | Funguje, když jsou všechny Weld na místě, ale každý nepřivařený part zůstane pozadu, když se pant pohne. | Drží všechny party ukotvené, bez Weld. PivotTo posune dveře a všechno v nich. |
| Kopíruje stejný skript do každých dveří | Každou opravu je potřeba zopakovat v každé kopii. Roblox navrhuje objekty označovat tagy a zpracovávat je jedním skriptem přes CollectionService. | Jeden DoorService a tag Door. |
| Otevírá dveře v LocalScriptu | Dveře se otevřou jen na obrazovce tohoto hráče a všichni ostatní je pořád vidí zavřené. | Dveřmi hýbe server, takže všichni hráči vidí stejné dveře. |
Otevírá dveře přes Touched | Touched se při jednom dotyku spustí několikrát za sebou (stránka Robloxu o debounce) a zařízení hráče může ovlivnit, kdy se Touched pro jeho vlastní postavu spustí (dokumentace Robloxu k bezpečnosti). | Výzva, kterou kontroluje server. |
Posouvá dveře po krocích ve smyčce s wait() | Roblox označuje wait() jako nahrazený task.wait() a smyčka se nedokáže v půli otočit, když někdo stiskne znovu. | Jeden tween na pohyb. Nový tween na stejné hodnotě zruší ten starý, takže dveře se otočí zpět z místa, kde jsou. |
| Kontroluje klíč v LocalScriptu, nebo vůbec | Podvodník ovládá všechno na svém zařízení, takže kontrola na klientu nikoho nezastaví. | Server hledá Tool v Backpacku a v postavě hráče. |
| Výzva nemá cooldown | Návod Robloxu k bezpečnosti říká, že výzvy jsou vůči zneužití stejně zranitelné jako remoty, takže nic nebrání ji spouštět znovu a znovu. | Jedno použití dveří jednou za 0.3 sekundy. |
Co podvodník může a co ne
Počítejte s tím, že podvodník ovládá všechno na svém zařízení, včetně své postavy. Tady je, co to znamená pro tyto dveře.
| Podvodník zkouší | Výsledek | Proč |
|---|---|---|
| Spustit výzvu z druhého konce mapy | Ignoruje se, pokud jeho postava není u dveří | DoorService měří vzdálenost od kořenového partu postavy k partu s výzvou a ignoruje všechno dál než 14 studů. Podvodník může postavu nejdřív teleportovat ke dveřím (viz poslední řádek), takže kontrola vzdálenosti chrání před použitím z dálky, ne před teleportem. |
| Spouštět ji mnohokrát za sekundu | Nejvýš jedno použití dveří jednou za 0.3 sekundy | Server si pamatuje čas posledního použití každých dveří. |
| Otevřít dveře s klíčem bez klíče | Odmítnuto | Server hledá Tool v jeho Backpacku a postavě tam, kde je vidí sám, ne na obrazovce podvodníka. |
| Použít dveře, když je postava mrtvá | Ignoruje se | DoorService ověří, že existuje Humanoid se zdravím nad 0 a kořenový part. |
| Projít zavřenými dveřmi přesto | Možné | Dokumentace Robloxu k bezpečnosti uvádí obcházení fyzických překážek a změnu vlastních kolizí mezi tím, co klient se svou postavou může dělat. |
| Teleportovat se za dveře | Možné | Stejná dokumentace zmiňuje teleportaci vlastní postavy kamkoli. |
Krok 3: otestujte
- Klikněte na Play (F5). Přijděte k FrontDoor: do 8 studů se objeví výzva s akcí Open a názvem objektu Door. Držte E. Po 0.2 sekundy se dveře otevřou o 90 stupňů kolem okraje s panty za 0.6 sekundy a na výzvě je teď Close.
- Projděte dveřmi a počkejte. Čtyři sekundy po úplném otevření se dveře samy zavřou. Držte E, zatímco se zavírají: otočí se a otevřou od místa, kde byly.
- Otestujte zámek. Pokud je RedKey ve StarterPack, přesuňte ho zatím do ServerStorage, klikněte na Play a držte E u VaultDoor: na výzvě je Needs RedKey a nic se nepohne. Zastavte hru, vraťte RedKey do StarterPack a spusťte znovu: VaultDoor se otevře, ať je klíč v hotbaru, nebo v ruce.
- Otestujte posuvné dveře. VaultDoor, Model se
StyleSlide, při otevření jede do strany o svou šířku. Zastavte hru, vyberte VaultDoor, otočte ho nástrojem Rotate o 90 stupňů a spusťte znovu: pořád má jet podél šířky, ne tloušťky. Až skončíte, otočte ho zpět. - V rozbalovacím seznamu režimů testu vyberte Server & Clients, nastavte 2 klienty a klikněte na Play. Otevřete dveře v okně jednoho klienta: jsou otevřené i v druhém okně a zavřou se v obou.
- Zastavte hru, vyberte dveře a stiskněte Ctrl+D, abyste udělali duplikát, pak kopii přesuňte do jiného otvoru. Ověřte, že kopie má v Tags pořád Door, a klikněte na Play: kopie funguje bez dalšího skriptu.
Mějte okno Output otevřené (menu Window, pak Output). Když vše funguje, DoorService nic nevypisuje. Varování, že dveře "has no part to put the prompt on", znamená, že uvnitř Modelu s tagem nejsou žádné party. Zbytek najdete v části Časté chyby.
Jak systém rozšířit
Automatické dveře
Aby se dveře otevřely, když někdo přijde, volejte move(true) zevnitř setUpDoor, bez čekání na výzvu. Na konci setUpDoor spusťte smyčku přes task.spawn, protože obyčejná smyčka by tam nikdy neskončila a DoorService by se nedostal dál než k prvním dveřím. Ať běží, jen dokud jsou dveře ve hře: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Uvnitř smyčky kontrolujte přes workspace:GetPartBoundsInBox, jestli je v kvádru kolem otvoru postava, a volejte move(true), když tam je a dveře jsou zavřené. Pak je jako dřív zavře automatické zavření. Nastavte výzvě Enabled na false, pokud se mají dveře otevírat jen samy.
VIP dveře
Návod ke gamepassům už staví VIP dveře, kterými majitelé passu procházejí přímo, na kolizních skupinách. Pro VIP dveře, které se otevírají na E, přidejte do handleru Triggered vedle kontroly klíče další kontrolu: udělejte return, pokud neplatí player:GetAttribute("OwnsPass_VIP") == true, což je atribut, který nastavuje serverový skript z návodu ke gamepassům. Čtěte ho jen na serveru.
Číselník s kódem
U dveří, které se otevírají zadaným kódem, ukládejte kód v serverovém Scriptu nebo ve ServerStorage, které hráči nikdy nedostanou, a v žádném případě ne v LocalScriptu, kde ho podvodník může přečíst. LocalScript číselníku posílá přes RemoteEvent jen zadané číslice. Na serveru ověřte, že je hráč u dveří, omezte četnost pokusů, porovnejte číslice a teprve pak zavolejte move(true). Návod k RemoteEvent ukazuje, jak kontrolovat, co remote dostává.
Zvuky
Dejte Sound do partu dveří, aby zněl z pozice tohoto partu, a volejte jeho metodu Play na začátku move. Nebo ho přehrávejte z LocalScriptu, který poslouchá atribut Open dveří přes GetAttributeChangedSignal("Open"), protože server tento atribut nastavuje při každém pohybu.
Dveře přidané během hry
Nové dveře klonujte ze zavřené šablony ve ServerStorage. DoorService si zavřenou polohu dveří přečte v okamžiku, kdy se objeví, takže kopie dveří, které byly v tu chvíli otevřené, by svou otevřenou polohu považovala za zavřenou. Kopii postavte do otvoru přes PivotTo dřív, než jí nastavíte Parent na Workspace, aby si DoorService toto místo zapamatoval jako zavřené. Staré výzvy a hodnoty, které přišly s kopií, se smažou automaticky. O dveřích, které přenášejí hráče do jiné oblasti nebo jiného place, si přečtěte v návodu k teleportům.
Časté chyby a řešení
Otevřete okno Output (menu Window, pak Output) před kliknutím na Play. Většina problémů s dveřmi vzniká kvůli tagu, pivotu nebo atributu, které nejsou přesně takové, jaké skript čeká.
U dveří se neobjeví výzva
Zkontrolujte popořadě: DoorService je Script, ne LocalScript, a leží přímo v ServerScriptService; dveře mají tag Door s velkým D, u dveří typu model na samotném Modelu; dveře jsou part (Part, MeshPart nebo jiný BasePart) nebo Model; a stojíte nejvýš 8 studů od partu, na kterém visí výzva. Varování v Output, že dveře "has no part to put the prompt on", znamená, že uvnitř Modelu s tagem nejsou žádné party.
Dveře při spuštění hry padají, odplouvají nebo se dají tlačit
Některý jejich part není ukotvený. Vyberte všechny party dveří a zaškrtněte Anchored. Ukotvené party se fyzikou nikdy nepohnou, ale DoorService s nimi pohnout stejně může.
Změnil jsem atribut, ale dveře ho ignorují
Zkontrolujte tři věci. Typ: OpenAngle, SlideDistance, OpenSeconds a AutoCloseSeconds musí být atributy typu number a Style a KeyName typu string; při špatném typu DoorService vezme výchozí hodnotu. Pravopis: názvy se porovnávají přesně, takže openAngle je jiný atribut. Hodnoty se porovnávají také přesně: Style musí být Slide s velkým S a bez mezer. Okamžik: DoorService čte atributy jednou, když dveře nastavuje, takže změna během playtestu nic neudělá, dokud hru nespustíte znovu.
Dveře se otevírají na špatnou stranu nebo se překlápějí na bok
Aby se otevíraly na druhou stranu, udělejte OpenAngle záporný, například -90. Pokud se otáčejí kolem vodorovné osy místo svislého pantu, je otočený samotný pivot: zapněte Pivot na kartě Model a otočte pivot zpět, aby stál svisle.
Posuvné dveře zajedou do zdi nebo se posunou jen kousek
Nastavte jim záporný SlideDistance, aby jely na druhou stranu. Pokud se posunou moc málo nebo moc daleko, nastavte do SlideDistance požadovaný počet studů a nespoléhejte na změřenou šířku.
Mám klíč, ale dveře se neotevřou
Klíč musí být Tool, ne Part ani Model, a jeho název musí přesně odpovídat KeyName, včetně velkých písmen. Musí ležet ve vašem Backpacku, nebo být v ruce. Ověřte také, že KeyName na dveřích je atribut typu string.
Udělat s RoCode
Pokud se vám nechce nastavovat to všechno ručně, RoCode to může postavit ve vašem otevřeném place. RoCode je nezávislý AI agent pro Roblox Studio, ne od Robloxu: změnu popíšete ve webovém chatu a jeho plugin pro Studio vytvoří skripty a objekty ve vašem Exploreru, takže vkládat kód nemusíte.
Udělej, aby se dveře s tagem Door otevíraly výzvou s podržením E: otočení o 90 stupňů kolem pivotu za 0.6 sekundy, zavření po 4 sekundách, posun místo otočení, když je atribut Style rovný Slide, a dveře zůstanou zavřené, pokud hráč nemá Tool s názvem z KeyName. Všechno na serveru, s kontrolou vzdálenosti.
- Může si prohlédnout váš place, když to krok potřebuje, přes Search Game a Search Scripts, aby navázal na předměty, remoty nebo kód ukládání, které už máte, a nepřidával druhý systém
- Napíše Script v ServerScriptService přes Create Script, může vytvořit part dveří přes Create Instance a nastavit na něm atributy jako Style a KeyName
- Má za úkol ověřit kompilaci každého napsaného skriptu přes Check Script, který ho ve Studiu zkompiluje bez spuštění
- Před každou dávkou změn i po ní vytvoří bod pro vrácení, takže Ctrl+Z vrací po jedné dávce
Před testem zkontrolujte pivot každých dveří nástrojem Pivot ve Studiu: dveře se kolem něj otáčejí. S pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby a s pluginem 3.9.15 nebo novějším může ovládat testovací postavu, která chodí a mačká klávesy, ale kontroluje jen to, co se sám rozhodl otestovat, proto ke každým dveřím přijděte a držte E sami. Jak se RoCode připojuje ke Studiu.
Časté otázky
Jak udělat, aby se dveře v Roblox Studiu otevíraly na E?
Dejte do dveří ProximityPrompt a jeho událost Triggered připojte v serverovém Scriptu, který dveřmi hýbe. DoorService dělá obojí pro všechny dveře s tagem Door. E je výchozí klávesa výzvy a Roblox ukazuje správný vstup pro klávesnice, gamepady i dotykové obrazovky.
Proč se moje dveře točí kolem svého středu?
Jejich pivot je pořád uprostřed. Zapněte Pivot na kartě Model a přetáhněte pivot na okraj s panty; skript otáčí dveře kolem pivotu.
Jak udělat posuvné dveře?
Nastavte atribut dveří Style na hodnotu Slide. Pojedou do strany o svou šířku nebo o SlideDistance studů; záporná vzdálenost je posune na druhou stranu.
Dají se dveře udělat bez skriptů?
Ano. Tutoriál Robloxu o dveřích na pantu připevní neukotvené dveře k rámu přes HingeConstraint s omezeními a hráči je otevírají tlačením tělem. Takové dveře nemají výzvu, zámek ani automatické zavření.
Jak udělat dveře, které otevřou jen VIP?
Vezměte VIP dveře z návodu ke gamepassům, kterými procházejí majitelé passu, nebo přidejte do handleru Triggered v DoorService kontrolu, která před otevřením na serveru přečte, jestli hráč pass vlastní, například atribut OwnsPass_VIP, který ten návod nastavuje.
Proč se dveře otevírají mně, ale ne ostatním hráčům?
Otevírá je LocalScript a změna provedená LocalScriptem zůstává na zařízení tohoto hráče. Přesuňte kód otevírání do serverového Scriptu, jako v DoorService, aby se změna dostala ke všem.
Zdroje a další čtení
- Roblox Creator Docs: PVInstance:PivotTo (anglicky). přesun partu nebo celého modelu za jeho pivot
- Roblox Creator Docs: Pivot tools (anglicky). přesun pivotu, Snap a opěrné body, pivot při existenci PrimaryPart
- Roblox Creator Docs: Model (anglicky). WorldPivot, GetExtentsSize sleduje pivot, SetPrimaryPartCFrame je zastaralý
- Roblox Creator Docs: CFrame:Lerp (anglicky). otočení se interpoluje po nejkratším oblouku
- Roblox Creator Docs: TweenService (anglicky). co se dá tweenovat a jak druhý tween na stejné vlastnosti zruší první
- Roblox Creator Docs: Proximity prompts (anglicky). vytvoření a nastavení výzev, vstup na každém zařízení a přímá viditelnost
- Roblox Creator Docs: ProximityPrompt (anglicky). výchozí klávesa a tlačítko, HoldDuration, MaxActivationDistance a Triggered
- Roblox Creator Docs: CollectionService (anglicky). tagy, GetTagged a GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (anglicky). přidávání tagů a atributů ve Studiu
- Roblox Creator Docs: Securing the client-server boundary (anglicky). ProximityPrompt jako plocha útoku a kontrola oprávnění „klíč a dveře“
- Roblox Creator Docs: Network ownership, movement validation, and physics (anglicky). co klient může dělat se svou postavou
- Roblox Creator Docs: Build a hinged door (anglicky). dveře na HingeConstraint bez kódu
- Roblox Creator Docs: In-game tools (anglicky). Handle, ukotvení a StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (anglicky). co Backspace udělá s vybaveným nástrojem
Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.