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ığıPivotToile 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
Scriptli bir kapı nasıl çalışır
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:
- 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.
- Oyuncu E'yi 0.2 saniye basılı tutar. Prompt'un
Triggeredevent'i sunucuda o oyuncuyla tetiklenir. - DoorService oyuncuyu kontrol eder: hayatta mı, yeterince yakın mı, prompt'u spam'liyor mu ve kapı anahtar gerektiriyorsa anahtarı taşıyor mu.
- Bir sayıyı 0'dan (kapalı) 1'e (açık) tween eder. Sayı her değiştiğinde kapıyı
PivotToile kapalı ve açık konumu arasındaki yolun o kesri kadar hareket ettirir. - 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.
| Parça | Nereye konur | Ne yapar |
|---|---|---|
DoorService Script'i | ServerScriptService | Tüm kapıları bulur, onlara prompt ekler, her kullanımı kontrol eder ve kapıyı hareket ettirir. Bu rehberdeki tek script. |
Door tag'i | Her kapı Part'ında ya da Model'inde | Neyin kapı olduğunu işaretler. Tag'ler Properties penceresinde eklenir ve place ile birlikte kaydedilir. |
Style ve KeyName gibi attribute'lar | Her 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'u | Kapı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'su | Kapı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çin | Kilitli bir kapının anahtarı. Adı kapının KeyName'iyle eşleşen her Tool işe yarar. |
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
- Explorer'da fareyle Workspace üzerine gel, + butonuna tıkla ve bir Part ekle. Adını
FrontDoorkoy,Size'ını yaklaşık4, 7, 0.5yap (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. - 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.
- 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.
- Tag'i ekle. Kapı seçiliyken Properties penceresinde Tags'e kadar in, +'ya tıkla ve büyük D ile
Dooryaz. Model olan bir kapıda tag'i içindeki parçalara değil, Model'e koy. - Kayan kapı ve anahtar bölümleri için ikinci bir kapı yap. Workspace'e iki Part daha ekle: yaklaşık
4, 7, 0.5boyutundaPanelve Panel'in bir yüzüne yapışık, yaklaşık0.5, 0.5, 0.5boyutundaKnob. İkisini seç, Ctrl+G'ye bas ve yeni Model'in adınıVaultDooryap. İki parçayı da anchored yap, modeli ikinci bir boşluğa taşı ve Model'eDoortag'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.
| Attribute | Tür | Varsayılan | Ne yapar |
|---|---|---|---|
Style | string | Swing | Swing kapıyı pivotu etrafında döndürür. Slide onu genişliği boyunca yana kaydırır. |
OpenAngle | number | 90 | Dö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. |
SlideDistance | number | genişliği | Kayan bir kapının genişliği boyunca kaç stud hareket ettiği. Negatif bir sayı onu öbür yöne kaydırır. |
OpenSeconds | number | 0.6 | Tamamen açılmasının ya da kapanmasının ne kadar sürdüğü, 0.05 ile 10 arasında. |
AutoCloseSeconds | number | 4 | Kendi kendine kapanmadan önce ne kadar süre tamamen açık kaldığı. 0 ile biri kapatana kadar açık kalır. |
KeyName | string | yok | Oyuncunun 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.
-- 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.
| Script bölümü | Ne yapar | Neden |
|---|---|---|
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 openPivot | Kapı 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 PivotTo | Tween 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. |
| Prompt | HoldDuration 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 kapanma | Açı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 kontrolleri | Kapı 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'u | Her 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
StyleSlide, biri ortadan ayrılmaları için negatif birSlideDistanceile. Dönen çift kapılar için her yarının pivotunu dış kenarına koy ve bir yarıya negatif birOpenAnglever. 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.yAxisyap (o zaman tüm kayan kapılar yukarı kalkar) ve her birine yüksekliğine eşit birSlideDistancever. - 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:
- Fareyle StarterPack üzerine gel, +'ya tıkla ve
RedKeyadında bir Tool ekle. İçine karakterin tuttuğu parça olanHandleadı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'daCanBeDropped'ın işaretini de kaldır: işaretliyken Backspace kuşanılmış tool'u Workspace'e bırakır. - VaultDoor'u seç,
KeyNameadında bir string attribute ekle ve onuRedKeyyap. 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
GiveItemeylemli bir seçeneği seçtiğindeServerStorage.DialogueItems'tan bir Tool verir. O klasöre RedKey adında bir Tool koy ve DialogueData'daki bir seçeneğeaction = "GiveItem"veitem = "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.
| Eğitim | Sorun | Bu rehber |
|---|---|---|
Kapı Model'inin CFrame'ini tween eder | Model 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 ettirir | Bunun 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 eder | Tü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 kopyalar | Her 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çar | Kapı 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çar | Touched 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 ettirir | Roblox 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 etmez | Hile 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 yok | Roblox'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 şunu dener | Sonuç | Neden |
|---|---|---|
| Prompt'u haritanın öbür ucundan tetiklemek | Karakteri kapının yanında değilse görmezden gelinir | DoorService 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 tetiklemek | Kapı başına en fazla 0.3 saniyede bir kullanım | Sunucu her kapının son kullanım zamanını tutar. |
| Anahtarlı bir kapıyı anahtarsız açmak | Reddedilir | Sunucu Tool'u oyuncunun ekranında değil, kendisinin gördüğü yerde, Backpack'inde ve karakterinde arar. |
| Kapıyı ölü karakteriyle kullanmak | Görmezden gelinir | DoorService 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çmek | Mümkün | Roblox 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 ışınlanmak | Mümkün | Aynı dokümantasyon kendi karakterini herhangi bir konuma ışınlamayı da sayıyor. |
Adım 3: test et
- 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.
- 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.
- 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.
- 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. - 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.
- 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.
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.
- 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
- Roblox Creator Docs: PVInstance:PivotTo (İngilizce). bir parçayı ya da bütün bir modeli pivotuyla hareket ettirmek
- Roblox Creator Docs: Pivot tools (İngilizce). pivotu taşımak, Snap ve oturma noktaları, PrimaryPart'lı pivotlar
- Roblox Creator Docs: Model (İngilizce). WorldPivot, pivotu takip eden GetExtentsSize ve yerine yenisi gelen SetPrimaryPartCFrame
- Roblox Creator Docs: CFrame:Lerp (İngilizce). dönüş en kısa yay üzerinden ara değerle hesaplanır
- Roblox Creator Docs: TweenService (İngilizce). neyin tween edilebildiği ve aynı özellikteki ikinci bir tween'in ilkini iptal etmesi
- Roblox Creator Docs: Proximity prompts (İngilizce). prompt oluşturmak ve özelleştirmek, her cihaz için girdiler ve görüş hattı
- Roblox Creator Docs: ProximityPrompt (İngilizce). varsayılan tuş ve buton, HoldDuration, MaxActivationDistance ve Triggered
- Roblox Creator Docs: CollectionService (İngilizce). tag'ler, GetTagged ve GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (İngilizce). Studio'da tag ve attribute eklemek
- Roblox Creator Docs: Securing the client-server boundary (İngilizce). saldırı yüzeyi olarak ProximityPrompt'lar ve anahtar ile kapı izninin kontrolü
- Roblox Creator Docs: Network ownership, movement validation, and physics (İngilizce). bir client'ın kendi karakteriyle neler yapabildiği
- Roblox Creator Docs: Build a hinged door (İngilizce). HingeConstraint'li kodsuz kapı
- Roblox Creator Docs: In-game tools (İngilizce). Handle, anchored durumu ve StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (İngilizce). Backspace'in kuşanılmış bir tool'la ne yaptığı
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.