`Class.StarterGui` adalah objek wadah yang dirancang untuk menyimpan objek `Class.LayerCollector` seperti `Class.ScreenGui|ScreenGuis`.

Ketika `Class.Player.Character` muncul, isi dari `Class.PlayerGui` mereka (jika ada) akan dikosongkan. Anak dari `Class.StarterGui` kemudian disalin bersama dengan keturunannya ke dalam `Class.PlayerGui`. Namun, perlu dicatat bahwa objek `Class.LayerCollector` seperti `Class.ScreenGui|ScreenGuis` yang memiliki properti `Class.LayerCollector.ResetOnSpawn|ResetOnSpawn` yang diatur ke `false` hanya akan diletakkan dalam `Class.PlayerGui` setiap pemain sekali dan tidak akan dihapus ketika `Class.Player` muncul kembali.

`Class.StarterGui` juga mencakup berbagai fungsi yang memungkinkan Anda untuk berinteraksi dengan `Class.CoreGui`. Misalnya, `Class.StarterGui:SetCoreGuiEnabled()` dapat digunakan untuk menonaktifkan elemen dari `Class.CoreGui`, dan `Class.StarterGui:SetCore()` dapat melakukan berbagai fungsi termasuk membuat pemberitahuan dan pesan sistem.

Metode ini mengembalikan data yang diatur atau dibuat tersedia oleh skrip inti Roblox. Parameter pertama dan satu-satunya adalah string yang memilih informasi yang akan diambil. Bagian berikutnya menjelaskan string dan data yang mereka kembalikan melalui fungsi ini.

Memanggil metode ini mungkin menghasilkan hasil. Banyak dari ini juga mendaftarkan fungsi setara `Class.StarterGui:SetCore()|SetCore()` (ini ditandai dengan asterisk).

##### PointsNotificationsActive \\*

Mengembalikan `true` jika pemberitahuan poin pemain diaktifkan.

##### BadgesNotificationsActive \\*

Mengembalikan `true` jika pemberitahuan lencana diaktifkan.

##### AvatarContextMenuEnabled \\*

Mengembalikan `true` jika
[Menu Konteks Avatar](/players/avatar-context-menu) diaktifkan.

##### ChatActive \\*

Mengembalikan apakah obrolan aktif atau tidak. Ini ditunjukkan oleh status pemilihan ikon obrolan di bar atas.

##### ChatWindowSize \\*

Mengembalikan ukuran jendela obrolan sebagai `Datatype.UDim2`.

##### ChatWindowPosition \\*

Mengembalikan posisi jendela obrolan sebagai `Datatype.UDim2`.

##### ChatBarDisabled \\*

Mengembalikan `true` jika bilah obrolan dinonaktifkan.

##### GetBlockedUserIds

Mengembalikan daftar `Class.Player.UserId|UserIds` yang terkait dengan pengguna yang telah diblokir oleh pemain lokal.

##### PlayerBlockedEvent

Mengembalikan `Class.BindableEvent` yang dipanggil setiap kali seorang pemain diblokir oleh pemain lokal.

##### PlayerUnblockedEvent

Mengembalikan `Class.BindableEvent` yang dipanggil setiap kali seorang pemain tidak diblokir oleh pemain lokal.

##### PlayerMutedEvent

Mengembalikan `Class.BindableEvent` yang dipanggil setiap kali seorang pemain dibisukan oleh pemain lokal.

##### PlayerUnmutedEvent

Mengembalikan `Class.BindableEvent` yang dipanggil setiap kali seorang pemain tidak dibisukan oleh pemain lokal.

##### PlayerFriendedEvent

Mengembalikan `Class.BindableEvent` yang dipanggil setiap kali seorang pemain terkoneksi oleh pemain lokal.

##### PlayerUnfriendedEvent

Mengembalikan `Class.BindableEvent` yang dipanggil setiap kali seorang pemain tidak terkoneksi oleh pemain lokal.

##### DevConsoleVisible \\*

Mengembalikan `true` jika
[Developer Console](/studio/developer-console) terlihat.

##### VRRotationIntensity

Mengembalikan string yang menggambarkan sensitivitas rotasi kamera dalam VR: `Rendah`, `Tinggi` dan `Halus`. Ini tidak akan tersedia kecuali `Class.VRService.VREnabled` adalah `true`.

StarterGui:GetCore

parameterName

Nama parameter inti yang akan diambil, seperti
`"PointsNotificationsActive"` atau `"ChatActive"`.


Nilai yang terkait dengan nama parameter inti yang ditentukan, yang
tipenya tergantung pada parameter yang ditanyakan.


Mengembalikan variabel yang telah ditentukan oleh skrip inti Roblox.

Contoh di bawah ini akan mencetak apakah daftar pemain terlihat oleh
LocalPlayer.

Fungsi ini mengembalikan apakah `Enum.CoreGuiType` yang diberikan diaktifkan, atau jika telah dinonaktifkan menggunakan `Class.StarterGui:SetCoreGuiEnabled()`. Fungsi ini harus dipanggil di klien.

Perlu dicatat bahwa mengatur `"TopbarEnabled"` ke `false` menggunakan `Class.StarterGui:SetCore()|SetCore()` menyembunyikan semua `Enum.CoreGuiType|CoreGuiTypes` tetapi tidak mempengaruhi hasil dari fungsi ini.

StarterGui:GetCoreGuiEnabled

coreGuiType

Apakah `Enum.CoreGuiType` yang diberikan diaktifkan.

Mengembalikan apakah `Enum.CoreGuiType` yang diberikan diaktifkan, atau jika telah dinonaktifkan menggunakan `Class.StarterGui:SetCoreGuiEnabled()`.

Metode ini (jangan bingung dengan
`Class.StarterGui:SetCoreGuiEnabled()|SetCoreGuiEnabled()`) membuka
beragam fungsi yang ditentukan oleh skrip inti Roblox, seperti mengirim
notifikasi, mengubah notifikasi untuk lencana/point, mendefinisikan
callback untuk tombol reset, atau mengubah tampilan topbar.

Parameter pertama adalah sebuah string yang memilih fungsionalitas dengan
apa yang akan berinteraksi saat pemanggilan. Mungkin perlu untuk
memanggil metode ini beberapa kali menggunakan `Global.LuaGlobals.pcall()` jika skrip inti terkait
belum dimuat (atau jika skrip tersebut telah sepenuhnya dinonaktifkan).

Tabel berikut menjelaskan string yang dapat diterima sebagai
parameter pertama. Parameter yang harus diikuti tergantung pada
fungsionalitas yang akan digunakan dan dijelaskan dalam sub-tabel.

##### ChatActive

Mengontrol apakah chat aktif.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(diperlukan)</td>
    <td>Menentukan apakah chat harus diaktifkan.</td>
  </tr>
  </tbody>
</table>

##### PointsNotificationsActive

Mengontrol apakah notifikasi untuk point pemain yang didapat akan muncul.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(diperlukan)</td>
    <td>Menentukan apakah notifikasi untuk point pemain yang didapat akan muncul.</td>
  </tr>
  </tbody>
