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
WorldPivotcủa nó chỉ quy định vị trí pivot. Hãy tween một NumberValue và di chuyển cửa bằngPivotTo: 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
Cửa dùng script hoạt động thế nào
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:
- 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.
- Người chơi giữ E trong 0.2 giây. Sự kiện
Triggeredcủa prompt kích hoạt trên server kèm người chơi đó. - 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.
- 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ở. - 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 ở.
| Thành phần | Nằm ở đâu | Làm gì |
|---|---|---|
Script DoorService | ServerScriptService | Tì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 Door | Trê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à KeyName | Trê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 DoorPrompt | Bê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 DoorProgress | Bê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, để test | Chì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. |
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ề
- Trong Explorer, rê chuột lên Workspace, bấm nút + và chèn một Part. Đặt tên là
FrontDoor, đặtSizekhoảng4, 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. - Đá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.
- Đặ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.
- Thêm tag. Vẫn chọn cửa, cuộn cửa sổ Properties xuống Tags, bấm + và gõ
Doorvớ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. - 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:
Panelcỡ khoảng4, 7, 0.5vàKnobkhoảng0.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ànhVaultDoor. Anchor cả hai part, đặt model vào khung cửa thứ hai và thêm tagDoorlê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 | Kiểu | Mặc định | Làm gì |
|---|---|---|---|
Style | string | Swing | Swing xoay cửa quanh pivot của nó. Slide trượt nó sang ngang theo chiều rộng. |
OpenAngle | number | 90 | Cử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. |
SlideDistance | number | chiề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. |
OpenSeconds | number | 0.6 | Một lần mở hoặc đóng hoàn toàn mất bao lâu, trong khoảng 0.05 đến 10. |
AutoCloseSeconds | number | 4 | Cửa mở hết bao lâu trước khi tự đóng. 0 để nó mở cho đến khi có người đóng. |
KeyName | string | khô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 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.
| Phần script | Là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 leftover | Thiế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à PivotTo | Tween 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 đó. |
| Prompt | HoldDuration 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 Triggered | Mỗ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ó
Stylelà 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ửaOpenAngleâ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
directiontrong script bằngVector3.yAxis(khi đó mọi cửa trượt sẽ đi lên) và cho mỗi cửaSlideDistancebằ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:
- 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ênHandle, đâ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ấuCanBeDroppedcủ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. - Chọn VaultDoor, thêm thuộc tính kiểu string tên
KeyNamevà đặ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.DialogueItemskhi người chơi chọn một lựa chọn có hành độngGiveItem. Đặt vào thư mục đó một Tool tên RedKey và cho lựa chọn trong DialogueDataaction = "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 đó.
| Hướng dẫn cũ | Vấn đề | Hướng dẫn này |
|---|---|---|
Tween CFrame của cửa Model | Trong 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ửa | Mỗ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 LocalScript | Cử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 Touched | Touched 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 prompt | Hướ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 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ửa | DoorService đ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ây | Không quá một lần dùng cửa mỗi 0.3 giây | Server 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ìa | Bị từ chối | Server 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ết | Bị bỏ qua | DoorService 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 đóng | Có 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ửa | Có 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
- 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.
- Đ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 ở.
- 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.
- Kiểm tra cửa trượt. VaultDoor, một Model có
Stylelà 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ề. - 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.
- 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.
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.
- 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
- Roblox Creator Docs: PVInstance:PivotTo (bằng tiếng Anh). di chuyển một part hoặc cả model theo pivot của nó
- Roblox Creator Docs: Pivot tools (bằng tiếng Anh). dời pivot, Snap và điểm neo, pivot khi có PrimaryPart
- Roblox Creator Docs: Model (bằng tiếng Anh). WorldPivot, GetExtentsSize theo pivot, SetPrimaryPartCFrame đã lỗi thời
- Roblox Creator Docs: CFrame:Lerp (bằng tiếng Anh). phép xoay được nội suy theo cung ngắn nhất
- Roblox Creator Docs: TweenService (bằng tiếng Anh). những gì tween được và tween thứ hai trên cùng thuộc tính hủy tween đầu thế nào
- Roblox Creator Docs: Proximity prompts (bằng tiếng Anh). tạo và tùy chỉnh prompt, nhập liệu trên mọi thiết bị và tầm nhìn trực tiếp
- Roblox Creator Docs: ProximityPrompt (bằng tiếng Anh). phím và nút mặc định, HoldDuration, MaxActivationDistance và Triggered
- Roblox Creator Docs: CollectionService (bằng tiếng Anh). tag, GetTagged và GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (bằng tiếng Anh). thêm tag và thuộc tính trong Studio
- Roblox Creator Docs: Securing the client-server boundary (bằng tiếng Anh). ProximityPrompt như một bề mặt tấn công và kiểm tra quyền "chìa khóa và cửa"
- Roblox Creator Docs: Network ownership, movement validation, and physics (bằng tiếng Anh). những gì client có thể làm với nhân vật của mình
- Roblox Creator Docs: Build a hinged door (bằng tiếng Anh). cửa dùng HingeConstraint không cần code
- Roblox Creator Docs: In-game tools (bằng tiếng Anh). Handle, anchor và StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (bằng tiếng Anh). Backspace làm gì với tool đang cầ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.