Eğitim · Oyun sistemleri

Roblox Studio'da kapı nasıl yapılır

Roblox'ta çalışan bir kapının üç şeye ihtiyacı var: oyuncunun bastığı bir şey ("Open" yazan bir ProximityPrompt), yumuşak bir hareket (TweenService) ve değişikliği yapan bir sunucu, böylece tüm oyuncular aynı kapıyı görür. Bu rehber, tag koyduğun her kapı için bunu yapan tek bir script kuruyor; kapı dönen ya da kayan olabilir ve sunucunun hiçbir şeyi açmadan önce kontrol ettiği isteğe bağlı bir anahtarlı kilidi olabilir.

Güncellendi: 20 Kasım 202617 dk okumaYazan:

Kısaca

Kapıyı bir Part ya da Model olarak yap, Anchored'ı işaretle, pivot'unu menteşe kenarına taşı (Model sekmesi, Pivot) ve Properties penceresinde Door tag'ini ekle. ServerScriptService'teki tek bir Script, tag'li tüm kapıları CollectionService ile bulur, onlara bir ProximityPrompt ("Open", E'yi basılı tut) ekler ve Triggered'da bir NumberValue'yu 0'dan 1'e tween ederken kapıyı door:PivotTo(closedPivot:Lerp(openPivot, alpha)) ile hareket ettirir. Her kapının attribute'ları dönüp dönmeyeceğini ya da kayıp kaymayacağını, açıyı, süreyi, otomatik kapanmayı ve anahtarı seçer.

  • Bir Model'in konumunu doğrudan tween edemezsin: bir Model'in CFrame ya da Position özelliği yok ve WorldPivot'u sadece pivotunun nerede olduğunu gösterir. Bir NumberValue'yu tween et ve kapıyı, Roblox'un modelleri scriptten hareket ettirmenin ana yolu olarak tanımladığı PivotTo ile hareket ettir.
  • Kapıları sunucuda aç. Bir LocalScript'in açtığı kapı sadece o oyuncunun ekranında hareket eder.
  • Anahtarı ve mesafeyi sunucuda kontrol et. Roblox'un güvenlik rehberi ProximityPrompt'ların RemoteEvent'ler gibi kötüye kullanılabileceğini söylüyor ve sunucunun yapması gereken bir kontrol için verdiği kendi örneği, oyuncunun bir kapıyı açmak için gereken anahtara sahip olup olmadığı.
Bu sayfada
  1. Nasıl çalışır
  2. 1. Kapıyı yapmak
  3. 2. Kapı scripti
  4. Kayan kapılar
  5. Anahtarlı kapılar
  6. Eski eğitimler
  7. Exploit sınırları
  8. 3. Test
  9. Genişletmek
  10. Sık hatalar
  11. RoCode ile
  12. Sık sorulan sorular
  13. Kaynaklar ve ek okumalar

Scriptli bir kapı nasıl çalışır

ÇizimE'yi 0.2 saniye basılı tutmak kapıyı 0.6 saniyede açıyor ve kapı açılmayı bitirdikten 4 saniye sonra kendi kendine kapanıyor (burada hızlandırılmış); bu arada VaultDoor, RedKey'i olmayan bir oyuncu için kapalı kalıyor.

Canlı bir oyunda çalışan bir kapıyı sunucu hareket ettirmeli. Onu bir LocalScript hareket ettirirse kapı o oyuncunun ekranında açılır, diğer herkes için kapalı kalır, çünkü bir client'ın yaptığı değişiklik o cihazda kalır (bkz. neyin replike edilip neyin edilmediği (İngilizce)). Bu yüzden bu rehberde oyuncunun cihazı sadece prompt'u gösterir ve tuş basışını bildirir, geri kalan her şeyi sunucudaki bir Script yapar. Kapının bir kullanımı şöyle ilerler:

  1. Oyuncu kapıya 8 stud'dan daha yakına gelir ve Open eylemi, Door nesne adı ve klavyede E tuşuyla bir prompt görünür. Roblox, oyun kumandasında ya da dokunmatik ekranda ilgili butonu gösterir.
  2. Oyuncu E'yi 0.2 saniye basılı tutar. Prompt'un Triggered event'i sunucuda o oyuncuyla tetiklenir.
  3. DoorService oyuncuyu kontrol eder: hayatta mı, yeterince yakın mı, prompt'u spam'liyor mu ve kapı anahtar gerektiriyorsa anahtarı taşıyor mu.
  4. Bir sayıyı 0'dan (kapalı) 1'e (açık) tween eder. Sayı her değiştiğinde kapıyı PivotTo ile kapalı ve açık konumu arasındaki yolun o kesri kadar hareket ettirir.
  5. Kapı tamamen açıldıktan dört saniye sonra onu aynı şekilde kapatır. Kapı hareket ederken basmak, kapıyı bulunduğu yerden geri döndürür.