</table>

##### BadgesNotificationsActive

Mengontrol apakah notifikasi untuk lencana yang didapat akan muncul.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
      </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(diperlukan)</td>
    <td>Menentukan apakah notifikasi untuk lencana yang didapat
akan muncul.</td>
  </tr>
  </tbody>
</table>

##### ResetButtonCallback

Menentukan perilaku, jika ada, dari tombol reset dengan memberikan boolean atau
`Class.BindableEvent` yang akan diinformasikan ketika pemain meminta untuk mereset.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
		</thead>
    <tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(diperlukan)</td>
    <td>Menentukan apakah tombol reset mempertahankan perilaku defaultnya.</td>
  </tr>
	<tr>
    <td colspan="4"><b>ATAU</b></td>
  </tr>
	<tr>
    <td><code>callback</code></td>
    <td><code>Class.BindableEvent</code></td>
    <td>(diperlukan)</td>
    <td>Sebuah <code>Class.BindableEvent</code> yang akan diinformasikan saat pemain mengonfirmasi bahwa mereka ingin mereset.</td>
  </tr>
  </tbody>
</table>

##### ChatMakeSystemMessage

Menampilkan pesan yang diformat di chat. Menggunakan metode ini memerlukan
`Class.TextChatService.ChatVersion` dari pengalaman diatur pada
`Enum.ChatVersion|LegacyChatService`, meskipun chat lama **deprecated** dan penggunaannya tidak disarankan. Untuk pengalaman yang menggunakan
`Class.TextChatService` saat ini, lihat
`Class.TextChannel:DisplaySystemMessage()`.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
      </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>configTable</code></td>
    <td>dictionary</td>
    <td>(diperlukan)</td>
    <td>Sebuah dictionary informasi yang menjelaskan pesan (lihat di bawah).</td>
  </tr>
  </tbody>
</table>

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>Text</code></td>
    <td>string</td>
    <td>(diperlukan)</td>
    <td>Pesan yang akan ditampilkan.</td>
  </tr>
	<tr>
    <td><code>Color</code></td>
    <td><code>Datatype.Color3</code></td>
    <td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
    <td>Warna teks dari pesan.</td>
  </tr>
	<tr>
    <td><code>Font</code></td>
    <td><code>Enum.Font</code></td>
    <td><code>SourceSansBold</code></td>
    <td>Font dari pesan.</td>
  </tr>
	<tr>
    <td><code>TextSize</code></td>
    <td>integer</td>
    <td><code>18</code></td>
    <td>Ukuran teks dari pesan.</td>
  </tr>
  </tbody>
</table>

##### SendNotification

Menyebabkan notifikasi non-intrusif muncul di sudut kanan bawah layar. Notifikasi dapat memiliki hingga dua tombol.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
  <tbody>
	<tr>
    <td><code>configTable</code></td>
    <td>dictionary</td>
    <td>(diperlukan)</td>
    <td>Sebuah dictionary informasi yang menjelaskan notifikasi (lihat di bawah).</td>
  </tr>
  </tbody>
</table>

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>Title</code></td>
    <td>string</td>
    <td>(diperlukan)</td>
    <td>Judul notifikasi.</td>
  </tr>
	<tr>
    <td><code>Text</code></td>
    <td>string</td>
    <td>(diperlukan)</td>
    <td>Teks utama notifikasi.</td>
  </tr>
	<tr>
    <td><code>Icon</code></td>
    <td>string</td>
    <td></td>
    <td>Gambar yang akan ditampilkan bersamaan dengan notifikasi.</td>
  </tr>
	<tr>
    <td><code>Duration</code></td>
    <td>number</td>
    <td><code>5</code></td>
    <td>Durasi (dalam detik) notifikasi harus tetap terlihat.</td>
  </tr>
	<tr>
    <td><code>Callback</code></td>
    <td><code>Class.BindableFunction</code></td>
    <td></td>
    <td>Sebuah <code>Class.BindableFunction</code> yang harus dipanggil dengan teks dari tombol yang ditekan oleh pemain.</td>
  </tr>
	<tr>
    <td><code>Button1</code></td>
    <td>string</td>
    <td></td>
    <td>Teks yang akan ditampilkan pada tombol pertama.</td>
  </tr>
	<tr>
    <td><code>Button2</code></td>
    <td>string</td>
    <td></td>
    <td>Teks yang akan ditampilkan pada tombol kedua.</td>
  </tr>
  </tbody>
</table>

##### TopbarEnabled

Menentukan apakah topbar ditampilkan. Menonaktifkan topbar juga
akan menonaktifkan semua `Class.CoreGui|CoreGuis` seperti chat, inventori, dan
daftar pemain (contohnya, yang diatur dengan
`Class.StarterGui:SetCoreGuiEnabled()|SetCoreGuiEnabled`).

Ketika dinonaktifkan, wilayah yang dulunya ditempati oleh topbar masih akan menangkap
event mouse; namun, tombol yang ditempatkan di sana tidak akan merespons klik.
Asal dari ruang GUI akan tetap offset 36 piksel dari bagian atas layar.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(diperlukan)</td>
    <td>Menentukan apakah topbar harus terlihat.</td>
  </tr>
</tbody>
</table>

##### DevConsoleVisible

Menentukan apakah
[Developer Console](/studio/developer-console) terlihat.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>visibility</code></td>
    <td>boolean</td>
    <td>(diperlukan)</td>
    <td>Menentukan apakah konsol terlihat.</td>
  </tr>
</tbody>
</table>

##### PromptSendFriendRequest

Meminta pemain saat ini untuk mengirimkan permintaan teman kepada
`Class.Player` yang diberikan.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(diperlukan)</td>
    <td>Pemain yang permintaan temannya harus dikirim.</td>
  </tr>
</tbody>
</table>

##### PromptUnfriend

Meminta pemain saat ini untuk menghapus `Class.Player` yang diberikan dari daftar temannya.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<body>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(diperlukan)</td>
    <td>Pemain yang harus dihapus dari daftar teman.</td>
  </tr>
</tbody>
</table>

##### PromptBlockPlayer

Meminta pemain saat ini untuk memblokir `Class.Player` yang diberikan.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(diperlukan)</td>
    <td>Pemain yang harus diblokir.</td>
  </tr>
  </tbody>
</table>

##### PromptUnblockPlayer

Meminta pemain saat ini untuk membuka blokir `Class.Player` yang diberikan.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
 </thead>
 <tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(diperlukan)</td>
    <td>Pemain yang harus dibuka blokirnya.</td>
  </tr>
  </tbody>
</table>

##### AvatarContextMenuEnabled

Menentukan apakah
[Avatar Context Menu](/players/avatar-context-menu) diaktifkan.

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(diperlukan)</td>
    <td>Menentukan apakah menu konteks diaktifkan.</td>
  </tr>
</tbody>
</table>

##### AvatarContextMenuTarget

