Sa madaling salita
Buuin ang pinto bilang Part o Model, i-check ang Anchored, ilipat ang pivot nito sa gilid na may bisagra (tab na Model, Pivot) at magdagdag ng tag na Door sa Properties window. Isang Script sa ServerScriptService ang naghahanap ng lahat ng pintong may tag gamit ang CollectionService, nagdadagdag ng ProximityPrompt ("Open", hold E) at sa event na Triggered, nagtu-tween ng NumberValue mula 0 hanggang 1, ginagalaw ang pinto gamit ang door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Ang mga attribute sa bawat pinto ang nagtatakda kung swing o sliding ito, ang anggulo, ang oras, ang auto-close at ang susi.
- Hindi direktang mate-tween ang posisyon ng Model: walang property na CFrame o Position ang Model, at ang
WorldPivotnito ay lugar lang ng pivot ang itinatakda. Mag-tween ng NumberValue at galawin ang pinto gamit angPivotTo: ito ang tinatawag ng Roblox na pangunahing paraan para galawin ang mga model mula sa script. - Buksan ang mga pinto sa server. Ang pintong binuksan mula sa LocalScript ay gumagalaw lang sa screen ng player na iyon.
- I-check ang susi at distansya sa server. Sinasabi ng security guide ng Roblox na puwedeng abusuhin ang ProximityPrompt gaya ng RemoteEvent, at may halimbawa doon ng check na dapat gawin ng server: kung may susi ba ang player na kailangan para buksan ang pinto.
Sa page na ito
Paano gumagana ang pintong may script
Ang pintong gumagana sa totoong game ay dapat galawin ng server. Kung LocalScript ang gagalaw dito, bubukas ang pinto sa screen ng isang player at mananatiling sarado para sa lahat ng iba, dahil ang pagbabagong ginawa ng client ay nananatili sa device na iyon (tingnan ang ano ang nire-replicate at ano ang hindi). Kaya sa guide na ito, ipinapakita lang ng device ng player ang prompt at ipinapaalam ang pagpindot ng key, at isang server Script ang gumagawa ng lahat ng iba. Ganito ang isang paggamit ng pinto:
- Lumapit ang player sa pinto nang mas malapit sa 8 studs, at lumabas ang prompt na may action na Open, pangalan ng object na Door at ang key na E sa keyboard. Sa gamepad o touchscreen, ipinapakita ng Roblox ang tamang button.
- Nag-hold ang player ng E nang 0.2 segundo. Nagpa-fire ang
Triggeredevent ng prompt sa server kasama ang player na iyon. - Chine-check ng DoorService ang player: buhay, sapat na malapit, hindi nagi-spam ng prompt at may dalang susi kung kailangan ito ng pinto.
- Nagtu-tween ang script ng number mula 0 (sarado) hanggang 1 (bukas). Sa bawat pagbabago ng number, ginagamit nito ang
PivotTopara ilipat ang pinto sa ganoong bahagi ng daan mula sa saradong posisyon papunta sa bukas. - Apat na segundo pagkatapos ganap na bumukas, sumasara ang pinto sa parehong paraan. Ang pagpindot habang gumagalaw ay nagpapabalik sa pinto mula sa kinaroroonan nito.
| Bahagi | Nasaan ito | Ano ang ginagawa |
|---|---|---|
Script DoorService | ServerScriptService | Hinahanap ang lahat ng pinto, binibigyan ng prompt ang bawat isa, chine-check ang bawat paggamit at ginagalaw ang pinto. Ang nag-iisang script sa guide na ito. |
Tag na Door | Sa bawat Part o Model ng pinto | Minamarkahan kung ano ang pinto. Idinadagdag ang tags sa Properties window at sine-save kasama ng place. |
Mga attribute, halimbawa Style at KeyName | Sa bawat pinto (optional) | Mga setting ng isang pinto: swing o sliding, anggulo, bilis, auto-close at susi. |
ProximityPrompt DoorPrompt | Sa loob ng pinto (idinadagdag ng DoorService) | Ipinapakita ang "Open" o "Close" at pina-fire ang Triggered kapag nag-hold ng E ang player. |
NumberValue DoorProgress | Sa loob ng pinto (idinadagdag ng DoorService) | Ang number na ginagalaw ng tween sa pagitan ng 0 at 1. Bawat pagbabago ay gumagalaw sa pinto. |
Tool RedKey (optional) | StarterPack, para sa test | Susi para sa nakakandadong pinto. Puwede ang kahit anong Tool basta tugma ang pangalan nito sa KeyName ng pinto. |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
Hakbang 1: buuin ang pinto at itakda ang bisagra
- Sa Explorer, i-hover ang Workspace, pindutin ang + button at mag-insert ng Part. Pangalanan itong
FrontDoor, i-set angSizesa mga4, 7, 0.5(4 studs ang lapad, 7 ang taas, kalahating stud ang kapal) at ilagay ito sa doorway. Puwede rin ang pintong gawa sa maraming part: piliin sila at pindutin ang Ctrl+G para i-group sila bilang Model. - I-check ang Anchored sa bawat part ng pinto at iwanang naka-on ang CanCollide. Hindi kailanman gumagalaw ang mga naka-anchor na part dahil sa gravity o banggaan, pero kaya pa rin silang galawin ng script, at iyon mismo ang ginagawa ng DoorService.
- Itakda ang bisagra. Piliin ang pinto, buksan ang tab na Model at i-on ang Pivot. Pindutin at i-hold ang maliit na arrow sa sulok ng Pivot button at i-check ang Snap, para dumikit ang pivot sa mga reference point sa mga sulok, gilid at gitna. I-drag ang pivot sa gilid ng pinto kung saan dapat ang bisagra. Sa sliding door, puwedeng manatili sa gitna ang pivot.
- Magdagdag ng tag. Habang naka-select pa rin ang pinto, i-scroll ang Properties window hanggang Tags, pindutin ang + at i-type ang
Doorna malaki ang D. Kung Model ang pinto, ilagay ang tag sa Model mismo, hindi sa mga part sa loob. - Buuin ang pangalawang pinto, kakailanganin ito sa mga section tungkol sa sliding door at susi. Mag-insert ng dalawa pang Part sa Workspace:
Panelna may laking mga4, 7, 0.5atKnobna mga0.5, 0.5, 0.5, na nakadikit sa isang mukha ng Panel. Piliin ang dalawa, pindutin ang Ctrl+G at palitan ang pangalan ng bagong Model ngVaultDoor. I-anchor ang dalawang part, ilagay ang model sa pangalawang doorway at idagdag ang tag naDoorsa Model. Puwedeng manatili sa gitna ang pivot nito, dahil sliding ang pintong ito.
Mahalaga ang pivot dahil umiikot ang swing door sa paligid nito. Kung iiwan ito sa gitna, iikot ang pinto sa puwesto nito, gaya ng revolving door sa mall. Sa isang part, sine-save ang pivot na itinakda mo bilang PivotOffset, at isinasaalang-alang ito ng GetPivot, kaya pinapaikot ng script ang pinto nang eksakto sa paligid ng puntong pinili mo. Kung may PrimaryPart ang Model, ang pivot ng model ay ang pivot ng part na iyon, at doon din inilalagay ng DoorService ang prompt. Kapag walang PrimaryPart, napupunta ang prompt sa unang part na nahanap sa loob ng model. Kung magse-set ka ng PrimaryPart, gawin ito bago galawin ang pivot: ang pag-assign ng PrimaryPart ay naglilipat sa pivot ng model papunta sa pivot ng part na iyon, gaya ng nakasaad sa page ng Roblox tungkol sa Pivot tools.
Mga setting ng pinto (attributes)
Gumagana ang kahit anong pinto gamit ang mga default value sa table sa ibaba. Para baguhin ang isang pinto, piliin ito, i-scroll ang Properties window hanggang Attributes, pindutin ang +, i-type ang pangalan, piliin ang type at pindutin ang Save, saka itakda ang value. Isang beses lang binabasa ng DoorService ang mga attribute, kapag sine-set up nito ang pinto, kaya baguhin sila habang nakahinto ang game.
| Attribute | Type | Default | Ano ang ginagawa |
|---|---|---|---|
Style | string | Swing | Pinapaikot ng Swing ang pinto sa paligid ng pivot nito. Pinapadulas ito ng Slide patagilid kasama ng lapad nito. |
OpenAngle | number | 90 | Ilang degrees umiikot ang swing door. Ang negatibong number ay nagbubukas dito sa kabilang direksyon. Panatilihin ang value sa pagitan ng -179 at 179: laging dumadaan ang pinto sa maikling arko, kaya nililimitahan ng DoorService ang anggulo sa mga hangganang ito. |
SlideDistance | number | ang lapad nito | Ilang studs dumudulas ang sliding door kasama ng lapad nito. Ang negatibong number ay nagpapadulas dito sa kabilang direksyon. |
OpenSeconds | number | 0.6 | Gaano katagal ang buong pagbukas o pagsara, mula 0.05 hanggang 10. |
AutoCloseSeconds | number | 4 | Gaano katagal nananatiling bukas nang buo ang pinto bago ito kusang sumara. Ang 0 ay iniiwan itong bukas hanggang may magsara. |
KeyName | string | wala | Pangalan ng Tool na dapat hawak ng player para mabuksan ang pinto, halimbawa RedKey. Huwag itong i-set sa pintong puwedeng buksan ng kahit sino. |
Hakbang 2: idagdag ang door script
I-hover ang ServerScriptService, mag-insert ng Script na pinangalanang DoorService at i-paste dito ang code sa ibaba. Hinahawakan nito ang lahat ng pinto sa place, gaano man karami ang nilagyan mo ng tag. Ang tatlong setting sa simula ay para sa lahat ng pinto; ang mga attribute sa hakbang 1 ay nagbabago ng isang pinto.
-- Script sa ServerScriptService na pinangalanang DoorService.
-- Binubuksan at isinasara ang bawat Part o Model na may tag na "Door" gamit ang prompt na hold E.
-- Server ang gumagalaw sa pinto, kaya iisang pinto ang nakikita ng lahat ng player, at server din
-- ang nagche-check ng distansya at susi, kaya walang makakabukas ng nakakandadong pinto mula sa malayo.
--
-- Mga optional na attribute sa bawat pinto (itinatakda sa Properties window):
-- Style string "Swing" (default) o "Slide"
-- OpenAngle number ilang degrees umiikot ang swing door sa paligid ng pivot (default 90, mula -179 hanggang 179)
-- SlideDistance number ilang studs dumudulas ang sliding door kasama ng lapad nito (default: ang lapad nito)
-- OpenSeconds number gaano katagal ang pagbukas (default 0.6)
-- AutoCloseSeconds number isara ulit pagkalipas ng ganitong segundo; ang 0 ay iniiwan itong bukas (default 4)
-- KeyName string pangalan ng Tool na dapat hawak ng player, halimbawa "RedKey"
local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")
local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- studs
local MIN_SECONDS_BETWEEN_USES = 0.3 -- kada pinto, laban sa spam ng prompt
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 o infinity na tinype sa Properties window
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 -- gumaganang pinto na, o hindi ito part o 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)
-- Dala ng kopya ng gumaganang pinto ang lumang prompt at value: i-delete natin sila
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- Isang beses kinukuwenta ang sarado at bukas na posisyon, mula sa kinatatayuan ng pinto ngayon
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- Dumudulas kasama ng mas mahabang pahalang na gilid ng pinto, ang lapad nito. Sinusukat ang Model kasama ng
-- mga gilid ng pivot nito, ang Part ayon sa sarili nitong Size, kaya huwag paikutin ang pivot ng sliding part
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
-- Laging umiikot ang Lerp sa maikling arko, kaya ang mas malaking anggulo ay magbubukas sa pinto sa maling direksyon
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", "")
-- Nagtu-tween ng number mula 0 (sarado) hanggang 1 (bukas) at ginagalaw ang pinto kasunod nito.
-- Ginagalaw ng PivotTo ang isang part o buong model sa paligid ng pivot nito.
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) -- puwede itong basahin ng ibang script
prompt.ActionText = if open then "Close" else "Open"
-- Kinakansela ng bagong tween sa parehong value ang luma, kaya puwedeng bumalik ang pinto sa kalagitnaan.
-- Ini-scale ang oras ayon sa kung gaano pa kalayo ang kailangan nitong lakbayin.
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
-- Sinasabi ng security guide ng Roblox na puwedeng abusuhin ang prompts gaya ng remotes, kaya chine-check ulit natin dito
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 -- masyadong malayo para tapat na gamitin ang prompt
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- nakakandado, at walang susi ang player na ito
end
lastUse = now
move(not isOpen)
end)
end
-- Lahat ng pintong may tag ngayon at lahat ng magkakaroon ng tag mamaya (kasama ang mga pintong kinlone ng script)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
Ang DoorService mismo ang nagdadagdag ng DoorPrompt at DoorProgress sa bawat pinto kapag nagsimula ang game, kaya wala kang kailangang i-insert nang mano-mano. Isang kopya lang ng script ang panatilihin: hinahawakan na nito ang lahat ng pintong may tag.
| Bahagi ng script | Ano ang ginagawa | Bakit |
|---|---|---|
attribute() | Nagbabasa ng isang attribute at nagbabalik ng default value kung wala ang attribute, mali ang type nito o hindi ito tunay na number (NaN o infinity). | Ang typo sa Properties window ay nagbibigay ng pintong may default na setting, hindi sirang pinto. |
doorsSetUp at ang loop sa leftover | Isang beses sine-set up ang bawat pinto at dine-delete muna ang DoorPrompt o DoorProgress na nakopya mula sa ibang pinto. | Kung hindi, magkakaroon ng dalawang prompt ang kopya ng gumaganang pinto, at hindi gumagana ang isa. |
closedPivot at openPivot | Isang beses kinukuwenta, mula sa kinatatayuan ng pinto sa sandali ng setup. Ang swing door ay umiikot sa pivot sa sarili nitong vertical axis; ang sliding door ay dumudulas kasama ng mas mahabang gilid ng pinto. | Ang Lerp mula sa saradong pivot papunta sa bukas ay nagpapanatili sa pivot sa puwesto habang umiikot ang pinto, kaya hindi gumagalaw ang gilid na may bisagra sa buong pag-ikot. |
DoorProgress at PivotTo | Binabago ng tween ang number; bawat pagbabago ay inilalagay ang pinto sa closedPivot:Lerp(openPivot, alpha). | Kayang mag-tween ng TweenService ng NumberValue, at ginagalaw ng PivotTo ang part o model kasama ang lahat ng part nito para mapunta ang pivot sa CFrame na iyon. |
| Ang prompt | HoldDuration 0.2, MaxActivationDistance 8, naka-off ang RequiresLineOfSight. Ipinapakita ng nakakandadong pinto ang "Needs RedKey". | Kapag naka-on ang line of sight, nagtatago ang prompt kapag may humaharang sa part nito; kapag naka-off, hindi itinatago ng frame o ng ibang bahagi ng door model ang prompt. |
move() | Nagsisimula ng tween papunta sa 1 o sa 0, at ini-scale ang oras ayon sa kung gaano pa kalayo ang kailangang lakbayin ng pinto. | Kinakansela ng bagong tween sa parehong value ang luma, kaya ang pintong pinabalik sa kalagitnaan ay dahan-dahang bumabalik at kalahati lang ng oras ang ginagamit. |
| Auto-close | Naghihintay ng oras ng pagbukas plus AutoCloseSeconds, saka isinasara ang pinto kung hindi nagbago ang moveCount. | Hindi kailanman isasara ng lumang timer ang pintong isinara at binuksan ulit ng ibang tao sa panahong iyon. |
Mga check sa Triggered | Isang paggamit ng pinto kada 0.3 segundo, buhay na character, hindi lalayo sa 14 studs mula sa part na may prompt at susi, pero para lang sa pagbukas. | Lahat ng kayang i-trigger ng client ay puwedeng abusuhin, kaya inuulit ng server ang mga check. Ang 14 studs ay ang 8 studs ng prompt plus 6 na palugit para sa player na gumalaw habang nagho-hold ng E. |
Attribute na Open | Sine-set sa pinto sa bawat galaw. | Nire-replicate sa lahat ng player ang mga attribute na sine-set sa server, kaya kayang pakinggan ito ng ibang script, kasama ang LocalScript, gamit ang GetAttributeChangedSignal("Open"). |
Ang paglalagay ng tag sa lahat ng pinto at paghawak sa kanila mula sa isang script ang paraang mismong inirerekomenda ng Roblox: sinasabi ng reference sa CollectionService na kung idinadagdag mo ang iisang script sa maraming object, puwedeng mas maganda ang script na gumagamit ng CollectionService. Ibinabalik ng GetTagged ang mga pintong umiiral kapag nagsimula ang script, at nahuhuli ng GetInstanceAddedSignal ang mga pintong nilagyan ng tag o idinagdag mamaya. Ipinaliwanag ang ganitong paraan ng pag-aayos ng place sa guide tungkol sa client at server scripts.
Paano gumawa ng sliding door
Piliin ang VaultDoor, magdagdag ng attribute na type string na pinangalanang Style at itakda ang value sa Slide. Ngayon, hindi na umiikot ang pinto kundi dumudulas patagilid: nang kasinlapad nito, o nang SlideDistance studs kung itinakda mo iyon. Para dumulas ito sa kabilang direksyon, magtakda ng negatibong distansya, halimbawa -4 para sa pintong 4 studs ang lapad. Ang kahit anong ibang pinto, kasama ang FrontDoor, ay magiging sliding sa parehong paraan kapag nakuha nito ang attribute na ito.
Sinusukat ng DoorService ang dalawang pahalang na sukat ng pinto, ang lapad at kapal, at ginagalaw ito kasama ng mas malaki. Sinusukat nito ang Model gamit ang GetExtentsSize, na ang box ay sumusunod sa orientation ng pivot ng model, kaya ang pintong pinaikot nang 90 degrees pagkatapos i-group ay dumudulas pa rin kasama ng lapad, hindi ng kapal. Sinusukat nito ang Part gamit ang sariling Size ng part, kaya huwag paikutin ang pivot ng sliding part. Puwede namang ilipat ang pivot na iyon.
- Double doors: dalawang kalahating may tag na magkatabi, parehong
Stylena Slide, at ang isa ay may negatibongSlideDistance, para maghiwalay sila mula sa gitna. Para sa swing double doors, ilagay ang pivot ng bawat kalahati sa panlabas na gilid nito at bigyan ang isang kalahati ng negatibongOpenAngle. May sariling prompt ang bawat kalahati, at hiwalay itong bumubukas. Kung nagbabanggaan ang mga kalahati, ilipat ang minus sa kabilang kalahati. - Gate na umaangat pataas: kasama lang ng lapad ginagalaw ng script na ito ang pinto. Para umangat ang mga pinto, itakda ang
directionsa script saVector3.yAxis(aangat na ang lahat ng sliding door) at bigyan ang bawat isa ngSlideDistancena katumbas ng taas nito. - Pintong may physics: ginagalaw ng tutorial ng Roblox tungkol sa mga gumagalaw na object ang mga part sa isang axis gamit ang PrismaticConstraint. Gaya ng pintong may bisagra, physics ito, walang prompt at lock hangga't hindi mo sila isinusulat mismo.
Paano ikandado ang pinto gamit ang susi
Bumubukas lang ang nakakandadong pinto para sa player na may Tool na may tamang pangalan. Gumawa ng susi, saka sabihin sa pinto ang pangalan nito:
- I-hover ang StarterPack, pindutin ang + at mag-insert ng Tool na pinangalanang
RedKey. Maglagay dito ng isang Part na pinangalanangHandle, ito ang part na hawak ng character sa kamay, at siguraduhing hindi ito naka-anchor: ang naka-anchor na part sa tool ay nagpapako sa character sa puwesto. Alisin ang check saCanBeDroppedng Tool kung hindi dapat ihulog ng mga player ang susi para sa iba: habang naka-check ito, inihuhulog ng Backspace ang naka-equip na tool sa Workspace. - Piliin ang VaultDoor, magdagdag ng attribute na type string na pinangalanang
KeyNameat itakda ang value saRedKey. Ngayon, Needs RedKey na ang nakasulat sa pangalan ng object sa prompt.
Sa dalawang lugar hinahanap ng DoorService ang susi. Nasa Backpack ng player ang Tool hangga't hindi naka-equip, at inililipat ito ng pag-equip sa character, kaya bumubukas ang pinto nasa hotbar man o nasa kamay ang susi. Nasa server ang check dahil tinutukoy mismo ng security guide ng Roblox ang kasong ito, kung may susi ba ang player para sa pinto, bilang karapatang dapat i-check ng server. Para lang sa pagbukas kailangan ang susi: kahit sino ay puwedeng magsara ng bukas na pinto, at kusa itong sumasara pagkatapos ng AutoCloseSeconds.
Binibigyan ng StarterPack ng susi ang lahat sa bawat spawn, at iyon ang kailangan para sa test. Sa totoong game, ibigay ito sa ibang paraan:
- Mula sa shop: ang guide tungkol sa shop GUI ay nagbibigay ng Tool mula sa ServerStorage papunta sa Backpack at StarterGear ng bumili.
- Mula sa isang character: ang guide tungkol sa NPC dialogue ay nagbibigay ng Tool mula sa
ServerStorage.DialogueItemskapag pumili ang player ng option na may action naGiveItem. Maglagay sa folder na iyon ng Tool na pinangalanang RedKey at itakda sa option sa DialogueData angaction = "GiveItem"atitem = "RedKey", at ibibigay ang susi sa usapan. - Bilang inventory item: sa inventory system, gumagana ang key item kapag na-equip ito ng player, dahil naglalagay ang pag-equip ng kopya ng Tool nito sa Backpack at sa kamay.
Nawawala ang susi sa Backpack kapag namatay ang character, dahil pinupuno ulit ng Roblox ang Backpack mula sa StarterPack at StarterGear sa bawat spawn. Para mapanatili ito, maglagay din ng kopya sa StarterGear ng player, gaya ng ginagawa ng shop guide. Kung gusto mo namang maubos ang susi, hanapin ang Tool ng susi sa Backpack o sa character ng player at i-destroy ito sa Triggered handler, kasunod mismo ng matagumpay na check ng susi.
Saan nagkakamali ang mga lumang door tutorial
Kung ikinukumpara mo ang guide na ito sa isang video o forum post, heto ang mga paraang pinagmumulan ng karamihan ng thread na "hindi gumagana ang pinto ko", at ang ginagawa ng guide na ito sa halip.
| Tutorial | Problema | Ang guide na ito |
|---|---|---|
Nagtu-tween ng CFrame ng pintong Model | Walang property na CFrame o Position sa reference ng Model. Ang WorldPivot nito ay lugar lang ng pivot ng model ang itinatakda, kaya ang tween nito ay gumagalaw sa pivot point habang nananatili ang mga part sa puwesto. | Nagtu-tween ng NumberValue at ginagalaw ang buong model gamit ang PivotTo. |
Ginagalaw ang model gamit ang SetPrimaryPartCFrame | Deprecated: pinapayo ng Roblox na gamitin ang PivotTo sa mga bagong project. | Gumagamit ng PivotTo, na tinatawag ng Roblox na pangunahing function para maglipat ng Model mula sa script. |
| Wine-weld ang lahat ng part sa isang hinge part at iyon lang ang tine-tween | Gumagana kapag nasa puwesto ang lahat ng Weld, pero naiiwan ang kahit anong part na hindi naka-weld kapag gumalaw ang hinge. | Pinapanatiling naka-anchor ang lahat ng part, walang Weld. Ginagalaw ng PivotTo ang pinto at lahat ng nasa loob nito. |
| Kinokopya ang iisang script sa bawat pinto | Kailangang ulitin ang bawat fix sa bawat kopya. Iminumungkahi ng Roblox na lagyan ng tag ang mga object at hawakan sila ng isang script gamit ang CollectionService. | Isang DoorService at ang tag na Door. |
| Binubuksan ang pinto sa LocalScript | Sa screen lang ng player na iyon bumubukas ang pinto, at sarado pa rin ito sa paningin ng lahat ng iba. | Server ang gumagalaw sa pinto, kaya iisang pinto ang nakikita ng lahat ng player. |
Binubuksan ang pinto sa Touched | Nagpa-fire ang Touched nang ilang beses sunod-sunod sa isang hawak lang (page ng Roblox tungkol sa debounce), at kayang kontrolin ng device ng player kung kailan nagpa-fire ang Touched para sa sarili niyang character (security docs ng Roblox). | Prompt na chine-check ng server. |
Ginagalaw ang pinto nang paunti-unti sa loop na may wait() | Minamarkahan ng Roblox ang wait() bilang pinalitan na ng task.wait(), at hindi makakabalik ang loop sa kalagitnaan kapag may pumindot ulit. | Isang tween kada galaw. Kinakansela ng bagong tween sa parehong value ang luma, kaya bumabalik ang pinto mula sa kinaroroonan nito. |
| Chine-check ang susi sa LocalScript o hindi talaga chine-check | Kontrolado ng cheater ang lahat sa sarili niyang device, kaya walang napipigilan ang check sa client. | Hinahanap ng server ang Tool sa Backpack at sa character ng player. |
| Walang cooldown ang prompt | Sinasabi ng security guide ng Roblox na puwedeng abusuhin ang mga prompt gaya ng mga remote, kaya walang pumipigil na i-trigger ito nang paulit-ulit. | Isang paggamit ng pinto kada 0.3 segundo. |
Ano ang kaya at hindi kaya ng cheater
Isipin na kontrolado ng cheater ang lahat sa sarili niyang device, kasama ang character niya. Heto ang ibig sabihin nito para sa mga pintong ito.
| Sinusubukan ng cheater | Resulta | Bakit |
|---|---|---|
| I-trigger ang prompt mula sa kabilang dulo ng mapa | Binabalewala kung wala sa pinto ang character niya | Sinusukat ng DoorService ang distansya mula sa root part ng character hanggang sa part na may prompt at binabalewala ang lahat ng lampas sa 14 studs. Kayang i-teleport muna ng cheater ang character sa pinto (tingnan ang huling row), kaya ang distance check ay proteksyon laban sa paggamit mula sa malayo, hindi laban sa teleport. |
| I-trigger ito nang maraming beses kada segundo | Hindi hihigit sa isang paggamit ng pinto kada 0.3 segundo | Itinatago ng server ang oras ng huling paggamit ng bawat pinto. |
| Buksan ang pintong may susi nang walang susi | Tinatanggihan | Hinahanap ng server ang Tool sa Backpack at character niya kung saan ito mismo nakakakita, hindi sa screen ng cheater. |
| Gamitin ang pinto habang patay ang character | Binabalewala | Chine-check ng DoorService na may Humanoid na may health na higit sa 0 at may root part. |
| Dumaan pa rin sa saradong pinto | Posible | Inililista ng security docs ng Roblox ang paglampas sa mga pisikal na harang at pagbago ng sariling collisions sa mga kayang gawin ng client sa sarili niyang character. |
| Mag-teleport sa likod ng pinto | Posible | Binabanggit din ng parehong docs ang pag-teleport ng sariling character kahit saan. |
Hakbang 3: i-test
- Pindutin ang Play (F5). Lumapit sa FrontDoor: sa loob ng 8 studs, lalabas ang prompt na may action na Open at pangalan ng object na Door. I-hold ang E. Pagkalipas ng 0.2 segundo, bumubukas ang pinto nang 90 degrees sa paligid ng gilid na may bisagra sa loob ng 0.6 segundo, at Close na ang nakasulat sa prompt.
- Dumaan sa pinto at maghintay. Apat na segundo pagkatapos ganap na bumukas, kusang sumasara ang pinto. I-hold ang E habang sumasara ito: babalik ito at bubukas mula sa kinaroroonan nito.
- I-test ang lock. Kung nasa StarterPack ang RedKey, ilipat muna ito sa ServerStorage, pindutin ang Play at i-hold ang E sa VaultDoor: Needs RedKey ang nakasulat sa prompt, at walang gumagalaw. Ihinto ang game, ibalik ang RedKey sa StarterPack at patakbuhin ulit: bumubukas ang VaultDoor, nasa hotbar man o nasa kamay ang susi.
- I-test ang sliding door. Ang VaultDoor, isang Model na may
Stylena Slide, ay dumudulas patagilid nang kasinlapad nito kapag binuksan. Ihinto ang game, piliin ang VaultDoor, paikutin ito nang 90 degrees gamit ang Rotate tool at patakbuhin ulit: dapat dumudulas pa rin ito kasama ng lapad, hindi ng kapal. Kapag tapos ka na, ibalik ang pag-ikot. - Piliin ang Server & Clients sa dropdown ng test mode, itakda sa 2 client at pindutin ang Play. Buksan ang pinto sa window ng isang client: bukas din ito sa kabilang window at sumasara sa pareho.
- Ihinto ang game, piliin ang pinto at pindutin ang Ctrl+D para gumawa ng duplicate, saka ilipat ang kopya sa ibang doorway. I-check na Door pa rin ang nakalagay sa Tags ng kopya, at pindutin ang Play: gumagana ang kopya nang walang dagdag na script.
Panatilihing bukas ang Output window (menu na Window, saka Output). Kapag gumagana ang lahat, walang ipini-print ang DoorService. Ang warning na ang pinto ay "has no part to put the prompt on" ay nangangahulugang walang part sa loob ng Model na may tag. Para sa iba, tingnan ang section na Mga karaniwang error.
Paano palawakin
Mga automatic na pinto
Para bumukas ang pinto kapag may lumapit, tawagin ang move(true) mula sa loob ng setUpDoor, nang hindi hinihintay ang prompt. Sa dulo ng setUpDoor, magsimula ng loop gamit ang task.spawn, dahil hindi kailanman matatapos ang karaniwang loop doon, at hindi makakalampas ang DoorService sa unang pinto. Patakbuhin lang ito habang nasa game ang pinto: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Sa loob ng loop, i-check gamit ang workspace:GetPartBoundsInBox kung may character sa loob ng box sa paligid ng doorway, at tawagin ang move(true) kapag nandoon siya at sarado ang pinto. Pagkatapos, gaya ng dati, isasara ito ng auto-close. Itakda ang Enabled ng prompt sa false kung dapat kusang bumukas lang ang pinto.
VIP doors
Ang guide tungkol sa game passes ay bumubuo na ng VIP door na direktang nadadaanan ng mga may-ari ng pass, gamit ang collision groups. Para sa VIP door na bumubukas sa E, magdagdag ng isa pang check sa Triggered handler katabi ng check ng susi: mag-return kung hindi totoo ang player:GetAttribute("OwnsPass_VIP") == true, ang attribute na sine-set ng server script mula sa guide tungkol sa game passes. Sa server lang ito basahin.
Code panel
Para sa pintong bumubukas sa tinype na code, itago ang code sa server Script o sa ServerStorage, na hindi kailanman natatanggap ng mga player, at huwag na huwag sa LocalScript kung saan mababasa ito ng cheater. Ang LocalScript ng panel ay ang mga tinype na digit lang ang ipinapadala sa pamamagitan ng RemoteEvent. Sa server, i-check na malapit ang player sa pinto, limitahan kung gaano kadalas ang mga pagsubok, ikumpara ang mga digit at saka lang tawagin ang move(true). Ipinapakita ng guide tungkol sa RemoteEvent kung paano i-check ang natatanggap ng isang remote.
Mga tunog
Maglagay ng Sound sa loob ng part ng pinto para tumunog ito mula sa posisyon ng part na iyon, at tawagin ang method nitong Play sa simula ng move. O i-play ito mula sa LocalScript na nakikinig sa attribute na Open ng pinto gamit ang GetAttributeChangedSignal("Open"), dahil sine-set ng server ang attribute na ito sa bawat galaw.
Mga pintong idinagdag habang tumatakbo ang game
I-clone ang mga bagong pinto mula sa saradong template sa ServerStorage. Binabasa ng DoorService ang saradong posisyon ng pinto sa sandaling lumitaw ito, kaya ang kopya ng pintong bukas noong sandaling iyon ay ituturing na sarado ang bukas na posisyon nito. Ilagay ang kopya sa doorway gamit ang PivotTo bago itakda ang Parent nito sa Workspace, para tandaan ng DoorService ang lugar na iyon bilang sarado. Awtomatikong dine-delete ang mga lumang prompt at value na kasama ng kopya. Para sa pintong naglilipat ng mga player sa ibang zone o ibang place, basahin ang guide tungkol sa teleport.
Mga karaniwang error at solusyon
Buksan ang Output window (menu na Window, saka Output) bago pindutin ang Play. Karamihan ng problema sa pinto ay galing sa tag, pivot o attribute na medyo iba sa inaasahan ng script.
Hindi lumalabas ang prompt sa pinto
I-check nang sunod-sunod: ang DoorService ay Script, hindi LocalScript, at direktang nasa ServerScriptService; may tag ang pinto na Door na malaki ang D, at para sa door model, nasa Model mismo; ang pinto ay part (Part, MeshPart o ibang BasePart) o Model; at nakatayo ka nang hindi lalayo sa 8 studs mula sa part kung saan nakalagay ang prompt. Ang warning sa Output na ang pinto ay "has no part to put the prompt on" ay nangangahulugang walang part sa loob ng Model na may tag.
Nahuhulog, lumulutang palayo o natutulak ang pinto kapag nagsimula ang game
May part ito na hindi naka-anchor. Piliin ang lahat ng part ng pinto at i-check ang Anchored. Hindi kailanman ginagalaw ng physics ang mga naka-anchor na part, pero kaya pa rin silang galawin ng DoorService.
Binago ko ang attribute, pero binabalewala ito ng pinto
I-check ang tatlong bagay. Type: ang OpenAngle, SlideDistance, OpenSeconds at AutoCloseSeconds ay dapat mga attribute na type number, at ang Style at KeyName ay type string; kapag mali ang type, default value ang kinukuha ng DoorService. Spelling: eksaktong ikinukumpara ang mga pangalan, kaya ibang attribute ang openAngle. Eksakto ring ikinukumpara ang mga value: ang Style ay dapat Slide na malaki ang S at walang space. Timing: isang beses lang binabasa ng DoorService ang mga attribute, kapag sine-set up nito ang pinto, kaya walang epekto ang pagbabago habang nagpa-playtest hangga't hindi mo pinapatakbo ulit ang game.
Bumubukas ang pinto sa maling direksyon o tumutumba patagilid
Para bumukas ito sa kabilang direksyon, gawing negatibo ang OpenAngle, halimbawa -90. Kung umiikot ito sa pahalang na axis at hindi sa patayong bisagra, ang pivot mismo ang naka-rotate: i-on ang Pivot sa tab na Model at ibalik ang pag-ikot ng pivot para nakatayo ito nang patayo.
Pumapasok sa pader ang sliding door o kaunti lang ang galaw
Bigyan ito ng negatibong SlideDistance para dumulas ito sa kabilang direksyon. Kung masyadong kaunti o masyadong malayo ang galaw nito, itakda sa SlideDistance ang tamang bilang ng studs at huwag umasa sa nasukat na lapad.
May susi ako, pero hindi bumubukas ang pinto
Dapat Tool ang susi, hindi Part o Model, at dapat eksaktong tugma ang pangalan nito sa KeyName, kasama ang malalaking letra. Dapat nasa Backpack mo ito o hawak mo. I-check din na attribute na type string ang KeyName sa pinto.
Gawin gamit ang RoCode
Kung ayaw mong i-set up nang mano-mano ang lahat ng ito, kayang buuin ito ng RoCode sa place na bukas mo. Ang RoCode ay isang independent na AI agent para sa Roblox Studio, hindi galing sa Roblox: ilalarawan mo ang pagbabago sa web chat, at ang plugin nito para sa Studio ang gagawa ng mga script at object sa Explorer mo, kaya hindi mo na kailangang mag-paste ng code.
Gawing bumubukas ang mga pintong may tag na Door gamit ang prompt na hold E: ikot na 90 degrees sa paligid ng pivot sa loob ng 0.6 segundo, sasara pagkalipas ng 4 na segundo, dudulas sa halip na iikot kapag Slide ang attribute na Style, at mananatiling sarado ang pinto kung walang Tool ang player na may pangalan mula sa KeyName. Lahat sa server, may distance check.
- Kayang tingnan ang place mo kapag kailangan ito ng hakbang, gamit ang Search Game at Search Scripts, para gamitin ang mga item, remote o save code na nandiyan na, sa halip na magdagdag ng pangalawang system
- Sumusulat ng Script sa ServerScriptService gamit ang Create Script, kayang gumawa ng part ng pinto gamit ang Create Instance at magtakda dito ng mga attribute gaya ng Style at KeyName
- Inuutusan itong i-check ang compile ng bawat script na isinulat nito gamit ang Check Script, na kino-compile ito sa Studio nang hindi pinapatakbo
- Naglalagay ng undo point bago at pagkatapos ng bawat batch ng pagbabago, kaya isang batch kada Ctrl+Z ang naibabalik
Bago mag-test, i-check ang pivot ng bawat pinto gamit ang Pivot tool sa Studio: sa paligid nito umiikot ang pinto. Sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, at sa plugin 3.9.15 o mas bago, kaya nitong kontrolin ang test character na naglalakad at pumipindot ng mga key, pero ang mga napagpasyahan lang nitong i-test ang chine-check nito, kaya lapitan mo mismo ang bawat pinto at i-hold ang E. Paano kumokonekta ang RoCode sa Studio.
Mga madalas itanong
Paano gawing bumubukas sa E ang pinto sa Roblox Studio?
Maglagay ng ProximityPrompt sa pinto at ikonekta ang Triggered event nito sa isang server Script na gumagalaw sa pinto. Ginagawa ng DoorService ang dalawa para sa bawat pintong may tag na Door. Ang E ang default key ng prompt, at ipinapakita ng Roblox ang tamang input para sa keyboard, gamepad at touchscreen.
Bakit umiikot ang pinto ko sa gitna nito?
Nasa gitna pa rin ang pivot nito. I-on ang Pivot sa tab na Model at i-drag ang pivot sa gilid na may bisagra; sa paligid ng pivot pinapaikot ng script ang pinto.
Paano gumawa ng sliding door?
Itakda ang attribute na Style ng pinto sa Slide. Dumudulas ito patagilid nang kasinlapad nito o nang SlideDistance studs; ang negatibong distansya ay nagpapadulas dito sa kabilang direksyon.
Puwede bang gumawa ng pinto nang walang script?
Oo. Ikinakabit ng tutorial ng Roblox tungkol sa pintong may bisagra ang hindi naka-anchor na pinto sa frame gamit ang HingeConstraint na may limits, at binubuksan ito ng mga player sa pagtulak gamit ang katawan. Walang prompt, lock at auto-close ang ganitong pinto.
Paano gumawa ng pintong mga VIP lang ang makakabukas?
Gamitin ang VIP door mula sa guide tungkol sa game passes, na nadadaanan ng mga may-ari ng pass, o magdagdag sa Triggered handler sa DoorService ng check na bago magbukas ay binabasa sa server kung may pass ang player, halimbawa ang attribute na OwnsPass_VIP na sine-set ng guide na iyon.
Bakit bumubukas ang pinto para sa akin pero hindi para sa ibang player?
LocalScript ang nagbubukas dito, at ang pagbabagong ginawa ng LocalScript ay nananatili sa device ng player na iyon. Ilipat ang code ng pagbukas sa isang server Script, gaya ng sa DoorService, para makarating ang pagbabago sa lahat.
Mga source at dagdag na babasahin
- Roblox Creator Docs: PVInstance:PivotTo (sa English). paglipat ng part o buong model ayon sa pivot nito
- Roblox Creator Docs: Pivot tools (sa English). paglipat ng pivot, Snap at reference points, pivot kapag may PrimaryPart
- Roblox Creator Docs: Model (sa English). WorldPivot, sumusunod sa pivot ang GetExtentsSize, deprecated ang SetPrimaryPartCFrame
- Roblox Creator Docs: CFrame:Lerp (sa English). ini-interpolate ang rotation sa pinakamaikling arko
- Roblox Creator Docs: TweenService (sa English). ano ang puwedeng i-tween at kung paano kinakansela ng pangalawang tween sa parehong property ang una
- Roblox Creator Docs: Proximity prompts (sa English). paggawa at pag-set up ng prompts, input sa kahit anong device at line of sight
- Roblox Creator Docs: ProximityPrompt (sa English). default na key at button, HoldDuration, MaxActivationDistance at Triggered
- Roblox Creator Docs: CollectionService (sa English). tags, GetTagged at GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (sa English). pagdagdag ng tags at attributes sa Studio
- Roblox Creator Docs: Securing the client-server boundary (sa English). ProximityPrompt bilang attack surface at ang check ng karapatang "susi at pinto"
- Roblox Creator Docs: Network ownership, movement validation, and physics (sa English). ano ang kayang gawin ng client sa sarili niyang character
- Roblox Creator Docs: Build a hinged door (sa English). pintong may HingeConstraint nang walang code
- Roblox Creator Docs: In-game tools (sa English). Handle, anchor at StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (sa English). ano ang ginagawa ng Backspace sa naka-equip na tool
Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.