Hướng dẫn · Hệ thống game

Cách làm cửa trong Roblox Studio

Một cánh cửa hoạt động trong Roblox cần ba thứ: thứ người chơi bấm vào (ProximityPrompt với chữ "Open"), chuyển động mượt (TweenService) và một server thực hiện thay đổi để mọi người chơi thấy cùng một cánh cửa. Trong hướng dẫn này, chúng ta dựng một script làm việc đó cho mọi cánh cửa có tag, cửa xoay hoặc cửa trượt, kèm khóa bằng chìa tùy chọn: server kiểm tra chìa trước khi mở bất cứ thứ gì.

Cập nhật ngày 20 tháng 11, 202624 phút đọcTác giả:

Tóm tắt

Dựng cửa bằng Part hoặc Model, đánh dấu Anchored, chuyển pivot của nó ra cạnh có bản lề (tab Model, Pivot) và thêm tag Door trong cửa sổ Properties. Một Script trong ServerScriptService tìm mọi cánh cửa có tag qua CollectionService, thêm ProximityPrompt ("Open", giữ E) và khi có sự kiện Triggered thì tween một NumberValue từ 0 đến 1, di chuyển cửa bằng door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Các thuộc tính (attribute) trên từng cửa quy định kiểu xoay hay trượt, góc, thời gian, tự đóng và chìa khóa.

  • Không thể tween trực tiếp vị trí của Model: Model không có thuộc tính CFrame hay Position, còn WorldPivot của nó chỉ quy định vị trí pivot. Hãy tween một NumberValue và di chuyển cửa bằng PivotTo: Roblox gọi đó là cách chính để di chuyển model từ script.
  • Mở cửa trên server. Cửa mở từ LocalScript chỉ di chuyển trên màn hình của người chơi đó.
  • Kiểm tra chìa khóa và khoảng cách trên server. Hướng dẫn bảo mật của Roblox nói ProximityPrompt có thể bị lạm dụng giống như RemoteEvent, và cũng đưa ví dụ về kiểm tra mà server bắt buộc phải làm: người chơi có chìa cần để mở cửa hay không.
Trong trang này
  1. Cách hoạt động
  2. 1. Dựng cửa
  3. 2. Script cửa
  4. Cửa trượt
  5. Cửa có chìa khóa
  6. Hướng dẫn cũ
  7. Giới hạn bảo vệ
  8. 3. Kiểm tra
  9. Mở rộng
  10. Common errors
  11. Với RoCode
  12. Câu hỏi thường gặp
  13. Nguồn và tài liệu đọc thêm

Cửa dùng script hoạt động thế nào

Minh họaGiữ E trong 0.2 giây mở cửa trong 0.6 giây, và 4 giây sau khi mở hết cửa tự đóng (ở đây được tua nhanh). VaultDoor vẫn đóng với người chơi không có RedKey.

Một cánh cửa chạy được trong game thật phải do server di chuyển. Nếu LocalScript di chuyển nó, cửa mở trên màn hình của một người chơi và vẫn đóng với mọi người khác, vì thay đổi do client làm chỉ ở lại trên thiết bị đó (xem cái gì được sao chép, cái gì không). Vì vậy trong hướng dẫn này, thiết bị của người chơi chỉ hiện prompt và báo việc nhấn phím, còn mọi thứ khác do một Script server làm. Một lần dùng cửa diễn ra như sau:

  1. Người chơi đến gần cửa trong vòng 8 stud, và một prompt xuất hiện với hành động Open, tên đối tượng Door và phím E trên bàn phím. Trên tay cầm hoặc màn hình cảm ứng, Roblox hiện nút phù hợp.
  2. Người chơi giữ E trong 0.2 giây. Sự kiện Triggered của prompt kích hoạt trên server kèm người chơi đó.
  3. DoorService kiểm tra người chơi: còn sống, đủ gần, không spam prompt và mang chìa khóa nếu cửa cần.
  4. Script tween một con số từ 0 (đóng) đến 1 (mở). Mỗi khi con số thay đổi, nó dùng PivotTo đặt cửa ở đúng phần quãng đường đó, từ vị trí đóng đến vị trí mở.
  5. Bốn giây sau khi mở hết, cửa đóng lại theo cùng cách. Bấm trong lúc cửa đang chuyển động sẽ cho cửa quay ngược lại từ chỗ nó đang ở.