Membuka secara paksa
[Avatar Context Menu](/players/avatar-context-menu).

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(diperlukan)</td>
    <td>Pemain tempat menu konteks akan dibuka.</td>
  </tr>
</tbody>
</table>

##### AddAvatarContextMenuOption

Menambahkan opsi ke
[Avatar Context Menu](/players/avatar-context-menu).

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>option</code></td>
    <td><code>Enum.AvatarContextMenuOption</code></td>
    <td>(diperlukan)</td>
    <td>Opsi untuk ditambahkan.</td>
  </tr>
	<tr>
    <td colspan="4"><b>ATAU</b></td>
  </tr>
	<tr>
    <td><code>option</code></td>
    <td>table</td>
    <td>(diperlukan)</td>
    <td>Sebuah tabel dua elemen, dimana yang pertama adalah nama tindakan kustom, dan yang kedua adalah <code>Class.BindableEvent</code> yang akan dipicu ketika pemain dipilih saat opsi diaktifkan.</td>
  </tr>
</tbody>
</table>

##### RemoveAvatarContextMenuOption

Menghapus opsi dari
[Avatar Context Menu](/players/avatar-context-menu). Argumen
`option` harus sama dengan yang digunakan dengan
`"AddAvatarContextMenuOption"` (lihat di atas).

<table size="small">
	<thead>
		<tr>
			<th>Nama</th>
			<th>Jenis</th>
			<th>Default</th>
			<th>Deskripsi</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>option</code></td>
    <td>Variant</td>
    <td>(diperlukan)</td>
    <td>Nilai yang sama diberikan kepada <b>AddAvatarContextMenuOption</b>.</td>
  </tr>
  </tbody>
</table>

##### AvatarContextMenuTheme

Mengkonfigurasi
[Avatar Context Menu](/players/avatar-context-menu) yang dapat dikustomisasi, yang merupakan fitur opt-in yang memungkinkan interaksi sosial antar pemain dengan mudah melalui
aksinya, seperti memulai perdagangan, pertempuran, dan lainnya. Untuk informasi lebih lanjut tentang cara mengkustomisasi temanya, lihat artikel
[Avatar Context Menu](/players/avatar-context-menu).

##### CoreGuiChatConnections

Mengatur koneksi gateway bindable antara tombol chat di topbar
`Class.CoreGui` dan sistem chat lama. Parameter kedua harus merupakan tabel dari
`Class.BindableEvent|BindableEvents` dan
`Class.BindableFunction|BindableFunctions`.

StarterGui:SetCore

Memilih fungsionalitas yang akan berinteraksi dengan panggilan tersebut.

value

Sebuah tabel dari `Class.BindableEvent|BindableEvents` dan `Class.BindableFunction|BindableFunctions`.

Memungkinkan Anda melakukan interaksi tertentu dengan skrip inti Roblox.

Fungsi ini mengatur apakah elemen `Class.CoreGui` yang terkait dengan `Enum.CoreGuiType` yang diberikan diaktifkan atau dinonaktifkan.

Bar atas tidak dapat dinonaktifkan menggunakan fungsi ini. Untuk menonaktifkannya, atur `"TopbarEnabled"` ke `false` menggunakan `Class.StarterGui:SetCore()`.

StarterGui:SetCoreGuiEnabled

enabled

Apakah untuk mengaktifkan atau menonaktifkan `Enum.CoreGuiType` yang diberikan.

Mengatur apakah elemen `Class.CoreGui` yang terkait dengan `Enum.CoreGuiType` yang diberikan diaktifkan atau dinonaktifkan.

StarterGui

Jika `true`, properti `Class.GuiObject.ClipsDescendants|ClipsDescendants`
dari `Class.GuiObject` memotong keturunan yang **diputar**.

StarterGui.ClipsDescendantsSupportsRotation

Menentukan apakah properti `Class.GuiObject.ClipsDescendants|ClipsDescendants`
dari `Class.GuiObject` memotong keturunan yang **diputar**.

Memungkinkan `Class.StarterGui` untuk memproses input seperti yang dilakukan oleh
`Class.PlayerGui` dan `Class.CoreGui`. Nilai default adalah `false`.

StarterGui.ProcessUserInput

Memungkinkan layanan ini untuk memproses input seperti yang dilakukan oleh
`Class.PlayerGui` dan `Class.CoreGui`.

Jika diatur ke true, setiap anak yang diparent ke `Class.StarterGui` akan
dicloning ke `Class.PlayerGui` pemain ketika karakter pemain tersebut
direspawn.

Jika salah satu anak adalah PlayerGui dan memiliki properti PlayerGui
yang diatur ke false, itu tidak akan dicloning.

StarterGui.ResetPlayerGuiOnSpawn

Menentukan apakah setiap anak yang diparent ke StarterGui akan dicloning
ke PlayerGui pemain ketika karakter pemain tersebut direspawn.

Properti ini menentukan apakah tata letak teks dari kanan ke kiri (RTL) diterapkan
pada teks `Class.GuiObject|GuiObjects` dalam pengalaman, yang diperlukan untuk menampilkan
bahasa yang ditulis dari kanan ke kiri dengan benar, seperti bahasa Arab dan Ibrani.

Nilai default adalah `Enum.RtlTextSupport.Default`. Baik
`Enum.RtlTextSupport.Default` dan `Enum.RtlTextSupport.Enabled` mengaktifkan dukungan
untuk tata letak teks RTL, sementara `Enum.RtlTextSupport.Disabled` menonaktifkannya.


StarterGui.RtlTextSupport

Mengontrol apakah tata letak teks dari kanan ke kiri (RTL) diaktifkan untuk teks di
`Class.GuiObject|GuiObjects` di seluruh pengalaman.


Properti ini mengatur mode orientasi layar yang diinginkan untuk pengguna dengan
perangkat mobile. Untuk mode yang berbeda yang tersedia, lihat
`Enum.ScreenOrientation`.

Secara default, properti ini diatur ke
`Enum.ScreenOrientation.Sensor|Sensor`, yang berarti pengalaman ditampilkan
tergantung pada kecocokan terbaik dengan orientasi saat ini dari perangkat,\ baik lanskap (kiri/kanan) atau potret.

Ketika `Class.Player` bergabung dengan pengalaman di perangkat mobile, properti ini
menentukan orientasi awal perangkat dan mengatur `Class.PlayerGui.ScreenOrientation`
pemain tersebut sesuai. Anda juga dapat mendapatkan
orientasi layar saat ini pemain melalui
`Class.PlayerGui.CurrentScreenOrientation`, berguna saat menggunakan salah satu
pengaturan `Enum.ScreenOrientation` "sensor".

Perlu dicatat bahwa mengubah properti ini tidak akan mengubah orientasi layar
untuk `Class.Player|Players` yang sudah ada di pengalaman. Untuk mengubah
orientasi untuk pemain yang sudah ada, gunakan properti
`Class.PlayerGui.ScreenOrientation` mereka.

StarterGui.ScreenOrientation

Mengatur mode orientasi layar default untuk pengguna dengan perangkat mobile.

