Tutorial · Sistem permainan

Cara buat pintu dalam Roblox Studio

Pintu yang berfungsi dalam Roblox memerlukan tiga perkara: sesuatu yang ditekan oleh pemain (ProximityPrompt dengan tulisan "Open"), pergerakan yang lancar (TweenService) dan pelayan yang membuat perubahan, supaya semua pemain melihat pintu yang sama. Dalam panduan ini kita membina satu skrip yang melakukan semua itu untuk setiap pintu yang bertag, sama ada berayun atau gelangsar, dengan kunci pilihan: pelayan menyemak kunci sebelum membuka apa-apa.

Dikemas kini 20 November 202619 minit bacaanDitulis oleh

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 melalui PivotTo: 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
  1. Cara ia berfungsi
  2. 1. Bina pintu
  3. 2. Skrip pintu
  4. Pintu gelangsar
  5. Pintu berkunci
  6. Tutorial lama
  7. Had perlindungan
  8. 3. Ujian
  9. Pengembangan
  10. Common errors
  11. Dengan RoCode
  12. Soalan lazim
  13. Sumber dan bacaan lanjut

Cara pintu berskrip berfungsi

IlustrasiMenahan E selama 0.2 saat membuka pintu dalam 0.6 saat, dan 4 saat selepas terbuka sepenuhnya ia menutup sendiri (dipercepatkan di sini). VaultDoor kekal tertutup bagi pemain tanpa RedKey.

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:

  1. 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.
  2. Pemain menahan E selama 0.2 saat. Event Triggered prompt itu dicetuskan pada pelayan bersama pemain tersebut.
  3. DoorService menyemak pemain: masih hidup, cukup dekat, tidak menekan prompt berulang-ulang dan membawa kunci jika pintu memerlukannya.
  4. Skrip men-tween nombor dari 0 (tertutup) ke 1 (terbuka). Setiap kali nombor berubah, ia menggunakan PivotTo untuk menggerakkan pintu sebanyak pecahan perjalanan itu dari kedudukan tertutup ke kedudukan terbuka.
  5. Empat saat selepas terbuka sepenuhnya, pintu menutup dengan cara yang sama. Menekan semasa pintu bergerak akan memusingkannya kembali dari tempat ia berada.
Komponen sistem pintu
ElemenDi mana ia beradaApa yang dilakukan
Script DoorServiceServerScriptServiceMencari semua pintu, menambah prompt pada setiap satu, menyemak setiap penggunaan dan menggerakkan pintu. Satu-satunya skrip dalam panduan ini.
Tag DoorPada setiap Part atau Model pintuMenandakan apa yang dikira sebagai pintu. Tag ditambah dalam tetingkap Properties dan disimpan bersama place.
Atribut, contohnya Style dan KeyNamePada setiap pintu (pilihan)Tetapan untuk satu pintu: berayun atau gelangsar, sudut, kelajuan, tutup automatik dan kunci.
ProximityPrompt DoorPromptDi dalam pintu (ditambah oleh DoorService)Memaparkan "Open" atau "Close" dan mencetuskan Triggered apabila pemain menahan E.
NumberValue DoorProgressDi dalam pintu (ditambah oleh DoorService)Nombor yang digerakkan oleh tween antara 0 dan 1. Setiap perubahan menggerakkan pintu.
Tool RedKey (pilihan)StarterPack, untuk ujianKunci untuk pintu berkunci. Mana-mana Tool sesuai, asalkan namanya sama dengan KeyName pintu.
Explorer selepas panduan ini selesai. Kedua-dua pintu mempunyai tag Door, dan VaultDoor juga mempunyai atribut Style = Slide dan KeyName = RedKey. Apabila game berjalan, DoorService menambah DoorProgress ke dalam setiap pintu dan DoorPrompt ke dalam part yang memegang prompt.
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

  1. Dalam Explorer, halakan kursor pada Workspace, klik butang + dan masukkan Part. Namakannya FrontDoor, tetapkan Size lebih kurang 4, 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.
  2. 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.
  3. 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.
  4. Tambah tag. Dengan pintu masih dipilih, tatal tetingkap Properties ke Tags, klik + dan taip Door dengan huruf besar D. Jika pintu ialah Model, letakkan tag pada Model itu sendiri, bukan pada part di dalamnya.
  5. Bina pintu kedua, ia diperlukan dalam bahagian tentang pintu gelangsar dan kunci. Masukkan dua lagi Part dalam Workspace: Panel bersaiz lebih kurang 4, 7, 0.5 dan Knob lebih kurang 0.5, 0.5, 0.5, diletakkan rapat pada salah satu muka Panel. Pilih kedua-duanya, tekan Ctrl+G dan namakan semula Model baharu itu kepada VaultDoor. Anchor kedua-dua part, letakkan model di bukaan kedua dan tambah tag Door pada 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 pilihan pada setiap pintu