Hệ thống cửa gồm những gì
Thành phầnNằm ở đâuLàm gì
Script DoorServiceServerScriptServiceTìm mọi cánh cửa, thêm prompt cho từng cửa, kiểm tra mỗi lần dùng và di chuyển cửa. Script duy nhất trong hướng dẫn này.
Tag DoorTrên mỗi Part hoặc Model cửaĐánh dấu cái gì là cửa. Tag được thêm trong cửa sổ Properties và được lưu cùng place.
Thuộc tính, ví dụ Style và KeyNameTrên mỗi cửa (không bắt buộc)Cài đặt cho một cửa: xoay hay trượt, góc, tốc độ, tự đóng và chìa khóa.
ProximityPrompt DoorPromptBên trong cửa (DoorService thêm vào)Hiện "Open" hoặc "Close" và kích hoạt Triggered khi người chơi giữ E.
NumberValue DoorProgressBên trong cửa (DoorService thêm vào)Con số mà tween di chuyển giữa 0 và 1. Mỗi thay đổi di chuyển cửa.
Tool RedKey (không bắt buộc)StarterPack, để testChìa cho cửa bị khóa. Tool nào cũng được, miễn tên trùng với KeyName của cửa.
Explorer khi làm xong hướng dẫn. Cả hai cửa đều có tag Door, còn VaultDoor có thêm thuộc tính Style = Slide và KeyName = RedKey. Khi game chạy, DoorService thêm DoorProgress vào mỗi cửa và DoorPrompt vào part mang 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

Bước 1: dựng cửa và đặt bản lề

  1. Trong Explorer, rê chuột lên Workspace, bấm nút + và chèn một Part. Đặt tên là FrontDoor, đặt Size khoảng 4, 7, 0.5 (rộng 4 stud, cao 7, dày nửa stud) và đặt vào khung cửa. Cửa gồm nhiều part cũng được: chọn chúng và bấm Ctrl+G để nhóm thành Model.
  2. Đánh dấu Anchored cho mọi part của cửa và giữ CanCollide bật. Part đã anchor không bao giờ di chuyển vì trọng lực hay va chạm, nhưng script vẫn có thể di chuyển chúng, và DoorService làm đúng như vậy.
  3. Đặt bản lề. Chọn cửa, mở tab Model và bật Pivot. Bấm giữ mũi tên nhỏ ở góc nút Pivot và đánh dấu Snap, để pivot bám vào các điểm neo ở góc, cạnh và tâm. Kéo pivot ra cạnh cửa nơi sẽ có bản lề. Với cửa trượt, pivot có thể để ở tâm.
  4. Thêm tag. Vẫn chọn cửa, cuộn cửa sổ Properties xuống Tags, bấm + và gõ Door với chữ D hoa. Nếu cửa là Model, đặt tag lên chính Model, không phải lên các part bên trong.
  5. Dựng cánh cửa thứ hai, bạn sẽ cần nó ở phần cửa trượt và chìa khóa. Chèn vào Workspace thêm hai Part: Panel cỡ khoảng 4, 7, 0.5 và Knob khoảng 0.5, 0.5, 0.5, áp vào một mặt của Panel. Chọn cả hai, bấm Ctrl+G và đổi tên Model mới thành VaultDoor. Anchor cả hai part, đặt model vào khung cửa thứ hai và thêm tag Door lên Model. Pivot của nó có thể để ở tâm, vì cửa này sẽ là cửa trượt.

Pivot quan trọng vì cửa xoay quay quanh nó. Nếu để ở tâm, cửa sẽ quay tại chỗ như cửa xoay ở cửa hàng. Với part, pivot bạn đặt được lưu thành PivotOffset, và GetPivot tính đến nó, nên script xoay cửa đúng quanh điểm bạn chọn. Nếu Model có PrimaryPart, pivot của model là pivot của part đó, và DoorService cũng gắn prompt lên part đó. Không có PrimaryPart, prompt được gắn lên part đầu tiên tìm thấy trong model. Nếu bạn đặt PrimaryPart, hãy làm trước khi di chuyển pivot: gán PrimaryPart sẽ chuyển pivot của model về pivot của part đó, như trang Pivot tools của Roblox có ghi.

Cài đặt cửa (thuộc tính)

Cửa nào cũng chạy với giá trị mặc định trong bảng dưới. Để đổi một cửa, chọn nó, cuộn cửa sổ Properties xuống Attributes, bấm +, gõ tên, chọn kiểu và bấm Save, rồi đặt giá trị. DoorService đọc thuộc tính một lần khi thiết lập cửa, nên hãy đổi chúng khi game đang dừng.

Thuộc tính tùy chọn trên mỗi cửa
Thuộc tínhKiểuMặc địnhLàm gì
StylestringSwingSwing xoay cửa quanh pivot của nó. Slide trượt nó sang ngang theo chiều rộng.
OpenAnglenumber90Cửa xoay quay bao nhiêu độ. Số âm làm nó mở về phía kia. Giữ giá trị trong khoảng -179 đến 179: cửa luôn đi theo cung ngắn, nên DoorService giới hạn góc trong khoảng này.
SlideDistancenumberchiều rộng của nóCửa trượt đi bao nhiêu stud theo chiều rộng. Số âm trượt nó về phía kia.
OpenSecondsnumber0.6Một lần mở hoặc đóng hoàn toàn mất bao lâu, trong khoảng 0.05 đến 10.
AutoCloseSecondsnumber4Cửa mở hết bao lâu trước khi tự đóng. 0 để nó mở cho đến khi có người đóng.
KeyNamestringkhông cóTên Tool người chơi phải có để mở cửa, ví dụ RedKey. Đừng đặt nó cho cửa mà ai cũng mở được.