Properti ini menentukan apakah konten dari `Class.StarterGui` terlihat di Studio.

StarterGui.ShowDevelopmentGui

Menentukan apakah konten dari `Class.StarterGui` terlihat di
Studio.

Properti ini menentukan apakah kursor virtual gamepad, yang memungkinkan
pemain memindahkan penunjuk di `Class.GuiObject|GuiObjects` di layar menggunakan
pengontrol, diaktifkan.

Nilai default adalah `Enum.VirtualCursorMode.Default`. Mengaturnya ke
`Enum.VirtualCursorMode.Enabled` mengaktifkan kursor virtual dan
`Enum.VirtualCursorMode.Disabled` menonaktifkannya. Ketika pemain berada di VR,
kursor virtual selalu aktif terlepas dari nilai properti ini.


StarterGui.VirtualCursorMode

Mengontrol apakah kursor virtual gamepad diaktifkan untuk menavigasi
`Class.GuiObject|GuiObjects` dengan pengontrol.


Sebuah wadah untuk objek `Class.LayerCollector` yang akan disalin ke dalam `Class.PlayerGui` dari `Class.Player|Players`. Juga menyediakan berbagai fungsi untuk berinteraksi dengan `Class.CoreGui`.

`BasePlayerGui` adalah kelas abstrak yang diwarisi oleh semua kelas penyimpanan gambar GUI.

Semua GUI yang dikembalikan oleh `Class.BasePlayerGui:GetGuiObjectsAtPosition()`
adalah 'dikonversi' oleh fungsi lokal `highlightAsFrame()`, yang membuat `Frame`
GUI yang diposisikan di atas GUI yang ditentukan dan bersifat semi-transparan serta
memiliki `Class.GuiBase2d.AbsoluteSize` dan `Class.GuiBase2d.AbsolutePosition` yang sama.

Sorotan ini ditambahkan ke container Sorotan `ScreenGui` di folder Sorotan
folder PlayerGui pemain. Keduanya dibuat oleh contoh kode ini. Semua GUI sorotan
akan `Class.Instance:Destroy()` setiap kali `highlightGui()` dijalankan.

Perhatikan bahwa `Class.ScreenGui.DisplayOrder` dari HighlightContainer adalah 99999,
sebuah angka yang besar, sehingga tidak mungkin GUI lain akan dirender di atas
GUI sorotan.

Mengambil posisi layar dan mengembalikan daftar semua instance `Class.GuiObject`
yang menempati posisi layar tersebut, diurutkan berdasarkan urutan
yang muncul di layar dari atas ke bawah sebagai indeks pertama dan terakhir,
masing-masing. Kasus penggunaan utamanya adalah untuk mendapatkan objek GUI
yang berada di bawah mouse pemain atau input sentuh untuk memungkinkan pemilihan atau penyorotan.

Karena kelas anak dari `Class.BasePlayerGui` mewarisi fungsi ini, ia
bisa dipanggil oleh kelas kontainer seperti `Class.PlayerGui` dan
`Class.StarterGui`.

BasePlayerGui:GetGuiObjectsAtPosition

Posisi **X** di layar relatif terhadap sudut kiri atas setelah
inset GUI diterapkan (lihat `Class.GuiService:GetGuiInset()`).

Posisi **Y** di layar relatif terhadap sudut kiri atas setelah
inset GUI diterapkan (lihat `Class.GuiService:GetGuiInset()`).

Sebuah tabel dari instansi `Class.GuiObject` yang menempati
ruang layar yang diberikan.

Mengembalikan daftar semua instansi `Class.GuiObject` yang menempati


BasePlayerGui

`BasePlayerGui` adalah kelas abstrak yang diwarisi oleh kelas penyimpanan gambar GUI.

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.

Tidak mungkin untuk secara langsung membuat objek `Instance` root, tetapi
konstruktor khusus `Datatype.Instance.new()` membuat objek melalui kode,
mengambil nama kelas sebagai parameter dan mengembalikan objek yang dibuat.


Menunjukkan cara mendeteksi perubahan pada leluhur sebuah instance dengan menghubungkan ke
`Class.Instance.AncestryChanged` event.

Parent dari ChangingPart diatur ke nilai yang berbeda seiring waktu. Parent dari
part adalah leluhur part, jadi event `Class.Instance.AncestryChanged`
akan dipicu setiap kali terjadi perubahan.

Ditembakkan ketika instance ini dipindahkan atau ketika salah satu nenek moyangnya
dipindahkan.

Anda dapat menggunakan peristiwa ini untuk melacak penghapusan instance di Studio,
seperti penghapusan manual di Explorer atau melalui plugin. Jika Anda perlu
deteksi ketika sebuah instance dihancurkan menggunakan `Class.Instance:Destroy()`,
gunakan peristiwa `Class.Instance.Destroying` sebagai gantinya.


Instance.AncestryChanged

child

Instance yang properti `Class.Instance.Parent|Parent`-nya telah diubah,
yang bisa jadi instance ini atau nenek moyang yang lebih jauh, **bukan**
harus instance yang terhubung ke handler.


parent

Ditembakkan ketika properti `Class.Instance.Parent` dari objek ini atau salah satu
nenek moyangnya diubah.


Peristiwa ini ditembakkan setiap kali atribut diubah pada instance,
termasuk ketika atribut diatur ke `nil`. Nama atribut yang diubah
akan diteruskan ke fungsi yang terhubung.

Sebagai contoh, cuplikan kode berikut menghubungkan fungsi `attributeChanged()`
untuk ditembakkan setiap kali salah satu atribut bagian berubah:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "berubah")
end

part.AttributeChanged:Connect(attributeChanged)
```
Lihat juga `Class.Instance:GetAttributeChangedSignal()` yang mengembalikan
peristiwa yang ditembakkan ketika atribut tertentu berubah.


Instance.AttributeChanged

attribute

Ditembakkan setiap kali atribut diubah pada `Class.Instance`.


Cuplikan ini mencetak nama objek saat mereka ditambahkan ke Workspace:

Ditembakkan setelah sebuah objek dipindahkan ke `Class.Instance` ini.

Catatan, saat menggunakan metode ini di klien untuk mendeteksi objek yang dibuat oleh
server, perlu menggunakan `Class.Instance:WaitForChild()` saat
mengindeks keturunan objek ini. Ini karena objek dan keturunannya tidak dijamin
akan direplikasi dari server ke klien secara bersamaan. Sebagai contoh:

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

Workspace.ChildAdded:Connect(function(child)
	-- Gunakan WaitForChild() karena keturunan mungkin belum direplikasi
	local head = child:WaitForChild("Head")
end)
```
Catatan, peristiwa ini hanya beroperasi untuk anak langsung dari
`Class.Instance`. Untuk peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantAdded`.

Lihat juga `Class.Instance.ChildRemoved`.


Instance.ChildAdded

`Class.Instance` yang telah ditambahkan.


Ditembakkan setelah sebuah objek dipindahkan ke `Class.Instance` ini.


Instance.childAdded

Potongan ini mencetak nama objek saat mereka dihapus dari Workspace:

Ditembakkan setelah seorang anak dihapus dari `Class.Instance` ini.

Dihapus mengacu pada ketika induk objek diubah dari `Class.Instance` ini
ke sesuatu selain `Class.Instance` ini. Catatan, peristiwa ini juga akan
terjadi ketika seorang anak dihancurkan (menggunakan
`Class.Instance:Destroy()`) karena fungsi hancur mengatur induk objek
ke `nil`.

Peristiwa ini hanya beroperasi untuk anak langsung dari `Class.Instance`.
Untuk peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantRemoving`.