AtributJenisLalaiApa yang dilakukan
StylestringSwingSwing memutarkan pintu mengelilingi pivotnya. Slide menggelongsorkannya ke tepi sepanjang lebarnya.
OpenAnglenumber90Berapa 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.
SlideDistancenumberlebarnyaBerapa stud pintu gelangsar bergerak sepanjang lebarnya. Nombor negatif menggerakkannya ke arah lain.
OpenSecondsnumber0.6Berapa lama masa untuk terbuka atau tertutup sepenuhnya, dalam julat 0.05 hingga 10.
AutoCloseSecondsnumber4Berapa lama pintu kekal terbuka sepenuhnya sebelum menutup sendiri. 0 membiarkannya terbuka sehingga seseorang menutupnya.
KeyNamestringtiadaNama 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
-- 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.

Apa yang dilakukan oleh setiap bahagian DoorService
Bahagian skripApa yang dilakukanKenapa
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 leftoverMenyediakan 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 openPivotDikira 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 PivotToTween 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.
PromptHoldDuration 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 automatikMenunggu 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 TriggeredSatu 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 OpenDitetapkan 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 Style Slide, dan satu dengan SlideDistance negatif supaya ia berpisah dari tengah. Untuk pintu berayun berkembar, letakkan pivot setiap bahagian pada tepi luarnya dan beri satu bahagian OpenAngle negatif. 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 direction dalam skrip kepada Vector3.yAxis (kemudian semua pintu gelangsar akan naik) dan beri setiap satu SlideDistance yang 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:

  1. Halakan kursor pada StarterPack, klik + dan masukkan Tool bernama RedKey. Masukkan satu Part bernama Handle ke dalamnya, iaitu part yang dipegang oleh watak, dan pastikan ia tidak di-anchor: part yang di-anchor dalam tool memaku watak di tempatnya. Nyahtanda CanBeDropped pada Tool jika pemain tidak patut menjatuhkan kunci untuk orang lain: selagi ia ditanda, Backspace menjatuhkan tool yang sedang dipakai ke dalam Workspace.
  2. Pilih VaultDoor, tambah atribut jenis string bernama KeyName dan tetapkan nilai RedKey. 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.DialogueItems apabila pemain memilih pilihan dengan tindakan GiveItem. Letakkan Tool bernama RedKey dalam folder itu dan tetapkan pada pilihan dalam DialogueData action = "GiveItem" dan item = "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.

Teknik biasa dalam tutorial pintu dan apa yang dilakukan oleh panduan ini sebagai gantinya
TutorialMasalahPanduan ini
Men-tween CFrame pintu ModelRujukan 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 SetPrimaryPartCFrameLapuk: 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 engselBerfungsi 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 pintuSetiap 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 LocalScriptPintu 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 TouchedTouched 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 menyemakPenipu mengawal semua pada perantinya, jadi semakan pada client tidak menghalang sesiapa.Pelayan mencari Tool dalam Backpack dan watak pemain.
Tiada cooldown pada promptPanduan 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.

Apa yang mungkin dicuba oleh penipu dan apa yang dilakukan oleh DoorService terhadapnya
Penipu mencubaHasilKenapa
Mencetuskan prompt dari hujung peta yang lainDiabaikan jika wataknya tiada di pintuDoorService 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 sesaatTidak lebih daripada satu penggunaan pintu setiap 0.3 saatPelayan menyimpan masa penggunaan terakhir setiap pintu.
Membuka pintu berkunci tanpa kunciDitolakPelayan mencari Tool dalam Backpack dan wataknya di tempat pelayan sendiri melihatnya, bukan pada skrin penipu.
Menggunakan pintu semasa watak sudah matiDiabaikanDoorService menyemak bahawa ada Humanoid dengan kesihatan lebih daripada 0 dan part akar.
Tetap menembusi pintu yang tertutupMungkinDokumentasi keselamatan Roblox menyenaraikan memintas halangan fizikal dan mengubah perlanggaran sendiri antara perkara yang boleh dilakukan oleh client terhadap wataknya.
Menteleport ke belakang pintuMungkinDokumentasi yang sama menyebut menteleport watak sendiri ke mana-mana titik.

Langkah 3: uji

  1. 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.
  2. 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.
  3. 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.
  4. Uji pintu gelangsar. VaultDoor, iaitu Model dengan Style Slide, 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.
  5. 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.
  6. 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.

Anda tulis

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.

RoCode buat
  • 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

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.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.