Bước 2: thêm script cửa

Rê chuột lên ServerScriptService, chèn một Script tên DoorService và dán code bên dưới vào. Nó điều khiển mọi cánh cửa trong place, dù bạn gắn tag bao nhiêu cửa. Ba cài đặt ở đầu áp dụng cho mọi cửa; thuộc tính ở bước 1 thay đổi một cửa.

Script trong ServerScriptService tên là DoorService
-- Script trong ServerScriptService tên DoorService.
-- Mở và đóng mọi Part hoặc Model có tag "Door" bằng prompt giữ E.
-- Server di chuyển cửa, nên mọi người chơi thấy cùng một cánh cửa, và cũng chính server
-- kiểm tra khoảng cách và chìa khóa, nên không ai mở được cửa khóa từ xa.
--
-- Thuộc tính tùy chọn trên mỗi cửa (đặt trong cửa sổ Properties):
--   Style            string  "Swing" (mặc định) hoặc "Slide"
--   OpenAngle        number  cửa xoay quay bao nhiêu độ quanh pivot (mặc định 90, từ -179 đến 179)
--   SlideDistance    number  cửa trượt đi bao nhiêu stud theo chiều rộng (mặc định: chiều rộng của nó)
--   OpenSeconds      number  mở mất bao lâu (mặc định 0.6)
--   AutoCloseSeconds number  đóng lại sau ngần ấy giây; 0 để mở luôn (mặc định 4)
--   KeyName          string  tên Tool người chơi phải có, ví dụ "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 -- cho mỗi cửa, chống spam 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 hoặc vô cực nhập trong cửa sổ 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 -- đã là cửa đang hoạt động, hoặc không phải part hay 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)
	-- Bản sao của một cửa đang hoạt động mang theo prompt và value cũ: xóa chúng đi
	for _, leftover in door:GetDescendants() do
		if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
			leftover:Destroy()
		end
	end

	-- Tính vị trí đóng và mở một lần, từ chỗ cửa đang đứng
	local closedPivot = door:GetPivot()
	local openPivot: CFrame
	if attribute(door, "Style", "Swing") == "Slide" then
		-- Trượt theo cạnh ngang dài hơn của cửa, tức chiều rộng. Model được đo theo
		-- các cạnh của pivot, Part theo Size của chính nó, nên đừng xoay pivot của part cửa trượt
		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 luôn xoay theo cung ngắn, nên góc lớn hơn sẽ làm cửa mở sai hướng
		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 một con số từ 0 (đóng) đến 1 (mở) và di chuyển cửa theo nó.
	-- PivotTo di chuyển một part hoặc cả model quanh pivot của nó.
	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) -- các script khác có thể đọc giá trị này
		prompt.ActionText = if open then "Close" else "Open"
		-- Tween mới trên cùng value hủy tween cũ, nên cửa có thể quay ngược giữa chừng.
		-- Thời gian được co giãn theo quãng đường cửa còn phải đi.
		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
		-- Hướng dẫn bảo mật của Roblox nói prompt có thể bị lạm dụng như remote, nên kiểm tra lại ở đây
		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 -- quá xa để dùng prompt một cách hợp lệ
		end
		if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
			return -- cửa bị khóa và người chơi này không có chìa
		end
		lastUse = now
		move(not isOpen)
	end)
end

-- Mọi cửa có tag lúc này và mọi cửa được gắn tag sau đó (kể cả cửa do script clone ra)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
	setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)

DoorService tự thêm DoorPrompt và DoorProgress vào mỗi cửa khi game chạy, nên không cần chèn gì bằng tay. Chỉ giữ một bản script: nó đã phục vụ mọi cửa có tag.