Lihat juga `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Ditembakkan setelah seorang anak dihapus dari `Class.Instance` ini.


Contoh berikut akan mencetak nama objek apa pun yang ditambahkan ke
Workspace:

Peristiwa ini ditembakkan setelah seorang keturunan ditambahkan ke `Class.Instance`.

Karena ini ditembakkan untuk setiap keturunan, memindahkan objek ke
`Class.Instance` akan menembakkan peristiwa untuk objek ini dan semua keturunannya
secara individu.

Jika Anda hanya peduli dengan **anak langsung** dari
`Class.Instance`, gunakan `Class.Instance.ChildAdded` sebagai gantinya.

Lihat juga `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Ditembakkan setelah seorang keturunan ditambahkan ke `Class.Instance`.


Contoh berikut mencetak nama dari setiap keturunan saat sedang dihapus
 dari Workspace:

Peristiwa ini ditembakkan **segera sebelum** induk `Class.Instance`
berubah sehingga sebuah instance **keturunan** tidak lagi menjadi
keturunan. `Class.Instance:Destroy()|Destroy()` mengubah `Class.Instance.Parent|Parent`
sebuah instance menjadi `nil`, jadi memanggil metode itu pada seorang keturunan
induk akan menyebabkan peristiwa ini ditembakkan.

Karena peristiwa ini ditembakkan **sebelum** penghapusan keturunan, induk dari
keturunan tidak akan berubah pada saat peristiwa ini ditembakkan. Jika keturunan
juga merupakan **anak langsung** dari induk, peristiwa ini akan ditembakkan
sebelum `Class.Instance.ChildRemoved`.

Jika seorang keturunan memiliki anak, peristiwa ini ditembakkan dengan keturunan
terlebih dahulu, diikuti oleh keturunannya.

#### Peringatan

Peristiwa ini ditembakkan dengan objek keturunan yang sedang dihapus.
Mencoba mengatur `Class.Instance.Parent|Parent` dari keturunan ke
sesuatu yang lain akan gagal. Di bawah ini adalah contoh yang menunjukkan hal ini:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Jangan manipulasi induk keturunan dalam fungsi ini!
	-- Peristiwa ini ditembakkan KARENA induk dimanipulasi, dan perubahan belum terjadi
	-- Oleh karena itu, akan bermasalah untuk mengubah induk seperti ini:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Lihat juga `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

Ditembakkan segera sebelum seorang keturunan dari `Class.Instance` dihapus.


Contoh ini menunjukkan bagaimana, saat menggunakan perilaku sinyal Segera, sebuah
Instance yang dihancurkan tetap berada di tempatnya sampai fungsi yang terhubung menunggu.

Contoh ini menunjukkan bagaimana, ketika menggunakan perilaku sinyal Tertunda, sebuah Instance
 dihancurkan sebelum sinyal dipicu.

`Class.Instance` tidak akan pernah dihapus dari memori selama fungsi yang terhubung
masih menggunakannya. Namun, jika fungsi tersebut menunggu pada titik mana pun,
`Class.Instance` dan keturunannya akan dipindahkan ke `nil`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Immediate`, peristiwa ini akan ditembakkan segera sebelum
`Class.Instance` atau salah satu nenek moyangnya dihancurkan dengan
`Class.Instance:Destroy()`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Deferred`, peristiwa ini akan ditembakkan pada titik
resumsi berikutnya, yang akan terjadi setelah `Class.Instance` atau salah satu
nenek moyangnya dihancurkan dengan `Class.Instance:Destroy()`.

Dengan perilaku `Enum.SignalBehavior.Deferred|Deferred`, menghubungkan skrip
ke peristiwa `Class.Instance.Destroying` miliknya sendiri menjadi bermasalah,
karena skrip akan dihancurkan sebelum callback dapat dipanggil (artinya tidak
akan dieksekusi).

Saat menghapus `Class.Instance` di Studio, seperti menghapus secara manual
melalui [Explorer](/studio/explorer) atau melalui plugin,
`Class.Instance` tidak dihancurkan. Sebaliknya, induk diatur ke `nil`
yang dapat Anda lacak dengan `Class.Instance.AncestryChanged`.


Instance.Destroying

Ditembakkan segera sebelum (atau ditunda hingga setelah) instance dihancurkan
melalui `Class.Instance:Destroy()`.


Mendemonstrasikan `Class.Instance.StyledPropertiesChanged`.


Peristiwa ini ditembakkan setiap kali properti gaya diubah pada instance,
termasuk ketika properti diatur ke `nil`.


Instance.StyledPropertiesChanged

Ditembakkan setiap kali properti gaya diubah pada instance, termasuk
ketika properti diatur ke `nil`.


Metode ini menerapkan tag pada instance, tanpa efek jika tag sudah
 diterapkan. Menambahkan tag dengan sukses akan memicu sinyal yang dibuat oleh
`Class.CollectionService:GetInstanceAddedSignal()` dengan tag yang diberikan.

#### Peringatan

- Tag instance yang ditambahkan di sisi klien akan dihapus jika server
  kemudian menambahkan atau menghapus tag pada instance tersebut karena server
  mereplikasi semua tag bersama dan menimpa tag sebelumnya.

- Saat memberi tag pada instance, umum bahwa beberapa sumber daya digunakan untuk
  memberikan fungsionalitas tag, misalnya koneksi acara atau tabel.
  Untuk mencegah kebocoran memori, adalah ide yang baik untuk membersihkannya
  (putuskan sambungan, atur ke `nil`, dll.) saat tidak lagi diperlukan untuk tag. Lakukan ini saat
  memanggil `Class.Instance:RemoveTag()`, memanggil
  `Class.Instance:Destroy()`, atau dalam fungsi yang terhubung ke sinyal
  yang dikembalikan oleh `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

Fungsi anak mengembalikan array dari anak-anak objek.


Instance:children

Mengembalikan array dari anak-anak objek.


Metode ini menghancurkan semua anak dari sebuah instance dan keturunannya.

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

-- Tambahkan beberapa kilau
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
```
Jika Anda tidak ingin menghancurkan **semua** anak dan keturunan, gunakan
`Class.Instance:GetChildren()` atau `Class.Instance:GetDescendants()` untuk
melalui anak-anak/keturunan tersebut dan memilih apa yang akan dihancurkan. Sebagai
contoh, cuplikan kode berikut akan menghancurkan semua
`Class.BasePart|BaseParts` yang diturunkan dari `Class.Model`:

```
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