Kapı sisteminin parçaları
ParçaNereye konurNe yapar
DoorService Script'iServerScriptServiceTüm kapıları bulur, onlara prompt ekler, her kullanımı kontrol eder ve kapıyı hareket ettirir. Bu rehberdeki tek script.
Door tag'iHer kapı Part'ında ya da Model'indeNeyin kapı olduğunu işaretler. Tag'ler Properties penceresinde eklenir ve place ile birlikte kaydedilir.
Style ve KeyName gibi attribute'larHer kapıda (isteğe bağlı)Bir kapının ayarları: dönme ya da kayma, açı, hız, otomatik kapanma ve anahtar.
DoorPrompt ProximityPrompt'uKapının içinde (DoorService ekler)"Open" ya da "Close" gösterir ve bir oyuncu E'yi basılı tuttuğunda Triggered'ı tetikler.
DoorProgress NumberValue'suKapının içinde (DoorService ekler)Tween'in 0 ile 1 arasında hareket ettirdiği sayı. Her değişiklik kapıyı hareket ettirir.
RedKey Tool'u (isteğe bağlı)StarterPack, test içinKilitli bir kapının anahtarı. Adı kapının KeyName'iyle eşleşen her Tool işe yarar.
Rehber bittiğinde Explorer. İki kapının da Door tag'i var, VaultDoor'un da Style = Slide ve KeyName = RedKey attribute'ları var. Oyun çalışınca DoorService her kapıya DoorProgress'i, prompt'un konduğu parçaya da DoorPrompt'u ekler.
Workspace
  FrontDoor Part new
  VaultDoor Model new
    Panel Part new
    Knob Part new
ServerScriptService
  DoorService Script new
StarterPack
  RedKey Tool new
    Handle Part new

Adım 1: kapıyı yap ve menteşesini yerleştir

  1. Explorer'da fareyle Workspace üzerine gel, + butonuna tıkla ve bir Part ekle. Adını FrontDoor koy, Size'ını yaklaşık 4, 7, 0.5 yap (4 stud genişlik, 7 yükseklik ve yarım stud kalınlık) ve kapı boşluğuna taşı. Birkaç parçadan yapılmış bir kapı da olur: onları seç ve bir Model'de gruplamak için Ctrl+G'ye bas.
  2. Kapının tüm parçalarında Anchored'ı işaretle ve CanCollide'ı açık bırak. Anchored parçalar yerçekimiyle ya da çarpışmalarla asla hareket etmez, ama bir script onları hareket ettirebilir; DoorService'in yaptığı da tam olarak bu.
  3. Menteşeyi yerleştir. Kapıyı seç, Model sekmesini aç ve Pivot'u aç. Pivot butonunun köşesindeki küçük oka tıklayıp basılı tut ve Snap'i işaretle, böylece pivot köşe, kenar ve merkez noktalarına oturur. Pivotu kapının menteşelerin olacağı kenarına sürükle. Kayan bir kapı pivotu merkezde bırakabilir.
  4. Tag'i ekle. Kapı seçiliyken Properties penceresinde Tags'e kadar in, +'ya tıkla ve büyük D ile Door yaz. Model olan bir kapıda tag'i içindeki parçalara değil, Model'e koy.
  5. Kayan kapı ve anahtar bölümleri için ikinci bir kapı yap. Workspace'e iki Part daha ekle: yaklaşık 4, 7, 0.5 boyutunda Panel ve Panel'in bir yüzüne yapışık, yaklaşık 0.5, 0.5, 0.5 boyutunda Knob. İkisini seç, Ctrl+G'ye bas ve yeni Model'in adını VaultDoor yap. İki parçayı da anchored yap, modeli ikinci bir boşluğa taşı ve Model'e Door tag'ini ekle. Pivotu merkezde kalabilir, çünkü bu kapı kayacak.

Pivot önemli, çünkü dönen bir kapı onun etrafında döner. Merkezde kalırsa kapı döner kapı gibi kendi etrafında döner. Bir parçada yerleştirdiğin pivot onun PivotOffset'i olarak kaydedilir ve GetPivot onu hesaba katar, yani script kapıyı tam olarak seçtiğin nokta etrafında döndürür. Bir Model'in PrimaryPart'ı varsa modelin pivotu o parçanın pivotudur ve DoorService prompt'u da o parçaya koyar. PrimaryPart yoksa prompt modelin içinde bulduğu ilk parçaya gider. Bir PrimaryPart atayacaksan bunu pivotu taşımadan önce yap: atamak modelin pivotunu o parçanın pivotuna taşır, Roblox'un Pivot araçları sayfasının belirttiği gibi.