Mỗi phần của DoorService làm gì
Phần scriptLàm gìVì sao
attribute()Đọc một thuộc tính và trả về giá trị mặc định nếu thuộc tính không có, sai kiểu hoặc không phải số thật (NaN hoặc vô cực).Gõ nhầm trong cửa sổ Properties cho ra cửa với cài đặt mặc định, chứ không phải cửa hỏng.
doorsSetUp và vòng lặp leftoverThiết lập mỗi cửa một lần, và trước hết xóa DoorPrompt hoặc DoorProgress được sao chép từ cửa khác.Nếu không, bản sao của cửa đang hoạt động sẽ có hai prompt, và một trong hai không chạy.
closedPivot và openPivotĐược tính một lần, từ chỗ cửa đứng lúc thiết lập. Cửa xoay quay pivot quanh trục đứng của chính nó; cửa trượt dời nó theo cạnh dài hơn của cửa.Lerp từ pivot đóng sang pivot mở giữ pivot đứng yên khi cửa xoay, nên cạnh bản lề không lệch trong suốt lúc xoay.
DoorProgress và PivotToTween thay đổi con số; mỗi thay đổi đặt cửa vào closedPivot:Lerp(openPivot, alpha).TweenService tween được NumberValue, còn PivotTo di chuyển một part hoặc một model cùng mọi part của nó sao cho pivot nằm đúng CFrame đó.
PromptHoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight tắt. Cửa bị khóa hiện "Needs RedKey".Khi bật tầm nhìn trực tiếp, prompt sẽ ẩn khi có gì đó che part của nó; tắt đi thì khung cửa hay các phần khác của cửa model không che mất prompt.
move()Chạy tween về 1 hoặc về 0, và co giãn thời gian theo quãng đường cửa còn phải đi.Tween mới trên cùng value hủy tween cũ, nên cửa bị quay ngược giữa chừng sẽ đi về mượt mà và chỉ mất nửa thời gian.
Tự đóngĐợi thời gian mở cộng AutoCloseSeconds, rồi đóng cửa chỉ khi moveCount không đổi.Bộ hẹn giờ cũ không bao giờ đóng sập cánh cửa mà trong lúc đó ai đó đã đóng rồi mở lại.
Kiểm tra trong TriggeredMỗi cửa một lần dùng mỗi 0.3 giây, nhân vật còn sống, cách part có prompt không quá 14 stud, và có chìa, nhưng chỉ khi mở.Mọi thứ client có thể kích hoạt đều có thể bị lạm dụng, nên server kiểm tra lại. 14 stud là 8 stud của prompt cộng 6 stud dư cho người chơi đã di chuyển trong lúc giữ E.
Thuộc tính OpenĐược đặt trên cửa mỗi lần cửa di chuyển.Thuộc tính đặt trên server được sao chép cho mọi người chơi, nên các script khác, kể cả LocalScript, có thể lắng nghe nó qua GetAttributeChangedSignal("Open").

Gắn tag cho mọi cửa và điều khiển chúng từ một script là cách chính Roblox khuyên dùng: tài liệu về CollectionService nói nếu bạn thêm cùng một script vào nhiều đối tượng, một script dùng CollectionService có thể tốt hơn. GetTagged trả về các cửa đang tồn tại khi script chạy, còn GetInstanceAddedSignal bắt các cửa được gắn tag hoặc thêm vào sau. Cách tổ chức place như vậy được trình bày trong hướng dẫn về script client và server.

Cách làm cửa trượt

Chọn VaultDoor, thêm thuộc tính kiểu string tên Style và đặt giá trị Slide. Giờ cửa không xoay nữa mà trượt sang ngang: bằng chính chiều rộng của nó, hoặc SlideDistance stud nếu bạn đã đặt. Để nó trượt về phía kia, đặt khoảng cách âm, ví dụ -4 cho cửa rộng 4 stud. Bất kỳ cửa nào khác, kể cả FrontDoor, cũng thành cửa trượt theo cùng cách ngay khi có thuộc tính này.

DoorService đo hai kích thước ngang của cửa, chiều rộng và độ dày, rồi di chuyển nó theo kích thước lớn hơn. Nó đo Model bằng GetExtentsSize, có hộp bám theo hướng pivot của model, nên cửa bị xoay 90 độ sau khi nhóm vẫn trượt theo chiều rộng, không theo độ dày. Nó đo Part theo Size của chính part, nên đừng xoay pivot của part cửa trượt. Dời pivot đó thì được.

  • Cửa đôi: hai nửa có tag đặt cạnh nhau, cả hai có Style là Slide, và một nửa có SlideDistance âm để chúng tách ra từ giữa. Với cửa đôi xoay, đặt pivot của mỗi nửa ở cạnh ngoài của nó và cho một nửa OpenAngle âm. Mỗi nửa có prompt riêng và mở riêng. Nếu hai nửa trượt vào nhau, hãy chuyển dấu trừ sang nửa kia.
  • Cổng nâng lên: script này chỉ di chuyển cửa theo chiều rộng. Để cửa nâng lên, đặt direction trong script bằng Vector3.yAxis (khi đó mọi cửa trượt sẽ đi lên) và cho mỗi cửa SlideDistance bằng chiều cao của nó.
  • Cửa vật lý: hướng dẫn của Roblox về vật thể chuyển động di chuyển part theo một trục bằng PrismaticConstraint. Giống cửa bản lề, đó là vật lý, không có prompt hay khóa cho đến khi bạn tự viết.

Cách khóa cửa bằng chìa