Metode ini menghancurkan semua anak dari sebuah instance.


Menunjukkan cara mengkloning sebuah model menggunakan `Class.Instance:Clone()`.

`Clone()` membuat salinan dari sebuah instance dan semua keturunannya,
 mengabaikan semua instance yang tidak
 `Class.Instance.Archivable|Archivable`. Salinan dari instance root dikembalikan oleh metode ini dan `Class.Instance.Parent|Parent`-nya diatur ke
 `nil`. Perhatikan bahwa jika instance itu sendiri memiliki
 `Class.Instance.Archivable|Archivable` diatur ke `false`, metode ini akan
 mengembalikan `nil`.

Jika properti referensi seperti `Class.ObjectValue.Value` diatur dalam
instance yang disalin, nilai dari properti salinan tergantung pada
nilai aslinya:

- Jika properti referensi merujuk pada instance yang **juga** disalin,
  salinan akan merujuk pada salinan tersebut.
- Jika properti referensi merujuk pada instance yang **tidak** disalin,
  nilai yang sama dipertahankan dalam salinan.


Instance:Clone

Salinan dari instance, atau `nil` jika instance tidak
 `Class.Instance.Archivable|Archivable`.


Membuat salinan dari sebuah instance dan semua keturunannya, mengabaikan instance
 yang tidak `Class.Instance.Archivable|Archivable`.


Instance:clone

Menunjukkan cara menghancurkan sebuah Part menggunakan fungsi `Class.Instance:Destroy()`.

Fungsi ini adalah cara yang benar untuk membuang objek yang tidak lagi
dibutuhkan.

Mengatur properti `Class.Instance.Parent` menjadi `nil`, mengunci
properti `Class.Instance.Parent`, memutuskan semua koneksi, dan memanggil
`Destroy()` pada semua anak. Metode ini adalah cara yang benar untuk membuang
objek yang tidak lagi diperlukan.

Membuang objek yang tidak diperlukan itu penting, karena objek dan
koneksi yang tidak perlu di suatu tempat menggunakan memori yang dapat
menyebabkan masalah kinerja yang serius seiring waktu.

Sebagai praktik terbaik setelah memanggil `Destroy()` pada sebuah objek,
aturkan variabel yang merujuk pada objek (atau keturunannya) menjadi `nil`. Ini
mencegah kode Anda mengakses apa pun yang berhubungan dengan objek tersebut.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Jangan lakukan ini:
print(part.Name)  --> "Hello, world"
-- Lakukan ini untuk mencegah baris di atas berfungsi:
part = nil
```
Setelah `Class.Instance` dihancurkan oleh metode ini, tidak dapat digunakan
kembali karena properti `Class.Instance.Parent` terkunci. Untuk
**sementara** menghapus objek alih-alih menghancurkannya, atur
`Class.Instance.Parent|Parent` menjadi `nil`. Sebagai contoh:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Untuk menghancurkan objek setelah waktu tertentu, gunakan
`Class.Debris:AddItem()`.


Instance:Destroy

Mengatur properti `Class.Instance.Parent` menjadi `nil`, mengunci
properti `Class.Instance.Parent`, memutuskan semua koneksi, dan memanggil
`Destroy()` pada semua anak.


Instance:destroy

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name`-nya sama dengan nama yang diberikan.

Metode ini bekerja ke atas, artinya dimulai dari `Class.Instance.Parent`
yang langsung dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, ia mengembalikan `nil`.

Cuplikan kode berikut akan menemukan nenek moyang pertama dari objek
bernama `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Untuk varian dari metode ini yang menemukan nenek moyang dari kelas tertentu,
lihat `Class.Instance:FindFirstAncestorOfClass()` dan
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name`-nya sama dengan nama yang diberikan.


Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName`-nya sama dengan className yang diberikan.

Metode ini bekerja ke atas, artinya dimulai dari `Class.Instance.Parent`
yang langsung dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, ia mengembalikan `nil`.

Penggunaan umum dari metode ini adalah menemukan `Class.Model` yang
`Class.BasePart` miliki. Sebagai contoh:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Metode ini adalah varian dari `Class.Instance:FindFirstAncestor()` yang
memeriksa properti `Class.Object.ClassName` alih-alih
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` juga
ada, menggunakan metode `Class.Object:IsA()` sebagai gantinya untuk menghormati
pewarisan kelas.


Instance:FindFirstAncestorOfClass

className

Nama `Class.Object.ClassName` yang dicari.


Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName`-nya sama dengan className yang diberikan.


Mengembalikan nenek moyang pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.

Metode ini bekerja ke atas, artinya dimulai dari `Class.Instance.Parent`
yang langsung dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, ia mengembalikan `nil`.

Berbeda dengan `Class.Instance:FindFirstAncestorOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Oleh karena itu, cuplikan kode berikut akan mengembalikan nenek moyang pertama
`Class.BasePart`, terlepas dari apakah itu adalah `Class.WedgePart`,
`Class.MeshPart` atau `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Lihat juga `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Mengembalikan nenek moyang pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.


Di bawah ini akan mencari di Workspace untuk objek dengan nama "Brick". Jika ditemukan,
akan mengganti nama objek tersebut menjadi "Foo".

Mengembalikan anak pertama dari `Class.Instance` dengan nama yang diberikan, atau
`nil` jika tidak ada anak seperti itu yang ada. Jika argumen opsional `recursive`
`true`, metode ini mencari semua keturunan alih-alih hanya anak langsung dari `Class.Instance`.

#### Memeriksa Keberadaan Objek

`FindFirstChild()` diperlukan jika Anda perlu memverifikasi keberadaan objek
sebelum melanjutkan. Mencoba mengindeks anak dengan nama menggunakan operator titik
akan melempar kesalahan jika anak tersebut tidak ada.

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

-- Baris berikut akan menghasilkan kesalahan jika bagian tidak ada di workspace
Workspace.Part.Transparency = 0.5
```
Pendekatan yang lebih baik adalah menggunakan `FindFirstChild()` untuk terlebih dahulu memeriksa `Part`,
kemudian menggunakan pernyataan `if` untuk menjalankan kode yang membutuhkannya.

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

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

#### Menemukan Anak yang Namanya Cocok dengan Properti

Terkadang `Class.Instance.Name|Name` dari sebuah objek sama dengan
properti dari `Class.Instance.Parent|Parent`-nya. Saat menggunakan operator titik,
properti memiliki prioritas lebih tinggi daripada anak jika mereka memiliki nama yang sama.

Dalam contoh berikut, sebuah `Class.Folder` bernama `Color` ditambahkan ke
`Class.Part`, yang juga memiliki properti `Class.Part.Color`. Perhatikan bahwa
`part.Color` merujuk pada nilai properti `Datatype.Color3`, bukan instance anak
`Class.Folder`. Manfaat menggunakan
`Class.Instance:FindFirstChild()|FindFirstChild()` adalah bahwa
pengenalan properti baru tidak menimbulkan risiko pada kode Anda.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Properti
local c2 = part:FindFirstChild("Color")  -- Folder anak
```

