Singkatnya
Buat pintunya sebagai Part atau Model, centang Anchored, pindahkan pivot-nya ke tepi engsel (tab Model, Pivot), dan tambahkan tag Door di jendela Properties. Satu Script di ServerScriptService menemukan setiap pintu yang diberi tag dengan CollectionService, menambahkan ProximityPrompt ("Open", tahan E), dan saat Triggered men-tween sebuah NumberValue dari 0 sampai 1 sambil menggerakkan pintu dengan door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Atribut di setiap pintu menentukan ayun atau geser, sudutnya, waktunya, tutup otomatis dan kuncinya.
- Kamu tidak bisa men-tween posisi Model secara langsung: Model tidak punya properti CFrame atau Position, dan
WorldPivot-nya hanya mengatur letak pivot-nya. Tween sebuah NumberValue dan gerakkan pintu denganPivotTo, yang disebut Roblox sebagai cara utama menggerakkan model dari script. - Buka pintu di server. Pintu yang dibuka oleh LocalScript hanya bergerak di layar pemain itu.
- Cek kunci dan jaraknya di server. Panduan keamanan Roblox menyebut ProximityPrompt bisa disalahgunakan sama seperti RemoteEvent, dan contoh pengecekan yang wajib dilakukan server di sana adalah "Do they have a key required to open a door?" (apakah mereka punya kunci yang dibutuhkan untuk membuka pintu?).
Di halaman ini
Cara kerja pintu dengan script
Pintu yang berfungsi di game live harus digerakkan oleh server. Kalau LocalScript yang menggerakkannya, pintu terbuka di layar satu pemain itu dan tetap tertutup bagi semua orang lain, karena perubahan yang dibuat client tetap di perangkat itu (lihat apa yang direplikasi dan apa yang tidak, dalam bahasa Inggris). Jadi di panduan ini perangkat pemain hanya menampilkan prompt dan melaporkan penekanan tombol, dan satu Script server mengerjakan sisanya. Satu kali pemakaian pintu berjalan seperti ini:
- Pemain berjalan sampai jarak 8 stud dari pintu dan muncul prompt dengan aksi Open dan nama objek Door, serta E di keyboard. Roblox menampilkan tombol yang sesuai di gamepad atau layar sentuh.
- Pemain menahan E selama 0,2 detik. Event
Triggeredmilik prompt terjadi di server dengan pemain itu. - DoorService mengecek pemainnya: hidup, cukup dekat, tidak men-spam prompt, dan membawa kunci kalau pintunya butuh kunci.
- Script men-tween sebuah angka dari 0 (tertutup) ke 1 (terbuka). Setiap kali angkanya berubah, script menggerakkan pintu sejauh pecahan itu dari posisi tertutup ke posisi terbukanya dengan
PivotTo. - Empat detik setelah pintu terbuka penuh, script menutupnya dengan cara yang sama. Penekanan saat pintu sedang bergerak membalikkan pintu dari posisinya saat itu.
| Bagian | Tempatnya | Fungsinya |
|---|---|---|
Script DoorService | ServerScriptService | Menemukan setiap pintu, menambahkan prompt-nya, mengecek setiap pemakaian dan menggerakkan pintu. Satu-satunya script di panduan ini. |
Tag Door | Di setiap Part atau Model pintu | Menandai mana yang pintu. Tag ditambahkan di jendela Properties, dan ikut tersimpan bersama place. |
Atribut seperti Style dan KeyName | Di setiap pintu (opsional) | Pengaturan untuk satu pintu: ayun atau geser, sudut, kecepatan, tutup otomatis dan kunci. |
ProximityPrompt DoorPrompt | Di dalam pintu (ditambahkan DoorService) | Menampilkan "Open" atau "Close" dan memicu Triggered saat pemain menahan E. |
NumberValue DoorProgress | Di dalam pintu (ditambahkan DoorService) | Angka yang digerakkan tween antara 0 dan 1. Setiap perubahan menggerakkan pintu. |
Tool RedKey (opsional) | StarterPack, untuk testing | Kunci untuk pintu yang terkunci. Tool apa pun bisa dipakai asal namanya cocok dengan KeyName pintu. |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
Langkah 1: Buat pintunya dan atur engselnya
- Di Explorer, arahkan kursor ke Workspace, klik tombol + dan sisipkan Part. Beri nama
FrontDoor, aturSize-nya kira-kira4, 7, 0.5(lebar 4 stud, tinggi 7, tebal setengah stud) dan pindahkan ke lubang pintumu. Pintu dari beberapa part juga bisa: pilih semuanya dan tekan Ctrl+G untuk mengelompokkannya menjadi Model. - Centang Anchored di setiap part pintu dan biarkan CanCollide menyala. Part yang di-anchor tidak pernah bergerak karena gravitasi atau tabrakan, tapi script tetap bisa menggerakkannya, dan itulah yang dilakukan DoorService.
- Atur engselnya. Pilih pintunya, buka tab Model dan nyalakan Pivot. Klik dan tahan panah kecil di sudut tombol Pivot lalu centang Snap, supaya pivot menempel ke hotspot di sudut, tepi dan tengah. Seret pivot ke tepi pintu tempat engselnya seharusnya berada. Pintu geser boleh tetap punya pivot di tengah.
- Tambahkan tag. Dengan pintu masih terpilih, gulir jendela Properties ke Tags, klik + dan ketik
Door, dengan D kapital. Untuk pintu Model, beri tag pada Model-nya, bukan part di dalamnya. - Buat pintu kedua, untuk bagian pintu geser dan kunci nanti. Sisipkan dua Part lagi di Workspace:
Panel, berukuran kira-kira4, 7, 0.5, danKnob, kira-kira0.5, 0.5, 0.5, ditempelkan ke salah satu sisi Panel. Pilih keduanya, tekan Ctrl+G dan ganti nama Model barunya menjadiVaultDoor. Anchor kedua part, pindahkan model ke lubang pintu kedua dan tambahkan tagDoorke Model-nya. Pivot-nya boleh tetap di tengah, karena pintu ini akan bergeser.
Pivot penting karena pintu ayun berputar pada pivot itu. Kalau dibiarkan di tengah, pintu berputar di tempat seperti pintu putar. Untuk part, pivot yang kamu atur disimpan sebagai PivotOffset-nya, dan GetPivot menyertakannya, jadi script memutar pintu tepat pada titik yang kamu pilih. Kalau Model punya PrimaryPart, pivot model adalah pivot part itu, dan DoorService juga menaruh prompt di part itu. Tanpa PrimaryPart, prompt ditaruh di part pertama yang ditemukan di dalam model. Kalau kamu mengatur PrimaryPart, atur sebelum memindahkan pivot: mengisinya memindahkan pivot model ke pivot part itu, seperti dicatat halaman Pivot tools Roblox.
Pengaturan pintu (atribut)
Setiap pintu berfungsi dengan nilai default di bawah. Untuk mengubah satu pintu, pilih pintunya, gulir jendela Properties ke Attributes, klik +, masukkan namanya, pilih tipenya dan klik Save, lalu atur nilainya. DoorService membaca atribut satu kali, saat menyiapkan pintu, jadi ubahlah saat game berhenti.
| Atribut | Tipe | Default | Fungsinya |
|---|---|---|---|
Style | string | Swing | Swing memutar pintu pada pivot-nya. Slide menggesernya ke samping sepanjang lebarnya. |
OpenAngle | number | 90 | Derajat putaran pintu ayun. Angka negatif mengayunkannya ke arah sebaliknya. Jaga antara -179 dan 179: pintu selalu mengambil jalan putar yang lebih pendek, jadi DoorService membatasinya di situ. |
SlideDistance | number | lebarnya | Jumlah stud pintu geser bergerak sepanjang lebarnya. Angka negatif menggesernya ke arah sebaliknya. |
OpenSeconds | number | 0.6 | Lama satu kali buka atau tutup penuh, dijaga antara 0,05 dan 10. |
AutoCloseSeconds | number | 4 | Lama pintu tetap terbuka penuh sebelum menutup sendiri. 0 membiarkannya terbuka sampai ada yang menutupnya. |
KeyName | string | tidak ada | Nama Tool yang harus dimiliki pemain untuk membuka pintu, misalnya RedKey. Jangan diisi untuk pintu yang bisa dibuka siapa saja. |
Langkah 2: Tambahkan script pintu
Arahkan kursor ke ServerScriptService, sisipkan Script bernama DoorService dan tempel kode di bawah. Script ini menjalankan setiap pintu di place, berapa pun yang kamu beri tag. Tiga pengaturan di bagian atas berlaku untuk semua pintu; atribut dari Langkah 1 mengubah satu pintu.
-- Script di ServerScriptService bernama DoorService.
-- Membuka dan menutup setiap Part atau Model bertag "Door" dengan prompt tahan E.
-- Server yang menggerakkan pintu, jadi setiap pemain melihat pintu yang sama, dan server
-- mengecek jarak dan kuncinya, jadi tidak ada yang bisa membuka pintu terkunci dari jauh.
--
-- Atribut opsional di setiap pintu (atur di jendela Properties):
-- Style string "Swing" (default) atau "Slide"
-- OpenAngle number derajat putaran pintu ayun pada pivot-nya (default 90, -179 sampai 179)
-- SlideDistance number stud pergeseran pintu geser sepanjang lebarnya (default: lebarnya)
-- OpenSeconds number lama membuka (default 0.6)
-- AutoCloseSeconds number menutup lagi setelah selama ini; 0 membiarkannya terbuka (default 4)
-- KeyName string nama Tool yang harus dimiliki pemain, misalnya "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 -- per pintu, melawan 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 atau tak hingga diketik di jendela 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 jadi pintu yang berfungsi, atau bukan part maupun 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 prompt dan value lamanya: hapus keduanya
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- Hitung posisi tertutup dan terbuka satu kali, dari tempat pintu berada sekarang
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- Geser sepanjang sisi datar pintu yang lebih panjang, yaitu lebarnya. Model diukur sepanjang
-- sisi pivot-nya, Part dengan Size-nya sendiri, jadi jangan putar pivot Part yang bergeser
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 selalu berputar lewat jalan yang lebih pendek, jadi sudut lebih besar akan berayun 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 sebuah angka dari 0 (tertutup) ke 1 (terbuka) dan gerakkan pintu mengikutinya.
-- PivotTo menggerakkan satu part atau seluruh model pada pivot-nya.
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) -- script lain bisa membaca ini
prompt.ActionText = if open then "Close" else "Open"
-- Tween baru pada value yang sama membatalkan yang lama, jadi pintu bisa berbalik di tengah jalan.
-- Skalakan waktunya dengan jarak yang masih harus ditempuh.
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 keamanan Roblox menyebut prompt bisa disalahgunakan seperti remote, jadi cek 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 memakai prompt secara jujur
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- terkunci, dan pemain ini tidak punya kunci
end
lastUse = now
move(not isOpen)
end)
end
-- Setiap pintu yang bertag sekarang, dan yang diberi tag nanti (termasuk pintu yang di-clone oleh script)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
DoorService sendiri yang menambahkan DoorPrompt dan DoorProgress ke setiap pintu saat game dimulai, jadi tidak ada yang perlu disisipkan secara manual. Simpan satu salinan script saja: script ini sudah menangani setiap pintu yang bertag.
| Bagian script | Fungsinya | Alasannya |
|---|---|---|
attribute() | Membaca satu atribut dan kembali ke nilai default kalau atributnya tidak ada, tipenya salah, atau bukan angka nyata (NaN atau tak hingga). | Salah ketik di jendela Properties menghasilkan pintu dengan pengaturan default, bukan pintu yang rusak. |
doorsSetUp dan loop leftover | Menyiapkan setiap pintu satu kali, dan lebih dulu menghapus DoorPrompt atau DoorProgress yang tersalin dari pintu lain. | Tanpa itu, salinan pintu yang berfungsi akan punya dua prompt, salah satunya mati. |
closedPivot dan openPivot | Dihitung satu kali, dari tempat pintu berdiri saat disiapkan. Ayunan memutar pivot pada sumbu atasnya sendiri; geseran memindahkannya sepanjang sisi pintu yang lebih panjang. | Lerp dari pivot tertutup ke pivot terbuka menjaga pivot tetap di tempat selagi pintu berputar, jadi tepi engsel tidak bergeser sepanjang ayunan. |
DoorProgress dan PivotTo | Tween mengubah sebuah angka; setiap perubahan menggerakkan pintu ke closedPivot:Lerp(openPivot, alpha). | TweenService bisa men-tween NumberValue, dan PivotTo menggerakkan part, atau model beserta semua part-nya, supaya pivot-nya mendarat di CFrame itu. |
| Prompt | HoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight mati. Pintu terkunci menampilkan "Needs RedKey". | Dengan line of sight menyala, prompt tersembunyi saat ada yang menghalangi pandangan ke part-nya; mematikannya mencegah kusen atau bagian lain pintu Model menyembunyikannya. |
move() | Memulai tween menuju 1 atau 0, dengan waktu yang diskalakan menurut jarak yang masih harus ditempuh pintu. | Tween baru pada value yang sama membatalkan yang lama, jadi pintu yang dibalik di tengah jalan berbalik dengan mulus dan butuh setengah waktunya. |
| Tutup otomatis | Menunggu selama waktu membuka ditambah AutoCloseSeconds, lalu menutup pintu hanya kalau moveCount belum berubah. | Timer lama tidak pernah menutup pintu yang sudah ditutup dan dibuka lagi oleh seseorang sementara itu. |
Pengecekan Triggered | Satu pemakaian per pintu setiap 0,3 detik, karakter yang hidup, dalam jarak 14 stud dari part prompt, dan kuncinya, tapi hanya untuk membuka. | Apa pun yang bisa dipicu client bisa disalahgunakan, jadi server mengulang pengecekannya. Angka 14 stud adalah 8 milik prompt ditambah 6 kelonggaran untuk pemain yang bergerak sambil menahan E. |
Atribut Open | Diatur di pintu pada setiap gerakan. | Atribut yang diatur di server direplikasi ke setiap pemain, jadi script lain, termasuk LocalScript, bisa mendengarkannya dengan GetAttributeChangedSignal("Open"). |
Memberi tag pada setiap pintu dan menjalankannya dari satu script adalah pola yang direkomendasikan Roblox: referensi CollectionService-nya mengatakan bahwa kalau kamu mendapati dirimu menambahkan script yang sama ke banyak objek, script yang memakai CollectionService mungkin lebih baik. GetTagged mengembalikan pintu yang ada saat script mulai, dan GetInstanceAddedSignal menangkap pintu yang diberi tag atau ditambahkan belakangan. Panduan script client dan server (dalam bahasa Inggris) membahas cara menata place seperti ini.
Membuat pintu geser
Pilih VaultDoor, tambahkan atribut string bernama Style dan isi dengan Slide. Pintu lalu bergeser ke samping, tidak berputar: sejauh lebarnya sendiri, atau sejauh SlideDistance stud kalau kamu mengisinya. Untuk menggesernya ke arah sebaliknya, pakai jarak negatif, misalnya -4 untuk pintu 4 stud. Pintu lain mana pun, termasuk FrontDoor, bergeser dengan cara yang sama begitu punya atribut ini.
DoorService mengukur dua ukuran mendatar pintu, lebar dan tebalnya, dan menggeser sepanjang yang lebih panjang. Untuk Model, pengukurannya memakai GetExtentsSize, yang kotaknya mengikuti orientasi pivot model, jadi pintu yang diputar 90 derajat setelah kamu kelompokkan tetap bergeser sepanjang lebarnya, bukan tebalnya. Untuk Part, yang diukur adalah Size part itu sendiri, jadi jangan putar pivot part yang bergeser. Memindahkan pivot itu tidak masalah.
- Pintu ganda: dua belahan bertag yang bersebelahan, keduanya dengan
StyleSlide, dan salah satunya denganSlideDistancenegatif supaya keduanya membelah di tengah. Untuk pintu ganda ayun, taruh pivot tiap belahan di tepi luarnya dan beri salah satu belahanOpenAnglenegatif. Tiap belahan punya prompt sendiri dan terbuka sendiri-sendiri. Kalau kedua belahan bergerak saling menabrak, pindahkan tanda minusnya ke belahan yang lain. - Gerbang yang bergeser ke atas: script ini hanya menggeser sepanjang lebar pintu. Untuk mengangkat pintu, ubah
directiondi script menjadiVector3.yAxis(setiap pintu geser lalu bergerak ke atas) dan beri masing-masingSlideDistanceyang sama dengan tingginya. - Pintu fisika: tutorial moving objects dari Roblox menggerakkan part sepanjang satu sumbu dengan PrismaticConstraint. Seperti pintu engsel, itu fisika, tanpa prompt atau kunci kecuali kamu menulis script-nya.
Mengunci pintu dengan kunci
Pintu terkunci hanya terbuka untuk pemain yang punya Tool dengan nama yang tepat. Buat kuncinya, lalu beri tahu pintu namanya:
- Arahkan kursor ke StarterPack, klik + dan sisipkan Tool bernama
RedKey. Sisipkan satu Part ke dalamnya bernamaHandle, part yang dipegang karakter, dan pastikan part itu tidak di-anchor: part yang di-anchor di dalam tool menahan karakter di tempat. Hilangkan juga centangCanBeDroppeddi Tool kalau pemain tidak boleh menjatuhkan kunci untuk orang lain: selama dicentang, Backspace menjatuhkan tool yang sedang dipegang ke Workspace. - Pilih VaultDoor, tambahkan atribut string bernama
KeyNamedan isi denganRedKey. Nama objek di prompt sekarang bertuliskan Needs RedKey.
DoorService mencari kunci di dua tempat. Tool berada di Backpack pemain sampai mereka memegangnya, dan memegangnya memindahkan Tool ke karakter mereka, jadi pintu terbuka baik kuncinya ada di hotbar maupun di tangan. Pengecekannya berjalan di server karena panduan keamanan Roblox menyebut kasus persis ini, "Do they have a key required to open a door?", sebagai izin yang harus diverifikasi server. Hanya membuka yang butuh kunci: siapa pun bisa menutup pintu yang terbuka, dan pintu menutup sendiri setelah AutoCloseSeconds.
StarterPack memberikan kunci ke semua orang setiap kali spawn, yang pas untuk testing. Di game sungguhan, bagikan kuncinya dengan cara lain:
- Dari toko: panduan shop GUI memberikan Tool dari ServerStorage ke Backpack dan StarterGear pembeli.
- Dari karakter: panduan dialog NPC memberikan Tool dari
ServerStorage.DialogueItemssaat pemain memilih pilihan dengan aksiGiveItem. Taruh Tool bernama RedKey di folder itu dan beri sebuah pilihan di DialogueDataaction = "GiveItem"danitem = "RedKey", dan kuncinya datang dari percakapan. - Sebagai item inventory: dengan sistem inventory, item kunci berfungsi begitu pemain memakainya, karena memakainya menaruh salinan Tool-nya di Backpack dan tangan mereka.
Kunci di Backpack hilang saat karakter mati, karena Roblox mengisi ulang Backpack dari StarterPack dan StarterGear setiap kali spawn. Untuk mempertahankannya, taruh juga salinannya di StarterGear pemain, seperti yang dilakukan panduan shop. Untuk kunci sekali pakai, cari Tool kunci di Backpack atau karakter pemain dan hancurkan di handler Triggered, tepat setelah pengecekan kunci lolos.
Kesalahan di tutorial pintu yang lebih lama
Kalau kamu membandingkan panduan ini dengan video atau postingan forum, inilah pola-pola yang menyebabkan sebagian besar thread "pintuku tidak berfungsi", dan apa yang dilakukan panduan ini sebagai gantinya.
| Tutorialnya | Masalahnya | Panduan ini |
|---|---|---|
Men-tween CFrame sebuah Model pintu | Referensi Model tidak mencantumkan properti CFrame atau Position. WorldPivot-nya hanya mengatur letak pivot model, jadi men-tween-nya memindahkan titik pivot dan membiarkan part-nya di tempat. | Men-tween NumberValue dan menggerakkan seluruh model dengan PivotTo. |
Menggerakkan model dengan SetPrimaryPartCFrame | Sudah digantikan: Roblox menyarankan PivotTo untuk pekerjaan baru. | Memakai PivotTo, yang disebut Roblox "the primary function that should be used to move Models via scripting" (fungsi utama untuk menggerakkan Model lewat script). |
| Me-weld setiap part ke satu part engsel dan hanya men-tween engselnya | Berfungsi kalau setiap weld benar, tapi part yang lupa di-weld tertinggal saat engsel bergerak. | Menjaga setiap part di-anchor tanpa weld. PivotTo menggerakkan pintu dan semua isinya. |
| Menyalin script yang sama ke setiap pintu | Setiap perbaikan harus diulang di setiap salinan. Roblox menyarankan memberi tag pada objek dan menanganinya dari satu script dengan CollectionService. | Satu DoorService dan tag Door. |
| Membuka pintu di LocalScript | Pintu hanya terbuka di layar pemain itu, dan semua orang lain masih melihatnya tertutup. | Server yang menggerakkan pintu, jadi setiap pemain melihat pintu yang sama. |
Membuka pintu dari Touched | Touched terjadi beberapa kali berturut-turut dengan cepat untuk satu sentuhan (halaman debounce Roblox), dan perangkat pemain bisa mengendalikan kapan Touched terjadi untuk karakternya sendiri (dokumentasi keamanan Roblox). | Prompt yang dicek server. |
Menggerakkan pintu selangkah demi selangkah dalam loop dengan wait() | Roblox menandai wait() sudah digantikan task.wait(), dan loop tidak bisa berbalik di tengah jalan saat seseorang menekan lagi. | Satu tween per gerakan. Tween baru pada value yang sama membatalkan yang lama, jadi pintu berbalik dari posisinya saat itu. |
| Mengecek kunci di LocalScript, atau tidak sama sekali | Cheater mengendalikan segala sesuatu di perangkatnya sendiri, jadi pengecekan di sisi client tidak menghentikan siapa pun. | Server mencari Tool di Backpack dan karakter pemain. |
| Tanpa cooldown di prompt | Panduan keamanan Roblox menyebut prompt terbuka untuk penyalahgunaan sama seperti remote, jadi tidak ada yang mencegahnya dipicu berulang-ulang. | Satu pemakaian per pintu setiap 0,3 detik. |
Apa yang bisa dan tidak bisa dilakukan cheater
Anggap cheater mengendalikan segala sesuatu di perangkatnya sendiri, termasuk karakternya. Inilah artinya bagi pintu-pintu ini.
| Cheater mencoba | Hasil | Alasannya |
|---|---|---|
| Memicu prompt dari seberang map | Diabaikan kecuali karakternya ada di pintu | DoorService mengukur dari root part karakter mereka ke part prompt dan mengabaikan apa pun di luar 14 stud. Mereka bisa menteleport karakternya ke samping pintu lebih dulu (lihat baris terakhir), jadi pengecekan jarak menghentikan pemakaian dari jauh, bukan teleport. |
| Memicunya berkali-kali per detik | Paling banyak satu pemakaian per pintu setiap 0,3 detik | Server menyimpan waktu pemakaian terakhir untuk setiap pintu. |
| Membuka pintu kunci tanpa kuncinya | Ditolak | Server mencari Tool di Backpack dan karakter mereka, di tempat server melihatnya, bukan di layar mereka. |
| Memakai pintu saat karakternya mati | Diabaikan | DoorService mengecek adanya Humanoid dengan health lebih dari 0 dan sebuah root part. |
| Tetap berjalan menembus pintu tertutup | Mungkin | Dokumentasi keamanan Roblox mencantumkan melewati rintangan fisik dan mengubah collision sendiri di antara hal yang bisa dilakukan client dengan karakternya sendiri. |
| Teleport melewati pintu | Mungkin | Dokumentasi yang sama mencantumkan menteleport karakter sendiri ke posisi mana pun. |
Langkah 3: Tes
- Tekan Play (F5). Berjalanlah ke FrontDoor: dalam jarak 8 stud, muncul prompt dengan aksi Open dan nama objek Door. Tahan E. Setelah 0,2 detik pintu berayun 90 derajat pada tepi engselnya dalam 0,6 detik, dan prompt sekarang bertuliskan Close.
- Berjalanlah melewatinya dan tunggu. Empat detik setelah selesai terbuka, pintu menutup sendiri. Tahan E saat pintu sedang menutup: pintu berbalik dan terbuka dari posisinya saat itu.
- Tes kuncinya. Kalau RedKey ada di StarterPack, pindahkan ke ServerStorage untuk sementara, tekan Play dan tahan E di VaultDoor: prompt bertuliskan Needs RedKey dan tidak ada yang bergerak. Stop, kembalikan RedKey ke StarterPack dan main lagi: VaultDoor terbuka, dengan kunci di hotbar atau di tanganmu.
- Cek geserannya. VaultDoor, Model dengan
StyleSlide, bergeser ke samping sejauh lebarnya sendiri saat terbuka. Stop, pilih VaultDoor, putar 90 derajat dengan tool Rotate dan main lagi: pintu harus tetap bergeser sepanjang lebarnya, bukan tebalnya. Putar kembali setelah selesai. - Pilih Server & Clients di dropdown mode tes, atur 2 client dan tekan Play. Buka sebuah pintu di satu jendela client: pintu itu juga terbuka di jendela lainnya, dan menutup di keduanya.
- Hentikan game, pilih sebuah pintu dan tekan Ctrl+D untuk menduplikatnya, lalu pindahkan salinannya ke lubang pintu lain. Cek bahwa salinannya masih mencantumkan Door di bawah Tags, lalu tekan Play: salinannya berfungsi tanpa script tambahan.
Biarkan jendela Output terbuka (menu Window, lalu Output). DoorService tidak mencetak apa pun saat berfungsi. Peringatan bahwa sebuah pintu "has no part to put the prompt on" berarti Model yang bertag tidak punya part di dalamnya. Lihat Error umum untuk sisanya.
Mengembangkannya
Pintu otomatis
Untuk pintu yang terbuka saat seseorang mendekat, panggil move(true) dari dalam setUpDoor, tanpa menunggu prompt. Di akhir setUpDoor, mulai sebuah loop dengan task.spawn, karena loop biasa di situ tidak pernah selesai dan DoorService tidak akan pernah melewati pintu pertama. Biarkan loop berjalan hanya selama pintu ada di game: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Di dalam loop, cek dengan workspace:GetPartBoundsInBox apakah ada karakter di dalam kotak di sekitar lubang pintu, dan panggil move(true) kalau ada dan pintunya tertutup. Tutup otomatis lalu menutupnya seperti biasa. Atur Enabled milik prompt ke false kalau pintu hanya boleh terbuka sendiri.
Pintu VIP
Panduan game pass (dalam bahasa Inggris) sudah membuat pintu VIP yang bisa langsung ditembus pemilik pass, memakai collision group. Untuk pintu VIP yang dibuka dengan E, tambahkan satu pengecekan lagi di handler Triggered, di samping pengecekan kunci: return kecuali player:GetAttribute("OwnsPass_VIP") == true, atribut yang diatur script server panduan game pass itu. Baca hanya di server.
Keypad kode
Untuk pintu yang terbuka dengan kode yang diketik, simpan kodenya di Script server atau di ServerStorage, yang tidak pernah diterima pemain, dan jangan pernah di LocalScript, tempat cheater bisa membacanya. LocalScript keypad hanya mengirim angka yang diketik lewat RemoteEvent. Di server, cek bahwa pemain berada di dekat pintu, batasi seberapa sering mereka bisa menebak, bandingkan angkanya, dan baru setelah itu panggil move(true). Panduan RemoteEvent menunjukkan cara mengecek apa yang diterima sebuah remote.
Suara
Taruh Sound di dalam part pintu, supaya suaranya terdengar dari posisi part itu, dan panggil method Play-nya di awal move. Atau putar dari LocalScript yang mendengarkan atribut Open pintu dengan GetAttributeChangedSignal("Open"), karena server mengatur atribut itu pada setiap gerakan.
Pintu yang ditambahkan saat game berjalan
Clone pintu baru dari template tertutup di ServerStorage. DoorService membaca posisi tertutup pintu saat pintu itu muncul, jadi salinan dari pintu yang sedang terbuka akan menganggap posisi terbukanya sebagai tertutup. Pindahkan salinan ke lubang pintunya dengan PivotTo sebelum kamu mengatur Parent-nya ke Workspace, supaya DoorService mencatat titik itu sebagai tertutup. Prompt dan value lama yang terbawa salinan dihapus otomatis. Untuk pintu yang membawa pemain ke area lain atau place lain, lihat panduan teleporter.
Error umum dan cara memperbaikinya
Buka jendela Output (menu Window, lalu Output) sebelum kamu menekan Play. Sebagian besar masalah pintu berasal dari tag, pivot atau atribut yang tidak persis seperti yang diharapkan script.
Tidak ada prompt yang muncul di pintu
Cek ini secara berurutan: DoorService adalah Script, bukan LocalScript, langsung di ServerScriptService; pintunya punya tag Door dengan D kapital, di Model-nya sendiri untuk pintu Model; pintunya adalah part (Part, MeshPart atau BasePart lain) atau Model; dan kamu berada dalam jarak 8 stud dari part tempat prompt berada. Peringatan di Output bahwa pintu "has no part to put the prompt on" berarti Model yang bertag tidak punya part di dalamnya.
Pintu jatuh, bergeser atau terdorong saat game dimulai
Salah satu part-nya tidak di-anchor. Pilih setiap part pintu dan centang Anchored. Part yang di-anchor tidak pernah bergerak karena fisika, tapi DoorService tetap bisa menggerakkannya.
Aku mengubah atribut tapi pintu mengabaikannya
Cek tiga hal. Tipenya: OpenAngle, SlideDistance, OpenSeconds dan AutoCloseSeconds harus atribut number, dan Style serta KeyName harus atribut string; DoorService memakai nilai default kalau tipenya salah. Ejaannya: nama dicocokkan persis, jadi openAngle adalah atribut yang berbeda. Nilai juga dicocokkan persis: Style harus Slide dengan S kapital dan tanpa spasi. Waktunya: DoorService membaca atribut satu kali, saat menyiapkan pintu, jadi perubahan saat playtest tidak berpengaruh sampai kamu main lagi.
Pintu berayun ke arah yang salah, atau terguling ke samping
Untuk mengayunkannya ke arah sebaliknya, buat OpenAngle negatif, misalnya -90. Kalau pintu berputar pada sumbu mendatar, bukan pada engsel tegak, pivot-nya sendiri sudah terputar: nyalakan Pivot di tab Model dan putar pivot kembali sampai berdiri tegak.
Pintu geser bergeser masuk ke dinding atau hanya bergerak sedikit
Beri SlideDistance negatif untuk menggesernya ke arah sebaliknya. Kalau gerakannya terlalu sedikit atau terlalu jauh, isi SlideDistance dengan jumlah stud yang kamu mau, jangan mengandalkan lebar yang diukur.
Aku punya kuncinya tapi pintu tetap tertutup
Kuncinya harus berupa Tool, bukan Part atau Model, dan namanya harus cocok persis dengan KeyName, termasuk huruf kapitalnya. Kunci harus ada di Backpack atau di tanganmu. Cek juga bahwa KeyName di pintu adalah atribut string.
Buat dengan RoCode
Kalau kamu tidak mau menyiapkan ini secara manual, RoCode bisa membuatnya di place yang sedang kamu buka. RoCode adalah agen AI independen untuk Roblox Studio, bukan buatan Roblox: kamu menjelaskan perubahannya di web chat, dan plugin Studio-nya membuat script dan instance di Explorer kamu, jadi tidak ada kode yang perlu ditempel.
Buat pintu-pintu bertag Door terbuka dengan prompt tahan E: berayun 90 derajat pada pivot dalam 0,6 detik, menutup setelah 4 detik, bergeser kalau atribut Style bernilai Slide, dan tetap tertutup kecuali pemain punya Tool yang disebut di KeyName. Semua di server, dengan pengecekan jarak.
- Bisa memeriksa place kamu saat sebuah langkah membutuhkannya, dengan Search Game dan Search Scripts, jadi RoCode bisa melanjutkan item, remote atau kode save yang sudah kamu punya, bukan menambah sistem kedua
- Menulis Script di ServerScriptService dengan Create Script, dan bisa membuat part pintu dengan Create Instance serta mengatur atribut seperti Style dan KeyName di part itu
- Diperintahkan untuk mengecek compile setiap script yang ditulisnya dengan Check Script, yang meng-compile-nya di Studio tanpa menjalankannya
- Memasang titik undo sebelum dan sesudah setiap batch perubahan, jadi Ctrl+Z mundur satu batch setiap kali
Cek pivot setiap pintu dengan tool Pivot di Studio sebelum kamu mengetes: pintu berputar pada pivot itu. Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.15 atau lebih baru RoCode bisa mengendalikan karakter tes yang berjalan dan menekan tombol, tapi yang dicek hanya apa yang dipilihnya untuk dites, jadi datangi sendiri setiap pintu dan tahan E. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Bagaimana cara membuat pintu terbuka dengan E di Roblox Studio?
Taruh ProximityPrompt di pintu dan sambungkan event Triggered-nya di Script server, yang menggerakkan pintu. DoorService melakukan keduanya untuk setiap pintu bertag Door. E adalah tombol default prompt, dan Roblox menampilkan input yang tepat untuk keyboard, controller dan layar sentuh.
Kenapa pintuku berputar di tengahnya?
Pivot-nya masih di tengah. Nyalakan Pivot di tab Model dan seret pivot ke tepi engsel; script memutar pintu pada pivot itu.
Bagaimana cara membuat pintu geser?
Isi atribut Style pintu dengan Slide. Pintu bergeser ke samping sejauh lebarnya sendiri, atau sejauh SlideDistance stud; pakai jarak negatif untuk menggeser ke arah sebaliknya.
Bisakah membuat pintu tanpa scripting?
Bisa. Tutorial hinged door dari Roblox menyambungkan pintu yang tidak di-anchor ke kusennya dengan HingeConstraint, dengan batas, jadi pemain mendorongnya terbuka dengan berjalan menabraknya. Pintu itu tidak punya prompt, kunci atau tutup otomatis.
Bagaimana cara membuat pintu yang hanya bisa dibuka VIP?
Pakai pintu VIP dari panduan game pass (dalam bahasa Inggris), yang membiarkan pemilik pass berjalan menembusnya, atau tambahkan pengecekan di handler Triggered milik DoorService yang membaca kepemilikan pass pemain di server sebelum membuka, misalnya atribut OwnsPass_VIP yang diatur panduan itu.
Kenapa pintuku terbuka untukku tapi tidak untuk pemain lain?
Pintunya dibuka di LocalScript, dan perubahan yang dibuat LocalScript tetap di perangkat pemain itu. Pindahkan kode pembukanya ke Script server, seperti DoorService, supaya perubahannya sampai ke semua orang.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: PVInstance:PivotTo (dalam bahasa Inggris). menggerakkan part atau seluruh model lewat pivot-nya
- Roblox Creator Docs: Pivot tools (dalam bahasa Inggris). memindahkan pivot, Snap dan hotspot, dan pivot dengan PrimaryPart
- Roblox Creator Docs: Model (dalam bahasa Inggris). WorldPivot, GetExtentsSize yang mengikuti pivot, dan SetPrimaryPartCFrame yang sudah digantikan
- Roblox Creator Docs: CFrame:Lerp (dalam bahasa Inggris). rotasi diinterpolasi sepanjang busur terpendek
- Roblox Creator Docs: TweenService (dalam bahasa Inggris). apa yang bisa di-tween, dan tween kedua pada properti yang sama membatalkan yang pertama
- Roblox Creator Docs: Proximity prompts (dalam bahasa Inggris). membuat dan menyesuaikan prompt, input untuk setiap perangkat, dan line of sight
- Roblox Creator Docs: ProximityPrompt (dalam bahasa Inggris). tombol default, HoldDuration, MaxActivationDistance dan Triggered
- Roblox Creator Docs: CollectionService (dalam bahasa Inggris). tag, GetTagged dan GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (dalam bahasa Inggris). menambahkan tag dan atribut di Studio
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggris). ProximityPrompt sebagai celah serangan, dan pengecekan izin kunci dan pintu
- Roblox Creator Docs: Network ownership, movement validation, and physics (dalam bahasa Inggris). apa yang bisa dilakukan client dengan karakternya sendiri
- Roblox Creator Docs: Build a hinged door (dalam bahasa Inggris). pintu HingeConstraint tanpa kode
- Roblox Creator Docs: In-game tools (dalam bahasa Inggris). Handle, anchoring dan StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (dalam bahasa Inggris). apa yang dilakukan Backspace pada tool yang sedang dipegang
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.