Cửa bị khóa chỉ mở cho người chơi có Tool đúng tên. Hãy làm chìa, rồi báo tên của nó cho cửa:

  1. Rê chuột lên StarterPack, bấm + và chèn một Tool tên RedKey. Chèn vào đó một Part tên Handle, đây là part nhân vật cầm trên tay, và đảm bảo nó không được anchor: part đã anchor trong tool sẽ ghim nhân vật tại chỗ. Bỏ đánh dấu CanBeDropped của Tool nếu người chơi không được vứt chìa cho người khác: khi nó còn bật, Backspace sẽ vứt tool đang cầm ra Workspace.
  2. Chọn VaultDoor, thêm thuộc tính kiểu string tên KeyName và đặt giá trị RedKey. Giờ tên đối tượng trên prompt ghi Needs RedKey.

DoorService tìm chìa ở hai chỗ. Tool nằm trong Backpack của người chơi cho đến khi được trang bị, và trang bị sẽ chuyển nó vào nhân vật, nên cửa mở dù chìa nằm trên hotbar hay trên tay. Việc kiểm tra diễn ra trên server, vì hướng dẫn bảo mật của Roblox nêu đúng trường hợp này, người chơi có chìa cho cửa hay không, như một quyền mà server bắt buộc phải kiểm tra. Chìa chỉ cần để mở: ai cũng có thể đóng cửa đang mở, và nó tự đóng sau AutoCloseSeconds.

StarterPack trao chìa cho mọi người mỗi lần spawn, và khi test thì đó là điều bạn cần. Trong game thật, hãy trao nó theo cách khác:

  • Từ cửa hàng: hướng dẫn GUI cửa hàng trao Tool từ ServerStorage vào Backpack và StarterGear của người mua.
  • Từ nhân vật: hướng dẫn hội thoại NPC trao Tool từ ServerStorage.DialogueItems khi người chơi chọn một lựa chọn có hành động GiveItem. Đặt vào thư mục đó một Tool tên RedKey và cho lựa chọn trong DialogueData action = "GiveItem" và item = "RedKey", và chìa sẽ được trao trong cuộc trò chuyện.
  • Như một vật phẩm trong túi đồ: với hệ thống túi đồ, vật phẩm chìa khóa có tác dụng ngay khi người chơi trang bị, vì trang bị đặt một bản sao Tool của nó vào Backpack và lên tay.

Chìa trong Backpack sẽ mất khi nhân vật chết, vì mỗi lần spawn Roblox nạp lại Backpack từ StarterPack và StarterGear. Để giữ nó, hãy đặt thêm một bản sao vào StarterGear của người chơi, như hướng dẫn cửa hàng làm. Ngược lại, để chìa bị tiêu hao, hãy tìm Tool chìa trong Backpack hoặc nhân vật của người chơi và hủy nó trong handler Triggered, ngay sau khi kiểm tra chìa thành công.

Những chỗ các hướng dẫn làm cửa cũ làm sai

Nếu bạn đang so hướng dẫn này với một video hay bài viết trên diễn đàn, đây là những cách làm gây ra phần lớn các chủ đề "cửa của tôi không chạy", và cách hướng dẫn này làm thay vào đó.

Các cách làm thường gặp trong hướng dẫn làm cửa và cách hướng dẫn này làm thay vào đó
Hướng dẫn cũVấn đềHướng dẫn này
Tween CFrame của cửa ModelTrong tài liệu về Model không có thuộc tính CFrame hay Position. WorldPivot của nó chỉ quy định vị trí pivot của model, nên tween nó sẽ di chuyển điểm pivot, còn các part đứng yên.Tween một NumberValue và di chuyển cả model bằng PivotTo.
Di chuyển model bằng SetPrimaryPartCFrameĐã lỗi thời: Roblox khuyên dùng PivotTo trong dự án mới.Dùng PivotTo, thứ Roblox gọi là hàm chính để di chuyển Model từ script.
Weld mọi part vào một part bản lề và chỉ tween bản lềChạy được khi mọi Weld đều đúng chỗ, nhưng part nào chưa weld sẽ bị bỏ lại khi bản lề di chuyển.Giữ mọi part được anchor, không dùng Weld. PivotTo di chuyển cửa và mọi thứ bên trong nó.
Sao chép cùng một script vào từng cửaMỗi lần sửa phải lặp lại ở từng bản sao. Roblox đề nghị gắn tag cho đối tượng và xử lý chúng bằng một script qua CollectionService.Một DoorService và tag Door.
Mở cửa trong LocalScriptCửa chỉ mở trên màn hình của người chơi đó, còn mọi người khác vẫn thấy nó đóng.Server di chuyển cửa, nên mọi người chơi thấy cùng một cánh cửa.
Mở cửa bằng TouchedTouched kích hoạt nhiều lần liên tiếp cho một lần chạm (trang debounce của Roblox), và thiết bị của người chơi có thể kiểm soát khi nào Touched kích hoạt cho nhân vật của chính họ (tài liệu bảo mật của Roblox).Một prompt được server kiểm tra.
Di chuyển cửa từng bước trong vòng lặp có wait()Roblox đánh dấu wait() là đã được thay bằng task.wait(), và vòng lặp không thể quay ngược giữa chừng khi ai đó bấm lại.Một tween cho mỗi chuyển động. Tween mới trên cùng value hủy tween cũ, nên cửa quay ngược từ chỗ nó đang ở.
Kiểm tra chìa trong LocalScript hoặc không kiểm tra gìKẻ gian lận kiểm soát mọi thứ trên thiết bị của họ, nên kiểm tra trên client không ngăn được ai.Server tìm Tool trong Backpack và nhân vật của người chơi.
Không có thời gian hồi cho promptHướng dẫn bảo mật của Roblox nói prompt dễ bị lạm dụng giống như remote, nên không có gì ngăn việc kích hoạt nó liên tục.Mỗi cửa một lần dùng mỗi 0.3 giây.

