`Class.PhysicsService` esas olarak **çarpışma
grupları** ile çalışmak için yöntemler içerir; bu gruplar, bir parça setinin diğer çarpışma gruplarındaki parçalarla çarpışıp çarpışmayacağını tanımlar. Bir çarpışma grubunu `Class.PhysicsService:RegisterCollisionGroup()|RegisterCollisionGroup()` aracılığıyla kaydedebilir ve parçaları bu gruba atamak için bu parçaların `Class.BasePart.CollisionGroup|CollisionGroup` özelliğini çarpışma grubunun **adı** ile ayarlayabilirsiniz.

Çarpışma grupları arasındaki çarpışma ilişkilerini oluşturmak, silmek ve değiştirmek yalnızca sunucu tarafında `Class.Script|Scripts` ile sınırlıdır.

Kullanım detayları için
[Çarpışma Filtreleme](/workspace/collisions#collision-filtering)
bakınız.

Belirtilen parçanın belirtilen çarpışma grubunda olup olmadığını döndürür.
Bu yöntem şu koşullarda bir çalışma zamanı hatası fırlatır:

- Belirtilen grup mevcut değildir.
- Belirtilen parça bir `Class.BasePart` değildir.

PhysicsService:CollisionGroupContainsPart

name

Kontrol edilecek çarpışma grubunun adı.

part

Çarpışma grubuna üyeliği kontrol edilecek `BasePart`.

`true` eğer parça belirtilen çarpışma grubuna ait ise, `false`
aksi takdirde.

Parçanın çarpışma grubunda olup olmadığını döndürür.

İki belirtilen çarpışma grubunun çarpışıp çarpışmayacağını döndürür. Bu
yöntem ayrıca gruplardan herhangi biri kaydedilmemişse true döndürür, çünkü varsayılan çarpışma maskesi tüm gruplarla çarpışır.

PhysicsService:CollisionGroupsAreCollidable

name1

name2

`true` eğer iki grup çarpışacak şekilde ayarlandıysa, `false` aksi takdirde. Ayrıca
herhangi bir grup kaydedilmemişse `true` döner.

İki grubun çarpışıp çarpışmayacağını döndürür.

İki grup arasındaki çarpışma durumunu ayarlar. Bu yöntem, gruplardan herhangi biri kaydedilmemişse bir hata fırlatır, bu nedenle bu çağrıyı yapmadan önce her grubun kaydını `Class.PhysicsService:IsCollisionGroupRegistered()` ile doğrulamanız önerilir.

PhysicsService:CollisionGroupSetCollidable

collidable

İki grubun birbirleriyle çarpışıp çarpışmayacağı.

İki grup arasındaki çarpışma durumunu ayarlar.

Verilen isimle yeni bir çarpışma grubu oluşturur ve oluşturulan grubun ID'sini döndürür.

PhysicsService:CreateCollisionGroup

Oluşturulacak yeni çarpışma grubunun adı.

Yeni oluşturulan çarpışma grubuna atanan tamsayı ID'si.

Bu yöntem, belirtilen adı olan çarpışma grubunun ID'sini döndürür.
Verilen adı taşıyan bir grup yoksa bir hata fırlatır.

PhysicsService:GetCollisionGroupId

Retrieve edilen çarpışma grubunun adı.

Retrieve edilen çarpışma grubunun ID'si veya böyle bir grup
yoksa `nil`.

Belirtilen adı olan çarpışma grubunun ID'sini döndürür.

Karşılık gelen ID'ye sahip çarpışma grubunun adını döner, ya da o ID (`0`–`31`) bir gruba atanmadıysa boş bir dize döner. ID geçerli aralığın dışındaysa yöntem bir hata fırlatır.

PhysicsService:GetCollisionGroupName

Bakılacak çarpışma grubunun tamsayı ID'si.

Verilen ID'ye sahip çarpışma grubunun adı, ya da ID bir gruba atanmadıysa boş bir dize.

Karşılık gelen ID'ye sahip grubun adını döndürür.

Yerinin tüm çarpışma grupları hakkında bilgi içeren bir tablo döndürür. Döndürülen tablodaki her değer, üç üye içeren bir tabloyu içerir:

<table>
  <thead>
    <tr>
      <th>Üye</th>
      <th>Tip</th>
      <th>Açıklama</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>id</td>
      <td>integer</td>
      <td>Grubun ID'si.</td>
    </tr>
    <tr>
      <td>mask</td>
      <td>integer</td>
      <td>Çarpışma grubunun maskesi; sadece iç kullanım içindir.</td>
    </tr>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>Çarpışma grubunun adı.</td>
    </tr>
  </tbody>
</table>

PhysicsService:GetCollisionGroups

Her biri bir kayıtlı çarpışma grubu için `name` (dize), `id` (tamsayı),
ve `mask` (tamsayı) alanlarını içeren tabloların bir dizisi.

Yerinin tüm çarpışma grupları hakkında bilgi içeren bir tablo döndürür.

Motorun desteklediği çarpışma gruplarının maksimum sayısını döndürür. Bu
değer şu anda 32'dir.

PhysicsService:GetMaxCollisionGroups

Desteklenen maksimum çarpışma grubu sayısı, şu anda 32.

Çarpışma gruplarının maksimum sayısını döndürür.

Yerinin tüm çarpışma grupları hakkında bilgi içeren bir tablo döndürür. Döndürülen tablodaki her değer, iki üye içeren bir tabloyu içerir:

<table>
  <thead>
    <tr>
      <th>Üye</th>
      <th>Tip</th>
      <th>Açıklama</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>mask</td>
      <td>integer</td>
      <td>Çarpışma grubunun maskesi; sadece iç kullanım içindir.</td>
    </tr>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>Çarpışma grubunun adı.</td>
    </tr>
  </tbody>
</table>

PhysicsService:GetRegisteredCollisionGroups

Her biri bir kayıtlı çarpışma grubu için `name` (dize) ve `mask`
(tamsayı) alanlarını içeren tabloların bir dizisi.

Bir çarpışma grubunun kayıtlı olup olmadığını kontrol eder. Kaydedilmemiş
çarpışma grupları için hata fırlatan yöntemleri çağırmadan önce bu yöntemi
çağırmanız önerilir, örneğin
`Class.PhysicsService:CollisionGroupSetCollidable()`.

PhysicsService:IsCollisionGroupRegistered

`true` eğer verilen isimde bir çarpışma grubu kayıtlıysa, `false`
aksi takdirde.

Bir çarpışma grubunun kayıtlı olup olmadığını kontrol eder.

Bu örnek, çarpışma gruplarının temel bir kullanımını göstermektedir. **BallPart**'ı `"CollisionGroupBall"`'a ve **DoorPart**'ı `"CollisionGroupDoor"`'a atar, ardından iki grubu `Class.PhysicsService:CollisionGroupSetCollidable()` kullanarak çarpışmaz hale getirir.


Verilen isimle yeni bir çarpışma grubu kaydeder. İsim `"Default"`
olamaz.

Bu yöntemin, çalışma alanındaki `Class.BasePart|BaseParts` sayısına bağlı olarak hafif bir performans yükü olduğunu unutmayın, bu yüzden tüm çarpışma gruplarını düzenleme sırasında Studio
[editörü](/workspace/collisions#collision-groups) aracılığıyla kaydedip `Class.PhysicsService:UnregisterCollisionGroup()|UnregisterCollisionGroup()`
ve `Class.PhysicsService:RenameCollisionGroup()|RenameCollisionGroup()`
çağrılarını olabildiğince az yapmanız önerilir.

PhysicsService:RegisterCollisionGroup

Verilen isimle yeni bir çarpışma grubu kaydeder.

Verilen isimle çarpışma grubunu kaldırır. Geçersiz bir isim verilirse,
bu yöntem hiçbir şey yapmaz; ancak eğer ayrılmış isim `"Default"`
verilirse, bir hata fırlatır. Çarpışma grubunda kaldırıldığı zaman herhangi bir parça varsa, bu parçalar hala aynı çarpışma grup ID'sini koruyacaktır. Kaldırılan gruptaki parçaların fiziksel davranışı belirsizdir, bu nedenle kaldırılan gruptaki parçaları başka bir gruba taşımak önerilir. Bu yöntem, aşağıdaki koşullarda bir çalışma zamanı hatası fırlatır:

- `"Default"` ismi verildiğinde.
- Yöntem bir istemciden çağrıldığında.

PhysicsService:RemoveCollisionGroup

Kaldırılacak çarpışma grubunun adı.

Verilen isimle çarpışma grubunu kaldırır.

Belirtilen kayıtlı çarpışma grubunun adını değiştirir, ancak bu grubun
kullanıldığı `Class.BasePart.CollisionGroup|CollisionGroup` özelliğini **değiştirmez**. Bu yöntemin ilk argümanı, adını değiştireceğiniz grubun adıdır, ikinci argümanı ise grubun yeni adıdır. Belirtilen grup mevcut değilse, bu yöntem hiçbir şey yapmaz. Yeni ad için adlandırma kuralları,
yeni grup oluşturuluyormuş gibi
`Class.PhysicsService:RegisterCollisionGroup()|RegisterCollisionGroup()`
yöntemiyle aynı kurallara tabidir.

Bu yöntem, aşağıdaki koşullarda bir çalışma zamanı hatası fırlatır:

- Geçersiz veya boş isim verildiğinde.
- Yöntem bir istemciden çağrıldığında.

Bu yöntemin, çalışma alanındaki `Class.BasePart|BaseParts` sayısına göre hafif bir performans yükü olduğunu unutmayın,
yani tüm çarpışma gruplarını düzenleme zamanı boyunca Studio
[editörü](/workspace/collisions#collision-groups) aracılığıyla kaydedip bunları olabildiğince az değiştirmeniz önerilir.

PhysicsService:RenameCollisionGroup

from

Yeniden adlandırılacak çarpışma grubunun mevcut adı.

Belirtilen çarpışma grubunun adını değiştirir.

Bu yöntem, belirtilen parçanın çarpışma grubunu belirtilen isimle tanımlanmış gruba ayarlar. Bu, `Class.BasePart.CollisionGroupId` ayarlamakla eşdeğerdir, ancak bu yöntemi çağırmak önerilen yaklaşımdır.

Bu yöntem, aşağıdaki koşullarda bir çalışma zamanı hatası fırlatır:

- Parça parametresi `Class.BasePart` örneği değildir.
- Belirtilen grup mevcut değildir.

PhysicsService:SetPartCollisionGroup

Parçanın çarpışma grubunun ayarlanacağı isim.

Bir parçanın çarpışma grubunu ayarlar.

Verilen isim için çarpışma grubunun kaydını kaldırır, aşağıdaki davranışlarla:

- Geçersiz bir isim verildiğinde, yöntem hiçbir şey yapmaz.
- Eğer ayrılmış isim `"Default"` verilirse **veya** yöntem bir istemciden çağrılırsa, bir hata fırlatır.
- Kaldırıldığında çarpışma grubunda herhangi bir parça varsa, bu parçalar aynı çarpışma grubu adını korur. Kaldırılan gruptaki parçaların fiziksel davranışı belirsizdir, bu nedenle kaldırılan gruptaki parçaların başka bir gruba, örneğin `"Default"` grubuna taşınması önerilir.

Bu yöntemin, çalışma alanındaki `Class.BasePart|BaseParts` sayısına bağlı olarak hafif bir performans yükü olduğunu unutmayın, bu yüzden tüm çarpışma gruplarını düzenleme sırasında Studio
[editörü](/workspace/collisions#collision-groups) aracılığıyla kaydedip bu yöntemi olabildiğince az çağırmanız önerilir.

PhysicsService:UnregisterCollisionGroup

Kayıt dışı bırakılacak çarpışma grubunun adı.

Verilen isim için çarpışma grubunun kaydını kaldırır.

PhysicsService

Çarpışma gruplarını oluşturma ve yönetme yöntemleri sağlayan hizmet,
`Class.BasePart|BaseParts` kümesinin birbirleriyle çarpışıp çarpışmayacağını kontrol eder.

`Instance`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır
`Class.DataModel` ağacının bir parçası olabilir.

Kök `Instance` nesneleri doğrudan oluşturulamaz, ancak özel
`Datatype.Instance.new()` yapıcı, sınıfın adını bir parametre olarak alarak ve oluşturulan nesneyi döndürerek nesneler oluşturur.


Bir nesnenin soy ağacındaki değişiklikleri algılamayı, `Class.Instance.AncestryChanged` olayıyla bağlanarak gösterir.

ChangingPart'in Parent'ı zamanla farklı değerlere ayarlanır. Parçanın ebeveyni, parçanın atasıdır, bu yüzden `Class.Instance.AncestryChanged` olayı değiştiğinde tetiklenecektir.

Bu örnek yeniden ebeveyn yapıldığında veya herhangi bir atasının
yeniden ebeveyn yapıldığında tetiklenir.

Bu olayı, bir örneğin Studio'da silinmesini takip etmek için kullanabilirsiniz,
örneğin Explorer'da manuel silme veya bir eklenti aracılığıyla. Eğer bir
örneğin `Class.Instance:Destroy()` kullanılarak yok edildiğini tespit etmeniz
gerekiyorsa, bunun yerine `Class.Instance.Destroying` olayını kullanın.


Instance.AncestryChanged

child

Değişen `Class.Instance.Parent|Parent` özelliğine sahip örnek,
bu örnek veya daha uzak bir ata olabilir, **bağlayıcının bağlı olduğu**
örnek olmayabilir.


parent

Bu nesnenin veya bir atasının `Class.Instance.Parent` özelliği değiştiğinde tetiklenir.


Bu olay, örnekte herhangi bir özellik değiştiğinde tetiklenir,
özellikle bir özellik `nil` olarak ayarlandığında. Değiştirilen
özelliğin adı bağlı fonksiyona iletilir.

Örneğin, aşağıdaki kod parçası, bir parçanın özelliklerinden biri değiştiğinde
`attributeChanged()` fonksiyonunu tetikler:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "değişti")
end

part.AttributeChanged:Connect(attributeChanged)
```
Ayrıca `Class.Instance:GetAttributeChangedSignal()`'ı da inceleyin,
bu belirli bir özelliğin değiştiğinde tetiklenen bir olayı döndürür.


Instance.AttributeChanged

attribute

Bir `Class.Instance` üzerinde herhangi bir özellik değiştiğinde tetiklenir.


Bu kod parçası, nesneler Workspace'e eklendikçe isimlerini yazdırır:

Bu `Class.Instance`'e bir nesne eklendikten sonra tetiklenir.

Not, bu yöntemi istemcide sunucu tarafından oluşturulan nesneleri tespit etmek için
kullanırken, bu nesnelerin alt nesnelerini indekslerken `Class.Instance:WaitForChild()`
metodunu kullanmak gereklidir. Çünkü nesne ve alt nesnelerinin sunucudan
istemciye aynı anda çoğaltılacağı garanti edilmez. Örneğin:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Alt nesnelerin henüz çoğaltılmamış olabileceğinden WaitForChild() kullanın
	local head = child:WaitForChild("Head")
end)
```
Not, bu olay yalnızca `Class.Instance`'in doğrudan çocukları için çalışır.
Tüm alt nesneleri yakalayan bir olay için `Class.Instance.DescendantAdded`'ı kullanın.

Ayrıca `Class.Instance.ChildRemoved`'ı da inceleyin.


Instance.ChildAdded

Bu `Class.Instance`'e bir nesne eklendikten sonra tetiklenir.


Instance.childAdded

Bu kesit, nesnelerin Workspace'ten kaldırıldıkça isimlerini yazdırır:

Bu `Class.Instance`'den bir çocuk kaldırıldıktan sonra tetiklenir.

Kaldırma, bir nesnenin ebeveyninin bu `Class.Instance`'den başka bir
şeye değiştirilmesi anlamına gelir. Not, bu olay bir çocuğun yok edildiğinde
(`Class.Instance:Destroy()` kullanılarak) de tetiklenecektir, çünkü yok etme
fonksiyonu bir nesnenin ebeveynini `nil` olarak ayarlar.

Bu olay yalnızca `Class.Instance`'in doğrudan çocukları için çalışır.
Tüm alt nesneleri yakalayan bir olay için `Class.Instance.DescendantRemoving`'i
kullanın.

Ayrıca `Class.Instance.ChildAdded`'ı da inceleyin.


Instance.ChildRemoved

Bu `Class.Instance`'den bir çocuk kaldırıldıktan sonra tetiklenir.


Aşağıdaki örnek, Workspace'e eklenen her nesnenin adını yazdıracaktır:

Bu olay, bir alt nesne bu `Class.Instance`'e eklendikten sonra tetiklenir.

Her alt nesne için tetiklendiğinden, bir nesneyi `Class.Instance`'e ebeveyn
yapmak, bu nesne ve tüm alt nesneleri için olayı ayrı ayrı tetikler.

Eğer yalnızca `Class.Instance`'in **doğrudan çocukları** ile ilgileniyorsanız,
`Class.Instance.ChildAdded`'ı kullanın.

Ayrıca `Class.Instance.DescendantRemoving`'i de inceleyin.


Instance.DescendantAdded

descendant

Bir alt nesne bu `Class.Instance`'e eklendikten sonra tetiklenir.


Aşağıdaki örnek, herhangi bir bebeğin adı Workspace'ten kaldırılırken yazdırılır:

Bu olay, ebeveyn `Class.Instance`'in değiştiği **hemen önce** tetiklenir,
böylece bir **alt nesne** artık bir alt nesne olmayacaktır. `Class.Instance:Destroy()|Destroy()`
bir nesnenin `Class.Instance.Parent|Parent` değerini `nil` olarak değiştirir,
bu nedenle ebeveynin bir alt nesnesi üzerinde bu metodu çağırmak, bu olayın tetiklenmesine
neden olacaktır.

Bu olay, alt nesnenin kaldırılmasından **önce** tetiklendiğinden, bu olay
tetiklendiğinde alt nesnenin ebeveyni değişmemiş olacaktır. Eğer alt nesne
aynı zamanda ebeveynin **doğrudan çocuğu** ise, bu olay `Class.Instance.ChildRemoved`
dan önce tetiklenecektir.

Eğer bir alt nesnenin çocukları varsa, bu olay önce alt nesne ile,
sonra onun alt nesneleri ile tetiklenir.

#### Uyarı

Bu olay, kaldırılan alt nesne ile tetiklenir. Alt nesnenin `Class.Instance.Parent|Parent`
özelliğini başka bir şeye ayarlamaya çalışmak başarısız olacaktır. Aşağıda bunu
gösteren bir örnek bulunmaktadır:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Bu fonksiyonda alt nesnenin ebeveynini değiştirmeyin!
	-- Bu olay, ebeveyn değiştirildiği için tetiklenir ve değişiklik henüz gerçekleşmemiştir
	-- Bu nedenle, ebeveyni bu şekilde değiştirmek sorunludur:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Ayrıca `Class.Instance.DescendantAdded|DescendantAdded`'ı da inceleyin.


Instance.DescendantRemoving

Bir `Class.Instance`'in alt nesnesi kaldırılmadan hemen önce tetiklenir.


Bu örnek, Immediate sinyal davranışını kullanırken, bir
örneğin yok edildiğinde bağlı fonksiyonun beklemesine kadar yerinde kaldığını gösterir.

Bu örnek, Ertelenmiş sinyal davranışı kullanıldığında, bir Instance'ın
sinyal ateşlenmeden önce yok edildiğini göstermektedir.

Bağlı bir fonksiyon hala kullanıyorken `Class.Instance` asla bellekten silinmeyecektir.
Ancak, fonksiyon herhangi bir noktada bekletilirse, `Class.Instance` ve alt nesneleri
`nil`'e ebeveyn yapılacaktır.

Eğer `Class.Workspace.SignalBehavior` özelliği `Enum.SignalBehavior.Immediate`\olarak ayarlandıysa, bu olay `Class.Instance` veya bir atasının
`Class.Instance:Destroy()` ile yok edilmeden hemen önce tetiklenir.

Eğer `Class.Workspace.SignalBehavior` özelliği `Enum.SignalBehavior.Deferred`\olarak ayarlandıysa, bu olay bir sonraki devam noktasında tetiklenecektir,
bu da `Class.Instance` veya bir atasının `Class.Instance:Destroy()` ile yok edilmesinden
sonra olacaktır.

`Enum.SignalBehavior.Deferred|Deferred` davranışı ile, bir betiği kendi
`Class.Instance.Destroying` olayına bağlamak sorunludur, çünkü betik
geri çağırma çağrılmadan önce yok edilecektir (yani çalışmayacaktır).

Studio'da bir `Class.Instance`'i silerken, örneğin [Explorer](/studio/explorer)
üzerinden manuel silme veya bir eklenti aracılığıyla, `Class.Instance` yok edilmez.
Bunun yerine, ebeveyn `nil` olarak ayarlanır ve bunu `Class.Instance.AncestryChanged`
ile takip edebilirsiniz.


Instance.Destroying

`Class.Instance:Destroy()` aracılığıyla yok edilmeden hemen önce (veya
sonrasında) tetiklenir.


 `Class.Instance.StyledPropertiesChanged`'i gösterir.


Bu olay, örnekte herhangi bir stil özelliği değiştiğinde tetiklenir,
özellikle bir özellik `nil` olarak ayarlandığında.


Instance.StyledPropertiesChanged

Örnekte herhangi bir stil özelliği değiştiğinde tetiklenir, özellikle
bir özellik `nil` olarak ayarlandığında.


Bu yöntem, nesneye bir etiket uygular, etiket zaten uygulanmışsa etkisi yoktur. Başarıyla bir etiket eklemek, `Class.CollectionService:GetInstanceAddedSignal()` tarafından oluşturulan bir sinyali tetikler.

#### Uyarılar

- Bir nesnenin istemci tarafında eklenen etiketleri, sunucu daha sonra o nesneye bir etiket ekler veya kaldırırsa düşecektir çünkü sunucu tüm etiketleri birlikte çoğaltır ve önceki etiketleri üzerine yazar.

- Bir nesneyi etiketlerken, etiketin işlevselliğini sağlamak için bazı kaynakların kullanılması yaygındır, örneğin olay bağlantıları veya tablolar. Bellek sızıntılarını önlemek için, etiket için artık gerekli olmadığında bunları temizlemek iyi bir fikirdir (bağlantıyı kesmek, `nil` olarak ayarlamak vb.). Bunu `Class.Instance:RemoveTag()` çağrıldığında, `Class.Instance:Destroy()` çağrıldığında veya `Class.CollectionService:GetInstanceRemovedSignal()` tarafından döndürülen bir sinyale bağlı bir işlevde yapın.


Instance:AddTag

Çocuklar işlevi, nesnenin çocuklarının bir dizisini döndürür.


Instance:children

Nesnenin çocuklarının bir dizisini döndürür.


Bu yöntem, bir nesnenin tüm çocuklarını ve torunlarını yok eder.

```
local part = Instance.new("Part")

-- Bazı parıltılar ekle
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Eğer **tüm** çocukları ve torunları yok etmek istemiyorsanız, `Class.Instance:GetChildren()` veya `Class.Instance:GetDescendants()` kullanarak o çocukları/torunları döngüye alabilir ve yok etmek istediğinizi seçebilirsiniz. Örneğin, aşağıdaki kod örneği, bir `Class.Model`'den inen tüm `Class.BasePart|BaseParts`'ı yok edecektir:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

Bu yöntem, bir nesnenin tüm çocuklarını yok eder.


Modeli `Class.Instance:Clone()` kullanarak klonlamayı gösterir.

`Clone()` bir nesnenin ve tüm torunlarının bir kopyasını oluşturur, `Class.Instance.Archivable|Archivable` olmayan tüm nesneleri göz ardı eder. Kök nesnenin kopyası bu yöntemle döner ve `Class.Instance.Parent|Parent` değeri `nil` olarak ayarlanır. Eğer nesnenin kendisi `Class.Instance.Archivable|Archivable` değeri `false` olarak ayarlanmışsa, bu yöntem `nil` döner.

Eğer `Class.ObjectValue.Value` gibi bir referans özelliği, kopyalanmış bir nesnede ayarlanırsa, kopyanın özelliğinin değeri orijinalin değerine bağlıdır:

- Eğer bir referans özelliği **aynı zamanda** kopyalanmış bir nesneye atıfta bulunuyorsa, kopya kopyaya atıfta bulunur.
- Eğer bir referans özelliği **kopyalanmamış** bir nesneye atıfta bulunuyorsa, kopyada aynı değer korunur.


Instance:Clone

Nesnenin bir kopyası veya nesne `Class.Instance.Archivable|Archivable` değilse `nil`.


Bir nesnenin ve tüm torunlarının bir kopyasını oluşturur, `Class.Instance.Archivable|Archivable` olmayan nesneleri göz ardı eder.


Instance:clone

Bir Parçayı `Class.Instance:Destroy()` fonksiyonunu kullanarak yok etmenin gösterimi.

Bu fonksiyon, artık gereksiz olan nesneleri imha etmenin doğru yoludur.

`Class.Instance.Parent` özelliğini `nil` olarak ayarlar, `Class.Instance.Parent` özelliğini kilitler, tüm bağlantıları keser ve tüm çocuklar üzerinde `Destroy()` çağrısı yapar. Bu yöntem, artık gerekli olmayan nesneleri atmanın doğru yoludur.

Gereksiz nesneleri atmak önemlidir, çünkü bir yerde gereksiz nesneler ve bağlantılar bellek kullanır ve zamanla ciddi performans sorunlarına yol açabilir.

Bir nesne üzerinde `Destroy()` çağrıldıktan sonra, o nesneye (veya torunlarına) referans veren herhangi bir değişkeni `nil` olarak ayarlamak en iyi uygulamadır. Bu, kodunuzun nesneyle ilgili herhangi bir şeye erişmesini önler.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Bunu yapmayın:
print(part.Name)  --> "Hello, world"
-- Yukarıdaki satırın çalışmasını önlemek için bunu yapın:
part = nil
```
Bir `Class.Instance`, bu yöntemle yok edildikten sonra yeniden kullanılamaz çünkü `Class.Instance.Parent` özelliği kilitlenmiştir. Bir nesneyi yok etmek yerine **geçici olarak** kaldırmak için, `Class.Instance.Parent|Parent` değerini `nil` olarak ayarlayın. Örneğin:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Belirli bir süre sonra bir nesneyi yok etmek için `Class.Debris:AddItem()` kullanın.


Instance:Destroy

`Class.Instance.Parent` özelliğini `nil` olarak ayarlar, `Class.Instance.Parent` özelliğini kilitler, tüm bağlantıları keser ve tüm çocuklar üzerinde `Destroy()` çağrısı yapar.


Instance:destroy

`Class.Instance.Name`'i verilen adla eşit olan `Class.Instance`'nin ilk atasını döndürür.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlayarak `Class.DataModel`'e doğru çalışır. Eğer eşleşen bir ata bulunamazsa, `nil` döner.

Aşağıdaki kod parçası, `Car` adındaki nesnenin ilk atasını bulacaktır.

```
local car = object:FindFirstAncestor("Car")
```
Belirli bir sınıfın atalarını bulan bu yöntemin varyantları için `Class.Instance:FindFirstAncestorOfClass()` ve `Class.Instance:FindFirstAncestorWhichIsA()`'ya bakın.


Instance:FindFirstAncestor

`Class.Instance.Name`'i verilen adla eşit olan `Class.Instance`'nin ilk atasını döndürür.


`Class.Instance`'nin ilk atasını döndürür, `Class.Object.ClassName`'i verilen className ile eşit olan.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlayarak `Class.DataModel`'e doğru çalışır. Eğer eşleşen bir ata bulunamazsa, `nil` döner.

Bu yöntemin yaygın bir kullanımı, bir `Class.BasePart`'ın ait olduğu `Class.Model`'ı bulmaktır. Örneğin:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Bu yöntem, `Class.Instance:FindFirstAncestor()`'nın bir varyantıdır ve `Class.Object.ClassName` özelliğini kontrol eder, `Class.Instance.Name` yerine. `Class.Instance:FindFirstAncestorWhichIsA()` da vardır, sınıf mirasını dikkate almak için `Class.Object:IsA()` yöntemini kullanır.


Instance:FindFirstAncestorOfClass

className

`Class.Instance`'nin ilk atasını döndürür, `Class.Object.ClassName`'i verilen className ile eşit olan.


`Class.Instance`'nin ilk atasını döndürür, `Class.Object:IsA()` verilen className için `true` döner.

Bu yöntem yukarı doğru çalışır, yani nesnenin hemen `Class.Instance.Parent`'ından başlayarak `Class.DataModel`'e doğru çalışır. Eğer eşleşen bir ata bulunamazsa, `nil` döner.

`Class.Instance:FindFirstAncestorOfClass()`'dan farklı olarak, bu yöntem `Class.Object:IsA()` kullanır ve sınıf mirasını dikkate alır. Örneğin:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Bu nedenle, aşağıdaki kod örneği, ilk `Class.BasePart` atasını döndürecektir, ister `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Ayrıca `Class.Instance:FindFirstAncestor()`'ya da bakın.


Instance:FindFirstAncestorWhichIsA

`Class.Instance`'nin ilk atasını döndürür, `Class.Object:IsA()` verilen className için `true` döner.


Aşağıdakiler, Workspace içinde "Brick" adlı bir nesne arayacaktır. Eğer bulunursa, bu
nesnenin adını "Foo" olarak değiştirecektir.

Verilen adla bulunan `Class.Instance`'nin ilk çocuğunu döndürür veya böyle bir çocuk yoksa `nil` döner. İsteğe bağlı `recursive` argümanı `true` ise, bu yöntem yalnızca `Class.Instance`'nin hemen çocukları yerine tüm torunları arar.

#### Bir Nesnenin Varlığını Kontrol Etme

`FindFirstChild()` bir nesnenin var olup olmadığını doğrulamak için gereklidir. Nokta operatörü kullanarak bir çocuğu adla indekslemeye çalışmak, çocuk yoksa bir hata fırlatır.

```lua
local Workspace = game:GetService("Workspace")

-- Aşağıdaki satır, parça workspace'de yoksa hata verir
Workspace.Part.Transparency = 0.5
```
Daha iyi bir yaklaşım, önce `Part`'ı kontrol etmek için `FindFirstChild()` kullanmak ve ardından ihtiyaç duyan kodu çalıştırmak için bir `if` ifadesi kullanmaktır.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Bir Özelliği Eşleşen Bir Çocuğu Bulma

Bazen bir nesnenin `Class.Instance.Name|Name`'i, `Class.Instance.Parent|Parent`'ın bir özelliği ile aynı olabilir. Nokta operatörü kullanıldığında, özellikler aynı adı paylaşırlarsa çocuklardan önce gelir.

Aşağıdaki örnekte, `Color` adında bir `Class.Folder`, `Class.Part`'a eklenmiştir, bu da `Class.Part.Color` özelliğine sahiptir. Dikkat edin ki `part.Color`, çocuk `Class.Folder` örneği değil, `Datatype.Color3` özellik değerine atıfta bulunur. `Class.Instance:FindFirstChild()|FindFirstChild()` kullanmanın bir avantajı, yeni özelliklerin tanıtımının kodunuza risk getirmemesidir.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Özellik
local c2 = part:FindFirstChild("Color")  -- Çocuk klasörü
```

#### Performans Notları

`Class.Instance:FindFirstChild()|FindFirstChild()` kullanmak, nokta operatörü kullanmaktan yaklaşık %20 daha uzun sürer ve bir nesneye referans saklamaktan neredeyse 8 kat daha uzun sürer. Bu nedenle, sıkı döngüler veya `Class.RunService.Heartbeat` ve `Class.RunService.PreRender` ile bağlantılı işlevler gibi performansa bağlı kodda çağrılmaktan kaçınmalısınız. Bunun yerine, sonucu bir değişkende saklayın veya bir çocuğun belirli bir adla mevcut olduğunda algılamak için `Class.Instance.ChildAdded|ChildAdded` veya `Class.Instance:WaitForChild()|WaitForChild()` kullanmayı düşünün.


Instance:FindFirstChild

recursive

Aramanın özyinelemeli olarak gerçekleştirilip gerçekleştirilmeyeceği.


Verilen adla bulunan `Class.Instance`'nin ilk çocuğunu döndürür.


Instance:findFirstChild

Verilen `className` ile eşit olan `Class.Instance`'nin ilk çocuğunu döndürür. `Class.Instance:FindFirstChildWhichIsA()`'dan farklı olarak, bu yöntem yalnızca `className` ile eşleşen nesneleri döndürür, sınıf mirasını göz ardı eder. Eğer eşleşen bir çocuk bulunamazsa, bu yöntem `nil` döner.


Instance:FindFirstChildOfClass

Verilen sınıf adıyla eşit olan `Class.Instance`'nin ilk çocuğunu döndürür.


Verilen sınıf adı için `Class.Object:IsA()` `true` dönen `Class.Instance`'nin ilk çocuğunu döndürür.

Eğer eşleşen bir çocuk bulunamazsa, bu yöntem `nil` döner. İsteğe bağlı `recursive` argümanı `true` ise, bu yöntem yalnızca `Class.Instance`'nin hemen çocukları yerine tüm torunları arar.

`Class.Instance:FindFirstChildOfClass()`'dan farklı olarak, bu yöntem `Class.Object:IsA()` kullanır ve sınıf mirasını dikkate alır. Örneğin:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Bu nedenle, aşağıdaki kod örneği, ilk `Class.BasePart` çocuğunu döndürecektir, ister `Class.WedgePart`, `Class.MeshPart` veya `Class.Part` olsun.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Adla bir çocuğu arayan geliştiricilerin, bunun yerine `Class.Instance:FindFirstChild()` kullanmaları önerilir.


Instance:FindFirstChildWhichIsA

Verilen sınıf adı için `Class.Object:IsA()` `true` dönen `Class.Instance`'nin ilk çocuğunu döndürür.


Verilen `Class.Instance.Name` ile bulunan ilk torunu döndürür.

Bu yöntem devre dışı bırakılmıştır ve kullanılamaz. Bir nesnenin ilk torununu bulmak için, bunun yerine `Class.Instance:FindFirstChild()` üzerinde `recursive` parametresini kullanmayı düşünün.


Instance:FindFirstDescendant

Verilen `Class.Instance.Name` ile bulunan ilk torunu döndürür.


Eğer `Class.Instance` bir `Class.Actor` ise, `Class.Actor` kendisi döner. Aksi takdirde, en yakın atası `Class.Actor` döner. Eğer hiçbir ata `Class.Actor` değilse, sonuç `nil` olur.


Instance:GetActor

`Class.Instance` ile ilişkili `Class.Actor`'ı döndürür, varsa.


Bu yöntem, verilen özellik adında atanmış değeri döndürür. Eğer hiçbir özellik atanmadıysa, `nil` döner.

Örneğin, aşağıdaki kod parçası, nesnenin `InitialPosition` özelliğinin değerini ayarlar ve ardından alır:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Ayrıca Bakınız

- `Class.Instance:SetAttribute()` verilen adla özelliği verilen değere ayarlar.
- `Class.Instance:GetAttributes()` nesnenin her bir özelliği için anahtar-değer çiftlerini döndürür.


Instance:GetAttribute

Verilen özellik adında atanmış değer. Eğer hiçbir özellik atanmadıysa, `nil` döner.


Verilen özellik adında atanmış değeri döndürür.


Bu yöntem, `Class.Object.Changed|Changed` olayıyla aynı şekilde davranan bir olayı döndürür, ancak yalnızca belirli verilen özellik değiştiğinde tetiklenir; etkili olarak, `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`'a benzer, ancak özellikler için.

Genellikle, bu yöntemi, özellik adını kontrol eden bir işlevle `Class.Object.Changed|Changed` bağlantısı yerine kullanmak iyi bir fikirdir. Bu yöntemi aynı nesne üzerinde aynı özellik adıyla ardışık çağrılar, aynı olayı döndürür.

Aşağıdaki kod örneği, parça `InitialPosition` özelliği değiştiğinde `attributeChanged()` işlevini tetikleyen bir sinyal döndürür:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Attribute changed")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Ayrıca, nesne üzerinde herhangi bir özelliğin değiştiğinde tetiklenen `Class.Instance.AttributeChanged`'a da bakın.


Instance:GetAttributeChangedSignal

Değişiklik sinyalinin döndürüleceği belirtilen özelliğin adı.


Verilen özellik değiştiğinde tetiklenen bir olay.


Verilen özelliğin değiştiğinde tetiklenen bir olayı döndürür.


Bu yöntem, her bir özelliğin adı anahtar ve değeri `nil` olmayan değerler için anahtar-değer çiftlerini içeren bir sözlük döndürür.

Örneğin, aşağıdaki kod parçası, bir nesnenin özelliklerini ve değerlerini çıktılar:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Ayrıca, verilen özellik adında atanmış değeri döndüren `Class.Instance:GetAttribute()`'a da bakın.


Instance:GetAttributes

Her bir özelliğin adı ve değeri için bir sözlük.


Nesnenin özelliklerinin bir sözlüğünü döndürür.


Aşağıdakiler çalıştırıldığında Workspace'teki tüm nesnelerin adını yazdırır.

Nesnenin doğrudan çocuklarını içeren bir dizi (sayısal olarak indekslenmiş bir tablo) döndürür veya `Class.Instance`'nin `Class.Instance.Parent|Parent` değeri nesneye eşit olan her `Class.Instance`'yi döndürür. Dizi, sayısal veya genel bir `for` döngüsü kullanılarak yinelemeye tabi tutulabilir:

```lua
local Workspace = game:GetService("Workspace")

-- Sayısal döngü örneği
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " is child number " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- Genel döngü örneği
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is child number " .. i)
end
```
Dikkat edin ki döndürülen dizi **belirli bir sırada** sıralanmamıştır, bu nedenle manuel sıralama (örneğin `Library.table.sort()` kullanarak) bu yöntemin döndürdüğü çocukları sıralamak için önerilir.

Ayrıca `Class.Instance:GetDescendants()|GetDescendants()` yöntemine de bakın.


Instance:GetChildren

Nesnenin çocuklarını içeren bir dizi.


Nesnenin tüm çocuklarını içeren bir dizi döndürür.


Instance:getChildren

Roblox tarafından dahili olarak kullanılan hata ayıklama kimliğinin kodlanmış bir dizesini döndürür. Dikkat edin ki:

- Bu öğe korumalıdır. `Class.Script` veya `Class.LocalScript` içinde kullanılmaya çalışılması bir hata oluşturur.
- Hata ayıklama kimliği, hata ayıklama süreçlerinde kullanılan bir kimliktir. Bir hata ayıklayıcının, bir uygulama işlemeden önce her talimatı okumasına olanak tanır. Roblox'taki tüm nesneler, gerektiğinde hata ayıklanabilen işlemler gibi davranır ve her çalıştırma talimatları (veya 'kod') içerir.
- Bu, benzer nesneleri birbirinden ayırması gereken eklentiler için yararlı olabilir (örneğin, aynı adı paylaşan nesneler).


Instance:GetDebugId

scopeLength

Roblox tarafından dahili olarak kullanılan hata ayıklama kimliğinin kodlanmış bir dizesini döndürür.


GetDescendants genellikle belirli bir tür objenin tüm soyundan gelenleri bir
şeyler yapmak için kullanılır. Bu örnekteki kod, GetDescendants ve
`Class.Instance:IsA()` kullanarak çalışma alanındaki tüm parçaları bulur ve
onları yeşil yapar.

Bu nesne yöntemi, o nesnenin tüm torunlarını içeren bir dizi döndürür. `Class.Instance:GetChildren()`'den farklı olarak, bu yöntem yalnızca bir nesnenin doğrudan çocuklarını döndürmekle kalmaz, aynı zamanda o nesnenin her çocuğunu, o çocukların her çocuğunu ve daha fazlasını bulur.

Dikkat edin ki döndürülen dizi **belirli bir sırada** sıralanmamıştır, bu nedenle manuel sıralama (örneğin `Library.table.sort()` kullanarak) bu yöntemin döndürdüğü torunları sıralamak için önerilir. Ayrıca, belirli bir kombinasyon seçici ve kombinatorler ile torunları sorgulamak için `Class.Instance:QueryDescendants()|QueryDescendants()` yöntemini de düşünün.


Instance:GetDescendants

Nesnenin torunlarını içeren bir dizi.


Nesnenin tüm torunlarını içeren bir dizi döndürür.


Bu kod örneği, `Class.Instance:GetFullName()` fonksiyonunun davranışını göstermektedir.
Fonksiyonun `DataModel` hiyerarşisinde olmayan bir nesne üzerinde çağrıldığında nasıl davrandığını
ve dönüş değerinin özel karakterleri nasıl kaçırmadığını gösterir.

Bu kod örneği, `Class.Instance:GetFullName()` fonksiyonunu Lua'da yeniden uygular.


Nesnenin soyunu tanımlayan bir dize döndürür. Dize, nesnenin `Class.Instance.Name|Name`'i ve atalarının bir birleşimidir, noktalarla ayrılmıştır. `Class.DataModel` (`game`) dikkate alınmaz. Örneğin, `Class.Workspace` içindeki bir `Class.Part`, `Class.Workspace.Part` döndürebilir.

`Class.DataModel`'in bir torunu olmayan bir `Class.Instance` üzerinde çağrıldığında, bu yöntem, `Class.Instance.Parent|Parent`'ı olmayan en üstteki ata dahil olmak üzere tüm ataları dikkate alır.

Bu yöntem, günlük kaydı ve hata ayıklama için yararlıdır. Döndürülen dizeyi herhangi bir yararlı işlem için ayrıştırmaya çalışmamalısınız; bu yöntem, nesne adlarındaki noktaları (veya diğer sembolleri) kaçırmaz. Diğer bir deyişle, çıktısı genellikle geçerli bir Luau tanımlayıcısı gibi görünse de, garanti edilmez.


Instance:GetFullName

Nesnenin soyunu tanımlayan bir dize döndürür.


 `Class.Instance:GetStyled()`'i gösterir.


Bu yöntem, belirtilen özelliğin stilize edilmiş veya açıkça değiştirilmiş değerini döndürür, aksi takdirde stilize edilmemiş/değiştirilmemiş varsayılan özellik değerini döndürür. Bu, doğrudan özellik değerine erişmekten biraz farklıdır, örneğin `[GuiObject].Rotation`, bu özelliğin varsayılan veya değiştirilmiş değerini döndürür.


Instance:GetStyled

selector

Nesne üzerinde hedeflediğiniz sahte nesne için isteğe bağlı seçici.


Belirtilen özelliğin stilize edilmiş veya açıkça değiştirilmiş değeri, aksi takdirde stilize edilmemiş/değiştirilmemiş varsayılan özellik değeri.


Belirtilen özelliğin stilize edilmiş veya açıkça değiştirilmiş değerini döndürür, aksi takdirde stilize edilmemiş/değiştirilmemiş varsayılan özellik değerini döndürür.


Demonstrates `Class.Instance:GetStyledPropertyChangedSignal()`.


Bu yöntem, `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` olayıyla aynı şekilde davranan bir olayı döndürür, ancak yalnızca belirtilen stil özelliği değiştiğinde tetiklenir. Genellikle, bu yöntemi, özellik adını kontrol eden bir işlevle `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` bağlantısı yerine kullanmak iyi bir fikirdir. Bu yöntemi aynı nesne üzerinde aynı özellik adıyla ardışık çağrılar, aynı olayı döndürür.

Dikkat edin ki bu olay, bağlı bir işleve herhangi bir argüman geçmeyecektir, bu nedenle değişen özelliğin değeri bir betik içinde doğrudan okunmalıdır.


Instance:GetStyledPropertyChangedSignal

Nesne üzerindeki belirtilen stil özelliği değiştiğinde tetiklenen bir olayı döndürür.


Instance

`Instance`, Roblox sınıf hiyerarşisindeki tüm sınıflar için temel sınıftır
`Class.DataModel` ağacının bir parçası olabilir.


/reference/engine/classes/PhysicsService.yaml

Özet