Kapı ayarları (attribute'lar)

Tüm kapılar aşağıdaki varsayılan değerlerle çalışır. Bir kapıyı değiştirmek için onu seç, Properties penceresinde Attributes'a kadar in, +'ya tıkla, adı yaz, türü seç ve Save'e tıkla; sonra değeri gir. DoorService attribute'ları sadece bir kez, kapıyı hazırlarken okur, yani onları oyun durmuşken değiştir.

Her kapının isteğe bağlı attribute'ları
AttributeTürVarsayılanNe yapar
StylestringSwingSwing kapıyı pivotu etrafında döndürür. Slide onu genişliği boyunca yana kaydırır.
OpenAnglenumber90Dönen bir kapının kaç derece döndüğü. Negatif bir sayı onu öbür yöne döndürür. -179 ile 179 arasında tut: kapı her zaman en kısa yoldan döner, bu yüzden DoorService onu bu aralıkla sınırlar.
SlideDistancenumbergenişliğiKayan bir kapının genişliği boyunca kaç stud hareket ettiği. Negatif bir sayı onu öbür yöne kaydırır.
OpenSecondsnumber0.6Tamamen açılmasının ya da kapanmasının ne kadar sürdüğü, 0.05 ile 10 arasında.
AutoCloseSecondsnumber4Kendi kendine kapanmadan önce ne kadar süre tamamen açık kaldığı. 0 ile biri kapatana kadar açık kalır.
KeyNamestringyokOyuncunun kapıyı açmak için sahip olması gereken Tool'un adı, RedKey gibi. Kapıyı herkes açabiliyorsa ayarlama.

Adım 2: kapı scriptini ekle

Fareyle ServerScriptService üzerine gel, DoorService adında bir Script ekle ve aşağıdaki kodu yapıştır. Kaç tanesinin tag'i olursa olsun place'teki tüm kapıları yönetir. Baştaki üç ayar tüm kapılara uygulanır; 1. adımdaki attribute'lar ise tek bir kapıyı değiştirir.

Script konum: ServerScriptService adı: DoorService
-- ServerScriptService'te DoorService adlı Script.
-- "Door" tag'li her Part'ı ya da Model'i E'yi basılı tutma prompt'uyla açar ve kapatır.
-- Kapıyı sunucu hareket ettirir, yani tüm oyuncular aynı kapıyı görür, ve sunucu
-- mesafeyi ve anahtarı kontrol eder, yani kimse kilitli bir kapıyı uzaktan açamaz.
--
-- Her kapının isteğe bağlı attribute'ları (Properties penceresinde ayarla):
--   Style            string  "Swing" (varsayılan) ya da "Slide"
--   OpenAngle        number  dönen bir kapının pivotu etrafında kaç derece döndüğü (varsayılan 90, -179 ile 179 arası)
--   SlideDistance    number  kayan bir kapının genişliği boyunca kaç stud hareket ettiği (varsayılan: genişliği)
--   OpenSeconds      number  açılmasının ne kadar sürdüğü (varsayılan 0.6)
--   AutoCloseSeconds number  bu süreden sonra kendi kendine kapanır; 0 açık bırakır (varsayılan 4)
--   KeyName          string  oyuncunun sahip olması gereken Tool'un adı, "RedKey" gibi

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 -- kapı başına, prompt spam'ine karşı

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 -- Properties penceresine yazılmış NaN ya da sonsuz
	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 -- zaten çalışan bir kapı, ya da parça ya da model değil
	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)
	-- Çalışan bir kapının kopyası eski prompt'u ve değeri de getirir: onları kaldır
	for _, leftover in door:GetDescendants() do
		if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
			leftover:Destroy()
		end
	end

	-- Kapalı ve açık konumları bir kez, kapının şu an durduğu yerden hesapla
	local closedPivot = door:GetPivot()
	local openPivot: CFrame
	if attribute(door, "Style", "Swing") == "Slide" then
		-- Kapının en uzun düz kenarı, yani genişliği boyunca kaydır. Bir Model pivotunun
		-- kenarlarına göre, bir Part kendi Size'ına göre ölçülür, o yüzden kayan bir Part'ın pivotunu döndürme
		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 her zaman en kısa yoldan döner, o yüzden daha büyük bir açı yanlış yöne dönerdi
		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", "")

	-- Bir sayıyı 0'dan (kapalı) 1'e (açık) tween eder ve kapıyı ona uyacak şekilde hareket ettirir.
	-- PivotTo tek bir parçayı ya da bütün bir modeli pivotu etrafında hareket ettirir.
	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) -- diğer scriptler bunu okuyabilir
		prompt.ActionText = if open then "Close" else "Open"
		-- Aynı değer üzerindeki yeni bir tween öncekini iptal eder, yani kapı yolun yarısında geri dönebilir.
		-- Süreyi kalan yola göre ölçekle.
		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
		-- Roblox'un güvenlik rehberi prompt'ların remote'lar gibi kötüye kullanılabileceğini söylüyor, o yüzden burada tekrar kontrol et
		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 -- prompt'u dürüstçe kullanmış olmak için fazla uzak
		end
		if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
			return -- kilitli ve bu oyuncunun anahtarı yok
		end
		lastUse = now
		move(not isOpen)
	end)
end

-- Şu an tag'i olan tüm kapılar ve tag'i sonradan alanlar (başka scriptlerin klonladıkları dahil)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
	setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)

DoorService oyun başladığında her kapıya DoorPrompt ve DoorProgress'i kendisi ekler, yani elle eklenecek bir şey yok. Scriptin tek bir kopyasını bırak: tag'li tüm kapılarla zaten o ilgileniyor.