Kẻ gian lận làm được gì và không làm được gì

Hãy coi như kẻ gian lận kiểm soát mọi thứ trên thiết bị của họ, kể cả nhân vật của họ. Đây là ý nghĩa của điều đó với những cánh cửa này.

Kẻ gian lận có thể thử gì và DoorService xử lý thế nào
Kẻ gian lận thửKết quảVì sao
Kích hoạt prompt từ đầu kia bản đồBị bỏ qua nếu nhân vật của họ không ở cạnh cửaDoorService đo khoảng cách từ part gốc của nhân vật đến part có prompt và bỏ qua mọi thứ xa hơn 14 stud. Kẻ gian lận có thể teleport nhân vật đến cửa trước (xem dòng cuối), nên kiểm tra khoảng cách chống việc dùng từ xa, chứ không chống teleport.
Kích hoạt nó nhiều lần mỗi giâyKhông quá một lần dùng cửa mỗi 0.3 giâyServer lưu thời điểm dùng gần nhất của mỗi cửa.
Mở cửa có khóa mà không có chìaBị từ chốiServer tìm Tool trong Backpack và nhân vật của họ ở nơi server tự thấy, không phải trên màn hình của kẻ gian lận.
Dùng cửa khi nhân vật đã chếtBị bỏ quaDoorService kiểm tra có Humanoid với máu lớn hơn 0 và có part gốc.
Vẫn đi xuyên qua cửa đóngCó thểTài liệu bảo mật của Roblox liệt kê việc vượt qua chướng ngại vật lý và thay đổi va chạm của chính mình trong số những gì client có thể làm với nhân vật của họ.
Teleport ra sau cửaCó thểCùng tài liệu đó nhắc đến việc teleport nhân vật của mình đến bất kỳ điểm nào.

Bước 3: kiểm tra

  1. Bấm Play (F5). Đến gần FrontDoor: trong vòng 8 stud, prompt xuất hiện với hành động Open và tên đối tượng Door. Giữ E. Sau 0.2 giây, cửa xoay mở 90 độ quanh cạnh bản lề trong 0.6 giây, và giờ prompt ghi Close.
  2. Đi qua cửa và đợi. Bốn giây sau khi mở hết, cửa tự đóng. Giữ E trong lúc nó đang đóng: nó quay ngược và mở ra từ chỗ nó đang ở.
  3. Kiểm tra khóa. Nếu RedKey đang nằm trong StarterPack, tạm chuyển nó sang ServerStorage, bấm Play và giữ E ở VaultDoor: prompt ghi Needs RedKey, và không có gì di chuyển. Dừng game, đưa RedKey về StarterPack và chạy lại: VaultDoor mở, dù chìa nằm trên hotbar hay trên tay.
  4. Kiểm tra cửa trượt. VaultDoor, một Model có Style là Slide, trượt sang ngang bằng chiều rộng của nó khi mở. Dừng game, chọn VaultDoor, xoay nó 90 độ bằng công cụ Rotate và chạy lại: nó vẫn phải trượt theo chiều rộng, không theo độ dày. Làm xong thì xoay nó về.
  5. Chọn Server & Clients trong danh sách chế độ test, đặt 2 client và bấm Play. Mở cửa trong cửa sổ của một client: nó cũng mở trong cửa sổ kia và đóng ở cả hai.
  6. Dừng game, chọn cửa và bấm Ctrl+D để nhân bản, rồi chuyển bản sao sang khung cửa khác. Kiểm tra bản sao vẫn có Door trong Tags, và bấm Play: bản sao chạy mà không cần thêm script.

