Tutorial · Sistem game

Cara membuat pintu di Roblox Studio

Pintu yang berfungsi di Roblox butuh tiga hal: sesuatu yang ditekan pemain (ProximityPrompt bertuliskan "Open"), gerakan yang mulus (TweenService), dan server yang melakukan perubahannya supaya setiap pemain melihat pintu yang sama. Panduan ini membuat satu script yang melakukan itu untuk setiap pintu yang kamu beri tag, pintu ayun maupun pintu geser, dengan kunci opsional yang dicek server sebelum membuka apa pun.

Diperbarui 12 November 202619 menit bacaDitulis oleh

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 dengan PivotTo, 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
  1. Cara kerjanya
  2. 1. Buat pintu
  3. 2. Script pintu
  4. Pintu geser
  5. Pintu kunci
  6. Tutorial lama
  7. Batas exploit
  8. 3. Tes
  9. Mengembangkannya
  10. Error umum
  11. Dengan RoCode
  12. Pertanyaan umum
  13. Sumber dan bacaan lanjutan

Cara kerja pintu dengan script

IlustrasiMenahan E selama 0,2 detik mengayunkan pintu terbuka dalam 0,6 detik, dan pintu menutup sendiri 4 detik setelah selesai terbuka (di sini dipercepat), sementara VaultDoor tetap tertutup untuk pemain tanpa RedKey.

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:

  1. 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.
  2. Pemain menahan E selama 0,2 detik. Event Triggered milik prompt terjadi di server dengan pemain itu.
  3. DoorService mengecek pemainnya: hidup, cukup dekat, tidak men-spam prompt, dan membawa kunci kalau pintunya butuh kunci.
  4. 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.
  5. Empat detik setelah pintu terbuka penuh, script menutupnya dengan cara yang sama. Penekanan saat pintu sedang bergerak membalikkan pintu dari posisinya saat itu.
Bagian-bagian sistem pintu
BagianTempatnyaFungsinya
Script DoorServiceServerScriptServiceMenemukan setiap pintu, menambahkan prompt-nya, mengecek setiap pemakaian dan menggerakkan pintu. Satu-satunya script di panduan ini.
Tag DoorDi setiap Part atau Model pintuMenandai mana yang pintu. Tag ditambahkan di jendela Properties, dan ikut tersimpan bersama place.
Atribut seperti Style dan KeyNameDi setiap pintu (opsional)Pengaturan untuk satu pintu: ayun atau geser, sudut, kecepatan, tutup otomatis dan kunci.
ProximityPrompt DoorPromptDi dalam pintu (ditambahkan DoorService)Menampilkan "Open" atau "Close" dan memicu Triggered saat pemain menahan E.
NumberValue DoorProgressDi dalam pintu (ditambahkan DoorService)Angka yang digerakkan tween antara 0 dan 1. Setiap perubahan menggerakkan pintu.
Tool RedKey (opsional)StarterPack, untuk testingKunci untuk pintu yang terkunci. Tool apa pun bisa dipakai asal namanya cocok dengan KeyName pintu.
Explorer saat panduan selesai. Kedua pintu punya tag Door, dan VaultDoor punya atribut Style = Slide dan KeyName = RedKey. Saat game berjalan, DoorService menambahkan DoorProgress ke setiap pintu dan DoorPrompt ke part tempat prompt berada.
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

  1. Di Explorer, arahkan kursor ke Workspace, klik tombol + dan sisipkan Part. Beri nama FrontDoor, atur Size-nya kira-kira 4, 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.
  2. 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.
  3. 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.
  4. 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.
  5. Buat pintu kedua, untuk bagian pintu geser dan kunci nanti. Sisipkan dua Part lagi di Workspace: Panel, berukuran kira-kira 4, 7, 0.5, dan Knob, kira-kira 0.5, 0.5, 0.5, ditempelkan ke salah satu sisi Panel. Pilih keduanya, tekan Ctrl+G dan ganti nama Model barunya menjadi VaultDoor. Anchor kedua part, pindahkan model ke lubang pintu kedua dan tambahkan tag Door ke 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 opsional di setiap pintu