DoorService'in her bölümü ne yapar
Script bölümüNe yaparNeden
attribute()Bir attribute'u okur ve eksik olduğunda, yanlış türde olduğunda ya da gerçek bir sayı olmadığında (NaN ya da sonsuz) varsayılan değeri kullanır.Properties penceresindeki bir yazım hatası bozuk bir kapı değil, varsayılan ayarlı bir kapı verir.
doorsSetUp ve artıklar döngüsüHer kapıyı bir kez hazırlar ve önce başka bir kapıdan kopyalanmış DoorPrompt ya da DoorProgress'i kaldırır.Yoksa çalışan bir kapının kopyasında biri ölü iki prompt olurdu.
closedPivot ve openPivotKapı hazırlanırken durduğu yerden bir kez hesaplanır. Dönen kapı pivotu kendi dikey ekseni etrafında döndürür; kayan kapı onu kapının en uzun kenarı boyunca kaydırır.Kapalı pivottan açık pivota Lerp ile ara değer almak, kapı dönerken pivotu yerinde tutar, yani menteşe kenarı dönüş boyunca kımıldamaz.
DoorProgress ve PivotToTween bir sayıyı değiştirir; her değişiklik kapıyı closedPivot:Lerp(openPivot, alpha)'ya taşır.TweenService bir NumberValue'yu tween edebilir, PivotTo da bir parçayı ya da tüm parçalarıyla bir modeli, pivotu o CFrame'e gelecek şekilde hareket ettirir.
PromptHoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight kapalı. Anahtarlı bir kapı "Needs RedKey" gösterir.Görüş hattı açıkken bir şey parçasının görüntüsünü kapattığında prompt gizlenir; kapatmak, kasanın ya da model olan bir kapının geri kalanının onu gizlemesini engeller.
move()1'e ya da 0'a doğru bir tween başlatır, süre kapının kalan yoluna göre ölçeklenir.Aynı değer üzerindeki yeni bir tween öncekini iptal eder, yani yolun yarısında geri dönen bir kapı yumuşakça geri gelir ve yarı sürede gelir.
Otomatik kapanmaAçılma süresi artı AutoCloseSeconds kadar bekler, sonra kapıyı sadece moveCount değişmediyse kapatır.Eski bir zamanlayıcı, birinin bu arada kapatıp yeniden açtığı bir kapıyı asla kapatmaz.
Triggered kontrolleriKapı başına 0.3 saniyede bir kullanım, canlı bir karakter, prompt parçasına 14 stud'dan yakınlık ve anahtar, ama sadece açmak için.Bir client'ın tetikleyebildiği her şey kötüye kullanılabilir, bu yüzden sunucu kontrolleri tekrarlar. 14 stud, prompt'un 8'i artı E'yi basılı tutarken hareket etmiş bir oyuncu için 6 stud pay.
Open attribute'uHer harekette kapıya konur.Sunucuda ayarlanan attribute'lar tüm oyunculara replike edilir, yani LocalScript'ler dahil diğer scriptler GetAttributeChangedSignal("Open") ile dinleyebilir.

Her kapıya tag koyup hepsini tek bir scriptten yönetmek Roblox'un önerdiği kalıp: CollectionService referansı, aynı scripti birçok nesneye eklediğini fark edersen CollectionService kullanan tek bir scriptin daha iyi olabileceğini söylüyor. GetTagged script başladığında var olan kapıları döndürür, GetInstanceAddedSignal da tag'i sonradan alan ya da sonradan eklenen kapıları yakalar. Client ve sunucu scriptleri rehberi (İngilizce) bir place'i bu şekilde düzenlemeyi anlatıyor.

Kayan bir kapı yap

VaultDoor'u seç, Style adında bir string attribute ekle ve onu Slide yap. Bundan sonra kapı dönmez, yana kayar: kendi genişliği kadar ya da tanımlarsan SlideDistance stud kadar. Öbür yöne kaydırmak için negatif bir mesafe kullan, 4 stud'luk bir kapı için -4 gibi. FrontDoor dahil başka herhangi bir kapı da bu attribute'u alır almaz aynı şekilde kayar.

DoorService kapının iki yatay boyutunu, genişliğini ve kalınlığını ölçer ve onu uzun olanı boyunca kaydırır. Bir Model'de kutusu modelin pivotunun yönünü takip eden GetExtentsSize ile ölçer, yani gruplandıktan sonra 90 derece döndürülmüş bir kapı kalınlığı boyunca değil, yine genişliği boyunca kayar. Bir Part'ta parçanın kendi Size'ını ölçer, yani kayan bir parçanın pivotunu döndürme. Onu taşımak sorun çıkarmaz.

  • Çift kapılar: yan yana tag'li iki yarım, ikisi de Style Slide, biri ortadan ayrılmaları için negatif bir SlideDistance ile. Dönen çift kapılar için her yarının pivotunu dış kenarına koy ve bir yarıya negatif bir OpenAngle ver. Her yarının kendi prompt'u var ve ayrı açılır. Yarımlar birbirine doğru hareket ediyorsa eksi işaretini öbür yarıya taşı.
  • Yukarı kalkan bir kapı: bu script sadece kapının genişliği boyunca kaydırır. Kapıları kaldırmak için scriptteki direction'ı Vector3.yAxis yap (o zaman tüm kayan kapılar yukarı kalkar) ve her birine yüksekliğine eşit bir SlideDistance ver.
  • Fizikli bir kapı: Roblox'un hareketli nesneler eğitimi parçaları bir PrismaticConstraint ile bir eksen boyunca hareket ettiriyor. Menteşeli kapı gibi bu da fizik; sen programlamadıkça prompt'u ya da kilidi yok.