Hãy để cửa sổ Output mở (menu Window, rồi Output). Khi mọi thứ chạy, DoorService không in gì. Cảnh báo rằng một cửa "has no part to put the prompt on" nghĩa là bên trong Model có tag không có part nào. Những vấn đề khác xem ở phần Lỗi thường gặp.

Cách mở rộng

Cửa tự động

Để cửa mở khi có người đến gần, hãy gọi move(true) từ bên trong setUpDoor, không cần đợi prompt. Ở cuối setUpDoor, chạy một vòng lặp bằng task.spawn, vì vòng lặp thường ở đó sẽ không bao giờ kết thúc, và DoorService sẽ không đi tiếp qua cửa đầu tiên. Cho nó chạy chỉ khi cửa còn trong game: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Trong vòng lặp, kiểm tra bằng workspace:GetPartBoundsInBox xem có nhân vật nào trong hộp quanh khung cửa không, và gọi move(true) khi có mà cửa đang đóng. Sau đó tự đóng sẽ đóng nó như trước. Đặt Enabled của prompt bằng false nếu cửa chỉ nên tự mở.

Cửa VIP

Hướng dẫn game pass đã dựng một cửa VIP mà người sở hữu pass đi xuyên qua trực tiếp, bằng collision group. Với cửa VIP mở bằng E, hãy thêm một kiểm tra nữa vào handler Triggered cạnh kiểm tra chìa: return nếu không thỏa player:GetAttribute("OwnsPass_VIP") == true, đây là thuộc tính do script server trong hướng dẫn game pass đặt. Chỉ đọc nó trên server.

Bàn phím mã số

Với cửa mở bằng mã nhập vào, hãy giữ mã trong Script server hoặc trong ServerStorage, những nơi người chơi không bao giờ nhận được, và tuyệt đối không trong LocalScript, nơi kẻ gian lận có thể đọc nó. LocalScript của bàn phím chỉ gửi các chữ số đã nhập qua RemoteEvent. Trên server, kiểm tra người chơi ở gần cửa, giới hạn tần suất thử, so các chữ số và chỉ khi đó mới gọi move(true). Hướng dẫn RemoteEvent chỉ cách kiểm tra những gì remote nhận được.

Âm thanh

Đặt một Sound bên trong part của cửa để nó phát từ vị trí part đó, và gọi phương thức Play của nó ở đầu move. Hoặc phát nó từ một LocalScript lắng nghe thuộc tính Open của cửa qua GetAttributeChangedSignal("Open"), vì server đặt thuộc tính này mỗi lần cửa di chuyển.

Cửa được thêm trong lúc chơi

Clone cửa mới từ một mẫu đang đóng trong ServerStorage. DoorService ghi nhận vị trí đóng của cửa vào lúc nó xuất hiện, nên bản sao của một cửa đang mở vào lúc đó sẽ coi vị trí mở là vị trí đóng. Đặt bản sao vào khung cửa bằng PivotTo trước khi đặt Parent của nó là Workspace, để DoorService nhớ chỗ đó là vị trí đóng. Prompt và value cũ đi theo bản sao sẽ tự động bị xóa. Về cửa đưa người chơi sang khu vực khác hoặc place khác, hãy đọc hướng dẫn teleport.

Lỗi thường gặp và cách sửa

Mở cửa sổ Output (menu Window, rồi Output) trước khi bấm Play. Phần lớn vấn đề với cửa đến từ tag, pivot hoặc thuộc tính hơi khác so với những gì script chờ đợi.

Cửa không hiện prompt

Kiểm tra theo thứ tự: DoorService là Script, không phải LocalScript, và nằm trực tiếp trong ServerScriptService; cửa có tag Door với chữ D hoa, với cửa model thì trên chính Model; cửa là part (Part, MeshPart hoặc BasePart khác) hoặc Model; và bạn đứng cách part mang prompt không quá 8 stud. Cảnh báo trong Output rằng cửa "has no part to put the prompt on" nghĩa là bên trong Model có tag không có part nào.

Cửa rơi, trôi đi hoặc bị đẩy khi game chạy

Có part nào đó của nó chưa được anchor. Chọn mọi part của cửa và đánh dấu Anchored. Part đã anchor không bao giờ di chuyển vì vật lý, nhưng DoorService vẫn có thể di chuyển chúng.

Tôi đã đổi thuộc tính nhưng cửa bỏ qua nó

Kiểm tra ba điều. Kiểu: OpenAngle, SlideDistance, OpenSeconds và AutoCloseSeconds phải là thuộc tính kiểu number, còn Style và KeyName là kiểu string; nếu sai kiểu, DoorService dùng giá trị mặc định. Chính tả: tên được so chính xác, nên openAngle là một thuộc tính khác. Giá trị cũng được so chính xác: Style phải là Slide với chữ S hoa và không có khoảng trắng. Thời điểm: DoorService đọc thuộc tính một lần khi thiết lập cửa, nên thay đổi trong lúc playtest không có tác dụng cho đến khi bạn chạy lại game.

