Ringkasnya
Bina pintu sebagai Part atau Model, tandakan Anchored, alihkan pivotnya ke tepi yang berengsel (tab Model, Pivot) dan tambah tag Door dalam tetingkap Properties. Satu Script dalam ServerScriptService mencari semua pintu bertag melalui CollectionService, menambah ProximityPrompt ("Open", tahan E) dan pada event Triggered men-tween NumberValue dari 0 ke 1, sambil menggerakkan pintu melalui door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Atribut pada setiap pintu menetapkan jenis berayun atau gelangsar, sudut, masa, tutup automatik dan kunci.
- Kedudukan Model tidak boleh di-tween secara terus: Model tiada sifat CFrame atau Position, dan
WorldPivotnya hanya menetapkan tempat pivot. Tween NumberValue dan gerakkan pintu melaluiPivotTo: Roblox menyebutnya cara utama untuk menggerakkan model dari skrip. - Buka pintu pada pelayan. Pintu yang dibuka dari LocalScript hanya bergerak pada skrin pemain itu.
- Semak kunci dan jarak pada pelayan. Panduan keselamatan Roblox menyatakan bahawa ProximityPrompt boleh disalahgunakan sama seperti RemoteEvent, dan di situ juga diberi contoh semakan yang wajib dibuat oleh pelayan: sama ada pemain mempunyai kunci yang diperlukan untuk membuka pintu.
Di halaman ini
Cara pintu berskrip berfungsi
Pintu yang berfungsi dalam game sebenar mesti digerakkan oleh pelayan. Jika LocalScript yang menggerakkannya, pintu terbuka pada skrin seorang pemain dan kekal tertutup bagi semua orang lain, kerana perubahan yang dibuat oleh client kekal pada peranti itu (lihat apa yang direplikasi dan apa yang tidak). Oleh itu dalam panduan ini peranti pemain hanya memaparkan prompt dan melaporkan tekanan kekunci, dan segala yang lain dilakukan oleh satu Script pelayan. Satu penggunaan pintu berlaku begini:
- Pemain menghampiri pintu dalam jarak kurang daripada 8 stud, dan prompt muncul dengan tindakan Open, nama objek Door dan kekunci E pada papan kekunci. Pada gamepad atau skrin sentuh, Roblox memaparkan butang yang sesuai.
- Pemain menahan E selama 0.2 saat. Event
Triggeredprompt itu dicetuskan pada pelayan bersama pemain tersebut. - DoorService menyemak pemain: masih hidup, cukup dekat, tidak menekan prompt berulang-ulang dan membawa kunci jika pintu memerlukannya.
- Skrip men-tween nombor dari 0 (tertutup) ke 1 (terbuka). Setiap kali nombor berubah, ia menggunakan
PivotTountuk menggerakkan pintu sebanyak pecahan perjalanan itu dari kedudukan tertutup ke kedudukan terbuka. - Empat saat selepas terbuka sepenuhnya, pintu menutup dengan cara yang sama. Menekan semasa pintu bergerak akan memusingkannya kembali dari tempat ia berada.
| Elemen | Di mana ia berada | Apa yang dilakukan |
|---|---|---|
Script DoorService | ServerScriptService | Mencari semua pintu, menambah prompt pada setiap satu, menyemak setiap penggunaan dan menggerakkan pintu. Satu-satunya skrip dalam panduan ini. |
Tag Door | Pada setiap Part atau Model pintu | Menandakan apa yang dikira sebagai pintu. Tag ditambah dalam tetingkap Properties dan disimpan bersama place. |
Atribut, contohnya Style dan KeyName | Pada setiap pintu (pilihan) | Tetapan untuk satu pintu: berayun atau gelangsar, sudut, kelajuan, tutup automatik dan kunci. |
ProximityPrompt DoorPrompt | Di dalam pintu (ditambah oleh DoorService) | Memaparkan "Open" atau "Close" dan mencetuskan Triggered apabila pemain menahan E. |
NumberValue DoorProgress | Di dalam pintu (ditambah oleh DoorService) | Nombor yang digerakkan oleh tween antara 0 dan 1. Setiap perubahan menggerakkan pintu. |
Tool RedKey (pilihan) | StarterPack, untuk ujian | Kunci untuk pintu berkunci. Mana-mana Tool sesuai, asalkan namanya sama dengan KeyName pintu. |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
Langkah 1: bina pintu dan tetapkan engsel
- Dalam Explorer, halakan kursor pada Workspace, klik butang + dan masukkan Part. Namakannya
FrontDoor, tetapkanSizelebih kurang4, 7, 0.5(lebar 4 stud, tinggi 7, tebal setengah stud) dan letakkan di bukaan pintu. Pintu yang terdiri daripada beberapa part juga boleh: pilih semuanya dan tekan Ctrl+G untuk mengumpulkannya menjadi Model. - Tandakan Anchored pada setiap part pintu dan biarkan CanCollide hidup. Part yang di-anchor tidak pernah bergerak kerana graviti atau perlanggaran, tetapi skrip tetap boleh menggerakkannya, dan itulah yang dilakukan oleh DoorService.
- Tetapkan engsel. Pilih pintu, buka tab Model dan hidupkan Pivot. Klik dan tahan anak panah kecil di penjuru butang Pivot dan tandakan Snap, supaya pivot melekat pada titik rujukan di penjuru, tepi dan tengah. Seret pivot ke tepi pintu tempat engsel sepatutnya berada. Untuk pintu gelangsar, pivot boleh kekal di tengah.
- Tambah tag. Dengan pintu masih dipilih, tatal tetingkap Properties ke Tags, klik + dan taip
Doordengan huruf besar D. Jika pintu ialah Model, letakkan tag pada Model itu sendiri, bukan pada part di dalamnya. - Bina pintu kedua, ia diperlukan dalam bahagian tentang pintu gelangsar dan kunci. Masukkan dua lagi Part dalam Workspace:
Panelbersaiz lebih kurang4, 7, 0.5danKnoblebih kurang0.5, 0.5, 0.5, diletakkan rapat pada salah satu muka Panel. Pilih kedua-duanya, tekan Ctrl+G dan namakan semula Model baharu itu kepadaVaultDoor. Anchor kedua-dua part, letakkan model di bukaan kedua dan tambah tagDoorpada Model. Pivotnya boleh kekal di tengah, kerana pintu ini akan menjadi pintu gelangsar.
Pivot penting kerana pintu berayun berputar mengelilinginya. Jika ia dibiarkan di tengah, pintu akan berpusing di tempatnya seperti pintu putar di kedai. Bagi part, pivot yang anda tetapkan disimpan sebagai PivotOffset, dan GetPivot mengambil kiranya, jadi skrip memutarkan pintu tepat mengelilingi titik yang anda pilih. Jika Model mempunyai PrimaryPart, pivot model ialah pivot part itu, dan DoorService juga meletakkan prompt padanya. Tanpa PrimaryPart, prompt diletakkan pada part pertama yang ditemui di dalam model. Jika anda menetapkan PrimaryPart, lakukannya sebelum mengalihkan pivot: menetapkan PrimaryPart mengalihkan pivot model ke pivot part itu, seperti yang dinyatakan dalam halaman Roblox tentang Pivot tools.
Tetapan pintu (atribut)
Setiap pintu berfungsi dengan nilai lalai dalam jadual di bawah. Untuk mengubah satu pintu, pilih ia, tatal tetingkap Properties ke Attributes, klik +, taip nama, pilih jenis dan klik Save, kemudian tetapkan nilainya. DoorService membaca atribut sekali sahaja semasa menyediakan pintu, jadi ubahnya semasa game dihentikan.
| Atribut | Jenis | Lalai | Apa yang dilakukan |
|---|---|---|---|
Style | string | Swing | Swing memutarkan pintu mengelilingi pivotnya. Slide menggelongsorkannya ke tepi sepanjang lebarnya. |
OpenAngle | number | 90 | Berapa darjah pintu berayun berputar. Nombor negatif mengayunkannya ke arah lain. Kekalkan nilai antara -179 dan 179: pintu sentiasa mengikut lengkok pendek, jadi DoorService mengehadkan sudut kepada had ini. |
SlideDistance | number | lebarnya | Berapa stud pintu gelangsar bergerak sepanjang lebarnya. Nombor negatif menggerakkannya ke arah lain. |
OpenSeconds | number | 0.6 | Berapa lama masa untuk terbuka atau tertutup sepenuhnya, dalam julat 0.05 hingga 10. |
AutoCloseSeconds | number | 4 | Berapa lama pintu kekal terbuka sepenuhnya sebelum menutup sendiri. 0 membiarkannya terbuka sehingga seseorang menutupnya. |
KeyName | string | tiada | Nama Tool yang mesti ada pada pemain untuk membuka pintu, contohnya RedKey. Jangan tetapkannya untuk pintu yang boleh dibuka oleh sesiapa sahaja. |
Langkah 2: tambah skrip pintu
Halakan kursor pada ServerScriptService, masukkan Script bernama DoorService dan tampal kod di bawah ke dalamnya. Ia mengawal semua pintu dalam place, tidak kira berapa banyak yang anda tag. Tiga tetapan di bahagian atas terpakai untuk semua pintu; atribut dari langkah 1 mengubah satu pintu.
-- Script dalam ServerScriptService bernama DoorService.
-- Membuka dan menutup setiap Part atau Model bertag "Door" melalui prompt tahan E.
-- Pelayan yang menggerakkan pintu, jadi semua pemain melihat pintu yang sama, dan pelayan juga
-- menyemak jarak dan kunci, jadi tiada siapa boleh membuka pintu berkunci dari jauh.
--
-- Atribut pilihan pada setiap pintu (ditetapkan dalam tetingkap Properties):
-- Style string "Swing" (lalai) atau "Slide"
-- OpenAngle number berapa darjah pintu berayun berputar mengelilingi pivot (lalai 90, dari -179 hingga 179)
-- SlideDistance number berapa stud pintu gelangsar bergerak sepanjang lebarnya (lalai: lebarnya)
-- OpenSeconds number berapa lama masa membuka (lalai 0.6)
-- AutoCloseSeconds number tutup semula selepas sekian saat; 0 membiarkannya terbuka (lalai 4)
-- KeyName string nama Tool yang mesti ada pada pemain, contohnya "RedKey"
local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")
local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- stud
local MIN_SECONDS_BETWEEN_USES = 0.3 -- bagi setiap pintu, untuk menghalang prompt ditekan berulang-ulang
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 atau infiniti yang dimasukkan dalam tetingkap 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 -- sudah menjadi pintu yang berfungsi, atau ini bukan part mahupun 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)
-- Salinan pintu yang berfungsi membawa bersama prompt dan nilai lama: kita padamkannya
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- Kedudukan tertutup dan terbuka dikira sekali, dari tempat pintu berada sekarang
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- Bergerak sepanjang sisi mendatar pintu yang lebih panjang, iaitu lebarnya. Model diukur sepanjang
-- sisi pivotnya, Part mengikut Size sendiri, jadi jangan putarkan pivot part gelangsar
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 sentiasa berputar mengikut lengkok pendek, jadi sudut yang lebih besar akan mengayunkan pintu ke arah yang salah
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", "")
-- Tween nombor dari 0 (tertutup) ke 1 (terbuka) dan gerakkan pintu mengikutnya.
-- PivotTo menggerakkan satu part atau seluruh model mengelilingi pivotnya.
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) -- skrip lain boleh membaca ini
prompt.ActionText = if open then "Close" else "Open"
-- Tween baharu pada nilai yang sama membatalkan yang lama, jadi pintu boleh berpatah balik di pertengahan.
-- Masa diskalakan mengikut berapa jauh lagi perjalanan yang tinggal.
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
-- Panduan keselamatan Roblox menyatakan prompt boleh disalahgunakan seperti remote, jadi kita semak sekali lagi di sini
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 -- terlalu jauh untuk menggunakan prompt secara jujur
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- berkunci, dan pemain ini tiada kunci
end
lastUse = now
move(not isOpen)
end)
end
-- Semua pintu bertag sekarang dan semua yang akan mendapat tag kemudian (termasuk pintu yang diklon oleh skrip)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
DoorService sendiri menambah DoorPrompt dan DoorProgress ke dalam setiap pintu apabila game bermula, jadi anda tidak perlu memasukkan apa-apa secara manual. Simpan satu salinan skrip sahaja: ia sudah mengendalikan semua pintu bertag.
| Bahagian skrip | Apa yang dilakukan | Kenapa |
|---|---|---|
attribute() | Membaca satu atribut dan memulangkan nilai lalai jika atribut tiada, jenisnya salah atau ia bukan nombor sebenar (NaN atau infiniti). | Salah taip dalam tetingkap Properties menghasilkan pintu dengan tetapan lalai, bukan pintu yang rosak. |
doorsSetUp dan gelung leftover | Menyediakan setiap pintu sekali dan terlebih dahulu memadam DoorPrompt atau DoorProgress yang disalin dari pintu lain. | Jika tidak, salinan pintu yang berfungsi akan mempunyai dua prompt, dan salah satunya tidak berfungsi. |
closedPivot dan openPivot | Dikira sekali, dari tempat pintu berada semasa disediakan. Pintu berayun memutarkan pivot mengelilingi paksi menegaknya sendiri; pintu gelangsar menggerakkannya sepanjang sisi pintu yang lebih panjang. | Lerp dari pivot tertutup ke pivot terbuka mengekalkan pivot di tempatnya semasa pintu berputar, jadi tepi berengsel tidak beralih sepanjang putaran. |
DoorProgress dan PivotTo | Tween mengubah nombor; setiap perubahan meletakkan pintu pada closedPivot:Lerp(openPivot, alpha). | TweenService boleh men-tween NumberValue, dan PivotTo menggerakkan part atau model bersama semua partnya supaya pivot berada pada CFrame itu. |
| Prompt | HoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight dimatikan. Pintu berkunci memaparkan "Needs RedKey". | Dengan garis penglihatan dihidupkan, prompt tersembunyi apabila sesuatu menghalang partnya; tanpanya, bingkai atau bahagian lain pintu model tidak menyembunyikan prompt. |
move() | Memulakan tween ke 1 atau ke 0, dan menskalakan masa mengikut berapa jauh lagi pintu perlu bergerak. | Tween baharu pada nilai yang sama membatalkan yang lama, jadi pintu yang berpatah balik di pertengahan bergerak kembali dengan lancar dan mengambil separuh masa. |
| Tutup automatik | Menunggu masa membuka ditambah AutoCloseSeconds, kemudian menutup pintu hanya jika moveCount tidak berubah. | Pemasa lama tidak akan menghempas pintu yang dalam masa itu telah ditutup dan dibuka semula oleh seseorang. |
Semakan dalam Triggered | Satu penggunaan pintu setiap 0.3 saat, watak yang hidup, tidak lebih daripada 14 stud dari part prompt dan kunci, tetapi hanya untuk membuka. | Semua yang boleh dicetuskan oleh client boleh disalahgunakan, jadi pelayan mengulangi semakan. 14 stud ialah 8 stud prompt ditambah 6 stud ruang untuk pemain yang bergerak semasa menahan E. |
Atribut Open | Ditetapkan pada pintu setiap kali ia bergerak. | Atribut yang ditetapkan pada pelayan direplikasi kepada semua pemain, jadi skrip lain, termasuk LocalScript, boleh mendengarnya melalui GetAttributeChangedSignal("Open"). |
Menandakan semua pintu dengan tag dan mengawalnya dari satu skrip ialah pendekatan yang disyorkan oleh Roblox sendiri: rujukan CollectionService menyatakan bahawa jika anda menambah skrip yang sama ke dalam banyak objek, skrip yang menggunakan CollectionService mungkin lebih baik. GetTagged memulangkan pintu yang wujud semasa skrip bermula, dan GetInstanceAddedSignal menangkap pintu yang ditag atau ditambah kemudian. Cara menyusun place sebegini dihuraikan dalam panduan skrip client dan pelayan.
Cara buat pintu gelangsar
Pilih VaultDoor, tambah atribut jenis string bernama Style dan tetapkan nilai Slide. Kini pintu tidak berputar, tetapi bergerak ke tepi: sejauh lebarnya sendiri, atau sejauh SlideDistance stud jika anda menetapkannya. Untuk menggerakkannya ke arah lain, tetapkan jarak negatif, contohnya -4 untuk pintu selebar 4 stud. Mana-mana pintu lain, termasuk FrontDoor, akan menjadi pintu gelangsar dengan cara yang sama sebaik sahaja ia mendapat atribut ini.
DoorService mengukur dua dimensi mendatar pintu, lebar dan ketebalan, dan menggerakkannya sepanjang yang lebih besar. Model diukur melalui GetExtentsSize, yang kotaknya mengikut orientasi pivot model, jadi pintu yang diputar 90 darjah selepas dikumpulkan tetap bergerak sepanjang lebarnya, bukan ketebalannya. Part diukur mengikut Size part itu sendiri, jadi jangan putarkan pivot part gelangsar. Mengalihkan pivot itu tidak mengapa.
- Pintu berkembar: dua bahagian bertag bersebelahan, kedua-duanya dengan
StyleSlide, dan satu denganSlideDistancenegatif supaya ia berpisah dari tengah. Untuk pintu berayun berkembar, letakkan pivot setiap bahagian pada tepi luarnya dan beri satu bahagianOpenAnglenegatif. Setiap bahagian mempunyai prompt sendiri dan dibuka secara berasingan. Jika kedua-dua bahagian bergerak ke arah satu sama lain, pindahkan tanda tolak ke bahagian yang satu lagi. - Pagar yang naik ke atas: skrip ini hanya menggerakkan pintu sepanjang lebarnya. Untuk pintu yang naik, tetapkan
directiondalam skrip kepadaVector3.yAxis(kemudian semua pintu gelangsar akan naik) dan beri setiap satuSlideDistanceyang sama dengan ketinggiannya. - Pintu berfizik: tutorial Roblox tentang objek bergerak menggerakkan part sepanjang satu paksi melalui PrismaticConstraint. Seperti pintu berengsel, ini ialah fizik, tanpa prompt atau kunci sehingga anda menulisnya sendiri.
Cara kunci pintu dengan kunci
Pintu berkunci hanya terbuka untuk pemain yang mempunyai Tool dengan nama yang betul. Buat kunci, kemudian beritahu pintu namanya:
- Halakan kursor pada StarterPack, klik + dan masukkan Tool bernama
RedKey. Masukkan satu Part bernamaHandleke dalamnya, iaitu part yang dipegang oleh watak, dan pastikan ia tidak di-anchor: part yang di-anchor dalam tool memaku watak di tempatnya. NyahtandaCanBeDroppedpada Tool jika pemain tidak patut menjatuhkan kunci untuk orang lain: selagi ia ditanda, Backspace menjatuhkan tool yang sedang dipakai ke dalam Workspace. - Pilih VaultDoor, tambah atribut jenis string bernama
KeyNamedan tetapkan nilaiRedKey. Kini nama objek pada prompt tertulis Needs RedKey.
DoorService mencari kunci di dua tempat. Tool berada dalam Backpack pemain sehingga ia dipakai, dan memakainya memindahkannya ke dalam watak, jadi pintu terbuka sama ada kunci berada dalam hotbar atau di tangan. Semakan dibuat pada pelayan kerana panduan keselamatan Roblox menyebut kes ini secara khusus, iaitu sama ada pemain mempunyai kunci untuk pintu, sebagai kebenaran yang wajib disemak oleh pelayan. Kunci hanya diperlukan untuk membuka: sesiapa sahaja boleh menutup pintu yang terbuka, dan ia menutup sendiri selepas AutoCloseSeconds.
StarterPack memberikan kunci kepada semua orang setiap kali spawn, dan untuk ujian itulah yang diperlukan. Dalam game sebenar, berikannya dengan cara lain:
- Dari kedai: panduan GUI kedai memberikan Tool dari ServerStorage ke dalam Backpack dan StarterGear pembeli.
- Dari watak: panduan dialog NPC memberikan Tool dari
ServerStorage.DialogueItemsapabila pemain memilih pilihan dengan tindakanGiveItem. Letakkan Tool bernama RedKey dalam folder itu dan tetapkan pada pilihan dalam DialogueDataaction = "GiveItem"danitem = "RedKey", dan kunci akan diberikan dalam perbualan. - Sebagai item inventori: dengan sistem inventori, item kunci berfungsi sebaik sahaja pemain memakainya, kerana memakainya meletakkan salinan Toolnya dalam Backpack dan di tangan.
Kunci dalam Backpack hilang apabila watak mati, kerana Roblox mengisi semula Backpack dari StarterPack dan StarterGear setiap kali spawn. Untuk menyimpannya, letakkan salinan juga dalam StarterGear pemain, seperti yang dilakukan oleh panduan kedai. Sebaliknya, untuk menjadikan kunci habis digunakan, cari Tool kunci dalam Backpack atau watak pemain dan musnahkannya dalam pengendali Triggered, sejurus selepas semakan kunci berjaya.
Kesilapan dalam tutorial pintu yang lama
Jika anda membandingkan panduan ini dengan video atau pos forum, berikut ialah teknik yang menyebabkan kebanyakan topik "pintu saya tidak berfungsi", dan apa yang dilakukan oleh panduan ini sebagai gantinya.
| Tutorial | Masalah | Panduan ini |
|---|---|---|
Men-tween CFrame pintu Model | Rujukan Model tiada sifat CFrame atau Position. WorldPivotnya hanya menetapkan tempat pivot model, jadi men-tweennya menggerakkan titik pivot, manakala part kekal di tempatnya. | Men-tween NumberValue dan menggerakkan seluruh model melalui PivotTo. |
Menggerakkan model melalui SetPrimaryPartCFrame | Lapuk: Roblox menasihatkan penggunaan PivotTo dalam projek baharu. | Menggunakan PivotTo, yang disebut oleh Roblox sebagai fungsi utama untuk menggerakkan Model dari skrip. |
| Mengimpal semua part pada satu part engsel dan hanya men-tween engsel | Berfungsi apabila semua Weld ada, tetapi mana-mana part yang tidak diimpal tertinggal apabila engsel bergerak. | Mengekalkan semua part di-anchor, tanpa Weld. PivotTo menggerakkan pintu dan semua yang ada di dalamnya. |
| Menyalin skrip yang sama ke dalam setiap pintu | Setiap pembaikan perlu diulang dalam setiap salinan. Roblox mencadangkan menandakan objek dengan tag dan mengendalikannya dengan satu skrip melalui CollectionService. | Satu DoorService dan tag Door. |
| Membuka pintu dalam LocalScript | Pintu hanya terbuka pada skrin pemain itu, dan semua orang lain masih melihatnya tertutup. | Pelayan yang menggerakkan pintu, jadi semua pemain melihat pintu yang sama. |
Membuka pintu pada Touched | Touched dicetuskan beberapa kali berturut-turut untuk satu sentuhan (halaman Roblox tentang debounce), dan peranti pemain boleh mengawal bila Touched dicetuskan untuk wataknya sendiri (dokumentasi keselamatan Roblox). | Prompt yang disemak oleh pelayan. |
Menggerakkan pintu langkah demi langkah dalam gelung dengan wait() | Roblox menandakan wait() sebagai telah digantikan oleh task.wait(), dan gelung tidak boleh berpatah balik di pertengahan apabila seseorang menekan lagi. | Satu tween bagi setiap pergerakan. Tween baharu pada nilai yang sama membatalkan yang lama, jadi pintu berpatah balik dari tempat ia berada. |
| Menyemak kunci dalam LocalScript atau langsung tidak menyemak | Penipu mengawal semua pada perantinya, jadi semakan pada client tidak menghalang sesiapa. | Pelayan mencari Tool dalam Backpack dan watak pemain. |
| Tiada cooldown pada prompt | Panduan keselamatan Roblox menyatakan prompt terdedah kepada penyalahgunaan sama seperti remote, jadi tiada apa yang menghalang ia dicetuskan berulang-ulang. | Satu penggunaan pintu setiap 0.3 saat. |
Apa yang boleh dan tidak boleh dilakukan oleh penipu
Anggap penipu mengawal semua pada perantinya, termasuk wataknya sendiri. Inilah maksudnya bagi pintu-pintu ini.
| Penipu mencuba | Hasil | Kenapa |
|---|---|---|
| Mencetuskan prompt dari hujung peta yang lain | Diabaikan jika wataknya tiada di pintu | DoorService mengukur jarak dari part akar watak ke part prompt dan mengabaikan apa-apa yang melebihi 14 stud. Penipu boleh menteleport wataknya ke pintu dahulu (lihat baris terakhir), jadi semakan jarak melindungi daripada penggunaan dari jauh, bukan daripada teleport. |
| Mencetuskannya banyak kali sesaat | Tidak lebih daripada satu penggunaan pintu setiap 0.3 saat | Pelayan menyimpan masa penggunaan terakhir setiap pintu. |
| Membuka pintu berkunci tanpa kunci | Ditolak | Pelayan mencari Tool dalam Backpack dan wataknya di tempat pelayan sendiri melihatnya, bukan pada skrin penipu. |
| Menggunakan pintu semasa watak sudah mati | Diabaikan | DoorService menyemak bahawa ada Humanoid dengan kesihatan lebih daripada 0 dan part akar. |
| Tetap menembusi pintu yang tertutup | Mungkin | Dokumentasi keselamatan Roblox menyenaraikan memintas halangan fizikal dan mengubah perlanggaran sendiri antara perkara yang boleh dilakukan oleh client terhadap wataknya. |
| Menteleport ke belakang pintu | Mungkin | Dokumentasi yang sama menyebut menteleport watak sendiri ke mana-mana titik. |
Langkah 3: uji
- Tekan Play (F5). Hampiri FrontDoor: dalam jarak 8 stud, prompt muncul dengan tindakan Open dan nama objek Door. Tahan E. Selepas 0.2 saat, pintu berayun 90 darjah mengelilingi tepi berengsel dalam 0.6 saat, dan prompt kini tertulis Close.
- Lalui pintu dan tunggu. Empat saat selepas terbuka sepenuhnya, pintu menutup sendiri. Tahan E semasa ia menutup: ia berpatah balik dan terbuka dari tempat ia berada.
- Uji kunci. Jika RedKey berada dalam StarterPack, pindahkannya buat sementara ke ServerStorage, tekan Play dan tahan E di VaultDoor: prompt tertulis Needs RedKey, dan tiada apa yang bergerak. Hentikan game, kembalikan RedKey ke StarterPack dan jalankan semula: VaultDoor terbuka sama ada kunci berada dalam hotbar atau di tangan.
- Uji pintu gelangsar. VaultDoor, iaitu Model dengan
StyleSlide, bergerak ke tepi sejauh lebarnya apabila dibuka. Hentikan game, pilih VaultDoor, putarkannya 90 darjah dengan alat Rotate dan jalankan semula: ia masih sepatutnya bergerak sepanjang lebar, bukan ketebalan. Apabila selesai, putarkannya kembali. - Pilih Server & Clients dalam senarai mod ujian, tetapkan 2 client dan tekan Play. Buka pintu dalam tetingkap satu client: ia juga terbuka dalam tetingkap yang lain dan tertutup dalam kedua-duanya.
- Hentikan game, pilih pintu dan tekan Ctrl+D untuk membuat pendua, kemudian alihkan salinan ke bukaan lain. Pastikan Tags salinan itu masih menunjukkan Door, dan tekan Play: salinan berfungsi tanpa skrip tambahan.
Biarkan tetingkap Output terbuka (menu Window, kemudian Output). Apabila semuanya berfungsi, DoorService tidak mencetak apa-apa. Amaran bahawa pintu "has no part to put the prompt on" bermakna tiada part di dalam Model bertag itu. Untuk yang lain, lihat bahagian Ralat biasa.
Cara mengembangkannya
Pintu automatik
Untuk pintu yang terbuka apabila seseorang menghampiri, panggil move(true) dari dalam setUpDoor tanpa menunggu prompt. Di hujung setUpDoor, mulakan gelung melalui task.spawn, kerana gelung biasa di situ tidak akan pernah tamat, dan DoorService tidak akan bergerak melepasi pintu pertama. Biar ia berjalan hanya selagi pintu masih ada dalam game: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Di dalam gelung, semak melalui workspace:GetPartBoundsInBox sama ada ada watak di dalam kotak di sekeliling bukaan, dan panggil move(true) apabila ada watak di situ dan pintu tertutup. Selepas itu, tutup automatik akan menutupnya seperti biasa. Tetapkan Enabled prompt kepada false jika pintu hanya patut terbuka sendiri.
Pintu VIP
Panduan game pass sudah membina pintu VIP yang boleh ditembusi terus oleh pemilik pass, menggunakan kumpulan perlanggaran. Untuk pintu VIP yang dibuka dengan E, tambah satu lagi semakan dalam pengendali Triggered di sebelah semakan kunci: lakukan return jika player:GetAttribute("OwnsPass_VIP") == true tidak dipenuhi, iaitu atribut yang ditetapkan oleh skrip pelayan dari panduan game pass. Baca ia pada pelayan sahaja.
Panel kod
Untuk pintu yang dibuka dengan kod yang dimasukkan, simpan kod itu dalam Script pelayan atau dalam ServerStorage, yang tidak pernah diterima oleh pemain, dan jangan sekali-kali dalam LocalScript, tempat penipu boleh membacanya. LocalScript panel hanya menghantar digit yang dimasukkan melalui RemoteEvent. Pada pelayan, semak bahawa pemain berada dekat pintu, hadkan kekerapan percubaan, bandingkan digit dan barulah panggil move(true). Panduan RemoteEvent menunjukkan cara menyemak apa yang diterima oleh remote.
Bunyi
Letakkan Sound di dalam part pintu supaya ia berbunyi dari kedudukan part itu, dan panggil kaedah Playnya di awal move. Atau mainkannya dari LocalScript yang mendengar atribut Open pintu melalui GetAttributeChangedSignal("Open"), kerana pelayan menetapkan atribut ini setiap kali pintu bergerak.
Pintu yang ditambah semasa game berjalan
Klon pintu baharu dari templat tertutup dalam ServerStorage. DoorService membaca kedudukan tertutup pintu pada saat ia muncul, jadi salinan pintu yang sedang terbuka pada saat itu akan menganggap kedudukan terbukanya sebagai tertutup. Letakkan salinan di bukaan melalui PivotTo sebelum menetapkan Parentnya kepada Workspace, supaya DoorService mengingati tempat itu sebagai tertutup. Prompt dan nilai lama yang datang bersama salinan dipadam secara automatik. Untuk pintu yang membawa pemain ke kawasan lain atau place lain, baca panduan teleport.
Ralat biasa dan cara membaikinya
Buka tetingkap Output (menu Window, kemudian Output) sebelum menekan Play. Kebanyakan masalah pintu berpunca daripada tag, pivot atau atribut yang sedikit berbeza daripada yang dijangka oleh skrip.
Prompt tidak muncul pada pintu
Semak mengikut susunan: DoorService ialah Script, bukan LocalScript, dan berada terus dalam ServerScriptService; pintu mempunyai tag Door dengan huruf besar D, dan untuk pintu model, pada Model itu sendiri; pintu ialah part (Part, MeshPart atau BasePart lain) atau Model; dan anda berdiri tidak lebih daripada 8 stud dari part yang memegang prompt. Amaran dalam Output bahawa pintu "has no part to put the prompt on" bermakna tiada part di dalam Model bertag itu.
Pintu jatuh, hanyut atau ditolak apabila game bermula
Salah satu partnya tidak di-anchor. Pilih semua part pintu dan tandakan Anchored. Part yang di-anchor tidak pernah bergerak kerana fizik, tetapi DoorService tetap boleh menggerakkannya.
Saya menukar atribut, tetapi pintu mengabaikannya
Semak tiga perkara. Jenis: OpenAngle, SlideDistance, OpenSeconds dan AutoCloseSeconds mesti atribut jenis number, dan Style serta KeyName jenis string; jika jenisnya salah, DoorService mengambil nilai lalai. Ejaan: nama dibandingkan dengan tepat, jadi openAngle ialah atribut yang berbeza. Nilai juga dibandingkan dengan tepat: Style mesti Slide dengan huruf besar S dan tanpa ruang. Masa: DoorService membaca atribut sekali sahaja semasa menyediakan pintu, jadi perubahan semasa playtest tiada kesan sehingga anda menjalankan game semula.
Pintu berayun ke arah yang salah atau terbalik ke sisi
Untuk membukanya ke arah lain, jadikan OpenAngle negatif, contohnya -90. Jika ia berputar mengelilingi paksi mendatar dan bukan engsel menegak, bermakna pivot itu sendiri telah diputar: hidupkan Pivot pada tab Model dan putarkan pivot kembali supaya ia tegak.
Pintu gelangsar bergerak masuk ke dalam dinding atau hanya bergerak sedikit
Beri ia SlideDistance negatif supaya ia bergerak ke arah lain. Jika ia bergerak terlalu sedikit atau terlalu jauh, tetapkan bilangan stud yang dikehendaki dalam SlideDistance dan jangan bergantung pada lebar yang diukur.
Saya ada kunci, tetapi pintu tidak terbuka
Kunci mesti Tool, bukan Part atau Model, dan namanya mesti sama dengan tepat seperti KeyName, termasuk huruf besar. Ia mesti berada dalam Backpack anda atau di tangan. Pastikan juga KeyName pada pintu ialah atribut jenis string.
Buat dengan RoCode
Jika anda tidak mahu menyediakan semua ini secara manual, RoCode boleh membinanya dalam place yang anda buka. RoCode ialah ejen AI bebas untuk Roblox Studio, bukan daripada Roblox: anda menerangkan perubahan dalam chat web, dan plugin Studionya mencipta skrip dan objek dalam Explorer anda, jadi anda tidak perlu menampal kod.
Buat supaya pintu bertag Door terbuka melalui prompt tahan E: berputar 90 darjah mengelilingi pivot dalam 0.6 saat, tutup selepas 4 saat, bergerak ke tepi dan bukan berputar apabila atribut Style ialah Slide, dan pintu kekal tertutup jika pemain tiada Tool dengan nama daripada KeyName. Semuanya pada pelayan, dengan semakan jarak.
- Boleh meninjau place anda apabila sesuatu langkah memerlukannya, melalui Search Game dan Search Scripts, untuk menggunakan item, remote atau kod simpanan yang sudah ada dan bukan menambah sistem kedua
- Menulis Script dalam ServerScriptService melalui Create Script, boleh mencipta part pintu melalui Create Instance dan menetapkan atribut padanya, seperti Style dan KeyName
- Ia diarahkan untuk menyemak kompilasi setiap skrip yang ditulisnya melalui Check Script, yang mengkompilnya dalam Studio tanpa menjalankannya
- Meletakkan titik undo sebelum dan selepas setiap kumpulan perubahan, jadi Ctrl+Z membatalkan satu kumpulan pada satu masa
Sebelum menguji, semak pivot setiap pintu dengan alat Pivot dalam Studio: pintu berputar mengelilinginya. Dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.15 atau lebih baharu ia boleh mengawal watak ujian yang berjalan dan menekan kekunci, tetapi ia hanya menyemak apa yang diputuskannya untuk diuji, jadi hampiri setiap pintu dan tahan E sendiri. Cara RoCode bersambung ke Studio.
Soalan lazim
Bagaimana buat pintu yang terbuka dengan E dalam Roblox Studio?
Letakkan ProximityPrompt dalam pintu dan sambungkan event Triggerednya dalam Script pelayan yang menggerakkan pintu. DoorService melakukan kedua-duanya untuk setiap pintu bertag Door. E ialah kekunci lalai prompt, dan Roblox memaparkan input yang betul untuk papan kekunci, gamepad dan skrin sentuh.
Kenapa pintu saya berpusing mengelilingi bahagian tengahnya?
Pivotnya masih di tengah. Hidupkan Pivot pada tab Model dan seret pivot ke tepi berengsel; skrip memutarkan pintu mengelilingi pivot.
Bagaimana buat pintu gelangsar?
Tetapkan atribut Style pintu kepada Slide. Ia bergerak ke tepi sejauh lebarnya atau sejauh SlideDistance stud; jarak negatif menggerakkannya ke arah lain.
Bolehkah buat pintu tanpa skrip?
Boleh. Tutorial Roblox tentang pintu berengsel memasang pintu yang tidak di-anchor pada bingkai melalui HingeConstraint dengan had, dan pemain membukanya dengan menolak menggunakan badan. Pintu sebegini tiada prompt, kunci atau tutup automatik.
Bagaimana buat pintu yang hanya boleh dibuka oleh VIP?
Gunakan pintu VIP daripada panduan game pass, yang boleh ditembusi oleh pemilik pass, atau tambah dalam pengendali Triggered dalam DoorService semakan yang membaca pada pelayan, sebelum membuka, sama ada pemain memiliki pass itu, contohnya atribut OwnsPass_VIP yang ditetapkan oleh panduan tersebut.
Kenapa pintu terbuka untuk saya tetapi tidak untuk pemain lain?
LocalScript yang membukanya, dan perubahan yang dibuat oleh LocalScript kekal pada peranti pemain itu. Pindahkan kod pembukaan ke Script pelayan, seperti dalam DoorService, supaya perubahan sampai kepada semua orang.
Sumber dan bacaan lanjut
- Roblox Creator Docs: PVInstance:PivotTo (dalam bahasa Inggeris). menggerakkan part atau seluruh model melalui pivotnya
- Roblox Creator Docs: Pivot tools (dalam bahasa Inggeris). mengalihkan pivot, Snap dan titik rujukan, pivot apabila ada PrimaryPart
- Roblox Creator Docs: Model (dalam bahasa Inggeris). WorldPivot, GetExtentsSize mengikut pivot, SetPrimaryPartCFrame lapuk
- Roblox Creator Docs: CFrame:Lerp (dalam bahasa Inggeris). putaran diinterpolasi mengikut lengkok terpendek
- Roblox Creator Docs: TweenService (dalam bahasa Inggeris). apa yang boleh di-tween dan bagaimana tween kedua pada sifat yang sama membatalkan yang pertama
- Roblox Creator Docs: Proximity prompts (dalam bahasa Inggeris). mencipta dan menyediakan prompt, input pada semua peranti dan garis penglihatan
- Roblox Creator Docs: ProximityPrompt (dalam bahasa Inggeris). kekunci dan butang lalai, HoldDuration, MaxActivationDistance dan Triggered
- Roblox Creator Docs: CollectionService (dalam bahasa Inggeris). tag, GetTagged dan GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (dalam bahasa Inggeris). menambah tag dan atribut dalam Studio
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggeris). ProximityPrompt sebagai permukaan serangan dan semakan kebenaran "kunci dan pintu"
- Roblox Creator Docs: Network ownership, movement validation, and physics (dalam bahasa Inggeris). apa yang boleh dilakukan oleh client terhadap wataknya
- Roblox Creator Docs: Build a hinged door (dalam bahasa Inggeris). pintu dengan HingeConstraint tanpa kod
- Roblox Creator Docs: In-game tools (dalam bahasa Inggeris). Handle, anchor dan StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (dalam bahasa Inggeris). apa yang dilakukan oleh Backspace terhadap tool yang sedang dipakai
Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.