Bir kapıyı anahtarla kilitle

Anahtarlı bir kapı sadece doğru adlı bir Tool'u olan oyuncu için açılır. Anahtarı oluştur, sonra kapıya adının ne olduğunu söyle:

  1. Fareyle StarterPack üzerine gel, +'ya tıkla ve RedKey adında bir Tool ekle. İçine karakterin tuttuğu parça olan Handle adında bir Part ekle ve o parçanın anchored olmadığından emin ol: bir tool içindeki anchored bir parça karakteri yerine çiviler. Oyuncular anahtarı başkası için yere bırakamamalıysa Tool'da CanBeDropped'ın işaretini de kaldır: işaretliyken Backspace kuşanılmış tool'u Workspace'e bırakır.
  2. VaultDoor'u seç, KeyName adında bir string attribute ekle ve onu RedKey yap. Prompt'taki nesne adı artık Needs RedKey diyor.

DoorService anahtarı iki yerde arar. Bir Tool, oyuncu onu kuşanana kadar Backpack'indedir, kuşanınca da karakterine geçer, yani anahtar ister araç çubuğunda ister elde olsun kapı açılır. Kontrol sunucuda yapılır, çünkü Roblox'un güvenlik rehberi tam olarak bu durumu, oyuncunun bir kapıyı açmak için gereken anahtara sahip olup olmadığını, sunucunun doğrulaması gereken bir izin olarak sayıyor. Anahtar sadece açmak için gerekir: açık bir kapıyı herkes kapatabilir ve kapı AutoCloseSeconds sonra kendi kendine kapanır.

StarterPack anahtarı her yeniden doğuşta herkese verir; test için bu iyi. Gerçek bir oyunda onu başka bir şekilde ver:

  • Bir mağazadan: mağaza GUI rehberi ServerStorage'daki Tool'ları alıcının Backpack'ine ve StarterGear'ına verir.
  • Bir karakterden: NPC diyalog rehberi, oyuncu GiveItem eylemli bir seçeneği seçtiğinde ServerStorage.DialogueItems'tan bir Tool verir. O klasöre RedKey adında bir Tool koy ve DialogueData'daki bir seçeneğe action = "GiveItem" ve item = "RedKey" ver; anahtar bir konuşmadan çıksın.
  • Envanter eşyası olarak: envanter sistemiyle bir anahtar eşyası oyuncu onu kuşanır kuşanmaz çalışır, çünkü kuşanmak Tool'unun bir kopyasını Backpack'ine ve eline koyar.

Backpack'teki bir anahtar karakter ölünce kaybolur, çünkü Roblox her yeniden doğuşta Backpack'i StarterPack ve StarterGear'dan yeniden doldurur. Onu korumak için mağaza rehberinin yaptığı gibi oyuncunun StarterGear'ına da bir kopya koy. Anahtarın kullanılınca harcanması için anahtarın Tool'unu oyuncunun Backpack'inde ya da karakterinde bul ve Triggered handler'ında, anahtar kontrolü geçtikten hemen sonra yok et.

Eski kapı eğitimleri nerede hata yapıyor

Bu rehberi bir videoyla ya da bir forum gönderisiyle karşılaştırıyorsan, "kapım çalışmıyor" konularının çoğuna yol açan kalıplar ve bu rehberin onların yerine yaptığı şey şunlar.

Kapı eğitimlerindeki yaygın kalıplar ve bu rehberin onların yerine yaptığı şey
EğitimSorunBu rehber
Kapı Model'inin CFrame'ini tween ederModel referansında CFrame ya da Position özelliği yok. WorldPivot'u sadece modelin pivotunun nerede olduğunu gösterir, yani onu tween etmek pivot noktasını taşır ve parçaları yerinde bırakır.Bir NumberValue'yu tween eder ve modelin tamamını PivotTo ile hareket ettirir.
Bir modeli SetPrimaryPartCFrame ile hareket ettirirBunun yerine yenisi geldi: Roblox yeni işlerde PivotTo kullanmanı söylüyor.Roblox'un Model'leri scriptten hareket ettirmenin ana fonksiyonu olarak tanımladığı PivotTo'yu kullanır.
Tüm parçaları bir menteşe parçasına weld eder ve sadece menteşeyi tween ederTüm weld'ler doğruyken çalışır, ama weld edilmemiş her parça menteşe hareket edince geride kalır.Tüm parçaları anchored ve weld'siz tutar. PivotTo kapıyı ve içindeki her şeyi hareket ettirir.
Aynı scripti her kapıya kopyalarHer düzeltme tüm kopyalarda tekrarlanmalı. Roblox nesnelere tag koyup onları CollectionService ile tek bir scriptten yönetmeyi öneriyor.Tek bir DoorService ve bir Door tag'i.
Kapıyı bir LocalScript'te açarKapı sadece o oyuncunun ekranında açılır, diğer herkes onu kapalı görmeye devam eder.Kapıyı sunucu hareket ettirir, yani tüm oyuncular aynı kapıyı görür.
Kapıyı Touched'dan açarTouched tek bir temasta arka arkaya birkaç kez tetiklenir (Roblox'un debounce sayfası) ve bir oyuncunun cihazı kendi karakteri için Touched'ın ne zaman tetikleneceğini kontrol edebilir (Roblox güvenlik dokümantasyonu).Sunucunun kontrol ettiği bir prompt.
Kapıyı wait() içeren bir döngüde adım adım hareket ettirirRoblox wait()'i, yerine task.wait() gelmiş olarak işaretliyor ve bir döngü biri tekrar bastığında yolun yarısında geri dönemez.Hareket başına bir tween. Aynı değer üzerindeki yeni bir tween öncekini iptal eder, yani kapı bulunduğu yerden geri döner.
Anahtarı bir LocalScript'te kontrol eder ya da hiç kontrol etmezHile yapan kendi cihazındaki her şeyi kontrol eder, yani client'taki bir kontrol kimseyi durdurmaz.Sunucu Tool'u oyuncunun Backpack'inde ve karakterinde arar.
Prompt'ta bekleme süresi yokRoblox'un güvenlik rehberi prompt'ların remote'lar gibi kötüye kullanılabileceğini söylüyor, yani hiçbir şey onu tekrar tekrar tetiklemeyi engellemiyor.Kapı başına 0.3 saniyede bir kullanım.