AtributTipeDefaultFungsinya
StylestringSwingSwing memutar pintu pada pivot-nya. Slide menggesernya ke samping sepanjang lebarnya.
OpenAnglenumber90Derajat 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.
SlideDistancenumberlebarnyaJumlah stud pintu geser bergerak sepanjang lebarnya. Angka negatif menggesernya ke arah sebaliknya.
OpenSecondsnumber0.6Lama satu kali buka atau tutup penuh, dijaga antara 0,05 dan 10.
AutoCloseSecondsnumber4Lama pintu tetap terbuka penuh sebelum menutup sendiri. 0 membiarkannya terbuka sampai ada yang menutupnya.
KeyNamestringtidak adaNama 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
-- 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.

Fungsi setiap bagian DoorService
Bagian scriptFungsinyaAlasannya
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 leftoverMenyiapkan 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 openPivotDihitung 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 PivotToTween 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.
PromptHoldDuration 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 otomatisMenunggu 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 TriggeredSatu 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 OpenDiatur 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 Style Slide, dan salah satunya dengan SlideDistance negatif supaya keduanya membelah di tengah. Untuk pintu ganda ayun, taruh pivot tiap belahan di tepi luarnya dan beri salah satu belahan OpenAngle negatif. 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 direction di script menjadi Vector3.yAxis (setiap pintu geser lalu bergerak ke atas) dan beri masing-masing SlideDistance yang 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:

  1. Arahkan kursor ke StarterPack, klik + dan sisipkan Tool bernama RedKey. Sisipkan satu Part ke dalamnya bernama Handle, part yang dipegang karakter, dan pastikan part itu tidak di-anchor: part yang di-anchor di dalam tool menahan karakter di tempat. Hilangkan juga centang CanBeDropped di Tool kalau pemain tidak boleh menjatuhkan kunci untuk orang lain: selama dicentang, Backspace menjatuhkan tool yang sedang dipegang ke Workspace.
  2. Pilih VaultDoor, tambahkan atribut string bernama KeyName dan isi dengan RedKey. 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.DialogueItems saat pemain memilih pilihan dengan aksi GiveItem. Taruh Tool bernama RedKey di folder itu dan beri sebuah pilihan di DialogueData action = "GiveItem" dan item = "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.

Pola umum di tutorial pintu, dan apa yang dilakukan panduan ini sebagai gantinya
TutorialnyaMasalahnyaPanduan ini
Men-tween CFrame sebuah Model pintuReferensi 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 SetPrimaryPartCFrameSudah 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 engselnyaBerfungsi 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 pintuSetiap 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 LocalScriptPintu 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 TouchedTouched 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 sekaliCheater 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 promptPanduan 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.

Apa yang bisa dicoba cheater, dan apa yang dilakukan DoorService
Cheater mencobaHasilAlasannya
Memicu prompt dari seberang mapDiabaikan kecuali karakternya ada di pintuDoorService 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 detikPaling banyak satu pemakaian per pintu setiap 0,3 detikServer menyimpan waktu pemakaian terakhir untuk setiap pintu.
Membuka pintu kunci tanpa kuncinyaDitolakServer mencari Tool di Backpack dan karakter mereka, di tempat server melihatnya, bukan di layar mereka.
Memakai pintu saat karakternya matiDiabaikanDoorService mengecek adanya Humanoid dengan health lebih dari 0 dan sebuah root part.
Tetap berjalan menembus pintu tertutupMungkinDokumentasi keamanan Roblox mencantumkan melewati rintangan fisik dan mengubah collision sendiri di antara hal yang bisa dilakukan client dengan karakternya sendiri.
Teleport melewati pintuMungkinDokumentasi yang sama mencantumkan menteleport karakter sendiri ke posisi mana pun.

Langkah 3: Tes

  1. 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.
  2. 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.
  3. 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.
  4. Cek geserannya. VaultDoor, Model dengan Style Slide, 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.
  5. 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.
  6. 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.

Kamu ketik

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.

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

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.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.