#### Catatan Kinerja

`Class.Instance:FindFirstChild()|FindFirstChild()` memakan waktu sekitar 20% lebih lama
 daripada menggunakan operator titik dan hampir 8 kali lebih lama daripada hanya menyimpan
referensi ke sebuah objek. Oleh karena itu, Anda harus menghindari memanggilnya dalam
kode yang bergantung pada kinerja seperti dalam loop ketat atau fungsi yang terhubung
ke `Class.RunService.Heartbeat` dan `Class.RunService.PreRender`. Sebagai gantinya,
 simpan hasilnya dalam variabel, atau pertimbangkan untuk menggunakan
`Class.Instance.ChildAdded|ChildAdded` atau
`Class.Instance:WaitForChild()|WaitForChild()` untuk mendeteksi kapan anak dengan nama tertentu menjadi tersedia.


Instance:FindFirstChild

Nama `Class.Instance.Name` yang akan dicari.


recursive

Apakah pencarian harus dilakukan secara rekursif atau tidak.


Mengembalikan anak pertama dari `Class.Instance` yang ditemukan dengan nama yang diberikan.


Instance:findFirstChild

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object.ClassName|ClassName`-nya sama dengan `className` yang diberikan.
Berbeda dengan `Class.Instance:FindFirstChildWhichIsA()`, metode ini hanya mengembalikan
objek yang kelasnya cocok dengan `className`, mengabaikan pewarisan kelas. Jika tidak
ada anak yang cocok ditemukan, metode ini mengembalikan `nil`.


Instance:FindFirstChildOfClass

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object.ClassName|ClassName`-nya sama dengan nama kelas yang diberikan.


Mengembalikan anak pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.

Jika tidak ada anak yang cocok ditemukan, metode ini mengembalikan `nil`. Jika argumen
opsional rekursif bernilai true, metode ini mencari semua keturunan alih-alih hanya anak langsung dari `Class.Instance`.

Berbeda dengan `Class.Instance:FindFirstChildOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Oleh karena itu, cuplikan kode berikut akan mengembalikan anak pertama
`Class.BasePart`, terlepas dari apakah itu adalah `Class.WedgePart`,
`Class.MeshPart` atau `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Pengembang yang mencari anak berdasarkan nama, sebaiknya menggunakan
`Class.Instance:FindFirstChild()` sebagai gantinya.


Instance:FindFirstChildWhichIsA

Mengembalikan anak pertama dari `Class.Instance` untuk siapa
`Class.Object:IsA()` mengembalikan true untuk className yang diberikan.


Mengembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.

Metode ini dinonaktifkan dan tidak dapat digunakan. Untuk menemukan keturunan pertama
 dari sebuah instance, pertimbangkan untuk menggunakan parameter `recursive` pada
`Class.Instance:FindFirstChild()` sebagai gantinya.


Instance:FindFirstDescendant

Mengembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.


Jika `Class.Instance` adalah `Class.Actor`, `Class.Actor` itu sendiri akan
 dikembalikan. Jika tidak, nenek moyang terdekatnya `Class.Actor` akan dikembalikan. Jika tidak
 ada nenek moyang yang merupakan `Class.Actor`, hasilnya adalah `nil`.


Instance:GetActor

Mengembalikan `Class.Actor` yang terkait dengan Instance, jika ada.


Metode ini mengembalikan nilai yang telah ditetapkan untuk nama
atribut yang diberikan. Jika tidak ada atribut yang ditetapkan, `nil` akan dikembalikan.

Sebagai contoh, cuplikan kode berikut mengatur dan kemudian mendapatkan nilai dari
atribut `InitialPosition` instance:

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

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

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

#### Lihat Juga

- `Class.Instance:SetAttribute()` yang mengatur atribut dengan nama yang diberikan
  ke nilai yang diberikan.
- `Class.Instance:GetAttributes()` yang mengembalikan kamus pasangan kunci-nilai
  untuk setiap atribut instance.


Instance:GetAttribute

Nilai yang telah ditetapkan untuk nama atribut yang diberikan. Jika tidak ada
atribut yang ditetapkan, `nil` akan dikembalikan.


Mengembalikan nilai yang telah ditetapkan untuk nama atribut yang diberikan.


Metode ini mengembalikan sebuah acara yang berfungsi persis seperti
acara `Class.Object.Changed|Changed`, kecuali bahwa ia hanya dipicu ketika
atribut yang diberikan berubah; secara efektif mirip dengan
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` tetapi
untuk atribut.

Umumnya adalah ide yang baik untuk menggunakan metode ini alih-alih koneksi ke
`Class.Object.Changed|Changed` dengan fungsi yang memeriksa nama atribut.
Panggilan berikutnya ke metode ini pada objek yang sama dengan nama atribut yang sama
mengembalikan acara yang sama.

Cuplikan kode berikut mengembalikan sinyal yang memicu fungsi
`attributeChanged()` ketika atribut `InitialPosition` bagian berubah:

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

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

local function attributeChanged()
	print("Atribut berubah")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Lihat juga `Class.Instance.AttributeChanged` yang dipicu setiap kali ada
atribut yang diubah pada instance.


Instance:GetAttributeChangedSignal

Nama atribut yang ditentukan untuk sinyal perubahan yang
sedang dikembalikan.


Sebuah acara yang dipicu ketika atribut yang diberikan berubah.


Mengembalikan sebuah acara yang dipicu ketika atribut yang diberikan berubah.


Metode ini mengembalikan kamus pasangan kunci-nilai untuk setiap atribut
di mana kunci adalah nama atribut dan nilai adalah nilai yang tidak `nil`.

Sebagai contoh, cuplikan kode berikut mengeluarkan atribut dan nilai dari
sebuah instance:

```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
```
Lihat juga `Class.Instance:GetAttribute()` yang mengembalikan nilai yang telah
ditetapkan untuk nama atribut yang diberikan.


Instance:GetAttributes

Sebuah kamus pasangan string → varian untuk setiap atribut di mana
string adalah nama atribut dan varian adalah nilai yang tidak-nil.


Mengembalikan kamus atribut dari instance.


Di bawah ini akan mencetak nama semua objek yang saat ini ada di Workspace saat dijalankan.

Mengembalikan array (tabel yang diindeks secara numerik) yang berisi semua
anak langsung dari instance, atau setiap `Class.Instance` yang
`Class.Instance.Parent|Parent`-nya sama dengan objek tersebut. Array dapat
iterasi menggunakan loop numerik atau loop generik:

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

-- Contoh loop numerik
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " adalah anak nomor " .. i)
end
```

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

-- Contoh loop generik
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " adalah anak nomor " .. i)
end
```
Perhatikan bahwa array yang dikembalikan **tidak** diurutkan dalam urutan tertentu,
jadi pengurutan manual (misalnya menggunakan `Library.table.sort()`) disarankan untuk
mengurutkan anak-anak yang dikembalikan oleh metode ini.

Lihat juga metode `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Mengembalikan array yang berisi semua anak dari instance.