Hile yapan biri neyi yapabilir, neyi yapamaz

Hile yapan birinin karakteri dahil kendi cihazındaki her şeyi kontrol ettiğini varsay. Bu kapılar için bunun anlamı şu.

Hile yapan birinin ne deneyebileceği ve DoorService'in buna ne yaptığı
Hile yapan şunu denerSonuçNeden
Prompt'u haritanın öbür ucundan tetiklemekKarakteri kapının yanında değilse görmezden gelinirDoorService karakterinin kök parçasından prompt parçasına kadar ölçer ve 14 stud'u aşan her şeyi görmezden gelir. Önce karakterini kapının yanına ışınlayabilir (son satıra bak), yani mesafe kontrolü uzaktan kullanımı engeller, ışınlanmayı değil.
Saniyede birçok kez tetiklemekKapı başına en fazla 0.3 saniyede bir kullanımSunucu her kapının son kullanım zamanını tutar.
Anahtarlı bir kapıyı anahtarsız açmakReddedilirSunucu Tool'u oyuncunun ekranında değil, kendisinin gördüğü yerde, Backpack'inde ve karakterinde arar.
Kapıyı ölü karakteriyle kullanmakGörmezden gelinirDoorService canı 0'dan fazla olan bir Humanoid ve bir kök parça olduğunu kontrol eder.
Kapalı bir kapının içinden yine de geçmekMümkünRoblox güvenlik dokümantasyonu, fiziksel engelleri atlamayı ve kendi çarpışmasını değiştirmeyi bir client'ın kendi karakteriyle yapabileceği şeyler arasında sayıyor.
Kapının öbür tarafına ışınlanmakMümkünAynı dokümantasyon kendi karakterini herhangi bir konuma ışınlamayı da sayıyor.

Adım 3: test et

  1. Play'e (F5) bas. FrontDoor'a yaklaş: 8 stud'dan yakında Open eylemi ve Door nesne adıyla bir prompt görünür. E'yi basılı tut. 0.2 saniye sonra kapı 0.6 saniyede menteşe kenarı etrafında 90 derece döner ve prompt artık Close der.
  2. Geç ve bekle. Açılmayı bitirdikten dört saniye sonra kapı kendi kendine kapanır. Kapanırken E'yi basılı tut: geri döner ve bulunduğu yerden açılır.
  3. Kilidi dene. RedKey StarterPack'teyse şimdilik ServerStorage'a taşı, Play'e bas ve VaultDoor'da E'yi basılı tut: prompt Needs RedKey der ve hiçbir şey hareket etmez. Oyunu durdur, RedKey'i StarterPack'e geri koy ve tekrar oyna: VaultDoor, anahtar araç çubuğunda ya da elinde olsun, açılır.
  4. Kaymayı kontrol et. Style'ı Slide olan bir Model olan VaultDoor açılınca kendi genişliği kadar yana kayar. Oyunu durdur, VaultDoor'u seç, Rotate aracıyla 90 derece döndür ve tekrar oyna: yine kalınlığı boyunca değil, genişliği boyunca kaymalı. Bitirince geri döndür.
  5. Test modu menüsünde Server & Clients'ı seç, 2 client ayarla ve Play'e bas. Bir client penceresinde bir kapı aç: diğer pencerede de açık ve ikisinde de kapanıyor.
  6. Oyunu durdur, bir kapı seç ve çoğaltmak için Ctrl+D'ye bas; sonra kopyayı başka bir boşluğa taşı. Kopyanın Tags'te hâlâ Door gösterdiğini kontrol et ve Play'e bas: kopya hiçbir ek script olmadan çalışır.