Cửa mở sai hướng hoặc đổ nghiêng

Để nó mở về phía kia, cho OpenAngle giá trị âm, ví dụ -90. Nếu nó xoay quanh trục ngang thay vì bản lề đứng, nghĩa là chính pivot đã bị xoay: bật Pivot ở tab Model và xoay pivot lại cho thẳng đứng.

Cửa trượt chui vào tường hoặc chỉ nhích một chút

Cho nó SlideDistance âm để nó trượt về phía kia. Nếu nó trượt quá ít hoặc quá xa, đặt SlideDistance bằng số stud cần thiết và đừng dựa vào chiều rộng đo được.

Tôi có chìa nhưng cửa không mở

Chìa phải là Tool, không phải Part hay Model, và tên của nó phải trùng chính xác với KeyName, kể cả chữ hoa. Nó phải nằm trong Backpack của bạn hoặc trên tay. Cũng kiểm tra KeyName trên cửa là thuộc tính kiểu string.

Làm với RoCode

Nếu không muốn tự thiết lập mọi thứ, RoCode có thể dựng nó trong place bạn đang mở. RoCode là AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn mô tả thay đổi trong web chat, và plugin Studio của nó tạo script và đối tượng trong Explorer của bạn, nên không cần dán code.

Bạn gõ

Làm cho các cửa có tag Door mở bằng prompt giữ E: xoay 90 độ quanh pivot trong 0.6 giây, đóng lại sau 4 giây, trượt thay vì xoay khi thuộc tính Style bằng Slide, và cửa vẫn đóng nếu người chơi không có Tool có tên trong KeyName. Mọi thứ trên server, có kiểm tra khoảng cách.

RoCode làm
  • Có thể xem place của bạn khi bước đó cần, qua Search Game và Search Scripts, để dựa vào vật phẩm, remote hoặc code lưu dữ liệu đã có thay vì thêm hệ thống thứ hai
  • Viết Script trong ServerScriptService qua Create Script, có thể tạo part cửa qua Create Instance và đặt trên đó các thuộc tính như Style và KeyName
  • Được dặn kiểm tra biên dịch mỗi script đã viết bằng Check Script, công cụ biên dịch script trong Studio mà không chạy nó
  • Đặt điểm hoàn tác trước và sau mỗi đợt thay đổi, nên Ctrl+Z lùi lại từng đợt một

Trước khi test, hãy kiểm tra pivot của từng cửa bằng công cụ Pivot trong Studio: cửa xoay quanh nó. Với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, và với plugin 3.9.15 trở lên nó có thể điều khiển một nhân vật thử nghiệm biết đi và nhấn phím, nhưng nó chỉ kiểm tra những gì nó tự quyết định test, nên hãy tự đến từng cửa và giữ E. RoCode kết nối với Studio thế nào.

Câu hỏi thường gặp

Làm sao để cửa mở bằng phím E trong Roblox Studio?

Đặt một ProximityPrompt vào cửa và kết nối sự kiện Triggered của nó trong một Script server di chuyển cửa. DoorService làm cả hai việc cho mọi cửa có tag Door. E là phím mặc định của prompt, và Roblox hiện đúng nút nhập cho bàn phím, tay cầm và màn hình cảm ứng.

Vì sao cửa của tôi quay quanh tâm của nó?

Pivot của nó vẫn ở tâm. Bật Pivot ở tab Model và kéo pivot ra cạnh bản lề; script xoay cửa quanh pivot.

Làm cửa trượt thế nào?

Đặt thuộc tính Style của cửa thành Slide. Nó trượt sang ngang bằng chiều rộng của nó hoặc SlideDistance stud; khoảng cách âm trượt nó về phía kia.

Có làm được cửa không cần script không?

Có. Hướng dẫn của Roblox về cửa bản lề gắn một cửa không anchor vào khung bằng HingeConstraint có giới hạn, và người chơi mở nó bằng cách đẩy người vào. Cửa như vậy không có prompt, khóa hay tự đóng.

Làm cửa chỉ VIP mở được thế nào?

Dùng cửa VIP trong hướng dẫn game pass, thứ người sở hữu pass đi xuyên qua, hoặc thêm vào handler Triggered trong DoorService một kiểm tra đọc trên server xem người chơi có sở hữu pass trước khi mở hay không, ví dụ thuộc tính OwnsPass_VIP mà hướng dẫn đó đặt.

Vì sao cửa mở với tôi nhưng không mở với người chơi khác?

Nó được mở bởi LocalScript, và thay đổi do LocalScript làm chỉ ở lại trên thiết bị của người chơi đó. Hãy chuyển code mở cửa sang Script server, như trong DoorService, để thay đổi đến được với mọi người.

Nguồn và tài liệu đọc thêm

Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.