Instance:getChildren

Mengembalikan string kode dari ID debug yang digunakan secara internal oleh Roblox. Perhatikan
bahwa:

- Item ini dilindungi. Mencoba menggunakannya dalam `Class.Script` atau
  `Class.LocalScript` akan menyebabkan kesalahan.
- ID debug adalah ID yang digunakan dalam proses debugging. Ini memungkinkan debugger untuk
  membaca setiap instruksi sebelum aplikasi memprosesnya. Semua objek di
  Roblox bertindak seperti proses dan setiap menjalankan instruksi (atau 'kode') yang dapat
  di-debug jika diperlukan.
- Ini dapat membantu untuk plugin yang perlu membedakan objek serupa satu sama lain
  (seperti objek yang memiliki nama yang sama).


Instance:GetDebugId

scopeLength

Mengembalikan string kode dari ID debug yang digunakan secara internal oleh Roblox.


GetDescendants sering digunakan untuk melakukan sesuatu kepada semua keturunan yang merupakan
jenis objek tertentu. Kode dalam contoh ini menggunakan GetDescendants dan
`Class.Instance:IsA()` untuk menemukan semua bagian di workspace dan mengubah
warna mereka menjadi hijau.

Metode objek ini mengembalikan array yang berisi semua keturunan
 dari objek tersebut. Berbeda dengan `Class.Instance:GetChildren()`, yang hanya mengembalikan
anak langsung dari sebuah objek, metode ini menemukan setiap anak dari objek,
every child of those children, dan seterusnya.

Perhatikan bahwa array yang dikembalikan **tidak** diurutkan dalam urutan tertentu,
jadi pengurutan manual (misalnya menggunakan `Library.table.sort()`) disarankan untuk
mengurutkan keturunan yang dikembalikan oleh metode ini. Juga pertimbangkan
metode `Class.Instance:QueryDescendants()|QueryDescendants()` untuk men-query
keturunan berdasarkan kombinasi pemilih dan penggabung.


Instance:GetDescendants

Mengembalikan array yang berisi semua keturunan dari instance.


Contoh kode ini menunjukkan perilaku dari `Class.Instance:GetFullName()`.
Ini menunjukkan bagaimana fungsi berperilaku saat dipanggil pada objek yang tidak berada di
hierarki `DataModel`, dan juga menunjukkan bagaimana nilai yang dikembalikan tidak meloloskan
karakter khusus.

Contoh kode ini mengimplementasikan kembali fungsi `Class.Instance:GetFullName()` dalam
Lua.


Mengembalikan string yang menggambarkan keturunan instance. String ini adalah
koneksi dari `Class.Instance.Name|Name` objek dan nenek moyangnya,
yang dipisahkan oleh titik. `Class.DataModel` (`game`) tidak
dipertimbangkan. Sebagai contoh, sebuah `Class.Part` di dalam `Class.Workspace` dapat
mengembalikan `Class.Workspace.Part`.

Ketika dipanggil pada `Class.Instance` yang bukan keturunan dari
`Class.DataModel`, metode ini mempertimbangkan semua nenek moyang hingga dan termasuk
nenek moyang teratas yang tidak memiliki `Class.Instance.Parent|Parent`.

Metode ini berguna untuk logging dan debugging. Anda tidak boleh mencoba untuk
mengurai string yang dikembalikan untuk operasi yang berguna; metode ini tidak
menghindari titik (atau simbol lain) dalam nama objek. Dengan kata lain,
meskipun outputnya sering tampak sebagai pengidentifikasi Luau yang valid, itu tidak
jamin.


Instance:GetFullName

Mengembalikan string yang menggambarkan keturunan instance.


Mendemonstrasikan `Class.Instance:GetStyled()`.


Metode ini mengembalikan nilai yang telah ditata atau diubah secara eksplisit dari
properti yang ditentukan, atau nilai properti default jika belum ditata/dimodifikasi. Ini sedikit berbeda dari mengakses nilai properti
secara langsung, seperti `[GuiObject].Rotation`, yang mengembalikan nilai default atau
modifikasi dari properti.


Instance:GetStyled

selector

Pemilih opsional untuk instance pseudo yang Anda targetkan pada
instance.


Nilai yang telah ditata atau diubah secara eksplisit dari properti yang ditentukan,
atau nilai properti default jika belum ditata/dimodifikasi.


Mengembalikan nilai yang telah ditata atau diubah secara eksplisit dari properti yang ditentukan,
atau nilai properti default jika belum ditata/dimodifikasi.


Mendemonstrasikan `Class.Instance:GetStyledPropertyChangedSignal()`.


Metode ini mengembalikan sebuah acara yang berfungsi persis seperti
acara `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
 kecuali bahwa ia hanya dipicu ketika properti gaya yang diberikan berubah. Ini
umumnya adalah ide yang baik untuk menggunakan metode ini alih-alih koneksi ke
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` dengan fungsi yang memeriksa
nama properti. Panggilan berikutnya ke metode ini pada objek yang sama dengan nama properti yang sama
mengembalikan acara yang sama.

Perhatikan bahwa acara ini tidak akan mengirimkan argumen ke fungsi yang terhubung,
jadi nilai dari properti yang berubah harus dibaca langsung dalam
skrip.


Instance:GetStyledPropertyChangedSignal

property

Nama properti gaya yang akan didengarkan untuk perubahan.


Acara yang dipicu ketika properti gaya yang diberikan berubah.


Mengembalikan sebuah acara yang dipicu ketika properti gaya yang diberikan berubah pada
instance.


Metode ini mengembalikan array dari tag yang diterapkan pada instance yang diberikan, sebagai
string. Anda dapat menambahkan tag baik di Studio di jendela
[Properties](/studio/properties) atau saat runtime dengan
`Class.Instance:AddTag()|AddTag()`.

Metode ini berguna ketika Anda ingin melakukan sesuatu dengan beberapa tag pada
instance sekaligus. Namun, tidak efisien untuk menggunakan metode ini untuk
memeriksa keberadaan satu tag; sebaliknya, gunakan
`Class.Instance:HasTag()|HasTag()` untuk memeriksa tag tertentu.


Instance:GetTags

Array string, masing-masing mewakili tag yang diterapkan pada instance.


Mengambil array dari semua tag yang diterapkan pada instance.


Metode ini mengembalikan `true` jika tag yang diberikan telah ditambahkan ke
objek. Anda dapat menambahkan tag baik di Studio di jendela
[Properties](/studio/properties) atau saat runtime dengan
`Class.Instance:AddTag()|AddTag()`.


Instance:HasTag

`true` jika instance memiliki tag yang diberikan, `false` jika tidak.


Memeriksa apakah instance memiliki tag tertentu.


Instance

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox
yang dapat menjadi bagian dari pohon `Class.DataModel`.


/reference/engine/classes/StarterGui.yaml