Output penceresini açık bırak (Window menüsü, sonra Output). DoorService çalışırken hiçbir şey yazdırmaz. Bir kapının "has no part to put the prompt on" olduğu uyarısı, tag'li bir Model'in içinde parça olmadığı anlamına gelir. Geri kalanı için Sık karşılaşılan hatalar'a bak.

Nasıl genişletilir

Otomatik kapılar

Biri yaklaşınca açılan bir kapı için prompt'u beklemek yerine setUpDoor'un içinden move(true) çağır. setUpDoor'un sonunda task.spawn ile bir döngü başlat, çünkü orada normal bir döngü hiç bitmez ve DoorService ilk kapıdan öteye geçemez. Döngüyü sadece kapı oyundayken çalıştır: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Döngünün içinde kapı boşluğunun etrafındaki bir kutuda karakter olup olmadığını workspace:GetPartBoundsInBox ile kontrol et ve karakter varsa ve kapı kapalıysa move(true) çağır. Otomatik kapanma onu sonra eskisi gibi kapatır. Kapı sadece kendi kendine açılmalıysa prompt'un Enabled'ını false yap.

VIP kapıları

Game pass rehberi (İngilizce), çarpışma grupları kullanarak pass sahiplerinin doğrudan içinden geçtiği bir VIP kapısı zaten kuruyor. E ile açılan bir VIP kapısı için Triggered handler'ına anahtarınkinin yanına bir kontrol daha ekle: player:GetAttribute("OwnsPass_VIP") == true değilse return yap; bu, game pass rehberinin sunucu scriptinin ayarladığı attribute. Onu sadece sunucuda oku.

Şifreli tuş takımı

Yazılan bir şifreyle açılan bir kapı için şifreyi oyuncuların asla almadığı bir sunucu Script'inde ya da ServerStorage'da tut, hile yapan birinin okuyabileceği bir LocalScript'te asla tutma. Tuş takımının LocalScript'i bir RemoteEvent üzerinden sadece yazılan rakamları gönderir. Sunucuda oyuncunun kapıya yakın olduğunu kontrol et, ne sıklıkla tahmin edebileceğini sınırla, rakamları karşılaştır ve ancak o zaman move(true) çağır. RemoteEvent rehberi bir remote'un aldığını nasıl kontrol edeceğini gösteriyor.

Sesler

Kapı parçasının içine bir Sound koy, böylece o parçanın konumundan çalar, ve move'un başında Play metodunu çağır. Ya da onu kapının Open attribute'unu GetAttributeChangedSignal("Open") ile dinleyen bir LocalScript'ten çal, çünkü sunucu bu attribute'u her harekette ayarlıyor.

Oyun çalışırken eklenen kapılar

Yeni kapıları ServerStorage'daki kapalı bir şablondan klonla. DoorService bir kapının kapalı konumunu kapı ortaya çıktığında okur, yani o anda açık olan bir kapının kopyası açık konumunu kapalı konum olarak alırdı. Kopyayı Parent'ını Workspace yapmadan önce PivotTo ile boşluğuna taşı, böylece DoorService o noktayı kapalı olarak kaydeder. Bir kopyayla gelen eski prompt'lar ve değerler otomatik olarak kaldırılır. Oyuncuları başka bir bölgeye ya da başka bir place'e götüren bir kapı için ışınlanma rehberine bak.

Sık karşılaşılan hatalar ve çözümleri

Play'e basmadan önce Output penceresini aç (Window menüsü, sonra Output). Kapı sorunlarının çoğu, scriptin beklediği gibi olmayan bir tag'den, pivottan ya da attribute'tan gelir.

Kapıda hiç prompt görünmüyor

Sırayla şunları kontrol et: DoorService bir LocalScript değil, doğrudan ServerScriptService'te bir Script; kapının büyük D ile Door tag'i var, kapı Model ise Model'in kendisinde; kapı bir parça (bir Part, MeshPart ya da başka bir BasePart) ya da bir Model; ve prompt'un konduğu parçaya 8 stud'dan yakınsın. Output'ta kapının "has no part to put the prompt on" olduğu uyarısı, tag'li Model'in içinde parça olmadığı anlamına gelir.

Oyun başlayınca kapı düşüyor, kayıyor ya da itiliyor

Parçalarından biri anchored değil. Kapının tüm parçalarını seç ve Anchored'ı işaretle. Anchored parçalar fizikle asla hareket etmez, ama DoorService onları hareket ettirebilir.

Bir attribute değiştirdim ama kapı onu görmezden geliyor

Üç şeyi kontrol et. Tür: OpenAngle, SlideDistance, OpenSeconds ve AutoCloseSeconds number attribute'ları, Style ve KeyName de string attribute'ları olmalı; tür yanlışsa DoorService varsayılan değeri kullanır. Yazım: adlar birebir karşılaştırılır, yani openAngle başka bir attribute. Değerler de birebir karşılaştırılır: Style büyük S ile ve boşluksuz Slide olmalı. Zamanlama: DoorService attribute'ları sadece bir kez, kapıyı hazırlarken okur, yani bir oyun testi sırasında yapılan değişiklik tekrar oynayana kadar hiçbir şey yapmaz.

Kapı yanlış yöne dönüyor ya da yan yatıyor

Öbür yöne dönmesi için OpenAngle'ı negatif yap, mesela -90. Dikey bir menteşe yerine yatay bir eksen etrafında dönüyorsa pivotun kendisi döndürülmüş: Model sekmesinde Pivot'u aç ve pivotu dik duruma gelene kadar döndür.

Kayan bir kapı duvarın içine giriyor ya da çok az hareket ediyor

Öbür yöne kayması için ona negatif bir SlideDistance ver. Az ya da fazla hareket ediyorsa, ölçülen genişliğe güvenmek yerine SlideDistance'ı istediğin stud miktarına ayarla.

Anahtarım var ama kapı kapalı kalıyor

Anahtar bir Part ya da Model değil, bir Tool olmalı ve adı büyük küçük harfler dahil KeyName ile birebir eşleşmeli. Backpack'inde ya da elinde olmalı. Kapıdaki KeyName'in string bir attribute olduğunu da kontrol et.

RoCode ile kur

Bunların hepsini elle kurmak istemiyorsan RoCode bunu açık olan place'inde kurabilir. RoCode, Roblox Studio için bağımsız bir yapay zeka ajanı, Roblox tarafından yapılmıyor: değişikliği bir web sohbetinde anlatıyorsun, Studio plugin'i de scriptleri ve instance'ları Explorer'ında oluşturuyor, yani yapıştırılacak kod yok.

Sen yazarsın

Door tag'li kapılar E'yi basılı tutma prompt'uyla açılsın: pivot etrafında 0.6 saniyede 90 derece dönsünler, 4 saniye sonra kapansınlar, Style attribute'u Slide olduğunda kaysınlar ve oyuncunun KeyName'in belirttiği Tool'u yoksa kapalı kalsınlar. Her şey sunucuda, bir mesafe kontrolüyle.

RoCode yapar
  • Bir adım gerektirdiğinde Search Game ve Search Scripts ile place'ine bakabilir, böylece ikinci bir sistem eklemek yerine zaten sahip olduğun nesnelerin, remote'ların ya da kayıt kodunun üzerine kurar
  • Script'i Create Script ile ServerScriptService'e yazar, Create Instance ile bir kapı parçası oluşturup ona Style ve KeyName gibi attribute'lar koyabilir
  • Yazdığı her scriptin derlendiğini, onu çalıştırmadan Studio'da derleyen Check Script ile kontrol etme talimatı var
  • Her değişiklik grubundan önce ve sonra bir geri alma noktası koyar, yani Ctrl+Z her seferinde bir grup geri gider

Test etmeden önce her kapının pivotunu Studio'nun Pivot aracıyla kontrol et: kapı onun etrafında döner. Plugin 3.9 ya da üstüyle RoCode kısa bir test yapıp hataları okuyabilir, plugin 3.9.15 ya da üstüyle de yürüyen ve tuşlara basan bir test karakterini yönetebilir, ama sadece test etmeyi seçtiği şeyi kontrol eder, yani her kapıya yaklaş ve E'yi kendin basılı tut. RoCode Studio'ya nasıl bağlanır.

Sık sorulan sorular

Roblox Studio'da E ile açılan bir kapıyı nasıl yaparım?

Kapıya bir ProximityPrompt koy ve Triggered event'ini kapıyı hareket ettiren bir sunucu Script'inde bağla. DoorService bu ikisini Door tag'li her kapı için yapar. E, prompt'un varsayılan tuşu ve Roblox klavyeler, oyun kumandaları ve dokunmatik ekranlar için doğru girdiyi gösterir.

Kapım neden merkezi etrafında dönüyor?

Pivotu hâlâ merkezde. Model sekmesinde Pivot'u aç ve pivotu menteşe kenarına sürükle; script kapıyı pivot etrafında döndürür.

Kayan bir kapıyı nasıl yaparım?

Kapının Style attribute'unu Slide yap. Kendi genişliği kadar ya da SlideDistance stud kadar yana kayar; öbür yöne kaydırmak için negatif bir mesafe kullan.

Script yazmadan kapı yapabilir miyim?

Evet. Roblox'un menteşeli kapı eğitimi anchored olmayan bir kapıyı kasasına sınırlı bir HingeConstraint ile bağlıyor, yani oyuncular onu yürüyerek iterek açıyor. O kapının prompt'u, kilidi ya da otomatik kapanması yok.

Sadece VIP'lerin açabileceği bir kapıyı nasıl yaparım?

Pass sahiplerini geçiren game pass rehberindeki VIP kapısını (İngilizce) kullan ya da DoorService'in Triggered handler'ına, açmadan önce oyuncunun pass'e sahip olup olmadığını sunucuda okuyan bir kontrol ekle, o rehberin ayarladığı OwnsPass_VIP attribute'u gibi.

Kapım neden bana açılıyor ama diğer oyunculara açılmıyor?

Onu bir LocalScript açıyor ve bir LocalScript'in yaptığı değişiklik o oyuncunun cihazında kalır. Kapıyı açan kodu DoorService'in yaptığı gibi bir sunucu Script'ine taşı, böylece değişiklik herkese ulaşır.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.